В статьях как написать плагин для WordPress ( часть 1 ) и Как создать плагин для WordPress ( часть 2 ), я детально рассказывал о создании своего плагина.Но, логично если мы его создали, то вероятно нам захочется представить его не только русскоязычному населению, но и тем, кто живет за пределами 1/6 части суши.
Рассказывать о том, как сделать перевод своих сообщений, надписей, кнопок и т.д., я буду в контексте предыдущих статей. Поэтому, чтобы было понятней, рекомендую с ними ознакомится. Но и без ознакомления все будет предельно ясно.
«Ну-с, продолжим», — как сказала мать сорока детей.
В плагине описанном в статье Как создать плагин ( часть 2 ), мы выводим сообщение посетителю, который незалогинился у нас на сайте ( страница запрещена к просмотру обычным посетителям ).
В коде есть такие строки
"<p>".__('Для просмотра этой страницы залогиньтесь!', 'my_restrict')."</p>
Что это означает?
Строка внутри функции __() будет переведена на язык сайта, который стоит в пункте админ-меню «Настройки» опция «Site Language«.
Через запятую стоит название текстового домена, по которому будет найден перевод. Название произвольное, лишь бы совпадало с названием загружаемого функцией
add_action( 'plugins_loaded', 'true_load_plugin_textdomain' );
function true_load_plugin_textdomain() {
load_plugin_textdomain( 'my_restrict', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
}
это значит, что файлы с названием нашего текстового домена будут загружены из папки нашего плагина из подкаталога languages, который нужно создать заранее.
Теперь самое основное — нужно как-то реализовать перевод. Сам Вордпресс за вас этого не сделает. А кто?
Программа Poedit (скачать)!
После установки программы — запустим ее!
Выбрав в меню «File->New»
Нам предлагается выбрать язык НА КОТОРЫЙ! будем переводить.
В моем случае это English(United States) — информация взята из админ-меню, пункт «Настройки».
ОЧЕНЬ ВАЖНО! То значение которое в скобках.
Перейдем в пункт меню «Catalog->Properties».
Далее напишем имя нашего проекта, выберем кодировку UTF-8.
Нажмем «Save».
Программа по умолчанию поставит имя en.po, вот здесь важно сохранить файл с именем в формате {наш текстовый домен}-{en_EN}.po.
В нашем случае имя будет my_restrict-en_US.po. Помните, что я говорил выше насчет «ОЧЕНЬ ВАЖНО! То значение которое в скобках«.
Если имя будет my_restrict-en_EN.po, то нихрена у вас не заработает!
Перейдем к следующей закладке. Source paths
Там где первый зеленый плюс, выберем файл, в котором у нас прописаны текстовые константы в таком формате
"<p>".__('Для просмотра этой страницы залогинтесь!', 'my_restrict')."</p>в данном случае это наш plugin.php.
Далее посетим закладку Source keywords.
Выберем new item
Добавим __().
Т.е. чтобы просканировалось все что в качестве аргументов этой функции.
И нажмем ОК.
Нажмем кнопку Update.
Появилось окно с нашими просканированными строками.
Внизу для каждой строки напишем ее перевод в пункте Translation.
И снова нажмем Save.
Автоматически в папке с нашим языковым и понятным файлом my_restrict-en_US.po, который понимаем мы, если открыть его в текстовом редакторе, сгенерировался файл my_restrict-en_US.mo, который понимает WordPress.
И теперь у нас вместо русской строки «Для просмотра этой страницы залогинтесь!«, появилась английская версия «Please LogIn!«, которую мы написали в пункте Translation, напротив нашей строки. Ведь в моей версии WordPress на английском. У вас может быть на русском или украинском или на любом другом.
Таким образом можно делать перевод кнопок, сообщений вашего плагина на любой язык, создавая новые файлы формата {наш текстовый домен}-{язык_ЯЗЫК}.po.
Спасибо за внимание!