jjanvier/crowdin-bundle

This package is abandoned and no longer maintained. The author suggests using the akeneo/nelson package instead.

Manage Crowdin translations via Symfony2 commands.

0.2.0 2014-08-11 22:59 UTC

Requires

• php: >=5.3.3
• akeneo/crowdin-api: *@dev
• jjanvier/crowdin-lib: *@dev
• knplabs/github-api: *@dev
• symfony/framework-bundle: ~2.2

Requires (Dev)

• phpspec/phpspec: 2.0.*@dev

MIT

• Julien Janvier

• localization
• translating
• crowdin

README

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

This package is not maintained anymore!

Please use akeneo/nelson instead, which is up-to-date, maintained and contains more features.

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 "jjanvier/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 latest Crowdin translations. Can be invoked only once every 30 minutes.
• crowdin:api:add-file adds a new file to the Crowdin project.
• crowdin:api:update-file updates an existing file in 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.