Настройка переключателя языков WPML: размещение, стиль и поведение

Возможности переключателя языков WPML

Сразу после установки WPML создает переключатель, который:

• Показывает каждый активный язык на Вашем сайте в выбранном Вами порядке.
• Подписывает каждый язык его родным названием (Deutsch, Français) или на текущем языке сайта (немецкий, французский) — на Ваш выбор.
• При необходимости показывает флаги (спрайт, который масштабируется вместе с Вашей темой).
• Корректно обрабатывает отсутствующие переводы: либо пропускает язык, либо дает ссылку на главную страницу этого языка.
• Может быть размещен в любом меню WordPress, в любой области виджетов, в футере или встроен над и под записями.
• Доступен в виде блока Gutenberg для любого макета конструктора страниц.
• Может быть скрыт на определенных страницах, где он будет мешать (404, оформление заказа, учетная запись).
• Кеширует свой отрендеренный HTML для быстрой загрузки страниц.

Большинство сайтов используют встроенные варианты размещения и настройки по умолчанию. Разработчики тем, которым нужно больше контроля, могут создать пользовательский переключатель в коде с помощью API WPML.

Где находятся настройки

Откройте WPML > Настройки > Переключатели языков. Страница сгруппирована по вопросам, а не по вкладкам интерфейса. Выберите раздел, который соответствует тому, что Вы хотите изменить.

Какие языки отображаются и в каком порядке

В карточке Параметры переключателя языков есть область с поддержкой перетаскивания (drag-and-drop), в которой перечислены все активные языки. Порядок здесь определяет порядок в каждом переключателе на сайте. Перетащите языки вверх или вниз и сохраните.

В этой же карточке выберите:

• Родное название или название на текущем языке. Показывать Deutsch (родное) или немецкий (на текущем языке). Родное название более привлекательно для носителей этого языка; название на текущем языке понятнее для посетителей, зашедших впервые.
• Включение или отключение флагов, а также формат флага.

Что происходит при отсутствии перевода

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

• Пропустить язык (по умолчанию). Язык исчезает из переключателя для этой страницы. Самый чистый UX; посетители видят только те языки, на которых они действительно могут читать.
• Ссылка на главную страницу языка для отсутствующих переводов. Вместо этого в переключателе отображается главная страница языка. Полезно, когда Вы хотите, чтобы каждый язык был всегда доступен с любой страницы, но посетители могут попасть на контент, который они не ожидали увидеть.

Этот выбор имеет последствия для UX, которые стоит тщательно обдумать.

Где отображается переключатель

Пять вариантов размещения, каждый из которых включается независимо на одной и той же странице настроек:

• Переключатель языков в меню. Добавьте переключатель в любое меню WordPress (в шапку, футер, боковую панель — туда, куда Ваша тема назначает меню). Добавьте несколько, если хотите использовать разные варианты размещения для каждого меню. Каждый переключатель в меню получает свою собственную строку предпросмотра, показывающую, где он находится.
• Языковой переключатель виджета. Добавьте переключатель в любую область виджетов, зарегистрированную Вашей темой: боковые панели, зоны шапки, колонки футера.
• Переключатель языка в футере. Один глобальный переключатель, который автоматически рендерит переключатель языков внизу каждой страницы.
• Встроенные ссылки на переводы записей. Один флажок, который показывает ссылки вида «эта запись доступна на языке X» над или под каждой записью.
• Пользовательские переключатели. Когда встроенных вариантов размещения недостаточно, разработчики тем могут вызвать API переключателя WPML из любого файла шаблона. На странице настроек есть кнопка Настроить для параметров рендеринга.

Скрытие переключателя на определенных страницах

Некоторым страницам не нужен переключатель: Вашей странице 404, экранам учетной записи, оформлению заказа. Правила условного отображения WPML позволяют скрывать переключатель для каждой страницы отдельно, не прибегая к display:none CSS в Вашей теме.

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

Сохранение параметров URL

Когда посетитель нажимает на переключатель, WPML перестраивает URL-адрес для языка перевода. По умолчанию параметры строки запроса (?utm_source=newsletter, параметры фильтра и т. д.) отбрасываются. Это ломает аналитические кампании и отфильтрованные списки.

В поле Сохранять аргументы URL перечислены ключи запросов, которые Вы хотите сохранить при переключении. Все, что Вы здесь укажете (по одному в строке), переносится вместе с посетителем на переведенный URL-адрес.

Пользовательский CSS для переключателя

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

Кеширование шаблона переключателя

В карточке Производительность есть один флажок: Кешировать шаблоны переключателя языков. Если он включен, WPML кеширует отрендеренный HTML каждого варианта размещения переключателя, что ускоряет загрузку страниц на загруженном сайте.

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

Пользовательские переключатели в коде темы

Для сайтов, которым не подходят встроенные варианты размещения (переключатель в определенном месте внутри шапки страницы, пользовательский выпадающий список, отрендеренный Вашей темой, или что-либо за пределами меню WordPress или области виджетов), WPML предоставляет API, который позволяет разработчикам тем создать пользовательский переключатель.

В карточке Пользовательские переключатели языков есть переключатель Включить и кнопка Настроить. После включения код шаблона темы может рендерить переключатель в любом месте с помощью задокументированного PHP API от WPML.