 |
Краткое описание | Discourse Calendar and Events добавляет динамические и интерактивные функции календаря и событий на ваш сайт Discourse. |
 |
Руководство по установке | Этот плагин встроен в ядро Discourse. Отдельная установка плагина не требуется. |
Включение календаря и событий
Плагин Calendar and Events можно включить с помощью переключателя или через его настройки, доступные на странице admin/plugins:
Возможности
Как и следовало ожидать, Discourse Calendar and Events добавляет на ваш сайт Discourse функции календаря и событий. С их помощью вы можете:
- создавать индивидуальные календари тем для отслеживания важных дат или временных рамок;
- отображать календари в категориях;
- добавлять календарь праздников для отметки отпусков, отсутствия или больничных;
- создавать интерактивные темы событий;
- а также показывать сводку всех предстоящих событий в удобном календаре.
Календари
Специальные календари можно создавать в нескольких темах, а те, которым вы хотите придать большую заметность, можно отображать над списком тем категории.
Более подробную информацию о том, как создавать и использовать календари, вы найдете здесь:
События
Функция событий позволяет добавлять в темы интерактивные элементы, с помощью которых ваши участники могут регистрироваться для участия или присутствия на мероприятиях вашего сообщества. Все они сводятся в общий календарь всего сайта, с возможностью добавить быструю ссылку в меню навигации. Более подробную информацию о том, как создавать и использовать эту функцию, вы найдете здесь:
Это не следует путать с плагином Pavilion Events plugin (обратите внимание на множественное число)
Настройки календаря
| Имя | Описание |
|---|---|
| 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 | Заголовок бокового календаря на основе категории. По умолчанию «Upcoming events». |
Настройки событий
| Имя | Описание |
|---|---|
| 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 | Отображать ссылку на предстоящие события в боковой панели в разделе «More». Требуется post event enabled. |
| map events to color | Назначает цвет события указанному тегу или категории. |
Эндпоинт
discourse-post-event/events.jsonтеперь имеет дополнительный параметр для переключения между простым и подробным ответом. Чтобы получить подробный ответ, добавьте?include_details=true:
/discourse-post-event/events.json?include_details=true
Трансляции событий
Для живых событий используйте функцию трансляции, чтобы участники могли смотреть событие и участвовать в чате одновременно.
Трансляция события включает:
- Видеопоток (например, с YouTube);
- Событие календаря, созданное по инструкции Discourse Calendar and Events;
- Автоматически создаваемый для события канал чат.
Требования для трансляций событий
Для использования трансляций событий необходимо включить chat enabled, так как трансляция создает канал чата для сопровождения вашего события, а также требуется discourse post event enabled и calendar enabled.
Создание трансляции события
Чтобы создать трансляцию события:
- Откройте новую тему.
- Выберите значок + на панели инструментов редактора и нажмите Create Event (если событие еще не было добавлено в вашу тему).
- Вставьте ссылку на видео события (например, URL YouTube) в поле «Место/URL».
- Включите переключатель «livestream».
Затем вы увидите, что событие и трансляция созданы, а справа появится сопутствующий канал чата.
Как только любой пользователь нажмет Going в событии, он автоматически присоединится к каналу чата, что позволит ему участвовать в разговоре!
Интеграция с другими плагинами
Вы можете использовать компонент из этого плагина с Right Sidebar Blocks. Убедитесь, что нужный маршрут включен в компонент Right Sidebar Blocks. Имя блока будет upcoming-events-list. Ранее для этого требовались дополнительные настройки в самом плагине Calendar, но теперь процесс был упрощен.
Так будет выглядеть боковой календарь по умолчанию.
Если вы не хотите отображать время, вы можете добавить пустое значение timeFormat в настройке блока компонента.
Если ваш сайт размещается у нас? Этот плагин доступен на наших тарифах Business и Enterprise Calendar | Discourse - Civilized Discussion
categoryId — категория, над которой будет отображаться календарь.
postId — сообщение, в котором размещается календарь с помощью [calendar][/calendar] ↩︎позволяет отображать выбор часового пояса в правом верхнем углу календаря. По умолчанию False, можно включить с помощью tzPicker=true ↩︎
позволяет скрыть субботу и воскресенье из календаря. По умолчанию True. Можно отключить с помощью weekends=false. ↩︎
defaultView устанавливает вид календаря (день, неделя и т.д.). Может быть установлен как:
defaultView=agendaDay
defaultView=agendaWeek
defaultView=month (по умолчанию)
defaultView=listNextYear ↩︎