unicalendar/README.md

Unicalendar

Модуль Unicalendar - календарь событий v3.32

для AVE.CMS ALT ≥ v3.31

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

• Пример работы с модулем Календарь:
  • Создайте рубрику "Календарь" которая будет содержать в себе следующие поля:
    • Название события
    • Место проведения события
    • Описание события
    • Изображение (тип поля Изображение (Одиночное))
    • Дата начала события (тип поля Дата (Unix Timestamp))
    • Дата завершения события (тип поля Дата (Unix Timestamp))
  • Создайте документ в рубрике "Календарь" и заполните в нем эти поля.
  • Скачайте архив с модулем unicalendar-main.zip и положите его в папку modules, разархивируйте, после чего у вас появится папка unicalendar, ее оставляем архив unicalendar-main.zip удаляем.
  • Перейдите в раздел управления модулями вкладка Неустановленные модули, установите модуль Универсальный календарь событий.
  • Перейдите к управлению модулем вкладка Создать календарь, выберите тип событий календаря, далее выберите рубрику и вам станет доступным выбор полей для создания тизера события.
  • Выбор полей для создания тизера события:
    • Название события - по умолчанию используется содержимое тега <titel></title> но вы можете использовать поле из документа.
    • Изображение - выберите поле Изображение (Одиночное). Если оставить это поле пустым - календарь просто проигнорирует его.
    • Описание события - используйте нужное вам поле из документа. Важно - все HTML теги, если они имеются, будут очищены, выведется только текст.
    • Место события - используйте нужное вам поле из документа. Если оставить это поле пустым - календарь просто проигнорирует его.
    • Дата начала - по умолчанию используется дата и время создания документа. Однако, если вам понадобится указать более позднюю дату, например документ создан 20 апреля , а вы хотите в календаре установить дату события 1 мая - используйте для этого в документе поле Дата (Unix Timestamp), это позволит выбрать дату и время в правильном формате. Если использовать текстовое поле, запишите дату и время в таком формате: 01-05-2026 19:00
    • Дата завершения - полностью аналогична Дате начала.
    • Кликните кнопку "Создать". Ваш календарь будет готов к использованию после размещения системного тега [mod_unicalendar:XXX] в документе или Основном шаблоне или в шаблоне Рубрики.
• Календарь в публичной части сайта не делает запросов к базе данных. Создавая календарь вы создаете js файл с данными с которыми он работает. Поэтому, если вы, создав и сохранив календарь решили сделать в документе какие либо изменения - правки в полях, датах документа или меняете название документа - <titel></title>, обязательно после сохранения документа или удаления документа, пересохраните для актуальности календарь использующий данные из этого документа. Таким образом вы обновите js файл с данными и календарь будет актуальным.
• Используйте файл eventCalendar.css, подключается программно при использовании модуля и расположен в каталоге modules/unicalendar/css/, для редактирования некоторых стилей календаря. Непосредственно разметка вывода находится в файле jquery.eventCalendar.js

Changelog:

27.03.2026 - обновление модуля - версия 3.32 - рефакторинг кода для работы в ave.cms ALT v3.31. Добавлен выбор полей для Названия событий и даты начала и завершения события, обновлен дизайн календаря.

05.09.2019 - обновление модуля - версия 1.26.8 - адаптация для версии ave.cms 3.26, замена устаревшего size() на length

08.09.2017 - обновление модуля - версия 1.2.8 - Fix регулярного выражения для сохранения в файл (dataX.js) в кодировке UTF-8

04.09.2017 - обновление модуля - версия 1.2.7 - Добавлено создание тизера событий из существующих полей в документе (изображение, описание, место)

01.07.2017 - обновление модуля - версия 1.2.6 - Добавлен лимит вывода событий при перелистывании месяцев в календаре (лимит не распространяется на клик по дате с событиями)

25.06.2017 - обновление модуля - версия 1.2.5 - Добавлен выбор формата даты для публичной части календаря, проверка условий при создании календаря

15.05.2017 - обновление модуля - версия 1.2.4 - Исправлено: jQuery Form Styler - ограничивал раскрытие select по высоте; Исправлено ленг файл .php будет подключаться, в зависимости от языка Администратора (в админ-панели) и Пользователя (в публичной части)

14.05.2017 - обновление модуля - версия 1.2.3 - изменен алгоритм проверки актуальности календарей

09.05.2017 - обновление модуля - версия 1.2.2 - добавлена проверка актуальности календарей при изменении количества документов в рубрике после создания календаря

06.05.2017 - обновление модуля - версия 1.2.1 - оптимизация запросов БД для публичной части модуля

05.05.2017 - обновление модуля - версия 1.2 - исправление ошибок, добавлено редактирование календарей, скрипты вынесены в секцию <head>

10.04.2017 - обновление модуля - версия 1.1.2 - fix вывода документа - ошибка 404.

10.04.2017 - обновление модуля - версия 1.1.1 - fix для корректной работы модуля с версиями php начиная с =>5.3.13

09.04.2017 - обновление модуля - версия 1.1 (требуется чистая установка: полное удаление версии 1.0 и вместо нее залить все файлы v1.1)

09.04.2017 - инициализация модуля - версия 1.0