ibrows/sonata-translation-bundle

Integration of lexik translation into sonata admin

1.1.1 2015-07-03 09:55 UTC

Requires

• php: >=5.3.0
• lexik/translation-bundle: *
• sonata-project/admin-bundle: *
• symfony/framework-bundle: >=2.1

MIT

• translation
• sonata
• ibrows
• lexik

README

The SonataTranslationBundle is an integration of the LexikTranslationBundle into the SonataAdminBundle.

Installation

Add the following lines in your composer.json:

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

To start using the bundle, register the SonataTranslationBundle and LexikTranslationBundle in your application's kernel class:

<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.

However there are some options you can configure in order to edit the look. Below the default configuration is shown:

# 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:

# 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

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:

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

Once again refer to the official documentation for additional information.

Usage

To include the bundle in the admin dashboard, add group "group.translation" to dashboard

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

There really is not more to say about it ;).