Перевод плагинов и шаблонов Osclass. i18n является аббревиатурой internationalization. Вы можете получить дополнительную информацию из Википедии. OSClass использует библиотеки GNU Gettext.
Для того, чтобы переводимые строки выводились в приложении, необходимо обернуть исходную строку:
($text) — ищет версию для перевода $text и возвращает результат, а именно:(«Hello») ; _e($text) — ищет переведенную версию $text и выводит результат на экран
(same as echo __($text))
_e("Hello") ;
Однако, для того, чтобы сделать строку перевода для плагина или шаблона, вы должны добавить дополнительный параметр в функцию:
__($text, $domain) и _e($text, $domain). Переменная $domain будет выводить название плагина или темы. В случае основным шаблоном modern, он будет выглядеть так: __("Hello", "modern") and _e("Hello", "modern").
Если вы хотите добавить переменные в строки, следующий код не будет работать:
__e("Hello $name", "modern") ;
Строка для перевода, взята из источников, так что в переводе увидите: Hello $name. Тем не менее, _e будет вызван с аргументом, как Hello Juan и Gettext не найдет подходящий перевод и будет возвращать аргумент: Hello Juan. Решение заключается в использовании Printf. Вот правильное решение:
printf(__("Hello %s", "modern"), $name) ;
Практические советы
Целые фразы: в большинстве языков порядок слов отличается. Разделитель в строках: не включают в себя целые страницы текста в одной строке. Используйте sprintf и printf:
sprintf(__('Replace %s with %s', 'modern'), $a, $b) ;
или
__('Replace ') . $a . __(' with ') . $b ;
Создание файлов .PO
Это файл, который отвечает за перевод строк. Путей создания POT файла множество, мы используем для редактирования и создания программу POedit. Эта статья объясняет, как создать .PO файл. После окончания перевода, вы должны поместить в нужное место файл .mo:
Темы: {theme folder}/languages/{locale}/theme.mo Плагины: {plugin folder}/languages/{locale}/messages.mo
{locale} используется ISO код языков, а именно: ru_RU, en_US, es_ES, de_DE, fr_FR, es_AR и т.д.
Напоследок, если вы хотите заменить флэш-сообщения, вы должны скопировать файл изменить перевод при помощи POedit в файле .ро (он генерирует файл .mo).