После активации плагина qTranslate-X записи сайта нередко отображаются сразу на всех языках подряд, а в заголовках появляются служебные метки вида [:ru]Текст[:en]Text[:] — это типичный признак того, что плагин установлен, но его основные параметры ещё не настроены. Причина почти всегда одна: не выбраны активные языки и не задан язык по умолчанию в настройках расширения.
Ниже разберём полный цикл настройки: от установки плагина до перевода меню и решения конфликтов с темами. Материал ориентирован на связку WordPress и qTranslate-X — наиболее распространённый форк оригинального qTranslate, который давно не обновлялся и несовместим со свежими версиями движка.
Установка и активация плагина
Оригинальный qTranslate снят с поддержки, поэтому вам нужен его форк. Откройте раздел Плагины → Добавить новый в консоли WordPress и в поиске введите qTranslate-X. Если плагин недоступен в каталоге вашей версии, его можно загрузить вручную через Загрузить плагин, предварительно скачав архив с официального репозитория разработчика.
После установки нажмите «Активировать». В меню консоли появится новый пункт Настройки → Языки — именно через него выполняется вся дальнейшая конфигурация. Если пункт не появился, проверьте, не конфликтует ли плагин с другим мультиязычным расширением: одновременно активные Polylang или WPML нужно отключить.
⚠️ Внимание: перед установкой любого мультиязычного плагина сделайте резервную копию базы данных. qTranslate хранит переводы прямо в полях записей, и некорректное удаление плагина может «склеить» все языковые версии в один текст.
Выбор и добавление языков
Перейдите в Настройки → Языки и откройте вкладку управления языками. По умолчанию активен обычно только английский. В списке доступных найдите нужные языки — например, русский и украинский — и нажмите «Включить» напротив каждого из них.
Для каждого языка можно задать параметры, влияющие на отображение и URL:
- 🌐 Код языка — двухбуквенный идентификатор (
ru,en,uk), который попадёт в адрес страницы; - 🚩 Флаг — иконка, отображаемая в переключателе языков на сайте;
- 📅 Формат даты — локальное представление даты и времени для записей;
- 📝 Сообщение «недоступно» — текст, который увидит посетитель, если перевода страницы на выбранный язык нет.
Настройка языка по умолчанию и формата URL
На той же странице настроек укажите язык по умолчанию — тот, на котором сейчас написан основной контент сайта. От этого выбора зависит, какой вариант текста будет показан посетителю при отсутствии перевода, поэтому менять его после наполнения сайта нежелательно.
Отдельно настраивается режим URL — то, как язык отражается в адресной строке. Доступные варианты зависят от версии плагина, но обычно это префикс в пути (site.ru/ru/page), параметр запроса (?lang=ru) или поддомен. Для SEO чаще всего рекомендуют префикс в пути: он создаёт чистые, индексируемые адреса для каждой языковой версии.
| Режим URL | Пример адреса | Особенности |
|---|---|---|
| Префикс в пути | site.ru/ru/page | Удобен для SEO, требует корректных постоянных ссылок |
| Параметр запроса | site.ru/page?lang=ru | Работает почти всегда, но адреса менее читаемы |
| Поддомен | ru.site.ru/page | Требует настройки DNS и хостинга |
| Скрытый язык по умолчанию | site.ru/page | Основной язык без префикса, остальные — с ним |
Перевод записей и страниц
После активации языков в редакторе записей появляются языковые вкладки над полем заголовка и текстом. Принцип работы прост: вы переключаетесь между вкладками и вводите отдельный заголовок и содержимое для каждого языка. Плагин сохраняет всё в одном поле базы данных, разделяя версии служебными тегами.
Если вкладки по какой-то причине не отображаются — например, из-за конфликта с плагином редактора — контент можно разметить вручную тегами:
[:ru]Русский текст[:en]English text[:]Порядок действий при переводе типичной страницы выглядит так:
☑️ Чек-лист перевода записи
Обратите внимание: записи, созданные до установки плагина, автоматически считаются написанными на языке по умолчанию — их не нужно переводить заново, достаточно добавить версии на других языках через вкладки.
Перевод меню, виджетов и названия сайта
Элементы интерфейса переводятся иначе, чем записи. Название сайта и его описание (Настройки → Общие) после активации плагина обычно получают те же языковые вкладки. Если вкладок нет, впишите значения в формате тегов: [:ru]Мой сайт[:en]My site[:].
Пункты меню (Внешний вид → Меню) переводятся похожим образом — в поле «Текст ссылки» указывается строка с тегами для каждого языка. Виджеты с текстовым содержимым также поддерживают эту разметку, однако поведение зависит от конкретной темы: некоторые темы фильтруют служебные теги некорректно.
- 🧭 Меню — текст каждого пункта вводится с языковыми тегами;
- 🧩 Виджеты — заголовок и содержимое размечаются тегами вручную;
- 🏷️ Рубрики и метки — названия переводятся через теги в их настройках;
- 🖼️ Изображения — подписи и alt-тексты могут потребовать ручной разметки.
Что делать, если тема не обрабатывает языковые теги
Некоторые темы выводят заголовки напрямую, минуя фильтры WordPress. В этом случае на сайте будут видны сырые теги [:ru]...[:]. Решения: обновить тему, проверить настройки интеграции в qTranslate-X (вкладка совместимости) или обратиться к документации темы — многие разработчики добавляют поддержку мультиязычных плагинов отдельно.
Типичные проблемы и их решения
Самая частая жалоба — «склеенный» текст всех языков на странице. Возможная причина: конфликт с плагином кэширования, который сохранил страницу до применения языковых фильтров. Очистите кэш и проверьте снова. Если не помогло — временно отключите другие плагины по очереди, чтобы найти источник конфликта.
⚠️ Внимание: не удаляйте qTranslate-X простым нажатием «Удалить», если на сайте уже есть переведённый контент. Сначала сделайте экспорт базы данных и изучите официальную процедуру деактивации — иначе в записях останутся служебные теги, которые придётся вычищать вручную.
Вторая распространённая ситуация — переключатель языков не меняет контент. Проверьте, что в настройках включён нужный режим определения языка (по URL, по cookies или по языку браузера), и что постоянные ссылки WordPress (Настройки → Постоянные ссылки) сохранены заново после активации плагина — это пересоздаёт правила маршрутизации.
FAQ: частые вопросы о настройке qTranslate
Чем qTranslate-X отличается от оригинального qTranslate?
Оригинальный плагин прекратил развитие и несовместим с современными версиями WordPress. qTranslate-X — его форк, который продолжил поддержку и добавил совместимость с новыми версиями движка. Для новых сайтов следует использовать именно форк или рассмотреть альтернативы вроде Polylang.
Можно ли перенести контент из qTranslate в другой плагин?
Да, но это отдельная процедура миграции: контент хранится в особом формате с тегами, и его нужно конвертировать. Некоторые плагины предлагают инструменты импорта. Перед миграцией обязательно создайте полную резервную копию базы данных.
Почему на странице видны теги [:ru] и [:en]?
Это означает, что текст выводится в обход фильтров плагина. Проверьте настройки совместимости в qTranslate-X, обновите тему и убедитесь, что плагин активен. Также убедитесь, что теги закрыты корректно — незакрытый тег ломает разметку всего блока.
Влияет ли qTranslate на скорость сайта?
Плагин добавляет обработку текста при выводе каждой страницы, но при корректно настроенном кэшировании влияние на скорость обычно незаметно. Проблемы возникают в основном при конфликте с плагинами кэша, когда языковые версии страниц кэшируются некорректно.
Как перевести строки, зашитые в коде темы?
Строки темы переводятся не через qTranslate, а через файлы локализации (.po/.mo) или плагины перевода тем. qTranslate работает с контентом из базы данных, а не с текстами в PHP-шаблонах.