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

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

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

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

Нужно сгенерировать файл wpml-config.xml? Ознакомьтесь с нашим пошаговым руководством по автоматическому созданию файла конфигурации с помощью плагина Multilingual Tools.

Что можно настроить в переключателе языков?

WPML позволяет Вам настраивать ряд переменных в переключателе языков. К ним относятся:

Встроенные стили CSS — добавление пользовательского CSS непосредственно в переключатель языков
Ссылка на непереведенный контент — выбор, показывать или скрывать ссылки на непереведенный контент
Копируемые параметры URL — указание параметров URL, которые должны копироваться при переключении языков
Переключатель языков в боковой панели / футере — настройка внешнего вида переключателя языков в боковой панели и футере, включая:
- Отображение флагов и/или названий языков
- Отображение текущего языка в виде ссылки
- Задание заголовка для виджета переключателя языков
- Выбор шаблона для макета переключателя
- Настройка цветов текста, фона и границ с помощью шестнадцатеричных кодов

Действия шорткодов — определение внешнего вида переключателей языков, добавленных с помощью шорткодов

Пример добавления пользовательской конфигурации для встроенного переключателя языков WPML

<wpml-config>
  <language-switcher-settings>
    <key name="additional_css">{inline CSS styles}</key>
    <key name="link_empty">{0 or 1}</key>
    <key name="copy_parameters">{parameter1, parameter2}</key>
    <key name="sidebars">
        <key name="{sidebar slug}">
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="widget_title">{widget title}</key>
            <key name="template">{template slug}</key>
            <!-- color picker keys -->
            <key name="background_normal">#{hex color}</key>
            <key name="border_normal">#{hex color}</key>
            <key name="font_current_normal">#{hex color}</key>
            <key name="font_current_hover">#{hex color}</key>
            <key name="background_current_normal">#{hex color}</key>
            <key name="background_current_hover">#{hex color}</key>
            <key name="font_other_normal">#{hex color}</key>
            <key name="font_other_hover">#{hex color}</key>
            <key name="background_other_normal">#{hex color}</key>
            <key name="background_other_hover">#{hex color}</key>
        </key>
    </key>
    <key name="statics">
        <key name="footer">
            <key name="show">{0 or 1}</key>
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="template">{template slug}</key>
            <!-- color picker keys -->
            <key name="background_normal">#{hex color}</key>
            <key name="border_normal">#{hex color}</key>
            <key name="font_current_normal">#{hex color}</key>
            <key name="font_current_hover">#{hex color}</key>
            <key name="background_current_normal">#{hex color}</key>
            <key name="background_current_hover">#{hex color}</key>
            <key name="font_other_normal">#{hex color}</key>
            <key name="font_other_hover">#{hex color}</key>
            <key name="background_other_normal">#{hex color}</key>
            <key name="background_other_hover">#{hex color}</key>
        </key>
        <key name="post_translations">
            <key name="show">{0 or 1}</key>
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="display_before_content">{0 or 1}</key>
            <key name="display_after_content">{0 or 1}</key>
            <key name="template">{template slug}</key>
            <key name="availability_text">{string like "See post translations: %s"}</key>
        </key>
        <key name="shortcode_actions">
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="template">{template slug}</key>
            <!-- color picker keys -->
            <key name="background_normal">#{hex color}</key>
            <key name="border_normal">#{hex color}</key>
            <key name="font_current_normal">#{hex color}</key>
            <key name="font_current_hover">#{hex color}</key>
            <key name="background_current_normal">#{hex color}</key>
            <key name="background_current_hover">#{hex color}</key>
            <key name="font_other_normal">#{hex color}</key>
            <key name="font_other_hover">#{hex color}</key>
            <key name="background_other_normal">#{hex color}</key>
            <key name="background_other_hover">#{hex color}</key>
        </key>
    </key>
  </language-switcher-settings>
</wpml-config>

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

Сброс переключателя языков WPML к настройкам по умолчанию

Вы также можете использовать wpml-config.xml для сброса конфигурации переключателя языков, если она была изменена в бэкенде (относительно начальных значений).
Чтобы увидеть новые изменения, обязательно нажмите кнопку «Восстановить по умолчанию» внизу страницы WPML → Языки.

Дополнительные ресурсы

Чтобы узнать больше о файле wpml-config.xml, ознакомьтесь с руководством Файлы конфигурации языков.

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