Представьте: сайт на Joomla, нужно добавить второй язык. Вы ставите языковой пакет, создаёте меню — но ссылки ведут не туда, hreflang не генерируется, а переключатель языков не отображается. Знакомая ситуация? Мы сталкивались с этим десятки раз. В этой статье разберём, как настроить мультиязычность Joomla правильно: от установки языковых пакетов до SEO-оптимизации с hreflang. Вы получите готовые конфиги и чек-лист ошибок.
Joomla — единственная крупная CMS с полноценной мультиязычностью из коробки, без платных плагинов. Поддержка нескольких языков встроена в ядро: переводятся статьи, меню, категории, модули, шаблоны. Однако настройка требует внимания к деталям. За 5 лет работы мы настроили мультиязычность на 15+ проектах Joomla — от небольших блогов до интернет-магазинов. Гарантируем стабильную работу и корректную индексацию.
Почему Language Filter — ключевой плагин?
Без активации плагина Language Filter переключатель языков не будет работать, а hreflang не добавится. Его включение — обязательный шаг. Автоматическая смена языка и удаление префикса для основного языка — типовые настройки. Проверьте параметры:
Automatic language change: Yes Remove URL language code for default language: Yes Show language code in URL: Yes Даже при включённом плагине переключатель может не работать, если не созданы меню для каждого языка или модуль не размещён в позиции шаблона. Подробнее в документации Joomla.
Установка языковых пакетов и настройка Content Language
Расширения → Языки → Установить языки. Выбрать нужные языки (русский, украинский, английский), нажать установить — Joomla скачает пакеты с официального сервера.
Или вручную:
# Через CLI (Joomla 4+) php cli/joomla.php extension:install --url https://download.joomla.org/language/ru-RU/ru-RU.tar.gz Затем настройте Content Languages: Расширения → Языки → Языки контента → добавить языки с настройками:
- Языковой тег:
ru-RU,en-GB,uk-UA - URL код:
ru,en,uk— используется в URL - SEF prefix: то же самое
Как настроить Hreflang без ошибок?
Joomla генерирует hreflang автоматически при соблюдении двух условий: включён Language Filter и созданы языковые ассоциации. Проверить:
curl -s https://yourdomain.com/ | grep hreflang # <link rel="alternate" hreflang="ru" href="https://yourdomain.com/ru/" /> # <link rel="alternate" hreflang="en" href="https://yourdomain.com/en/" /> Ошибки возникают, если ассоциации не настроены или язык контента не привязан к статье. Используйте компонент «Языковые ассоциации» для каждой записи.
Мультиязычные статьи, меню и переключатель
Для каждого языка создаётся отдельный вариант статьи. Joomla связывает их как языковые ассоциации.
- Создать статью для русского: язык = ru-RU
- Создать статью для английского: язык = en-GB
- Компоненты → Языковые ассоциации → выбрать русскую статью → ассоциировать с английской
Меню: создайте отдельное меню для каждого языка. Пункты меню привязаны к конкретному языку. Это обязательное условие работы переключателя.
Добавить модуль Language Switcher (mod_languages) в позицию шаблона:
<jdoc:include type="modules" name="language-switcher" style="none" /> Параметры модуля:
- Использовать изображения флагов: по желанию
- Горизонтальное положение
- Использовать выпадающий список: для большого количества языков
Контентная модель и переопределение строк
Для сложных сайтов рекомендуется структура:
Категории (по языку): ├── Новости (ru-RU) ├── News (en-GB) └── Новини (uk-UA) Меню: ├── Главное меню (ru-RU) ├── Main Menu (en-GB) └── Головне меню (uk-UA) Нативный подход Joomla лучше платных решений (например, Falang) в производительности: не нужны дополнительные запросы к БД, сокращение времени загрузки на 30%.
Переопределение языковых строк:
; language/ru-RU/ru-RU.com_content.ini COM_CONTENT_ARTICLE_MORE_DETAILS="Подробнее" COM_CONTENT_ARTICLES_FILTER_SEARCH_DESC="Введите поисковый запрос" Или через Расширения → Языки → Переопределения.
Почему не работает переключатель? (разбор частой ошибки)
При создании меню для каждого языка убедитесь, что первый пункт меню (часто Home) связан с нужной категорией и языком. Если в меню нет ни одного пункта для данного языка, переключатель не появится. Ассоциации должны быть настроены для всех статей, категорий и элементов меню.Сравнение: нативная мультиязычность vs плагины
| Критерий | Нативная Joomla | Плагины (Falang и др.) |
|---|---|---|
| Производительность | Высокая (без лишних запросов) | Средняя (доп. таблицы) |
| Сложность настройки | Средняя (требует внимания) | Высокая (кривая обучения) |
| Совместимость с обновлениями | Полная | Может ломаться |
| Стоимость | Бесплатно | От $50 за лицензию |
Процесс работы
| Этап | Действия | Результат |
|---|---|---|
| Аналитика | Определение языков, структуры контента, адресов | План мультиязычности |
| Проектирование | Настройка Content Languages, плагина Language Filter, SEF-URL | Базовая конфигурация |
| Реализация | Установка языковых пакетов, создание ассоциаций, модулей, меню | Работающий переключатель |
| Тест | Проверка hreflang, ссылок, переключателя, контента | Отсутствие битых ссылок |
| Деплой | Перенос на боевой сервер, мониторинг | Стабильная работа |
| Обучение | Инструкция для редакторов контента | Самостоятельное добавление языков |
Что входит в работу
- Установка и настройка языковых пакетов
- Создание Content Languages (до 5 языков)
- Настройка Language Filter и SEF-URL
- Разработка структуры категорий и меню для каждого языка
- Настройка языковых ассоциаций для существующего контента
- Интеграция модуля Language Switcher
- Проверка hreflang и SEO-валидация
- Документация по управлению мультиязычностью
- Поддержка в течение 30 дней после сдачи
Сроки ориентировочно
Настройка мультиязычности Joomla для 2–3 языков с переводом меню, категорий и базового контента — от 2 до 5 дней в зависимости от объёма контента. Крупные проекты с десятками страниц требуют дополнительного согласования.
Свяжитесь с нами для точной оценки вашего проекта. Закажите настройку мультиязычности Joomla у экспертов — мы гарантируем корректную индексацию и стабильную работу.