 |
Резюме | Discourse Calendar and Events добавляет динамические и интерактивные функции календаря и событий на ваш сайт Discourse. |
 |
Руководство по установке | Этот плагин включён в ядро Discourse. Отдельная установка плагина не требуется. |
Включение календаря и событий
Плагин «Календарь и события» можно включить либо с помощью переключателя, либо через его настройки; оба варианта доступны на странице admin/plugins:
Функции
В некоторой степени предсказуемо, Discourse Calendar and Events добавляет на ваш сайт Discourse как функции календаря, так и функции событий. С их помощью вы можете создавать индивидуальные календари тем для отслеживания важных событий или временных линий, отображать календари в категориях, добавлять праздничный календарь для обозначения отпусков, отсутствия или больничных, создавать интерактивные темы событий, а также показывать легкодоступное резюме календаря со всеми предстоящими событиями.
Календари
Настраиваемые календари можно создавать в нескольких темах, а те, которым вы хотите придать более высокую видимость, можно отображать над списком тем категории.
Более подробную информацию о том, как создавать и использовать календари, вы найдёте здесь:
События
Функция «События» позволяет вставлять интерактивные элементы в темы, которые ваши участники могут использовать для регистрации на участие в мероприятиях вашего сообщества. Все они суммируются в специальном общесайтовом календаре, с возможностью добавить легкодоступную ссылку в меню навигации. Подробную информацию о том, как создавать и использовать эту функцию, вы найдёте здесь:
Не следует путать это с плагином «События» от Pavilion (обратите внимание на множественное число).
Настройки календаря
| Имя | Описание |
|---|---|
| calendar enabled | Включить плагин discourse-calendar. Это добавит поддержку тега [calendar][/calendar] в первом посте темы. |
| holiday calendar topic id | ID темы календаря праздников/отсутствия сотрудников. |
| holiday status emoji | Определяет эмодзи, используемый для статуса праздника. |
| delete expired event posts after | Посты с истёкшими событиями будут автоматически удаляться через (n) часов. Установите значение -1, чтобы отключить удаление. |
| all day event start time | События, для которых не указано время начала, будут начинаться в это время. Формат: ЧЧ:мм. Для 6:00 утра введите 06:00. |
| all day event end time | События, для которых не указано время окончания, будут заканчиваться в это время. Формат: ЧЧ:мм. Для 18:00 введите 18:00. |
| calendar categories | Отображение календаря в верхней части категории. Обязательные настройки: categoryId и postId. Например: categoryId=6;postId=453[1]. Другие допустимые настройки: tzPicker[2], weekends[3] и defaultView[4]. |
| calendar categories outlet | Позволяет изменить, какой outlet должен отображать календарь категории. |
| working days | Установите рабочие дни. Вы можете отобразить доступность группы, используя тег timezones в посте, например: [timezones group=admins][timezones]. |
| working day start hour | Время начала рабочего дня. |
| working day end hour | Время окончания рабочего дня. |
| close to working day hours extension | Установите время расширения рабочего дня для подсветки часовых поясов. |
| calendar automatic holidays enabled | Автоматически устанавливать статус праздника на основе региона пользователя (примечание: вы можете отключить конкретные автоматические праздники в настройках плагина). |
| map events title | Отображает заголовок бокового календаря событий в зависимости от категории. По умолчанию: «Предстоящие события». |
Настройки событий
| Имя | Описание |
|---|---|
| discourse post event enabled | Включает функции событий. Примечание: также необходимо включить настройку calendar enabled. |
| discourse post event allowed on groups | Группы, которым разрешено создавать события. |
| displayed invitees limit | Ограничивает количество отображаемых приглашённых на событии. |
| display post event date on topic title | Отображает дату события после заголовка темы. |
| use local event date | Использовать локальную дату после заголовка темы вместо относительного времени. |
| discourse post event edit notifications time extension | Увеличивает (в минутах) период после окончания события, в течение которого приглашённые со статусом going продолжают получать уведомления об изменениях в оригинальном посте. |
| discourse post event allowed custom fields | Позволяет каждому событию устанавливать значение пользовательских полей. |
| events calendar categories | Отображение календаря событий в верхней части категории. |
| sort categories by event start date enabled | Включить сортировку тем категории по дате начала события. |
| disable resorting on categories enabled | Разрешить категориям отключать возможность сортировки пользователями по событиям категории. |
| sidebar show upcoming events | Отображать ссылку «Предстоящие события» в боковой панели под разделом «Ещё». Требуется включение post event enabled. |
| map events to color | Назначает цвет события для указанного тега или категории. |
Эндпоинт
discourse-post-event/events.jsonтеперь имеет дополнительный параметр для переключения между простым и подробным ответом. Чтобы получить подробный ответ, добавьте?include_details=true:
/discourse-post-event/events.json?include_details=true
Интеграция с другими плагинами
Вы можете использовать компонент этого плагина с Right Sidebar Blocks. Убедитесь, что нужный маршрут включён в компонент Right Sidebar Blocks. Имя блока будет upcoming-events-list. Исторически в самом плагине Calendar требовались дополнительные настройки, но сейчас этот процесс упрощён.
Так по умолчанию будет выглядеть боковой календарь.
Если вы не хотите отображать время, вы можете добавить пустое значение timeFormat в настройках блока компонента.
Размещено нами? Этот плагин доступен на наших тарифах Business и Enterprise: Calendar | Discourse - Civilized Discussion
categoryId — это категория, над которой будет отображаться календарь.
postId — это пост, в который вы поместили календарь с помощью[calendar][/calendar]. ↩︎можно отобразить выборщик часового пояса в правом верхнем углу календаря. По умолчанию выключено, можно включить с помощью
tzPicker=true. ↩︎можно скрыть субботы и воскресенья из календаря. По умолчанию включено. Можно отключить с помощью
weekends=false. ↩︎defaultView устанавливает вид календаря (день, неделя и т. д.). Может быть установлено как:
defaultView=agendaDay
defaultView=agendaWeek
defaultView=month(по умолчанию)
defaultView=listNextYear↩︎