domis86/translator-bundle

Easily edit Symfony2 translations while browsing your site

domis86/TranslatorBundle

, _(*1)

What is it ?

Symfony2 bundle which helps in translation., _(*2)

A Symfony2 bundle which helps in editing of translations without need for editing the translations files. Edit can be performed via symfony WebDebugToolbar (translations from current request) or backend admin interface (all translations). Translations are stored in db and retrieved in a efficient way (+cached)., _(*3)

The Symfony2 WebDebugToolbar shows number of translations used in current request: , _(*4)

If you click on it a Edit Dialog will appear where you can edit translations used in current request: , _(*5)

- indicates that translation for this language is missing - click and add it!, _(*6)

- Black text is current translation stored in db. Blue text means that it is translation loaded from file - via default Symfony2 Translator service (messages.en.yml etc). It will be used if there is no translation in DB., _(*7)

In this example hello is translated to Hallo when language is german, but when language is french then it is translated to Bonjour (which resides somewhere in messages.fr.yml). Hit ( Click to edit ) above Bonjour to change it., _(*8)

You can also browse [your_domain.com]/app_dev.php/domis86translator/backend to edit all translations used in your application., _(*9)

Features

• edit/add translations without need of messing with translations files
• integration with Symfony2 WebDebugToolbar (dev env)
  • info how many translated/used messages was in request
• robust Edit Dialog (js) activated by clicking on WebDebugToolbar
  • search/sort your translations by name, domain name, content
  • just click on translation, edit it in place and save
  • click on Help button in Dialog for more info
• manage all translations from you application in Backend (same features as Edit Dialog)
• translations are stored in DB, and cached per Action

Installation

Add the domis86/translator-bundle package to your require section in the composer.json file: ``` json ... "require": { ... "domis86/translator-bundle": "dev-master" }, ..., _(*10)

Add the Domis86TranslatorBundle to your AppKernel:
``` php
// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        // ...
        new Domis86\TranslatorBundle\Domis86TranslatorBundle(),
        // ...
    );
    ...
}

Enable this bundle and configure managed_locales in your config.yml: ``` yaml, _(*11)

config.yml

domis86_translator: is_enabled: true managed_locales: [en, fr, de], _(*12)

Enable Dialog for `dev` environment in your `config_dev.yml`:
``` yaml
# config_dev.yml
domis86_translator:
    is_web_debug_dialog_enabled: true

Add routes in your routing_dev.yml: ``` yaml, _(*13)

routing_dev.yml

domis86_translator_routing: resource: "@Domis86TranslatorBundle/Resources/config/routing.yml" prefix: /domis86translator, _(*14)

Update your database:
``` console
php app/console doctrine:schema:update --force

Install assets ``` console php app/console assets:install, _(*15)

#### Optional config:

If your web server's DocumentRoot points to some other dir than symfony's `/web` dir then you can change `domis86_translator.assets_base_path` accordingly (default is `/bundles/domis86translator/`).
Assuming your app.php url is `http://localhost/uglydirectory/web/app.php` then you should do:

``` yaml
domis86_translator:
    managed_locales: [en, fr, de]
    assets_base_path: /uglydirectory/web/bundles/domis86translator/

Used libraries:

• jQuery
• jQuery-ui
• DataTables
• Jeditable
• yepnope.js

, _(*16)