Если вы разработчик плагинов WordPress и хотите расширить аудиторию своего плагина по всему миру, подготовка его к переводу является важнейшим шагом. Плагины, готовые к переводу, позволяют пользователям легко переводить их на свой родной язык, делая их доступными для более широкой аудитории. В этой статье мы рассмотрим как сделать ваш плагин WordPress готовым к переводу и выйти на глобальную аудиторию.
4 простых шага для создания плагина, готового к переводу
- Используйте функции интернационализации
- Используйте Text Domain
- Создайте файлы перевода
- Добавьте файлы перевода в ваш плагин
Используйте функции интернационализации:
Эти функции позволяют обернуть текстовые строки вашего плагина в функции перевода, делая их готовыми к локализации. Наиболее часто используемые функции интернационализации в WordPress:
- __() и _e(): Эти функции используются для перевода строк в PHP-коде. Функция __() возвращает переведённую строку, а функция _e() сразу выводит переведённую строку.
- _x(): Эта функция используется для перевода строк с учётом контекста. Она принимает дополнительный аргумент контекста, что особенно полезно в случаях, когда одна и та же строка должна переводиться по-разному в зависимости от контекста.
- esc_html__(), esc_html_e(), esc_attr__() и esc_attr_e(): Эти функции используются соответственно для перевода и экранирования HTML-атрибутов и HTML-текстовых строк. Они обеспечивают корректное экранирование переведённых строк, чтобы предотвратить возможные уязвимости безопасности.
Используйте Text Domain:
Text Domain — это уникальный идентификатор переводов вашего плагина. Он помогает WordPress определить, какие переводы необходимо загрузить для вашего плагина. Чтобы задать Text Domain для вашего плагина, необходимо использовать функцию load_plugin_textdomain() в основном файле плагина. Вот пример:
function my_plugin_load_textdomain()
{
load_plugin_textdomain( ‘my-plugin’, false, dirname( plugin_basename( __FILE__ ) ) . ‘/languages/’ );
}
add_action( ‘plugins_loaded’, ‘my_plugin_load_textdomain’ );Создайте файлы перевода:
Файлы перевода содержат переведённые строки вашего плагина. Обычно они хранятся в отдельной папке внутри директории плагина, которая обычно называется «languages». WordPress использует специальное соглашение об именовании файлов перевода, основанное на Text Domain и целевом языке. Например, если Text Domain вашего плагина — «my-plugin» и вы хотите перевести его на испанский язык, файл перевода должен называться «my-plugin-es_ES.mo» (для Испании) или «my-plugin-es_MX.mo» (для Мексики).
Файлы перевода компилируются из исходных файлов с расширением «.po», что означает Portable Object. Вы можете создавать файлы «.po» с помощью редактора переводов, например Poedit, который позволяет задавать исходные строки и их переводы. После создания файлов «.po» необходимо скомпилировать их в файлы «.mo» (Machine Object) с помощью такого плагина, как Automatic Translate Addon For Loco Translate.
Добавьте файлы перевода в ваш плагин:
После создания файлов перевода необходимо включить их в ваш плагин, чтобы WordPress мог загружать их при необходимости. Для этого поместите файлы ‘.mo’ в папку ‘languages’ вашего плагина и используйте функцию load_plugin_textdomain(), чтобы указать путь к этой папке. Вот пример:
function my_plugin_load_textdomain()
{
load_plugin_textdomain( ‘my-plugin’, false, dirname( plugin_basename( __FILEЗаключение
В заключение, подготовка плагина WordPress к переводу — это важный шаг, который позволяет легко переводить ваш плагин на разные языки и делать его доступным для мировой аудитории. Следуя шагам, описанным в этой статье, включая использование функций интернационализации, определение Text Domain, создание файлов перевода и их добавление в плагин, вы сможете подготовить свой плагин к переводу и повысить его удобство для пользователей по всему миру.
Предоставление переводов для вашего плагина позволяет охватить более широкую аудиторию и сделать его более удобным для пользователей, не говорящих на английском языке. Это демонстрирует ваше стремление к инклюзивности и доступности, что может способствовать успеху и популярности вашего плагина. Поэтому, если вы разрабатываете плагин WordPress, обязательно уделите время тому, чтобы сделать его готовым к переводу и открыть его для пользователей по всему миру.
