A Symfony Lokalise translation bundle

Installs: 1 152

Dependents: 0

Suggesters: 0

Stars: 0

Watchers: 1

Forks: 1

Open Issues: 0


v0.1.4 2018-07-13 11:33 UTC


This bundle receives the webhook from and uploads the new translation files to your directories.

1. Installing the bundle

Require it with composer.

composer require alicorn/lokalise-bundle

2. Enable the bundle in your kernel

// app/AppKernel.php

public function registerBundles()
    return array(
        // ...
        new Alicorn\LokaliseBundle\AlicornLokaliseBundle(),
        // ...

3. Configure the bundle routing

# app/config/routing.yml
# Webhook url configuration
    resource: "@AlicornLokaliseBundle/Controller/"
    type:     annotation
    prefix:   /lokalise/webhook/ # your webhook url

4. Configure the bundle

# app/config/config.yml
# ...
    # Webhook configuration
    host: "" # Lokalise host for downloads can be overwritten
    web_path: "web/locales" # Path for locale files #1
    symfony_path: "app/Resources/translations" # Path for locale files #2, can be blank
    extract_file: "/tmp/"
    # API configuration
        project_id: "XXXXXXXXXXXXXXXXXXXXXX"
        type: "json"
        use_original: "0"
        bundle_structure: "%%LANG_ISO%%.%%FORMAT%%"
        base_url: ""
        directory_prefix: "%%LANG_ISO%%"

5. Configure webhook on lokalise

Configure your webhook on lokalise.

screen shot 2017-05-03 at 16 43 42

When building the project in lokalise, it will trigger the webhook and unzip the translation files to the configured directories.

6. Download translations via cli

If the API is configured, you can use the import command to update all translation files locally.

php bin/console lokalise:import