На моем языке, пожалуйста! — Перевод тем WordPress и плагинов

Сайты на WordPress посещают миллионы людей по всему миру. Для многих из них английский не является родным языком, что затрудняет использование этих сайтов. К счастью, эту проблему легко решить, предложив пользователям перевод.

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

Цель этой статьи — показать вам, как правильно перевести любую тему или плагин, используя методы интернационализации и локализации. Вкратце, интернационализация (i18n) имеет дело с тем, чтобы строки текста были обернуты в вызовы определенных функций. Это практика подготовки текста к локализации, в то время как сама локализация (L10n) — это процесс перевода текста для определенной локали. WordPress управляет процессом локализации, проверяя конкретные файлы перевода и затем выполняя перевод. Это, конечно, звучит легко, поэтому давайте проверим это.

Начиная

Первое, что вам нужно сделать, это решить, где хранить переводы. Многие темы и плагины помещают файлы перевода в свой корневой каталог. Хотя переводы будут работать при использовании этого метода, он может немного запутаться, особенно если у вас есть файлы переводов для более чем одного языка. Для наиболее организованной системы лучше создать подкаталог в папке тем или плагинов под названием languages. Когда вы выпускаете тему или плагин, вы можете хранить файлы перевода по умолчанию в этом каталоге, а когда переводчики отправляют вам файлы перевода, вы просто отбрасываете эти файлы в этот каталог.

Процесс перевода состоит из трех этапов. Первым шагом в переводе вашей темы или плагина является использование специальной функции, которая сообщает WordPress загрузить файл перевода, если он существует для языка пользователя. Для перевода темы вы можете поместить этот вызов функции в файл functions.php вашей темы:

<?php
$domain = "myplugin";
$path = "myplugin/languages/";
load_theme_textdomain($domain, $path);

$domain В организационных целях вы должны присвоить это значение тому же значению, что и имя каталога вашей темы. $path

Вот еще один пример, этот пример взят из файла functions.php

 <?php
load_theme_textdomain( 'twentyeleven', TEMPLATEPATH.'/languages' );
  
$locale = get_locale();
$locale_file = TEMPLATEPATH."/languages/$locale.php";
if ( is_readable( $locale_file ) )
require_once( $locale_file );

Здесь «twentyeleven» — это домен, который соответствует имени каталога темы. Вы можете использовать все, что хотите, но это считается наилучшей практикой. Во втором параметре константа TEMPLATEPATH Оставшийся код говорит WordPress, чтобы получить файл перевода из папки языков.

В случае плагина используемая функция похожа, но принимает три параметра:

 <?php
load_plugin_textdomain($domain, $abs_rel_path, $plugin_rel_path);

$abs_rel_path $plugin_rel_path Вы должны поместить это в свой файл плагина, а не functions.php

 <?php
add_action("init", "pluginname_init");

function pluginname_init() {
   load_plugin_textdomain("myplugin", false, "myplugin/languages/");
}

Использование функций локализации

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

Первая функция готовит ваш текст к переводу и возвращает его для использования в PHP. Вот два примера:

 <?php
$text = "Hello World!";
$domain = "myplugin";
__($text, $domain); // begins with double underscore

 <?php
edit_post_link(__("Edit", "twentyeleven"), '<span class="edit-link">', "</span>");

Функция __()$text Он используется для управления отображением текста, уже содержащегося в тегах PHP. Если файлов локализации, кроме английского, не существует, текст останется прежним. Значение переменной $domain

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

 <?php
_e($text, $domain);

 <?php
printf(__("About %s", "twentyeleven"), get_the_author());

 <?php
$site_name = get_bloginfo("name");
$comments_count = wp_count_comments();
$mod_comments = $comments_count->moderated
$appr_comments = $comments_count->approved
$all_comments = $comments_count->total_comments

printf(__('There are %3$s comments on %4$s. %2$s approved and %1$s in moderation.', $domain), $mod_comments, $appr_comments, $all_comments, $site_name);

 <?php
define('WPLANG', ''); // this is default for a fresh WordPress installation
define('WPLANG', 'es_ES') // set the second parameter to your locale