CrowdinBundle

Manage your Crowdin translations via Symfony2 commands thanks to the akeneo/crowdin-api library.

Installation

We assume you're familiar with Composer, a dependency manager for PHP. Use following command to add the bundle to your composer.json and download package.

If you have Composer installed globally.

    $ composer require jjanvier/crowdin-bundle:*@dev

Otherwise you have to download .phar file.

    $ curl -sS https://getcomposer.org/installer | php
    $ php composer.phar require janvier/crowdin-bundle:*@dev

Adding required bundles to the kernel

You need to enable the bundle inside the symfony kernel.

    <?php

    // app/AppKernel.php

    public function registerBundles()
    {
        $bundles = array(
            new Jjanvier\Bundle\CrowdinBundle\JjanvierCrowdinBundle(),
        );
    }

Configuration

Add the following configuration to your config.yml :

    jjanvier_crowdin:
        crowdin_api_key: %crowdin_api_key%
        crowdin_project_identifier: %crowdin_project_identifier%

Add the following keys to your parameters.yml:

    crowdin_api_key: MY_API_KEY
    crowdin_project_identifier: MY_PROJECT_IDENTIFIER

Existing commands

• crowdin:api:add-directory adds a directory to the Crowdin project.
• crowdin:api:delete-directory deletes a Crowdin project directory. All nested files and directories will be deleted too.
• crowdin:api:download downloads last package from Crowdin.
• crowdin:api:export builds a zip archive with lastest Crowdin translations. Can be invoked only once every 30 minutes.
• crowdin:api:add-file adds a new file to the Crowdin project.
• crowdin:api:delete-file deletes a file from the Crowdin project. All the translations will be lost without ability to restore them.
• crowdin:api:status gets Crowdin project progress by language.
• crowdin:api:upload uploads latest version of your localization files to Crowdin.
• crowdin:extract retrieves translations of your project and extract them.