# Как подготовить ваш плагин WordPress к переводу?

Если вы **разработчик плагинов 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](https://wordpress.org/plugins/automatic-translator-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, обязательно уделите время тому, чтобы сделать его готовым к переводу и открыть его для пользователей по всему миру.