Плагин Multilingual Tools — это плагин для тестирования, который Вы можете использовать при регистрации пользовательских виджетов Elementor для перевода. Плагин включает в себя инструмент WPML – Config Generator for Elementor, который автоматически генерирует первую версию XML-кода для этих пользовательских виджетов.
С помощью этого инструмента Вы сможете получить информацию, необходимую для регистрации Вашего виджета.
Это руководство предназначено для разработчиков, которые создают темы оформления и плагины для Elementor и хотят сделать их совместимыми с WPML. Если Вы не являетесь разработчиком, ознакомьтесь с нашим руководством Как перевести сайт на Elementor с помощью WPML.
Начало работы
Для начала работы:
- Скачайте плагин Multilingual Tools со страницы OnTheGoSystems на GitHub.
- Убедитесь, что на Вашем сайте установлены и активированы ядро WPML Multilingual CMS и дополнение WPML Перевод строк .
- Убедитесь, что на Вашем сайте уже есть контент, созданный в Elementor.
Зачем использовать плагин Multilingual Tools
В WPML 4.9 и более новых версиях WPML автоматически распознает пользовательские виджеты Elementor и делает их переводимыми. Однако он может зарегистрировать строки, которые Вы не хотите переводить.
Поэтому мы рекомендуем использовать Multilingual Tools для регистрации Вашего пользовательского виджета Elementor для перевода. Это дает Вам точный контроль над тем, какие поля будут переводимыми.
Как это работает
Когда Вы создаете страницу с помощью конструктора страниц Elementor, весь контент сохраняется в произвольном поле _elementor_data.
Как только Вы добавляете на страницу пользовательские виджеты, которые хотите зарегистрировать для перевода, WPML – Config Generator for Elementor обращается к этому полю _elementor_data, чтобы прочитать его содержимое. После прочтения он преобразует данные в XML-код, который соответствует пользовательским виджетам, использованным на Вашей странице.
Генерация XML-кода с помощью WPML — Config Generator
Чтобы автоматически сгенерировать XML-код для Ваших пользовательских виджетов:
- Создайте новую страницу и нажмите Редактировать в Elementor.
- Добавьте на страницу пользовательские виджеты, которые Вы хотите зарегистрировать для перевода.
Важно: добавляя свой виджет, чтобы сделать его переводимым, обязательно заполните все поля и включите все доступные параметры.
Это связано с тем, что WPML – Config Generator for Elementor не генерирует XML-код для ненастроенных полей или параметров.
- Опубликуйте страницу и вернитесь на экран редактирования этой страницы в WordPress. Прокрутите вниз до раздела с названием WPML: Elementor Widgets. Вы увидите сгенерированный XML-код для полей и настроек виджета, которые еще не зарегистрированы для перевода.
Тестирование автоматически сгенерированного XML-кода
Прежде чем предоставлять код конечным пользователям, обязательно тщательно проверьте и протестируйте его. WPML – Config Generator for Elementor — это только отправная точка.
Чтобы протестировать автоматически сгенерированный XML-код:
- Скопируйте XML-код из раздела WPML: Elementor Widgets на экране редактирования Вашей страницы с пользовательскими виджетами в WordPress.
- Перейдите в WPML → Настройки и откройте вкладку Пользовательская конфигурация XML.
- Вставьте код в редактор и нажмите кнопку Сохранить. Убедитесь, что Вы не видите никаких предупреждений или ошибок валидации. Обязательно удалите все поля, которые не должны переводиться или изменяться пользователями, например поля конфигурации и логические поля. Если оставить эти поля доступными для перевода, это может привести к проблемам и ошибкам у конечных пользователей.
- Вернитесь на экран редактирования страницы с пользовательскими виджетами. Внесите небольшое изменение на страницу, например отредактируйте заголовок, и нажмите Обновить.
- В блоке Язык нажмите на значок плюса, чтобы перевести страницу. Откроется Расширенный редактор переводов, и Вы должны увидеть зарегистрированные поля пользовательского виджета, доступные для перевода. Проверьте автоматические переводы или введите свои собственные и нажмите Завершено, когда закончите.
- Взгляните на переведенную страницу во фронтенде, чтобы убедиться, что поля пользовательского виджета отображаются корректно.
Использование дополнительных функций проверки
Помимо автоматической генерации XML-кода для Ваших пользовательских виджетов Elementor, WPML – Config Generator for Elementor предоставляет дополнительную отладочную информацию.
Эта информация позволяет Вам изучить и понять базовые данные и то, как они используются. Она может быть полезна в особых случаях, например когда XML-код работает не так, как ожидалось.
WPML Config XML (сгенерировано для всех виджетов на странице)
Что это делает: предоставляет XML-код для всех виджетов на странице, включая те, которые уже зарегистрированы для перевода.
Зачем это нужно: позволяет Вам просматривать или редактировать XML-код существующих настроек виджетов.
Исходное значение из _elementor_data (JSON)
Что это делает: показывает исходное значение поля _elementor_data записи.
Зачем это нужно: позволяет Вам увидеть данные, которые WPML – Config Generator for Elementor Widgets использует для генерации XML-кода.
Массив, сгенерированный из _elementor_data
Что это делает: предоставляет значение поля _elementor_data записи, преобразованное в массив.
Зачем это нужно: Вы можете использовать этот массив для целей отладки.
Извлеченные виджеты из _elementor_data
Что это делает: показывает, какие пользовательские виджеты плагин смог извлечь и использовать из поля _elementor_data.
Зачем это нужно: если Вы не видите здесь пользовательский виджет, поле или параметр пользовательского виджета, они не будут добавлены в XML. Это полезно для отладки.