Поддержание совместимости Divi Builder с WPML

Узнайте, как поддерживать совместимость модулей Divi с WPML с помощью файла языковой конфигурации wpml-config.xml.

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

Эта страница относится к Divi 5, который хранит контент в виде совместимых с Gutenberg блоков (в Divi 4 использовались шорткоды).

Как работает интеграция Divi Builder с WPML

Чтобы понять, как Divi Builder работает с WPML, давайте начнем с создания простой страницы с помощью Divi Builder. В нашем примере ниже мы добавили несколько модулей, таких как Текст, Счетчик, Иконка и т. д.

Чтобы выполнить перевод, перейдите в WPML → Панель управления переводами и найдите страницу в разделе Страницы. Выберите ее и нажмите Перевести ваш контент, чтобы выбрать метод перевода. Если у Вас есть переводческие кредиты, Вы можете перевести эту страницу автоматически за считанные минуты.

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

В файле wpml-config.xml Вы можете настроить следующие элементы:

• Блоки конструкторов страниц
• Произвольные поля
• Произвольные таксономии
• Тексты администратора / wp_options
• Конфигурация переключателя языков

Для получения дополнительной информации о структуре и синтаксисе см. наше руководство по файлу языковой конфигурации.

Получение файла конфигурации для Divi

Настройка файла wpml-config.xml извлекает строки со страниц, созданных с помощью Divi Builder, и загружает их в Расширенный редактор переводов. Используйте этот файл для добавления новых типов блоков и атрибутов, а также для удаления устаревших типов блоков.

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

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

Настройка блоков в файле языковой конфигурации

Divi 5 использует блочный синтаксис, поэтому регистрация модулей Divi для перевода аналогична процессу перевода блоков Gutenberg:

• Все определения блоков заключены в родительский элемент <gutenberg-blocks>.
• Каждый отдельный блок объявляется с помощью элемента <gutenberg-block>, где атрибут type соответствует зарегистрированному имени блока.
• Переводимые поля объявляются как дочерние элементы <key>.

Рассмотрим пример модуля Divi Call to Action:

<!-- wp:divi/cta {"module":{"title":"CTA","button_text":"Contact Us","button_url":"https://example.com/contact/"}} /-->

Вот как он настраивается в wpml-config.xml:

<gutenberg-blocks>
    <gutenberg-block type="divi/cta" translate="1">
       <key name="module">
         <key name="title" />
         <key name="button_text" />
         <key name="button_url" type="link" />
       </key>
    </gutenberg-block>
</gutenberg-blocks>

Структура выглядит следующим образом:

• Элемент <gutenberg-blocks> оборачивает все определения блоков.
• Элемент <gutenberg-block> определяет один тип блока, идентифицируемый атрибутом type. translate="1" указывает WPML обработать его.
• Каждый элемент <key> определяет одно переводимое поле: title и button_text для обычных текстовых полей, а button_url — для ссылки.
• Атрибут type="link" указывает WPML автоматически заменять URL-адрес переведенной версией связанной записи или страницы.

Тестирование файла языковой конфигурации

Чтобы протестировать обновленный файл языковой конфигурации, выполните следующие действия:

1. Настройте сайт с активированными Divi и WPML. Убедитесь, что также активированы дополнения Перевод строк и Перевод медиафайлов.

2. Чтобы переопределить удаленный файл языковой конфигурации обновленной версией, перейдите в WPML → Настройки и откройте вкладку Пользовательская конфигурация XML. Скопируйте содержимое Вашего обновленного файла языковой конфигурации в редактор, а затем нажмите Сохранить.

3. Создайте новую страницу и добавьте на нее новый модуль (или модули). Если Вы обновили некоторые атрибуты для существующих модулей, также добавьте их на страницу. В этом примере мы предполагаем, что модуль Кнопка был недавно добавлен в Divi Builder. Добавьте его на страницу и нажмите Опубликовать.

4. Для перевода страницы с кнопкой Вы можете использовать Панель управления переводами. В качестве альтернативы можно использовать Расширенный редактор переводов (ATE), что бывает полезно при тестировании — он позволяет увидеть тег модуля для каждого элемента Divi на странице. Чтобы открыть ATE, нажмите Изменить на странице и щелкните значок плюса в блоке Язык на правой боковой панели.

5. Проверьте элементы и добавьте свои переводы или позвольте ATE перевести их автоматически.

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

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

По завершении тестов отправьте запрос на слияние в наш репозиторий. Наши разработчики по вопросам совместимости получат Ваш запрос и рассмотрят его.