salim/sonata-translation-bundle

Integration of lexik translation into sonata admin

SonataTranslationBundle

The SonataTranslationBundle is an integration of the LexikTranslationBundle into the SonataAdminBundle., _(*1)

, _(*2)

Installation

Add the following lines in your composer.json:, _(*3)

{
    "require": {
        "ibrows/sonata-translation-bundle" : "dev-master",
    }
}

To start using the bundle, register the SonataTranslationBundle and LexikTranslationBundle in your application's kernel class:, _(*4)

<php
// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        // ...
        new Lexik\Bundle\TranslationBundle\LexikTranslationBundle(),
        new Ibrows\SonataTranslationBundle\IbrowsSonataTranslationBundle(),
    );
)

Configuration

SonataTranslationBundle

No initial configuration is necessary., _(*5)

However there are some options you can configure in order to edit the look. Below the default configuration is shown:, _(*6)

# app/config/config.yml
ibrows_sonata_translation:
    defaultDomain: messages
    editable:
        mode: inline         # Mode of editable, can be popup or inline
        type: textarea       # Type of input. Can be text|textarea|select|date|checklist and more
        emptytext: Empty     # text to display on empty translations
        placement: top       # ingnored for inline mode

LexikTranslationBundle

The minimal configuration consists of:, _(*7)

# app/config/config.yml
lexik_translation:
    fallback_locale: en      # (required) default locale to use
    managed_locales: [en]    # (required) locales that the bundle have to manage

For additional configuration options please refer to the official documentation, _(*8)

In order to have some keys shown up in the admin panel, you have to import the translation files first. This is done through a command offered by LexikTranslationBundle:, _(*9)

./app/console lexik:translations:import [bundleName] [--cache-clear] [--force] [--globals]

Once again refer to the official documentation for additional information., _(*10)

Usage

To include the bundle in the admin dashboard, add group "group.translation" to dashboard, _(*11)

# app/config/config.yml
sonata_admin:
    dashboard:
        groups:
            group.translation:
                label: Translation
                items: ~ 

There really is not more to say about it ;)., _(*12)