BSL Daily Content — бесплатный content-плагин для
Joomla 5 и
Joomla 6, который позволяет связать отдельные материалы с календарными датами в формате
DD-MM и вывести их на общей странице или в модуле
Joomla Custom с записью на сегодняшний день.
Плагин подходит для сайтов, где каждому дню года соответствует отдельная запись: праздник, цитата, историческое событие, анекдот, гороскоп, аффирмация, совет, рецепт или любой другой ежедневный контент.
У меня задача была более конкретной: я публикую на своём сайте комментарии к записям «Ежедневных размышлений Анонимных Алкоголиков». Для каждой даты нужен отдельный обычный материал
Joomla, но посетитель должен получать запись за выбранный день на одной общей странице, а на главной — в модуле
Joomla Custom с текстом на сегодня.
Первоначально плагин создавался только для этой задачи и назывался
BSL Daily Reflections. Затем он был переработан в универсальное расширение, не привязанное к конкретной тематике, категориям или заранее заданной языковой паре.
Как это работаетШтатные даты материала
Joomla для этой задачи не подходят. Они содержат год и управляют жизненным циклом публикации: когда материал создан, изменён, опубликован или снят с публикации. Но запись «25 декабря» должна занимать своё место в календаре ежегодно — независимо от года её создания и сроков публикации.
Поэтому плагину нужен отдельный календарный признак, содержащий только день и месяц. После выбора языка и категории в настройках
BSL Daily Content создаёт служебное поле
Daily Content date. В редакторе материалов выбранной категории появляется вкладка
Daily Content, где указывается повторяющаяся дата в формате
DD-MM, например
25-12. Она определяет день показа записи, но не заменяет штатные даты
Joomla.
Каждая дата может использоваться только один раз внутри одной категории. Если попытаться назначить ту же дату второму материалу, плагин предупредит о дублировании.
Место вывода задаётся короткими безопасными командами — шорткодами. Это позволяет не вставлять в материал или модуль исполняемый код и сложную HTML-разметку, которые визуальный редактор
Joomla может удалить или изменить при сохранении. Не нужно отключать редактор глобально или каждый раз восстанавливать повреждённый код: в содержимом остаётся только простая команда в фигурных скобках, а настоящий интерфейс, календарь, текст материала и ссылки формирует сам плагин.
Для общей страницы ежедневных материалов используется шорткод:
Для записи на сегодняшний день в модуле
Joomla Custom используется:
Если записи для выбранной даты пока нет, посетитель увидит понятное сообщение об отсутствии материала.
Что нового в версии 1.3.2В
версии 1.3.2 календарь стал удобнее на границе месяцев: теперь он показывает полные календарные недели.
- в первой строке могут отображаться последние даты предыдущего месяца;
- в последней строке могут отображаться первые даты следующего месяца;
- даты соседних месяцев выглядят бледнее, но остаются полностью кликабельными;
- нужную дату предыдущего или следующего месяца можно выбрать сразу, не переключая месяц заранее;
- после выбора календарь показывает месяц выбранной даты;
- отметки доступных материалов, сегодняшней и выбранной даты, наведение и клавиатурный фокус работают и для дат соседних месяцев;
- шестая строка добавляется только тогда, когда она действительно нужна календарной сетке.
Например, если в последней неделе уже видны второе или третье число следующего месяца, нужную дату можно открыть одним нажатием. Обновление сохраняет материалы, введённые даты, категории, языковые настройки, шорткоды и существующие параметры календаря.
Что нового в версии 1.3.1Версия 1.3.1 добавляет полноценное управление акцентным цветом календаря.
В настройках плагина администратор может выбрать источник цвета:
- заголовок H1, H2, H3, H4, H5 или H6;
- навигация шаблона;
- ссылки;
- собственный цвет в формате HEX.
Плагин автоматически подбирает контрастный цвет текста для выбранного фона.
В описании
версии 1.3.0 я поторопился с утверждением, что управляющие цвета календаря адаптируются к активному шаблону
Joomla. Дополнительная проверка на
Helix Ultimate показала, что фактически календарь продолжал использовать исходный синий цвет. В
версии 1.3.1 этот механизм был не только исправлен, но и дополнен ручным выбором источника цвета и возможностью указать собственный цвет.
Что нового в версии 1.3.0Раньше дата на полной странице выбиралась через два отдельных списка — день и месяц. Механизм работал, но выглядел как техническая форма. В
версии 1.3.0 его заменил компактный месячный календарь.
- календарь по умолчанию свёрнут и раскрывается по строке выбора даты;
- стрелки позволяют переходить между месяцами;
- даты, для которых существуют доступные опубликованные материалы, отмечаются в сетке;
- сегодняшняя и выбранная даты выделяются отдельно;
- календарь остаётся открытым, пока посетитель сам его не закроет;
- прозрачность подложки настраивается ползунком;
- кнопка Aa позволяет посетителю выбрать размер Small, Medium или Large, включить Bold и сбросить настройки;
- выбранное оформление сохраняется в браузере.
При обновлении сохраняются существующие материалы, даты, категории, языковые настройки, ссылки и шорткоды.
Что произошло с версией 1.2.0Версия 1.2.0 была протеряна в ходе интенсивной разработки: номер мы — я и мой ИИ-ассистент — использовать успели, а оформить отдельный публичный релиз, сохранить архив и создать тег — нет. Все законченные изменения вошли в
версию 1.3.0.
Основные возможности- отдельный обычный материал Joomla для каждой календарной даты;
- служебная дата в формате DD-MM, не зависящая от года, даты создания или публикации материала;
- полная страница ежедневного контента с компактным месячным календарём;
- полные календарные недели с приглушёнными, но кликабельными датами соседних месяцев;
- выбор дат предыдущего или следующего месяца одним нажатием без предварительного переключения месяца;
- навигация между месяцами, отметки доступных дат и выделение сегодняшней и выбранной даты;
- настраиваемая прозрачность, управляемый источник акцентного цвета и пользовательская панель Aa;
- вывод записи на сегодняшний день в модуле Joomla Custom;
- ссылка из модуля Joomla Custom на соответствующую запись полной страницы;
- отдельная ветка комментариев JComments для каждой календарной записи;
- защита от повторного назначения одной даты внутри категории;
- автоматическое открытие вкладки Daily Content при выборе настроенной категории;
- основной и необязательный дополнительный язык контента;
- поддержка любых двух опубликованных языков Joomla;
- отдельная категория и отдельная цель ссылки для каждого языка;
- корректная работа со штатными ассоциациями материалов и переключателем языков Joomla;
- сохранение материалов и назначенных дат при изменении категорий в настройках;
- автоматические обновления через Joomla Update System;
- английский и русский языки интерфейса плагина.
МультиязычностьВ настройках выбирается один основной язык и при необходимости второй. Это могут быть любые два опубликованных языка контента
Joomla — плагин не привязан к русскому и английскому.
Для каждого языка назначается собственная категория материалов. Если сайту нужен только один язык, настройки второго языка можно оставить пустыми.
Работа плагина проверена на трёхъязычном тестовом сайте с русским, английским и немецким языками. Языки менялись местами в настройках, материалы и модули корректно переключались, а сохранённые даты не терялись.
Обновление и миграцияВерсия 1.3.2 поддерживает штатное обновление предыдущих выпусков
BSL Daily Content и перенос настроек со старого плагина
BSL Daily Reflections.
При миграции сохраняются:
- категории;
- пункты меню, используемые как цели ссылок;
- поле даты;
- ранее сохранённые значения дат;
- существующие материалы.
Установка- Установить ZIP-пакет через штатный установщик Joomla.
- Открыть настройки плагина Content - BSL Daily Content.
- Выбрать основной язык и категорию материалов.
- При необходимости настроить второй язык и его категорию.
- Сохранить настройки.
Создать материал для полной страницы и поместить в него:
При необходимости создать модуль
Joomla Custom и поместить в него:
Кэширование и смена даты в полночьBSL Daily Content не создаёт отдельный кэш для записи на сегодняшний день. Однако шорткод
выполняется внутри модуля
Joomla Custom.
Если для
Advanced → Caching выбрано
Use Global,
Joomla может продолжать показывать блок, сформированный до полуночи, пока не истечёт
Cache Time. Если запись должна сменяться сразу после наступления новых суток, выберите
Advanced → Caching → No Caching. Уже открытую в браузере страницу потребуется обновить. Кэш всей страницы, веб-сервера или CDN настраивается отдельно.
Совместимость и требования- Joomla 5.x или Joomla 6.x;
- PHP 8.3 или новее;
- один установочный пакет для обеих версий Joomla;
- сторонние библиотеки и внешние сервисы не требуются.
Чистая установка и обновление проверены на
Joomla 5 и
Joomla 6. Отдельно проверялись полные страницы, модули
Joomla Custom, переключение языков, защита от дублей дат, удаление и повторная установка плагина, а также миграция со старого расширения без потери сохранённых значений.
Текущая версия1.3.2Условия распространенияПлагин распространяется бесплатно на условиях
GNU General Public License версии 2 или более поздней.
СсылкиBSL Daily Content прошёл модерацию и опубликован в официальном каталоге
Joomla Extensions Directory.
Буду признателен за проверку плагина на других сайтах, шаблонах, языках и конфигурациях
Joomla 5/6. Сообщения об ошибках, замечания, вопросы по настройке и предложения можно оставлять непосредственно в этой теме.
Сейчас я нахожусь в активном поиске работы.Подробнее о моём профессиональном опыте, инженерном подходе и роли в создании продуктов
BSL-World можно прочитать в материале
«Честное резюме».