Переводим плагины и темы в WordPress

В этом посту я покажу вам простой и полностью рабочий способ создания перевода для своей WordPress-темы или плагина. Также вы сможете переводить темы и плагины других разработчиков.

Исходный код мы переводить не будем! Вообще, это непрофессионально и так делают те, кто только начинает осваивать WordPress.

Если же вам сразу хочется приступить к практике, то могу порекомендовать вам два видеоурока, один – про локализацию темы WordPress, другой – про локализацию плагина.

Пошаговое руководство по переводу

Перед тем, как создавать перевод, убедитесь, что всё, что нужно переводить в вашем плагине или в теме заключено в специальные функции перевода, вот эти функции:

Кроме того, часть этих функций даже есть уже со встроенной очисткой данных:

Итак, допустим в коде у нас есть текст «Hello World!» и нам нужно перевести его в «Привет, мир!», тогда:

Второй аргумент функции, «truemisha» — это название перевода, может быть произвольным (главное, чтобы он совпадал с аналогичным параметром при подключении файлов перевода), также обычно совпадает с названием директории темы или плагина. Этот параметр не обязателен, если его не указывать, то для перевода будут задействованы стандартные языковые файлы, те, которые используются для перевода самого движка, админки. Понятное дело, что в стандартных языковых файлах может и не быть перевода тех строк, которые будут в нашей теме или в плагине.

Такой же пример, но с использованием функции _e():

Итак, если нам надо вывести переведенную строку, мы используем функцию _e(), а если нужно записать строку в переменную или задействовать в качестве аргумента какой-либо функции, то используем __().

Кроме того, если выводимый код нуждается в очистке, то наша строчка кода снова видоизменяется:

Итак, подготавливаем свою тему или плагин к переводу и переходим к следующему шагу.

Нам понадобится программа Poedit, бесплатная версия вполне подойдет.

Открываем программу и переходим в Файл > Создать (File > New), после чего нам будет предложено выбрать язык перевода.

Переходим в Каталог > Свойства (Transations > Properties), и у нас откроется три вкладки с настройками. Сначала заполняем первую вкладку. Каких-либо особых требований к ее заполнению нет, главное, чтобы кодировка была UTF-8. Вот как получилось у меня:

Далее – вкладка «Ключевые слова исходных файлов». Указываем тут все используемые при интернационализации функции. Затем нажимаем ОК.

Вот чуть более подробный их список:

Думаю сейчас не помешает совсем немного объяснений.

• Функция __() принимает только один параметр для перевода, вторым является идентификатор перевода. Все функции перевода, которые имеют только два таких параметра, указываются в Poedit лишь в виде названия.
• Функция множественного числа _n() имеет на конце :1,2 , что означает, что первый и второй параметр функции должны быть переведены. имеет на конце :1,2c , что означает, что первый параметр функции должен быть переведён, а второй параметр является контекстом перевода.
• Функция _nx() является комбинацией функций _n() и _x() у неё на конце аж :4c,1,2 , что значит, что четвёртный параметр функции является контектом, а первый и второй должны быть переведены.

Далее – вкладка «Папка с исходными файлами». Новая версия Poedit вообще не позволяет делать в ней никаких изменений пока мы не сохраним файл. Ну окей.

1. Закрываем эти настройки нажатием кнопки ОК.
2. Переходим в Файл > Сохранить.
3. Переходим в папку с нашей темой или плагином.
4. В ней создаём папку languages .
5. Сохраняем в неё, но главное указать правильное название файла! Для плагинов это - , например для русского перевода: truemisha-ru_RU.po и truemisha-ru_RU.mo . Для тем же просто ru_RU.po и ru_RU.mo

Окей, про я уже писал ранее в этом посту, но откуда брать ? Всё просто — откройте файл wp-config.php и посмотрите значение константы WPLANG

Наконец-то теперь мы можем настроить последнюю оставшуюся вкладку. Указываем там либо точку, либо нажимаем кнопку плюсика и выбираем папку со своей темой или плагином.

Почти готово – сохраняем. Затем нажимаем кнопку «Обновить» либо Каталог > Обновить из исходного кода. Та-дам, в окне программы должны появиться все строки, доступные для перевода.

Если мы переводим тему, открываем её файл functions.php и добавляем туда следующий код:

Первый аргумент функции load_theme_textdomain() — это название перевода, оно же используется в функциях __() и _e(), второй аргумент — путь к директории с языковыми файлами. Функция get_template_directory() используется для получения пути к директории текущей темы.

Если мы переводим плагин, то открываем главный исполняемый файл плагина и вставляем туда:

Как видите, для плагинов мы используем другую функцию — load_plugin_textdomain(). Её единственное отличие — это второй аргумент, который не используется в новых версиях WordPress и всегда должен быть равен false . А для получения пути к директории плагина, воспользуемся plugin_basename().

Хотите разобраться с локализацией на реальных примерах? Тогда вот вам два видеоурока, один – про локализацию темы WordPress, другой – про локализацию плагина.

Как настроить множественное число для русского языка

Допустим, мы выводим количество товаров в своей теме интернет-магазина. Как сделать так, чтобы в зависимости от количества товаров, выводилась соответствующая форма слова, например: 1 товар, 2 товара, 5 товаров?

На самом деле в свежих версиях Poedit уже практически всё сделано за нас. Во вкладке свойств перевода при выборе языка уже будет вставлено соответствующее выражение для обработки форм множественного числа.

Хотя у нас есть возможность его изменить.

По умолчанию для русского языка это:

Это выражение позволяет использовать три формы множественного числа (именно столько используется в русском языке.

Вот выражение для двух форм (английский язык например) :

Для четырех форм (словенский язык) :

Теперь в этом же окошке переходим во вкладку «Ключевые слова исходных файлов» и дописываем туда функцию _n() следующим образом: _n:1,2 . Вот что получится:

Возможно вы ещё захотите использовать функцию _nx().

Непосредственно в файлах темы или плагина функция используется в комбинации с PHP-функцяими sprintf() или printf() . Например:

Окей, теперь сохраняем и обновляем файл перевода. Как видите, для задания форм слова у нас сейчас имеется три поля, указываем в них: 1 товар , %s товара и %s товаров соответственно.