 |
Сводка | 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 | Позволяет изменить, в каком выводе должен отображаться календарь категории. |
| 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 | Расширяет (в минутах) период после окончания события, в течение которого приглашенные со статусом «иду» все еще получают уведомления об изменениях в исходном посте. |
| 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
Создание событий через API
Вы можете создавать события через POST /posts.json с BBCode [event][/event] в поле raw. Вот подробности о том, как настроить ваш запрос API:
- Используйте
POST /posts.jsonс параметромraw - Синтаксис события:
[event start="2024-05-10 20:00" status="public" timezone="America/Vancouver" end="2024-05-10 21:30" allowedGroups="trust_level_0"]\n[/event] - Литеральный символ новой строки
\nобязателен между открывающим и закрывающим тегами - Двойные кавычки должны быть экранированы при использовании JSON (
\") - Учетная запись пользователя API должна иметь право на создание событий (администратор или группа с правами на создание событий)
- Установите категорию через параметр
category, передав ID категории в качестве значения.
События с прямой трансляцией
Для живых событий используйте функциональность прямой трансляции, чтобы участники могли смотреть событие и участвовать в чате одновременно.
Событие с прямой трансляцией включает:
- Видеопоток (например, через YouTube)
- Событие календаря, используя Discourse Calendar and Events
- Сопроводительный канал чата, автоматически созданный для события
Предварительные требования для событий с прямой трансляцией
Чтобы использовать события с прямой трансляцией, у вас должен быть включен chat enabled, поскольку прямая трансляция создает канал чата для сопровождения вашего события, в дополнение к discourse post event enabled и calendar enabled.
Если вы хотите использовать прямую трансляцию, но не хотите чат в других местах...
- Установите
chat allowed groupsпо умолчанию или включитеtrust_level_0, чтобы позволить новым пользователям участвовать в чате прямой трансляции - Удалите группы из настройки
direct message enabled groups, чтобы предотвратить личные сообщения между пользователями - Не создавайте другие каналы чата
Создание события с прямой трансляцией
Чтобы создать событие с прямой трансляцией:
- Откройте новую тему.
- Выберите значок + на панели инструментов редактора и нажмите Create Event (если событие еще не было добавлено в вашу тему).
- Вставьте ссылку на видео события (например, URL YouTube) в поле место/URL.
- Включите переключатель «прямая трансляция»
Затем вы увидите, что событие и прямая трансляция созданы, а также сопроводительный канал чата справа.
Как только любой пользователь нажмет Going на событии, он автоматически присоединится к каналу чата, что позволит ему участвовать в разговоре!
Прямая трансляция вебинаров Zoom
Вы можете использовать прямую трансляцию для проведения вебинаров Zoom непосредственно в Discourse, чтобы участники могли смотреть событие и участвовать в сопроводительном канале чата, не покидая ваше сообщество.
Предварительные требования для вебинаров Zoom
В дополнение к предварительным требованиям для прямой трансляции, вам также необходимо настроить следующие параметры:
- Включите
livestream zoom enabled - Введите ключ SDK встречи Zoom в настройке
livestream zoom sdk key - Введите секрет SDK встречи Zoom в настройке
livestream zoom sdk secret
Чтобы получить ключ и секрет SDK встречи Zoom:
-
Перейдите на marketplace.zoom.us, нажмите Develop (Разработка), а затем Build app (Создать приложение).
-
Когда вас спросят, какой тип приложения вы создаете, выберите General App (Общее приложение) и нажмите Create (Создать).
-
На странице App Credentials (Учетные данные приложения) скопируйте Client 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/Location. - Включите Livestream (Прямая трансляция).
- Установите название события, время начала, время окончания и другие детали события по желанию.
- Опубликуйте тему.
Как и другие события с прямой трансляцией, это событие будет создано с сопроводительным каналом чата Discourse, к которому участники автоматически присоединятся после подтверждения участия («Going»).
Опыт участника
Вот как ваши участники будут воспринимать вебинар:
До события
Кнопка Join Zoom (Присоединиться к Zoom) отображается за 30 минут до начала события. Вне этого окна кнопка отключена с сообщением о том, когда она станет доступной.
Во время события
После того как участники нажмут Join Zoom, вебинар загрузится на страницу темы (или, если ведущий еще не начал событие, участнику придется подождать, пока он это сделает, чтобы увидеть видео).
Аудиосоединение не устанавливается автоматически при присоединении к вебинару; слушателям необходимо нажать или коснуться значка аудио на панели инструментов Zoom для подключения. Это ограничение SDK Zoom, и его нельзя изменить.
На мобильных устройствах вебинар открывается в полноэкранном виде Zoom (который также доступен на настольных компьютерах путем добавления /zoom в конец URL темы события) с плавающей кнопкой Chat (Чат), которую можно нажать, чтобы открыть панель наложения чата во время события.
После события
Кнопка Join Zoom скрывается через 10 минут после времени окончания события. Канал чата остается доступным для участников, пока вы его не закроете.
Интеграция с другими плагинами
Вы можете использовать компонент этого плагина с Right Sidebar Blocks. Вам нужно убедиться, что желаемый маршрут включен в компонент Right Sidebar Blocks. Имя блока будет upcoming-events-list. Исторически требовались дополнительные настройки в самом плагине Calendar, но это было упрощено.
Вот так будет выглядеть календарь боковой панели по умолчанию.
Если вы не хотите отображать время, вы можете добавить пустое значение timeFormat в настройку блока компонента.
categoryId — это категория, над которой будет отображаться календарь.
postId — это пост, в который вы вставляете календарь с помощью [calendar][/calendar] ↩︎можно отобразить выбор часового пояса в правом верхнем углу календаря. По умолчанию false, можно включить с помощью tzPicker=true ↩︎
можно скрыть субботы и воскресенья из календаря. По умолчанию true. Можно установить false с помощью weekends=false. ↩︎
defaultView установит вид календаря (день, неделя и т.д.). Можно установить как:
defaultView=agendaDay
defaultView=agendaWeek
defaultView=month (по умолчанию)
defaultView=listNextYear ↩︎