Modals от Regular Labs открывает изображения, видео и страницы сайта поверх текущей страницы Joomla. В руководстве разберём совместимость, различия Free и Pro, установку, настройку и способы добавления окон в материалы. Отдельно рассмотрим управление с клавиатуры и мобильные устройства.

Что умеет Modals

Модальное окно позволяет показать дополнительное содержимое, не уводя посетителя с текущей страницы. Например, увеличить фотографию, открыть видеоролик или показать инструкцию. Для длинной статьи и сложной формы часто удобнее обычная страница.

В Joomla расширение обрабатывает теги вида {modal ...}...{/modal} или ссылки с заданным CSS-классом. Кнопка редактора помогает вставить тег, а системный плагин превращает его в работающую ссылку.

У Modals две редакции. Обе распространяются с открытым исходным кодом по GPL. Free бесплатна, а Pro добавляет возможности и доступ к персональной поддержке и обновлениям по условиям подписки. Бесплатная редакция не включает поддержку через тикеты.

Таблица «Основные различия Modals Free и Pro»
Возможность Free Pro
Открытие изображений, видео и страниц по URL Да Да
Открытие материала Joomla по его URL Да Да
Вставка через тег и преобразование ссылок по CSS-классу Да Да
Светлая и тёмная темы Да Да
Обращение к материалу через атрибут article по ID, алиасу или заголовку Нет Да
Текст и HTML внутри страницы без отдельного материала Нет Да
Галереи, группы окон и слайдшоу Нет Да
Автоматическое преобразование изображений Нет Да
Автоматическое открытие и закрытие Нет Да
Преобразование ссылок по типам файлов, URL и target="_blank" Нет Да

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

Скриншоты в руководстве показывают Modals 17.1.0 Pro в Joomla 6.2.0. Наличие функции в бесплатной редакции сверяйте с таблицей выше.

Совместимость и версии

На 12 ноября 2026 года актуальная версия — Modals 17.1.0 от 5 октября 2026 года. Разработчик указывает совместимость с Joomla 4, 5 и 6 и минимум PHP 8.2.

Требования расширения и Joomla нужно проверять вместе. Например, Joomla 6 требует PHP 8.3 или новее, поэтому PHP 8.2 для такого сайта недостаточно. При этом совместимость Modals с Joomla 4 не означает, что сама устаревшая ветка Joomla получает поддержку проекта.

Текущую версию Modals нельзя считать решением для Joomla 3. Поддержка этой ветки удалена из расширения начиная с Modals 13. Для старого сайта сначала спланируйте обновление CMS, шаблона и расширений. Актуальный дистрибутив Joomla доступен в разделе скачивания Joomla.

Перед установкой или обновлением создайте резервную копию и проверьте расширение на копии своего сайта. Заявленная совместимость не заменяет проверку с конкретным шаблоном, редактором и средствами оптимизации JavaScript.

Установка и активация

Для установки нужен пакет Modals с сайта Regular Labs, соответствующий выбранной редакции. Распаковывать ZIP перед загрузкой в Joomla не требуется.

  1. В панели Joomla откройте Система → Установка → Расширения.
  2. Загрузите ZIP-пакет и дождитесь сообщения об успешной установке. Другой вариант — установка через Regular Labs Extension Manager.
  3. Откройте Система → Управление → Плагины и найдите Modals.
  4. Проверьте, что включён системный плагин Modals. Для вставки через кнопку редактора нужен также плагин кнопки Modals. Служебный системный плагин Regular Labs тоже должен быть включён.

При обычном обновлении установите новый пакет поверх существующего или воспользуйтесь механизмом обновлений. Предварительно удалять Modals не нужно: удаление пакета убирает его сохранённую конфигурацию. Для обновлений Pro через Joomla используется действующий Download Key.

Основные настройки

Откройте системный плагин Modals. Начните с настроек оформления и поведения, а остальные параметры меняйте под конкретную задачу. Названия разделов зависят от языка интерфейса.

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

В настройках поведения оставьте видимую кнопку закрытия и включите управление с клавиатуры. Modals предусматривает закрытие через Escape и переход между элементами группы стрелками. Для чувствительных к движению пользователей предпочтительны спокойные эффекты или их отсутствие.

В параметрах кнопки редактора можно изменить её подпись и доступность во внешнем интерфейсе. Синтаксис тегов без необходимости не меняйте: после изменения слова modal или окружающих символов уже вставленные теги потребуют правки.

Автоматическое преобразование ссылок включайте выборочно. Собственный CSS-класс позволяет явно указать нужные ссылки. В Pro есть более широкие правила, но преобразование всех внешних ссылок или всех ссылок с target="_blank" стоит применять только после проверки результата.

Как добавить модальное окно

Вставлять теги можно вручную или через кнопку расширения в редакторе. В стандартном TinyMCE Joomla 6 откройте меню Контент → Modal. В другом редакторе расположение и подпись кнопки могут отличаться.

  1. Установите курсор в нужное место материала.
  2. Откройте Контент → Modal.
  3. Выберите тип содержимого, например URL.
  4. Заполните текст ссылки и адрес страницы.
  5. Нажмите Вставить. В редакторе появится тег Modals.
  6. Сохраните материал и проверьте окно на странице сайта.

Материал или другая страница

Для Free и Pro подходит обычный URL материала. Скопируйте адрес нужной страницы и укажите его в атрибуте url.

{modal url="/knowledge-base/joomla-system-requirements" title="Системные требования Joomla"}Посмотреть системные требования{/modal}

Пример использует внутреннюю страницу сайта. На своём сайте замените адрес и подпись на нужные.

Для внутренней страницы Modals по умолчанию выводит область компонента без окружающих модулей. Если нужен полный макет с модулями, предусмотрен атрибут fullpage="true". Проверяйте результат с используемым шаблоном.

В Pro можно обратиться к материалу через article, указав его ID, алиас или заголовок. Это сокращённый способ выбора материала, а не единственная возможность открыть статью в окне.

Изображение

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

{modal url="/images/example/photo.jpg" title="Фотография товара"}Увеличить фотографию{/modal}

Путь в примере нужно заменить на реальный. Текст между тегами станет ссылкой. В Pro атрибут image позволяет автоматически сформировать миниатюру. Не оставляйте имя файла вроде img-001 единственным описанием изображения.

Видео

Для видео используйте подходящий тип содержимого в кнопке редактора и адрес встраиваемого проигрывателя. Для этого сценария документация Modals требует HTTPS на сайте. В Pro есть сокращённые атрибуты youtube и vimeo для идентификаторов видео. Возможность воспроизведения зависит также от настроек видеосервиса и ограничений встраивания.

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

Текст и галерея в Pro

Для небольшого пояснения без отдельного материала можно использовать встроенное содержимое.

{modal html="Заказ можно забрать после подтверждения менеджера." title="Получение заказа"}Как получить заказ{/modal}

Для большого блока предусмотрены парные теги modalcontent и ссылка с атрибутом content. Содержимое остаётся в той же странице, поэтому не используйте этот способ для сокрытия конфиденциальной информации.

Галерею Pro можно создать из папки с изображениями.

{modal gallery="images/example/gallery" thumbnails="all"}Посмотреть фотографии{/modal}

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

Клавиатура и мобильные устройства

Установка расширения сама по себе не подтверждает доступность сайта. Проверьте готовое окно вместе с его содержимым, шаблоном и настройками.

  1. Перейдите к ссылке клавишей Tab и откройте окно с клавиатуры.
  2. Убедитесь, что фокус переместился внутрь окна и его положение видно.
  3. Проверьте обход элементов через Tab и Shift+Tab. Пока окно открыто, фокус не должен уходить на перекрытую страницу.
  4. Закройте окно клавишей Escape и отдельной видимой кнопкой. После закрытия фокус должен вернуться к исходной ссылке.
  5. Проверьте заголовок окна и названия кнопок со скринридером. Для iframe используйте осмысленный заголовок, в Modals для этого есть атрибут iframe-title.

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

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

Обновления и устранение проблем

Начиная с версий 16 и 17 в Modals менялись правила безопасной обработки содержимого. Версия 17.0.0 закрыла уязвимости, связанные с JavaScript-ссылками и событиями. В 17.1.0 появились настройки Process Tags для областей обработки тегов, а в Pro — доверенные источники JavaScript Events.

После обновления сначала проверьте права авторов и разрешённые области обработки. Не возвращайте доступ к выполнению JavaScript всем редакторам ради восстановления старого примера. Для обычного открытия картинки или статьи пользовательский JavaScript не требуется.

Если вместо окна показывается исходный тег, проверьте системный плагин, синтаксис и разрешение обработки тегов в нужной области. Если ссылка есть, но окно не открывается, проверьте ошибки JavaScript и влияние объединения, задержки и минификации скриптов. Такие проверки проводите на копии сайта.

При ошибках обработки изображений прочитайте сообщение полностью. Если оно указывает на Fileinfo или Exif, проверьте наличие и включение этих модулей PHP на сервере. Изменение тега Modals такую причину не устранит.

Если внешняя страница не загружается в iframe, причина может быть в её запрете на встраивание. Страница HTTPS также может блокировать содержимое HTTP. Modals не отменяет эти ограничения. Для неподходящей страницы оставьте обычную ссылку.

Итог

Modals помогает добавить в Joomla окна для фотографий, видео и дополнительных материалов. Начните с одной ссылки и возможностей Free. Переходите к Pro, когда нужны встроенное содержимое, галереи или автоматизация, и проверяйте каждый сценарий с клавиатурой и на телефоне.