 |
Резюме | Discourse Calendar and Events добавляет динамические и интерактивные функции календаря и событий на ваш сайт Discourse. |
 |
Руководство по установке | Этот плагин включен в ядро Discourse. Отдельная установка плагина не требуется. |
Включение календаря и событий
Плагин «Календарь и события» можно включить либо с помощью переключателя, либо через его настройки; оба варианта доступны на странице admin/plugins:
Возможности
Вполне ожидаемо, что Discourse Calendar and Events добавляет на ваш сайт Discourse функции календаря и событий. С их помощью вы можете создавать индивидуальные календари тем для отслеживания важных событий или временных шкал, отображать календари в категориях, добавлять праздничный календарь для отметки отпусков, отсутствия или больничных, создавать интерактивные темы событий, а также показывать удобную сводку всех предстоящих событий.
Календари
Нестандартные календари можно создавать в нескольких темах, а те, которым вы хотите придать большую видимость, можно отображать над списком тем категории.
Более подробную информацию о создании и использовании календарей вы найдете здесь:
События
Функция «События» позволяет добавлять в темы интерактивные элементы, с помощью которых участники могут зарегистрироваться для участия в мероприятиях вашего сообщества. Все они сводятся в отдельный общесайтовый календарь, с возможностью добавления удобной ссылки в меню навигации. Подробнее о создании и использовании этой функции читайте здесь:
Не путайте это с плагином Events от 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 | Время начала событий, для которых не указано время начала. Формат HH:mm. Для 6:00 утра введите 06:00. |
| all day event end time | Время окончания событий, для которых не указано время окончания. Формат HH:mm. Для 6: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
Трансляции в прямом эфире
Для живых событий используйте функцию трансляции, чтобы участники могли смотреть событие и одновременно участвовать в чате.
Событие трансляции включает:
- Видеопоток (например, с YouTube)
- Событие в календаре, созданное через Discourse Calendar and Events
- Автоматически созданный сопутствующий канал чата для события
Требования для трансляций в прямом эфире
Для использования трансляций в прямом эфире необходимо включить chat enabled, так как трансляция создает канал чата для вашего события, а также должны быть включены discourse post event enabled и calendar enabled.
Настройка трансляции
Есть несколько настроек для конфигурации:
livestream enabled: Включите эту опцию, чтобы использовать события трансляции.livestream chat allowed groups: УстановитеTrust Level 0, чтобы разрешить всем авторизованным пользователям общаться во время события.
Создание события трансляции
Чтобы создать событие трансляции:
- Откройте новую тему.
- Вставьте ссылку на видео события (например, URL YouTube) в редактор.
- Нажмите на значок + в панели инструментов редактора и выберите Создать событие (если событие еще не добавлено в вашу тему), затем обновите его деталями события.
- Добавьте тег
#livestreamв тему.
После этого вы увидите, что событие и трансляция созданы, а также появится сопутствующий канал чата справа.
Как только любой пользователь нажмет Я иду на событии, он автоматически присоединится к каналу чата, что позволит ему участвовать в обсуждении!
Интеграция с другими плагинами
Вы можете использовать компонент этого плагина с 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 ↩︎