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

Совместимость WPBakery Page Builder с WPML обеспечивается с помощью файла языковой конфигурации. Узнайте, как использовать этот файл для поддержания совместимости.

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

Если Вы клиент, которому нужно перевести сайт, созданный с помощью WPBakery, ознакомьтесь с нашей подробной документацией, чтобы узнать больше о создании многоязычных сайтов с помощью WPBakery Page Builder и WPML.

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

Чтобы понять, как WPBakery Page Builder работает с WPML, мы начнем с создания простой страницы с помощью WPBakery Page Builder. Мы добавим несколько модулей, таких как Text Block, Message Box и Hover Box.

Чтобы перевести созданную страницу, нажмите на значок плюса в метабоксе Язык на правой боковой панели.

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

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

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

1. Добавление нового шорткода в конструктор страниц
2. Добавление нового атрибута к существующему шорткоду
3. Удаление устаревшего шорткода

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

Авторам, которые включают кастомную версию WPBakery Page Builder в свою тему оформления, следует учесть, что им потребуется обновить файл языковой конфигурации для кастомной версии плагина.

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

Чтобы извлекать строки со страниц, созданных с помощью WPBakery Page Builder, и загружать их на экран Редактора переводов, нам нужно настроить WPML для распознавания шорткодов и атрибутов, содержащих строки, требующие перевода. Это делается путем добавления файла с названием wpml-config.xml, который обычно размещается в корневой папке Вашей темы оформления. Для WPBakery Page Builder мы размещаем файл языковой конфигурации на наших серверах. Он настроен на переопределение локального файла конфигурации, расположенного в корневой папке WPBakery Page Builder, что гарантирует актуальность файла конфигурации в любое время.

Файл wpml-config.xml также используется для настройки следующих элементов:

1. Произвольные поля
2. Произвольные таксономии
3. Тексты администратора / wp_options
4. Конфигурация переключателя языков
5. Шорткоды конструктора страниц

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

В качестве примера давайте посмотрим, как мы добавили шорткод Tabs в файл wpml-config.xml.

<shortcode>
         <tag>vc_tta_tabs</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
         </attributes>
</shortcode>

Структуру приведенного выше примера можно разобрать следующим образом:

• Все шорткоды обернуты в главный тег shortcodes (во множественном числе).
• Тег shortcode оборачивает все теги, относящиеся к одному шорткоду.
• Тег tag определяет имя шорткода, которым в данном случае является vc_tta_tabs.
• Шорткоды могут иметь один или несколько атрибутов; поэтому мы оборачиваем их в тег attributes (во множественном числе) и используем тег attribute (в единственном числе) для определения названия каждого атрибута. В данном случае у нас есть атрибут title.

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

<shortcode>
         <tag>vc_button</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
            <attribute encoding="vc_link" type="link">href</attribute>
         </attributes>
</shortcode>

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

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

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

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

4. Нажмите на значок плюса, чтобы перевести страницу. Вы перейдете на экран Расширенного редактора переводов.
5. Убедитесь, что текстовые элементы модуля отображаются в Расширенном редакторе переводов.
6. Введите Ваши переводы и подтвердите их зеленой галочкой. Когда закончите, нажмите кнопку Завершено.

7. Проверьте переведенную страницу на фронтенде.

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

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

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

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

Обратите внимание, что файл языковой конфигурации, размещенный в нашем репозитории, предназначен для версии WPBakery Page Builder по умолчанию. В случае, если Вы обновляете файл языковой конфигурации кастомной версии WPBakery Page Builder, примените изменения к файлу конфигурации внутри корневой папки Вашего плагина.