aecf/translator-tool-bundle

A graphical user interface to manage project translations

0.1 2016-05-17 14:48 UTC

README

The TranslatorToolBundle adds a symfony profiler tool for create and edit your translation. It supports multiple languages and formats. If you have multiple formats, he will write in several files at once. You can live edit your translations (if you set the live_edit at true in config_dev.yml). A gray border appear around your words with a trans filter. Just click on it !

Features:

  • Automatically adds your keys followed by "trans" twig filter in the translation file (create if it does not exist).
  • Adds an interface to add or edit translations, just click on your word in the "Message Preview" column (if you aren't in live edit), type your word and click outside the field.
  • Only the language of your current environment will be impacted.

Note: This bundle does not provide an translation system but make it easier

Build Status

Installation

You can install TranslatorToolBundle through Composer:

$ composer require aecf/translator-tool-bundle

Enable translation:

In your app/config/config.yml, just uncomment:

framework:
    translator: { fallbacks: ["%locale%"] }

Enable the bundle:

app/AppKernel.php:

if (in_array($this->getEnvironment(), array('dev', 'test'))) {
    ...
    $bundles[] = new AECF\TranslatorToolBundle\TranslatorToolBundle();
}

routing_dev.yml:

translator_tool:
    resource: "@TranslatorToolBundle/Controller/"
    type:     annotation
    prefix:   /translator_tool/

config_dev.yml:

translator_tool:
    enabled_locales: ['fr', 'en'] # optional, if not specified default value is parameter "locale"
    live_edit: true
    auto_create_missing:
        enabled: true
        formats: ['yml'] # Supported formats : csv, ini, json, mo, php, po, yml, xml

Result

TranslatorTool Profiler

License

This bundle is under the MIT license. See the complete license in the bundle:

Resources/meta/LICENSE

About

TranslatorToolBundle is a AECF initiative.

See also the list of contributors.

Reporting an issue or a feature request

Issues and feature requests are tracked in the Github issue tracker.

When reporting a bug, it may be a good idea to reproduce it in a basic project built using the Symfony Standard Edition to allow developers of the bundle to reproduce the issue by simply cloning it and following some steps.