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

Как получить плагин WPML?

Во-первых, для этого требуется учетная запись на WPML.org. Если у вас ее еще нет, и вы разрабатываете темы или плагины, обратитесь в нашу программу Go Global и получите бесплатную учетную запись и помощь.

У вас уже есть учетная запись? Тогда установите плагины WPML, Translation Management и String Translation.

Страница загрузок WPML

Страница загрузок WPML

* Поддержка перевода построителей страниц – нововведение в WPML версии 3.6.0. Если вы пользуетесь старой версией WPML, сначала обновите плагин.

Как это работает?

Давайте создадим пример страницы с помощью построителя страниц. В этом примере мы используем Visual Composer. Вы можете использовать свой собственный построитель страниц на основе коротких кодов.

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

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

Пример страницы во внешнем интерфейсе, созданной при помощи построителя страниц

Пример страницы во внешнем интерфейсе, созданной при помощи построителя страниц

Если посмотреть на исходный код страницы (в режиме HTML), можно увидеть короткие коды, составляющие структуру страницы и тексты.

Пример HTML-кода страницы

Пример HTML-кода страницы

Наша цель состоит в том, чтобы настроить WPML для поиска этих текстов в исходном коде страницы.

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

К счастью, WPML может извлекать тексты на перевод из страниц, созданных при помощи построителей страниц (использующих короткие коды). Нам нужно только настроить WPML так, чтобы он определял, какие короткие коды и атрибуты содержат тексты, требующие перевода. Это возможно с помощью файла wpml-config.xml, который необходимо поместить в корневую папку вашей темы или плагина.

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

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

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

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

<wpml-config>
    <shortcodes>
        <shortcode>
            <tag>vc_column_text</tag>
        </shortcode>
        <shortcode>
            <tag>vc_text_separator</tag>
            <attributes>
                <attribute>title</attribute>
            </attributes>
        </shortcode>
        …
</wpml-config>

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

В приведенном выше примере WPML извлекает тексты из таких коротких кодов, как:

[vc_column_text]Текст на перевод[/vc_column_text]

[vc_text_separator title=”текст на перевод”]

Вы знаете, какие короткие коды использует ваш построитель, и в каких атрибутах есть текст, требующий перевода. Создайте XML-файл, чтобы сопоставить эти короткие коды и их атрибуты. Когда XML-файл готов, сохраните его в корневой папке своей темы или плагина. Файл следует назвать wpml-config.xml.

После создания или обновления файла wpml-config.xml вашей темы или плагина необходимо сделать так, чтобы WPML загрузил его. Отключите и обратно включите тему/плагин. WPML загружает файлы конфигурации при активации или обновлении тем и плагинов.

Перевод страниц, созданных при помощи построителей страниц

После создания файла wpml-config.xml необходимо проверить перевод контента, созданного при помощи вашего построителя страниц.

Посмотрите видео ниже с обзором процесса перевода на примере Visual Composer.

 

Сначала необходимо настроить WPML для использования Редактора перевода (с поддержкой построителей страниц). После установки требуемого плагина (WPML, Translation Management, String Translation) и полной настройки WPML, перейдите в WPML -> Управление переводами -> Настройка многоязычного контента. Здесь выберите вариант «Использовать редактор переводов» в разделе Руководство к переводу записей и страниц и щелкните Сохранить.

Выбор параметра, позволяющего использовать редактор перевода

Выбор параметра, позволяющего использовать редактор перевода

Теперь вы можете приниматься за перевод.

  1. Создайте страницу WordPress и оформите ее дизайн с помощью своего построителя. Сохраните страницу.
  2. Во время редактирования страницы щелкните значок + под полем языка (будет создан новый перевод).

Перевод примера страницы

Начало перевода примера страницы

  1. Теперь откроется экран редактора перевода. Вы увидите поля каждого текста на созданной вами странице. Здесь всегда будет поле «заголовок» и должны быть поля для каждого текстового элемента в дизайне построителя страниц.
  2. Добавьте переведенные тексты в поля и выберите вариант Перевод закончен.
  3. Щелкните кнопку Сохранить и закрыть.

Перевод текстов страницы

Перевод текстов страницы

В редакторе страниц значок + должен измениться значком карандаша, обозначая завершение перевода (теперь вы можете редактировать его).

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

Пример переведенной страницы во внешнем интерфейсе

Пример переведенной страницы во внешнем интерфейсе

Давайте отредактируем страницу, чтобы увидеть, как выполняется перевод. В панели администратора щелкните кнопку «Редактировать страницу». Затем перейдите в режим HTML, чтобы увидеть ее исходный код.

Пример HTML-кода переведенной страницы

Пример HTML-кода переведенной страницы

Распространение построителя страниц с поддержкой WPML

Если в вашем построителе страниц используются короткие коды, единственное, что к нему необходимо добавить – это файл wpml-config.xml. Этот файл ничего не делает, если WPML не активен. Он сообщает WPML, как переводить страницы, созданные с помощью вашего построителя.

Нужна справка?

Вы можете получить помощь от группы по вопросам совместимости WPML (воспользуйтесь контактными данными, полученными из программы Go Global). Кроме того, вы можете посетить наш общий форум поддержки.

Мы также работаем над добавлением совместимости с построителями страниц, не использующими короткие коды. Свяжитесь с нами, чтобы получить дополнительные сведения и узнать о доступности версий в разработке.