Настройка и использование qTranslate-X

Плагин qTranslate-X позволяет сделать сайт на WordPress мультиязычным, причём с его помощью можно перевести абсолютно весь сайт, включая статический контент. Рассмотрим, как настроить плагин под себя и начать использовать его в полной мере.

Настройка qTranslate-X

Для настройки плагина qTranslate-X перейдём в Настройки » Языки.

Общие настройки

Язык по умолчанию - основной язык вашего сайта (до того, как он стал мультиязычным).

Режим URL-Модификации - изменение адреса сайта при выборе языка.

использование режима запроса - добавляет в конце адреса ?lang=en
использование режима предварительно пути - добавляет в конце адреса /en/
использование режима поддомена - добавляет в начале адреса en. (необходима настройка DNS на хостинге)
скрыть URL языка для языка по умолчанию - скрыть URL.

Untranslated Content (Непереведенный Контент) - выбор способа отображения непереведённого контента.

скрыть контент, который не доступен для выбранного языка - скрыть страницы, для которых нет перевода
показывать префикс языка, когда содержимое недоступно для выбранного языка - если содержимое недоступно для данного языка, то непереведённые поля будут отображены на альтернативном языке с префиксом в скобках
show content in an alternative language when translation is not available for the selected language - отображение содержимого на альтернативном языке, если перевод недоступен для выбранного языка.

Language Names - как отображать имена языков

show language names in "Camel Case" - отображать языки в стиле "Camel Case" (верблюжий регистр)

Определить язык браузера.

обнаруживает язык браузера и перенаправляет соответственно - автоопределение и перенаправление на язык, который используется в браузере у пользователя.

Моя настройка:

Дополнительные настройки

Рассмотрим лишь самые часто используемые.

Post Types - для каких типов записей будут доступны переводы.

Путь к изображениям флагов - здесь можно задать путь до своих изображений.

Head inline CSS - данные CSS стили будут добавлены в head HTML-страницы.

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

Editor Mode - выбор типа редактора для перевода.

Use Language Switching Buttons (LSB) - страницы с переводимыми полями имеют кнопки для переключения между языками
Raw режим редактора - перевод контента будет осуществляться при помощи шорткодов: [:ru]поле[:en]field[:]
Single Language Mode - этот режим редактирования необходим при возникновении проблем с первыми двумя типами редакторов

LSB Style - выбор стиля для кнопок переключения языков.

Highlight Style - подсветка переводимых полей, чтобы визуально показать какое поле имеет многоязычное значение.

Языки

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

Вывод переключателя языков в qTranslate-X

Рассмотрим три способа для вывода переключателя языков в qTranslate-X.

1. Вывод переключателя в код страницы.
2. Вывод в меню сайта.
3. Используя виджеты.

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

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

<?php
// в виде текста
qtranxf_generateLanguageSelectCode("text", "language"); ?>

<?php
// в виде флага
qtranxf_generateLanguageSelectCode("image", "language"); ?>

<?php
// в виде текста и флага
qtranxf_generateLanguageSelectCode("both", "language"); ?>

<?php
// в виде выпадающего списка
qtranxf_generateLanguageSelectCode("dropdown", "language"); ?>

Вывод переключателя языков qTranslate-X в меню сайта

Для того чтобы вывести переключатель языков в меню, зайдём Внешний вид » Меню.

В блоке Переключатель языка выберем Языковое меню и добавим его.

Значение по умолчанию, выводит текст и флаг:

#qtransLangSwLM#

Например, чтобы вывести только флаги, установим значение:

#qtransLangSw?type=LM&title=none&current=hidden&names=hidden

Кастомизация переключателя языков

Следующие параметры можно вводить в поле URL пункта меню после #qtransLangSw? разделяя знаком амперсанд &.

type:

LM - дефолтное значение (выводит все языки)
AL - выводит все доступные языки, кроме текущего

title:

language - слово "Language" переводится на текущий язык (по умолчанию)
none - без заголовка в верхней части меню, отображается только флаг
current - выводится название текущего языка

current:

shown - показать текущий язык в меню
hidden - скрыть текущий язык в меню

names:

shown - показать названия языков в подпунктах
hidden - скрыть названия языков в подпунктах

colon:

shown - отобразить двоеточие после названия заголовка
hidden - скрыть двоеточие после названия заголовка

flags:

none - скрывает отображение флагов
all - флаг присутствует как в вкладке, так и в названии языка
items - флаги присутствуют только в названии языка (во вкладке)

Изменить вывод названия текущего языка можно в Настройки » Языки » Язык по умолчанию.

Жмём Редактировать и в поле Название изменяем на нужное.

Вывод переключателя языков, используя виджеты

Заходим Внешний вид » Виджеты. Перетаскиваем на панель виджетов Выбор языка qTranslate:

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

Перевод статического текста с помощью qTranslate-X

Чтобы перевести статический текст можно использовать следующие условия вывода текста на нужном языке:

<?php
if ( qtrans_getLanguage() == "ru" ) { 
  echo "счастье";
} elseif ( qtrans_getLanguage() == "en" ) {
  echo "happiness";
} elseif ( qtrans_getLanguage() == "de" ) {
  echo "glück";
}
?>

Для перевода полей в плагинах и виджетах можно использовать шорткоды:

[:ru]милая улыбка[:en]sweet smile[:de]nettes lächeln[:]