This library adds new smarty block and var modifier trans
for using with Symfony Translation compatible library.
To install and use this package, we recommend to use Composer:
composer require imponeer/smarty-translate
Otherwise, you need to include manually files from src/
directory.
If you want to use these extensions from this package in your project you need register them with registerPlugin
function from Smarty. For example:
$smarty = new \Smarty();
$transBlockPlugin = new \Imponeer\Smarty\Extensions\Translate\TransBlock($translator);
$transModifierPlugin = new \Imponeer\Smarty\Extensions\Translate\TransVarModifier($translator);
$smarty->registerPlugin('block', $transBlockPlugin->getName(), [$transBlockPlugin, 'execute']);
$smarty->registerPlugin('modifier', $transModifierPlugin->getName(), [$transModifierPlugin, 'execute']);
Translations can be done from templates...
....with block function:
<{trans domain='admin'}>_AD_INSTALLEDMODULES<{/trans}>
...with modifier:
<{"_AD_INSTALLEDMODULES"|trans:[]:'admin'}>
Block function supports such attributes:
Atribute | What it does? | Default value |
---|---|---|
parameters | Key/value lists that should be replaced in translated string | [] |
domain | Domain from where to get translation string (in most cases same as translation file) | (system default value) |
locale | Translate in specific locale | (current system locale) |
Var modifier also supports these attributes, but syntax is a bit different - trans:PARAMETERS:DOMAIN:LOCALE
If you want to add some functionality or fix bugs, you can fork, change and create pull request. If you not sure how this works, try interactive GitHub tutorial.
If you found any bug or have some questions, use issues tab and write there your questions.