Как добавить локализацию в плагин WordPress

Если вы разрабатываете плагин для WordPress и хотите, чтобы его могли использовать люди из разных стран на их родных языках, очень важно добавить поддержку локализации. Это позволит вашему плагину автоматически показывать интерфейс и сообщения на языке пользователя. В этой статье подробно разберём, как добавить локализацию в собственный плагин WordPress, какие функции и файлы для этого нужны, а также познакомимся с полезными плагинами и инструментами.

Зачем нужна локализация плагина WordPress

Локализация — это процесс адаптации интерфейса программы под различные языки и регионы. Без неё ваш плагин будет доступен только на одном языке (обычно русском или английском), что ограничит аудиторию. Добавляя локализацию, вы расширяете охват и повышаете удобство использования. Более того, WordPress имеет встроенную систему i18n (интернационализации), которая облегчает этот процесс.

Кроме того, локализация помогает повысить доверие пользователей и часто является требованием для попадания плагина в официальное репозитории WordPress.

Как подготовить плагин к локализации: основные шаги

Для начала создайте в корне вашего плагина папку languages. В ней будут храниться файлы переводов — .pot, .po и .mo.

Далее, в основном файле плагина необходимо подключить текстовый домен локализации. Это делается функцией load_plugin_textdomain. Используйте префикс вашего плагина, например, wparticles, чтобы избежать конфликтов.

function wparticles_load_textdomain() {
    load_plugin_textdomain( 'wparticles', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' );
}
add_action( 'plugins_loaded', 'wparticles_load_textdomain' );

Теперь в вашем плагине нужно заменить статичные строки в коде на функции интернационализации WordPress:

• __() — возвращает переведённую строку;
• _e() — выводит переведённую строку сразу;
• _n() — для правильного склонения слов в зависимости от числа.

Пример:

echo __( 'Привет, мир!', 'wparticles' );
_e( 'Настройки плагина', 'wparticles' );

Создание файлов перевода: .pot, .po и .mo

Файл .pot — шаблон перевода, который содержит все строки для локализации. Его можно создать с помощью плагинов или инструментов.

Для генерации .pot используйте, например, Loco Translate. Этот плагин позволяет прямо из админки WordPress собирать строки и создавать файлы переводов.

После создания .pot создайте файлы .po (текстовые файлы с переводами для конкретного языка) и .mo (бинарные файлы, которые WordPress загружает для отображения перевода).

Пример создания файла перевода вручную

Если вы предпочитаете работать локально, скачайте и установите программу Poedit. Она умеет импортировать .pot и создавать .po, .mo файлы.

Затем скопируйте файлы в папку languages вашего плагина, например:

• wparticles-ru_RU.po
• wparticles-ru_RU.mo

Пример использования локализации в плагине WParticles

Допустим, у вас есть уведомление при активации плагина:

function wparticles_activation_message() {
    echo '<div class="notice notice-success is-dismissible">' .
         __( 'Плагин WParticles успешно активирован!', 'wparticles' ) .
         '</div>';
}
add_action( 'admin_notices', 'wparticles_activation_message' );

После добавления локализации, эту строку можно будет перевести через файлы .po на любой язык, и пользователь увидит сообщение на своём языке.

Полезные плагины для локализации и перевода WordPress

Кроме Loco Translate, существуют и другие инструменты, которые помогают с локализацией:

• WPML — мощный плагин для создания многоязычных сайтов с поддержкой перевода плагинов и тем.
• Polylang — бесплатный и простой инструмент для перевода контента и элементов интерфейса.
• Say What? — позволяет переопределять отдельные строки перевода без правки файлов.

Используйте их, если хотите расширить поддержку разных языков в вашем проекте.

Как отлаживать и проверять переводы в WordPress

Для проверки корректности локализации переключите язык сайта в админке WordPress (Настройки → Общие → Язык сайта). Если переводы не отображаются, убедитесь, что:

• Файл .mo находится в папке languages плагина.
• Текстовый домен и функции перевода используются правильно.
• Функция load_plugin_textdomain вызывается на хуке plugins_loaded.

Для отладки можно использовать плагин WPRemark, который помогает анализировать качество контента и может помочь в проверке текстов.

Советы по организации кода для локализации

Всегда придерживайтесь единого текстового домена — это идентификатор вашего плагина, например, wparticles. Никогда не используйте разные домены в одном плагине — это усложняет перевод.

Не забывайте обрабатывать все строки, которые видит пользователь — даже валидационные сообщения, подсказки и кнопки.

Для динамических строк используйте функции _n() и _x() с контекстом, чтобы избежать неправильного перевода.

Итог

Добавление локализации — обязательный этап для любого профессионального плагина WordPress. Следуя описанным шагам, вы сможете сделать свой плагин доступным для пользователей из разных стран. Используйте встроенные функции, создавайте файлы переводов через Loco Translate или Poedit, и тестируйте вывод на разных языках.

Больше полезных плагинов для разработки и оптимизации WordPress смотрите на WPShop.ru.