 |
Краткое описание | 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 | События, для которых не указано время начала, начнутся в это время. Формат ЧЧ:мм. Для 6:00 утра введите 06:00 |
| all day event end time | События, для которых не указано время окончания, закончатся в это время. Формат ЧЧ:мм. Для 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.
Создание события с прямой трансляцией
Чтобы создать событие с прямой трансляцией:
- Откройте новую тему.
- Выберите значок + на панели инструментов редактора и нажмите Create Event (создать событие) (если событие еще не было добавлено к вашей теме).
- Вставьте ссылку на видео события (например, URL YouTube) в поле место/URL.
- Включите переключатель “livestream” (прямая трансляция)
Затем вы увидите, что событие и прямая трансляция созданы, а также сопровождающий чат-канал справа.
Как только любой пользователь нажмет Going (иду) на событии, он автоматически присоединится к чат-каналу, что позволит ему участвовать в разговоре!
Прямая трансляция вебинаров Zoom
Вы можете использовать прямую трансляцию для проведения вебинаров Zoom непосредственно в Discourse, чтобы участники могли смотреть событие и участвовать в сопровождающем чат-канале, не покидая ваше сообщество.
Требования для вебинаров Zoom
В дополнение к требованиям для прямой трансляции, вам также необходимо настроить следующие параметры:
- Включите
livestream zoom enabled - Введите ключ Zoom Meeting SDK в настройке
livestream zoom sdk key - Введите секрет Zoom Meeting SDK в настройке
livestream zoom sdk secret
Чтобы получить ключ и секрет Zoom Meeting SDK:
-
Перейдите на marketplace.zoom.us, нажмите Develop (Разработка) и нажмите Build app (Создать приложение).
-
Когда вас спросят, какой тип приложения вы создаете, выберите General App (Общее приложение) и нажмите Create (Создать).
-
На странице App Credentials (Учетные данные приложения) скопируйте Client ID (ID клиента, который является SDK Key) и Client Secret (Секрет клиента, который является SDK Secret).
-
В разделе Embed (Встраивание) включите разрешение Meeting SDK.
-
В вашем Discourse перейдите в Admin → All site settings (Админ → Все настройки сайта) и введите значения из шага 3 в
livestream zoom sdk keyиlivestream zoom sdk secret.
Чтобы вебинар Zoom работал корректно в Discourse:
-
Для подключения к вебинару не должно требоваться регистрация или пароль.
-
Отключите встроенный чат вебинара Zoom, чтобы обеспечить обсуждение в единственном чат-канале Discourse, сохраняя все чаты в одном месте и гарантируя, что разговор может продолжаться после окончания вебинара.
Создание события с прямой трансляцией вебинара Zoom
Чтобы создать событие с прямой трансляцией для вашего вебинара Zoom:
- Откройте новую тему, выберите значок + и нажмите Create Event (Создать событие).
- Вставьте ссылку на ваш вебинар Zoom (например,
https://zoom.us/``...) в поле URL/Место. - Включите Livestream (Прямая трансляция).
- Установите название события, время начала, время окончания и другие детали события по желанию.
- Опубликуйте тему.
Как и другие события с прямой трансляцией, это событие будет создано с сопровождающим чат-каналом Discourse, к которому участники автоматически присоединятся после того, как отметят статус «Иду».
Опыт участников
Вот как ваши участники будут воспринимать вебинар:
До события
Кнопка Join Zoom (Подключиться к Zoom) отображается за 30 минут до начала события. Вне этого окна кнопка отключена с сообщением о том, когда она станет доступной.
Во время события
Когда участники нажимают Join Zoom, вебинар загружается на страницу темы (или, если ведущий еще не начал событие, участнику придется подождать, пока он это сделает, чтобы увидеть видео).
Аудиосоединение не устанавливается автоматически при подключении к вебинару; участникам необходимо нажать или коснуться значка аудио на панели инструментов Zoom, чтобы подключиться. Это ограничение Zoom SDK, и его нельзя изменить.
На мобильных устройствах вебинар открывается в полноэкранном режиме Zoom (который также доступен на настольных компьютерах путем добавления /zoom в конец URL темы события) с плавающей кнопкой Chat (Чат), на которую можно нажать, чтобы открыть панель наложения чата во время события.
После события
Кнопка Join Zoom скрывается через 10 минут после времени окончания события. Чат-канал остается доступным для участников до тех пор, пока вы его не закроете.
Интеграция с другими плагинами
Вы можете использовать компонент из этого плагина с Right Sidebar Blocks. Вам нужно убедиться, что желаемый маршрут включен в компонент Right Sidebar Blocks. Имя блока будет upcoming-events-list. Исторически требовались дополнительные настройки в самом плагине Календаря, но теперь это упрощено.
Так будет выглядеть календарь боковой панели по умолчанию.
Если вы не хотите отображать время, вы можете добавить пустое значение timeFormat в настройку блока компонента.
categoryId — это категория, над которой будет отображаться календарь.
postId — это пост, в который вы помещаете календарь с помощью [calendar][/calendar] ↩︎можно отобразить выбор часового пояса в правом верхнем углу календаря. По умолчанию false, можно включить с помощью tzPicker=true ↩︎
можно скрыть субботы и воскресенья из календаря. По умолчанию true. Можно установить false с помощью weekends=false. ↩︎
defaultView установит вид календаря (день, неделя и т.д.). Можно установить как:
defaultView=agendaDay
defaultView=agendaWeek
defaultView=month (по умолчанию)
defaultView=listNextYear ↩︎