README

Extract translations from Javascript source files.

Recommended willdurand/js-translation-bundle

Same bundle exists for JMSTranslation: see Coffreo/jms-translation-js-extractor-bundle

Installation

Application with Symfony flex

composer require coffreo/php-translation-js-extractor-bundle

Application without Symfony flex

Install bundle

composer require coffreo/php-translation-js-extractor-bundle

Enable bundle:

symfony 3.*

// config/AppKernel.php
public function registerBundles()
{
    return array(
        // ...
        new Coffreo\PHPTranslationJsExtractorBundle\CoffreoPHPTranslationJsExtractorBundle(),
        // ...
    );
}

symfony 4.* (if not already added by symfony/flex)

// config/bundles.php

return [
    // ...
    Coffreo\PHPTranslationJsExtractorBundle\CoffreoPHPTranslationJsExtractorBundle::class => ['all' => true],
];

Usage

This bundle allow extraction of translated strings in javascript files using Coffreo/js-translation-extractor.

No specific command line to use, just use originals php-translation/symfony-bundle commands:

$ bin/console translation:extract ....

Translations found are automatically added to current translations files as PHP, twig ones.

Configuration

This bundle doesn't need configuration.
However, to extract strings from JS files, you must indicate where are stored your JS files in php-translation/symfony-bundle configuration.

# paths below are symfony 4.X paths, make sure to change them for sumfony 3.X
# config/packages/php_translation.yaml
translation:
    ...
    configs:
        app:
            dirs: 
              - "%kernel.project_dir%/templates"
              - "%kernel.project_dir%/src"
              - "%kernel.project_dir%/assets"     # <-- add path containing JS files 
            #...

Developer commands

Run tests:

composer test

Apply coding standard

composer cs

Coding standard must be applied before commit, TravisCI will fail otherwise

License

This project is licensed under the MIT License - see the LICENSE file for details

coffreo / php-translation-js-extractor-bundle

Maintainers

Details