WPML может считывать конфигурационный файл, который указывает, что именно нужно переводить в темах оформления и плагинах. Файл называется wpml-config.xml и помещается в корневую папку плагина или темы оформления.
Назначение языкового конфигурационного файла
В рамках достижения совместимости с WPML Вам также следует создать конфигурационный файл, который поможет поддерживать совместимость в будущих релизах. WPML может перевести что угодно на Вашем сайте WordPress, но ему нужно указать, что именно требует перевода. Эту задачу и выполняет данный файл.
Перейдите на страницу WPML→ Настройки.
Эта страница сообщает WPML все, что ему нужно знать, включая то, какие произвольные поля следует переводить или синхронизировать, какие произвольные типы записей и таксономии должны быть многоязычными, и даже какие тексты администратора нужно переводить.
Языковой конфигурационный файл содержит эту информацию, чтобы каждому пользователю не приходилось вводить ее вручную на странице админ-панели.
Для некоторых тем оформления и плагинов мы размещаем языковые конфигурационные файлы на наших серверах. Их список можно посмотреть здесь. Они настроены на переопределение локального языкового конфигурационного файла, который находится в корневой папке темы оформления или плагина.
WPML также позволяет Вам вручную переопределять любые настройки, загруженные языковыми конфигурационными файлами тем оформления и плагинов. Это относится как к языковым конфигурационным файлам в корневой папке темы оформления или плагина, так и к файлам, размещенным на наших серверах.
Настройка параметров перевода для сторонних тем оформления и плагинов
WPML совместим со многими популярными темами оформления и плагинами, и для них Вам не нужно создавать языковой конфигурационный файл.
Однако, если Вы используете тему оформления или плагин, контент которых некорректно отображается в Расширенном редакторе переводов WPML, Вам может потребоваться настроить параметры их перевода вручную.
Чтобы настроить параметры перевода для сторонних тем оформления и плагинов, перейдите в WPML → Настройки и откройте вкладку Пользовательская конфигурация XML. Используйте текстовый редактор на этой странице для ввода кода точно так же, как если бы Вы создавали файл wpml-config.xml.
Автоматическое создание файла wpml-config.xml
Если Вы не знакомы с созданием XML-файлов, наша команда разработала плагин Multilingual Tools, который упрощает эту задачу. Хотя изначально он задумывался как инструмент, помогающий разработчикам тем оформления и плагинов делать свои продукты готовыми к многоязычности (Multilingual Ready), его можно легко использовать для создания Вашего собственного файла wpml-config.xml.
Чтобы узнать больше о создании файла wpml-config.xml, посетите страницу плагина Multilingual Tools. В частности, обратите внимание на раздел Как создать языковые конфигурационные файлы с помощью Multilingual Tools?.
Как только у Вас будет конфигурационный файл, добавьте его в корень папки Вашей темы оформления. Если он у Вас уже есть, не перезаписывайте его. Вместо этого отредактируйте исходный XML-файл и добавьте код, сгенерированный с помощью плагина Multilingual Tools.
Обратите внимание, что этот плагин не предназначен для использования на действующих рабочих сайтах.
Чтобы изучить это руководство и создать языковые конфигурационные файлы для Ваших тем оформления и плагинов, Вы можете начать с этого примера — wpml-config.zip.
Вам потребуется отредактировать его, но Вы можете использовать разделы и структуру этого файла.
Структура и синтаксис
WPML позволяет настраивать ряд элементов с помощью файла wpml-config.xml. Используйте следующие руководства, чтобы найти дополнительную информацию и инструкции о том, как сделать определенные элементы сайта переводимыми:
- Перевод произвольных шорткодов с помощью WPML
- Регистрация контента конструктора страниц для перевода
- Регистрация произвольных виджетов конструктора страниц для перевода
- Настройка параметров перевода для произвольных полей с помощью конфигурационного файла WPML
- Регистрация произвольных терминов, типов и таксономий как переводимых
- Как сделать произвольные блоки Gutenberg переводимыми
- Перевод текстов, которые тема оформления и плагины сохраняют в wp_options
- Настройка переключателя языков WPML с помощью конфигурационного файла WPML
- Включение числовых значений для перевода
Использование языкового конфигурационного файла WPML с дочерними темами оформления
Если Вы используете дочернюю тему оформления, языковой конфигурационный файл родительской темы переопределяет файл, находящийся в дочерней. WPML предоставляет страницу конфигурации, которая позволяет Вам легко переопределить это любыми пользовательскими настройками.
Рассмотрим пример, в котором языковой конфигурационный файл родительской темы оформления задает произвольный тип записи «Property» как переводимый.
Если Вы используете дочернюю тему оформления и хотите сделать произвольный тип записи «Property» непереводимым, перейдите на страницу WPML → Настройки и откройте вкладку Пользовательская конфигурация XML. Используйте редактор, чтобы задать произвольный тип записи «Property» как непереводимый. Просто установите значение атрибута translate равным 0 вместо 1.
Настройки на вкладке Пользовательская конфигурация XML имеют приоритет над настройками в языковом конфигурационном файле родительской темы оформления.
