repli2dev / gettexttranslator
Translator for Nette (PHP framework).
v1.2.2
2016-12-09 14:55 UTC
Requires
- php: >=5.3.0
- nette/nette: >=2.1.0
This package is not auto-updated.
Last update: 2024-11-04 16:18:34 UTC
README
Gettext Translator is tool that enables simple and user friendly translation of your texts via panel in debug bar. No need to edit or operate with .po/.mo files.
Tested with nette 2.1>, please report any bugs into Issues
Installation and usage
Installation via composer:
{ "require":{ "salamek/gettexttranslator" } }
Usage
Set up config.neon:
common: gettextTranslator: lang: cs #default language files: front: %appDir%/lang # for module Front and other non-specified modules admin: %appDir%/lang-admin # for module Admin # optional with defaults layout: horizontal # or: vertical height: 450 extensions: gettextTranslator: GettextTranslator\DI\Extension
Set up in BasePresenter.php
class BasePresenter extends Nette\Application\UI\Presenter { /** @persistent */ public $lang; /** @var \GettextTranslator\Gettext */ protected $translator; /** * @param \GettextTranslator\Gettext */ public function injectTranslator(GettextTranslator\Gettext $translator) { $this->translator = $translator; } public function createTemplate($class = NULL) { $template = parent::createTemplate($class); // if not set, the default language will be used if (!isset($this->lang)) { $this->lang = $this->translator->getLang(); } else { $this->translator->setLang($this->lang); } $template->setTranslator($this->translator); return $template; } }
Change language eg. in @template.latte
Choose language: <a n:href="this, lang => en">English</a> <a n:href="this, lang => cs">Česky</a>
How to translate a string
In template
{_"Login"} {_"piece", $number} 1 piece <!-- $number = 1; --> 2 pieces <!-- $number = 2; --> 5 pieces <!-- $number = 5; -->
In forms
protected function createComponentMyForm() { $form = new Form; $form->setTranslator($this->translator); // ... return $form; }
In components
public function createTemplate($class = NULL) { $template = parent::createTemplate($class); $template->setTranslator($this->parent->translator); // $translator in presenter has to be public // or $this->translator via construct/inject return $template; }
In flash message
<div n:foreach="$flashes AS $flash" class="alert {$flash->type} fade in"> <button type="button" class="close" data-dismiss="alert" aria-hidden="true">×</button> {!_$flash->message} </div>
Authors
Actively developing
- Adam Schubert
Previously developed by
- Josef Kufner (jk@frozen-doe.net)
- Miroslav Paulík (https://github.com/castamir)
- Roman Sklenář (http://romansklenar.cz)
- Miroslav Smetana
- Jan Smitka
- Patrik Votoček (patrik@votocek.cz)
- Tomáš Votruba (tomas.vot@gmail.com)
- Václav Vrbka (gmvasek@php-info.cz)
Under New BSD License