Частный Joomla-разработчик · работаю удалённо
My Joomla — блог веб-разработчика на JoomlaОбсудить задачу
Авторское расширение

LeoSpoiler

Спойлеры для Joomla: раскрывающиеся блоки с текстом, списками и ссылками. Настройка цветов, открытое или закрытое состояние и кнопка вставки в редакторе.

LeoSpoiler — раскрывающиеся блоки для Joomla

Дополнительная информация — по нажатию на заголовок

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

Системный плагин заменяет шорткоды на стандартные HTML-элементы <details> и <summary>. Раскрытие работает средствами браузера, поддерживает клавиатуру и не требует отдельной JavaScript-библиотеки.

Что входит в пакет

  • Система — LeoSpoiler 2.1.0. Обрабатывает шорткоды в выводе сайта и создаёт раскрывающиеся блоки.
  • Кнопка редактора — LeoSpoiler 1.0.1. Вставляет шаблон шорткода в текущую позицию курсора. Кнопка необязательна: шорткоды можно добавлять вручную.

Возможности

  • Спойлер может быть закрыт или открыт при загрузке страницы.
  • Внутри сохраняется HTML материала: абзацы, списки, ссылки и другое обычное оформление редактора.
  • Цвета заголовка, его фона, фона при наведении и содержимого меняются в настройках.
  • Заголовок экранируется перед выводом и используется как текст.
  • Стили плагина подключаются только к ответам сайта, где обработан хотя бы один корректный шорткод.
  • Кнопка использует API кнопок редактора Joomla и позволяет менять вставляемый шаблон.

Установка и первый спойлер

  1. Скачайте общий ZIP-пакет с этой страницы. Отдельно распаковывать вложенные архивы не нужно.
  2. В панели Joomla откройте Система → Установка → Расширения и загрузите пакет.
  3. В управлении плагинами включите «Система — LeoSpoiler».
  4. При необходимости включите также кнопку LeoSpoiler для редактора.
  5. Откройте материал и вставьте шорткод вручную или кнопкой редактора. Замените заголовок и содержимое на свои.
  6. Сохраните материал и проверьте его на странице сайта. Обработка выполняется на сайте, а не внутри редактора админки.

Примеры шорткодов

Закрытый блок

{spoiler title="Ответ на вопрос" opened=0}
Здесь находится текст, который посетитель увидит после раскрытия.
{/spoiler}

Открытый блок

{spoiler opened=1 title="Полезное пояснение"}
Этот текст сразу виден. Посетитель может свернуть блок.
{/spoiler}

Без указания начального состояния

{spoiler title="Дополнительная информация"}
Если параметр opened отсутствует, блок изначально закрыт.
{/spoiler}

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

Параметры шорткода
ПараметрОбязателенНазначение
titleДаТекст заголовка, по которому открывается и закрывается блок.
openedНет1 — открыт при загрузке; 0 — закрыт. По умолчанию закрыт.

Кнопка редактора

После включения кнопки LeoSpoiler в поддерживаемом редакторе появляется действие вставки спойлера. Оно добавляет готовую заготовку, в которой можно заменить заголовок, начальное состояние и содержимое.

В настройках плагина кнопки есть поле шаблона. По умолчанию оно вставляет такой текст:

{spoiler title=Правильный ответ opened=1}

{/spoiler}

Для своих заготовок удобно использовать заголовки в кавычках и выбирать opened=0, если новые блоки должны быть закрыты при первом открытии страницы.

Настройка оформления

Цвета меняются в системном плагине LeoSpoiler в разделе оформления.

Исходные цвета в версии 2.1.0
ПараметрЗначение
Цвет заголовка#008aeb
Фон заголовка#f0f0f0
Фон заголовка при наведении#e7e7e7
Фон содержимого#f9f9f9

Частые вопросы

Обязательно ли устанавливать кнопку редактора?

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

Можно ли размещать внутри списки и ссылки?

Да. Содержимое обрабатывается как HTML материала, поэтому обычная разметка редактора сохраняется. Заголовок при этом остаётся текстом.

Почему в редакторе виден шорткод?

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

Можно ли открыть спойлер с клавиатуры?

Плагин использует стандартный элемент HTML details. Его заголовок можно выбрать клавишей Tab и переключить стандартными клавишами браузера, например Enter или пробелом.

Текущий выпуск

Пакет 2.1.0 включает системный плагин 2.1.0 и кнопку редактора 1.0.1. Совместимость Joomla 5+ указана в README автора. Лицензия пакета — GNU GPL версии 2 или более поздней. Исходный ZIP опубликован без изменений и доступен бесплатно.