ibrows / sonata-translation-bundle
Integration of lexik translation into sonata admin
Installs: 70 079
Dependents: 1
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 2
Open Issues: 1
Type:symfony-bundle
Requires
- php: >=5.3.0
- lexik/translation-bundle: *
- sonata-project/admin-bundle: *
- symfony/framework-bundle: >=2.1
This package is auto-updated.
Last update: 2024-10-15 19:59:11 UTC
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 ;).