Что умеет
Расширение решает узкую задачу: показать в Polylang строки интерфейса темы и плагинов, чтобы переводить их в том же месте, где переводится остальное. Обычно такие строки берутся из языковых файлов .po и .mo, а в Polylang в разделе перевода строк видны только те, что зарегистрированы им самим.
Плагин просматривает файлы выбранных тем и плагинов с расширениями php, inc и twig и вытаскивает из них тексты, обёрнутые в функции:
- стандартные функции WordPress:
__(),_e(),_x(),_n(),esc_html__(),esc_attr__()и подобные; - функции Polylang
pll__()иpll_e().
Найденные строки появляются в разделе «Языки, Перевод строк». Дополнительно есть поддержка шаблонов twig при использовании Timber.
Установка и настройка
Сначала должен быть установлен и активирован Polylang. Затем установите плагин, откройте Языки, TTfP Settings и отметьте темы и плагины, из которых нужно собрать строки. После этого найдите их в разделе перевода строк и заполните переводы для каждого языка.
В собственном коде можно использовать pll_e('Текст') или стандартные функции с доменом темы: __('Текст', 'my_theme'). Для Timber функции нужно добавить в контекст.
Подводные камни
Плагин сканирует файлы, а не работает с контентом, поэтому в списке окажутся только строки, которые находятся в проверенных файлах. Чем больше тем и плагинов выбрано, тем длиннее список и тем сложнее в нём ориентироваться: отмечайте только нужное.
Переводы хранятся в базе Polylang. При смене темы строки с другим доменом придётся переводить заново, а при переносе сайта их нужно переносить вместе с базой данных.
Для переводов самой темы или плагина, у которых есть готовые языковые файлы, проще и надёжнее подключить их, например через Loco Translate. Это снимает с вас часть работы и сохраняет перевод в файлах.
Перед запуском на рабочем сайте проверьте плагин на копии: убедитесь, что тексты в шаблонах выводятся на нужных языках и ничего не пропало.
Кому подойдёт
Разработчикам и владельцам сайтов на Polylang, у которых тема написана самостоятельно или не имеет нужных переводов, и строки нужно вести в одном месте. Для работы с файлами перевода посмотрите Loco Translate, а как основную многоязычность — Polylang и TranslatePress.
