vsalvans / twig-translation

dev-master / 1.0.x-dev 2024-12-15 20:51 UTC

Requires

• php: >=5.3.0
• symfony/yaml: ^2.6
• twig/twig: ~1.0

Unknown License

Published on Packagist.org on 2025-09-03 13:38 UTC

README

Twig Translation Extension using YAML files

//TranslationTwigExtension is in include folder
$twig->addExtension(new TranslationTwigExtension($lang, __DIR__.'/locale'));

First argument is $lang and the second is the translation yaml files folder

/locale/es.yaml is the translation file

For instance in es.yaml

Hello: Hola
<a href="#">English</a>: <a href="#">Spanish</a>
Your name is @name: Your name is @name

In the twig template use trans function like this:

<h1>{{ "Hello" | trans }}</h1>
{{ "<a href=\"#\">English</a>" | trans | raw }} <!-- for translation of html content -->
<p>{{ "Your name is @name" | trans({"@name" : "víctor"}) }}</p>	<!-- for translation with tokens -->

You can add a language fallback usign the third parameter:

$twig->addExtension(new TranslationTwigExtension($lang, __DIR__.'/locale', $fallbackLanguage));

If there is no translation for the current language it searchs a translation in the fallback language files

You can add debug log file. It add a new entry for each translation failed

$twig->addExtension(new TranslationTwigExtension($lang, __DIR__.'/locale', $fallbackLanguage, $logfile));

Then in the terminal you can list all strings without translation buy typing:

$ cat log_file | sort -u

Alert!!

This project has been archived because is old and has vulnerabilities