Календарь основан на той же javascript-библиотеке, что и myCalendar, только имеет более широкие возможности.

Основные отличия

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

Управление календарями

Для того, чтобы вывести календарь на сайте, нужно сначала его создать. Делается это в админке.

Тут же можно указать ряд настроек: цвет текста, цвет события, класс календаря.

Для Google календаря вводим название календаря, которое нужно получить в кабинете разработчиков Google. Как это сделать описано тут. Не забываем при этом про системную настройку, в которой указываем ключ Google Calendar API Key.

Система уведомлений

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

— если у события есть автор, то уведомляем его,

— если автора нет (аноним), то уведомляем текущего авторизованного пользователя,

— если текущий пользователь не авторизован, то отбой.

Для управления уведомлениями есть 2 системные настройки:

1. Онлайн-уведомления — включает/отключает уведомление на сайте.
2. Уведомления по почте — включает/отключает уведомление по почте.

Такие события имеют класс notified-event для дополнительной css настройки.

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

Повторяющиеся события

Для любого календаря — это важный элемент. Функционал достаточно простой, но основные функции выполняет — повтор каждый день, каждую неделю, каждый месяц, каждый год. Возможно в дальнейшем сделаю более сложный алгоритм. Если будет востребовано.

Отличить повторяющиеся события от обычных можно по значку. Как и события с уведомлением.

Повторяющиеся события имеют класс repeated-event.

Личные события

Авторизованный пользователь может отметить событие как личное. Такие события при вызове календаря с параметром

showPrivate=`0`

посторонним пользователям отображаться не будут. Но даже если разрешить показывать личные сообщения (showPrivate=`1`), то редактировать их сможет только сам автор и админ, авторизованный в backend. Если пользователь не авторизован, то чекбокс Личное становится недоступным.

У таких событий css класс private-event.

Минимальная длительность события 30 мин.

Теперь, когда календарь создан, можно его вызывать

[[!fullCalendar? &calendars=`1`]]

Для вызова нескольких календарей на странице используем параметр calendar и не забывает, что каждый вызов fullCalendar нужно обзывать через instance. Если вызываем только один раз, то instance можно не указывать.

[[!fullCalendar? &instance=`calendar1` &calendars=`1`]]
[[!fullCalendar? &instance=`calendar2` &calendars=`2,3`]]

В планах научиться редактировать события Google календаря через API Google, поиск событий.

Обсуждение компонента в сообществе MODX.PRO

Со всеми возможностями компонента можно познакомиться на сайте компонента.