Skip to content

Library that provides trans modifer and block smarty extensions based on Symfony Translations contracts

License

Notifications You must be signed in to change notification settings

imponeer/smarty-translate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

License GitHub release Maintainability PHP Packagist

Smarty Translate

This library adds new smarty block and var modifier trans for using with Symfony Translation compatible library.

Installation

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.

Registering in Smarty

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']);

Using from templates

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

How to contribute?

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.