README

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.

How to register in Smarty

To register all the functions of this package, simply add the extension class to Smarty:

$smarty = new \Smarty();
$smarty->addExtension(
    new \Imponeer\Smarty\Extensions\Translate\TranslationSmartyExtension($translator)
);

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 functionality or fix bugs, you can fork the repository, make changes, and create a pull request. If you're not sure how this works, try reading the GitHub documentation.

If you found any bug or have some questions, use issues tab and write there your questions.

imponeer / smarty-translate

Maintainers

Details