События Discourse

[Discourse]

	Краткое описание	Discourse Events добавляет динамические и интерактивные функции календаря и событий на ваш сайт Discourse.
	Руководство по установке	Этот плагин входит в ядро Discourse. Отдельная установка плагина не требуется.

Поскольку это #официальный плагин, поддерживаемый командой Discourse, запросы на #поддержку, #вклад:bug, #вклад:ux и #вклад:feature можно отправлять в соответствующие категории здесь, на Meta, с соответствующими тегами плагина. Нажмите на ссылку ниже, чтобы начать.

Поддержка Ошибка UX Функция

Включение событий

Плагин Events можно включить с помощью переключателя или из его настроек, оба доступны на странице admin/plugins:

У нас хостинг? Этот плаген доступен на наших тарифных планах Business и Enterprise https://www.discourse.org/plugins/calendar.html

Функции

Что неудивительно, Discourse Events добавляет как функции календаря, так и функции событий на ваш сайт Discourse. С их помощью вы можете создавать отдельные календари тем для отслеживания важных событий или таймлайнов, отображать календари в категориях, добавлять календарь праздников для отметки отпусков, отсутствия или больничных, создавать интерактивные темы событий, а также отображать удобный календарный обзор всех ваших предстоящих событий.

Календари

Специальные календари могут быть созданы в нескольких темах, а те, которым вы хотите придать более высокую видимость, могут отображаться над списком тем категории.

Более подробную информацию о том, как создавать и использовать календари, можно найти здесь:

Создание и управление календарями

Это руководство объясняет, как создавать и управлять календарями в Discourse с помощью плагина Calendar (и Event). Требуемый уровень пользователя: Все пользователи Календари — это мощная функция в Discourse, позволяющая организовывать и отображать события внутри вашего сообщества. Это руководство проведет вас через процесс создания календарей, добавления событий и их эффективного управления. Краткое содержание Включение плагина Calendar Создание календаря в…

События

Функция 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	Включает функции Events. Примечание: также необходимо, чтобы 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

Создание событий через 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 Events
• Сопутствующий чат канал, автоматически созданный для события

Требования к событиям с прямым эфиром

Для использования событий с прямым эфиром у вас должен быть включен chat enabled, поскольку прямой эфир создает чат-канал, сопровождающий ваше событие, в дополнение к discourse post event enabled и calendar enabled.

Если вы хотите использовать прямой эфир, но не хотите чат в других местах...

• Установите chat allowed groups в конфигурацию по умолчанию или включите trust_level_0, чтобы позволить совершенно новым пользователям участвовать в чате прямого эфира
• Удалите группы из настройки direct message enabled groups, чтобы предотвратить личные сообщения между пользователями
• Не создавайте другие чат-каналы

Создание события с прямым эфиром

Чтобы создать событие с прямым эфиром:

1. Откройте новую тему.
2. Выберите значок + на панели инструментов композера и нажмите Создать событие (если событие еще не было добавлено к вашей теме).
3. Вставьте ссылку на видео события (например, URL YouTube) в поле местоположения/URL.
4. Включите переключатель “прямой эфир”

Затем вы увидите, что событие и прямой эфир были созданы, а также сопутствующий чат-канал на правой стороне.

Как только любой пользователь нажмет Участвую на событии, он автоматически присоединится к чат-каналу, что позволит ему участвовать в разговоре!

Прямые трансляции веб-семинаров Zoom

Вы можете использовать прямой эфир для проведения веб-семинаров Zoom непосредственно в Discourse, чтобы участники могли смотреть событие и участвовать в сопутствующем чат-канале, не покидая ваше сообщество.

Требования к веб-семинарам Zoom

В дополнение к требованиям к прямому эфиру, вам также необходимо настроить следующие параметры:

• Включите livestream zoom enabled
• Введите ключ Zoom Meeting SDK в настройку livestream zoom sdk key
• Введите секрет Zoom Meeting SDK в настройку livestream zoom sdk secret

Для получения ключа и секрета Zoom Meeting SDK:

1. Перейдите на marketplace.zoom.us, нажмите Develop (Разработка), а затем Build app (Создать приложение).
   

   

2. Когда вас спросят, какой тип приложения вы создаете, выберите General App (Общее приложение) и нажмите Create (Создать).
   

   

3. На странице App Credentials (Удостоверения приложения) приложения скопируйте Client ID (Ключ SDK) и Client Secret (Секрет SDK).

   

4. В разделе Embed (Встраивание) включите разрешение Meeting SDK (SDK совещаний).

   

5. В вашем Discourse перейдите в Админ → Все настройки сайта и введите значения из шага 3 в livestream zoom sdk key и livestream zoom sdk secret.

Для того чтобы веб-семинар Zoom работал правильно в Discourse:

• Для участия в веб-семинаре не должно требоваться регистрация или пароль.

• Отключите встроенный чат веб-семинара Zoom, чтобы обеспечить проведение всех обсуждений в едином чат-канале Discourse, чтобы держать весь чат в одном месте и обеспечить продолжение разговора после окончания веб-семинара.

  

Создание события прямого эфира для веб-семинара Zoom

Чтобы создать событие прямого эфира для вашего веб-семинара Zoom:

1. Откройте новую тему, выберите значок + и нажмите Создать событие.
2. Вставьте ссылку на ваш веб-семинар Zoom (например, https://zoom.us/``...) в поле URL/Местоположение.
3. Включите Прямой эфир.
4. Установите название события, время начала, время окончания и другие детали события по желанию.
5. Опубликуйте тему.

Как и другие события с прямым эфиром, это событие будет создано с сопутствующим чат-каналом Discourse, к которому участники автоматически присоединяются после подтверждения участия “Участвую”.

Опыт участника

Вот как ваши участники будут переживать веб-семинар:

Перед событием

Кнопка Присоединиться к Zoom отображается за 30 минут до начала события. Вне этого окна кнопка отключена с сообщением о том, когда она станет доступной.

Во время события

Как только участники нажимают Присоединиться к Zoom, веб-семинар загрузится на страницу темы (или, если хост еще не начал событие, участнику придется подождать, пока он это сделает, чтобы увидеть видео).

Аудио не подключается автоматически при присоединении к веб-семинару; участникам необходимо нажать или коснуться значка аудио на панели инструментов Zoom, чтобы подключиться. Это ограничение Zoom SDK, и его нельзя изменить.

На мобильных устройствах веб-семинар открывается в полноэкранном виде Zoom (который также доступен на настольных компьютерах, добавив /zoom в конец URL темы события) с плавающей кнопкой Чат, на которую можно нажать, чтобы открыть панель наложения чата во время события.

После события

Кнопка Присоединиться к Zoom скрывается через 10 минут после времени окончания события. Чат-канал остается доступным для участников, пока вы не закроете его.

Интеграции с другими плагинами

Вы можете использовать компонент из этого плагина с Right Sidebar Blocks. Вам нужно убедиться, что желаемый маршрут включен в компоненте Right Sidebar Blocks. Имя блока будет upcoming-events-list. Исторически в самом плагине Calendar требовались дополнительные настройки, но это было упрощено.

Вот как по умолчанию будет выглядеть календарь в боковой панели.

Если вы не хотите отображать время, вы можете добавить пустое значение timeFormat в настройке блока компонента.

---

1. categoryId — это категория, над которой будет отображаться календарь.
   postId — это пост, в котором вы разместили календарь с помощью [calendar][/calendar] ↩︎

2. может отображать выбор часового пояса в правом верхнем углу календаря. По умолчанию false, можно включить с помощью tzPicker=true ↩︎

3. может скрывать субботы и воскресенья из календаря. По умолчанию true. Можно установить false с помощью weekends=false. ↩︎

4. defaultView устанавливает вид календаря (день, неделя и т.д.). Может быть установлено как:
   
   defaultView=agendaDay
   defaultView=agendaWeek
   defaultView=month (по умолчанию)
   defaultView=listNextYear ↩︎

[martyn_thomas]

Этот плагин выглядит многообещающе, но в нём отсутствуют некоторые функции, из-за чего мы не можем перейти с плагина Pavilion.

• Отображение событий, не являющихся «весь день», с указанием времени начала в календаре. В настоящее время все события выглядят как события на весь день.

• Кнопка «Добавить событие» в редакторе рядом с селектором тегов (не скрытая в шестерёнке).

• Ограничение категорий, в которых могут создаваться события, и указание, являются ли события обязательными в определённой категории.

Желательные улучшения:

• Метаданные события в теме отображаются/вводятся только в верхней части темы (а не там, где находится курсор).
• Возможность ограничить группы пользователей, которые могут создавать события в категории (например, только группа «EventPlanners» может создавать события в категории «Обсуждение», но все пользователи могут создавать темы, не являющиеся событиями, или редактировать темы, если тема установлена как Wiki).
• Изменение URL /upcoming-events на /calendar.

[pokapow]

Здравствуйте,
Спасибо за эту работу.

У меня есть два вопроса по UX:

• Можно ли разместить кнопку «Добавить событие» рядом с кнопкой «Добавить место» в редакторе темы? Как это было в случае с плагином pavilion?
  

• Есть ли возможность добавить пункт «Календарь» в верхнее меню? Я не могу найти его в настройках.
  

  

[AstonJ]

Выглядит отлично! Есть несколько мыслей и вопросов:

Правильно ли я понимаю, что для создания календаря нужно просто создать новую тему и вставить в неё следующее:

Название календаря

[calendar]
[/calendar]

А чтобы добавить записи в календарь, достаточно сделать новый пост в той же теме с чем-то вроде следующего (нажав на иконку вставить время/дату в опциях поста):

Название события/записи

[date-range from=2024-04-18 to=2024-04-19 timezone="Europe/London"]

Это добавляет запись в календарь, что здорово, однако:

• Можно ли добавлять записи в календарь так, чтобы у каждой из них была своя отдельная тема? (Я вижу, что можно создавать события в новых темах, но, похоже, нет способа добавить эти события в календарь).
• Можно ли отображать «Ближайшие события» из конкретного календаря в письмах с дайджестом? Или, возможно, в левой колонке, причём каждая запись будет ссылаться на отдельную тему для этого события?

Если это пока невозможно, есть ли у вас планы добавить такую функцию?

[haozi (耗子)]

@vinothkannans, не могли бы вы помочь с ревью этого PR?

FEATURE: add China holidays and region (#561)

[putty]

Планируется ли добавить URL-канал, на который пользователи смогут подписываться? Уверен, что это будет сложно реализовать для всех событий, а не только для тех, на которые они подтвердили участие.

Во-вторых, было бы здорово добавить дополнительный уровень, который распознавал бы приватные события (или, возможно, это просто отдельный URL-канал для каждой группы).

[jordan-violet]

@putty

Планируется ли добавить URL-канал, на который пользователи смогут подписываться? Я уверен, что это будет непросто для всех событий по сравнению с теми, на которые они подтвердили участие.

Finding Discourse RSS feeds

A reference list of all the RSS feeds available in Discourse. Required user level: All users Here’s a list of most of the available RSS feeds in Discourse. RSS is a standardised, computer-readable format for content that allows it to be shared between sites and platforms easily. RSS links that contain an ID (categories, topics, badges, etc.) are defined by their ID. The links won’t break if the slug part of the URL changes, but the slug…

Однако для URL /upcoming-events нет RSS-канала — это было бы отличным дополнением!

[pokapow]

А как насчет синхронизации через CalDAV?

[Matthias_Schuster (Matthias)]

Для меня это тоже было бы поводом переключиться, действительно.

[Heliosurge (Dan DeMontmorency)]

Это требует более тщательной доработки, так как упоминается вставка события в редактор и добавление деталей события не так, как показано на изображении. Разве событие было опцией?

[Isambard]

Я установил плагин, и тег календаря работает в первом сообщении темы. Но я не вижу никаких опций событий или календаря в меню с шестерёнкой:

Не могли бы вы объяснить, что нужно сделать, чтобы опция события появилась в меню с шестерёнкой?

[JammyDodger]

Вам нужно включить раздел событий плагина discourse post event enabled

[Isambard]

Спасибо. Я как-то упустил эту настройку.

[Heliosurge (Dan DeMontmorency)]

Как сделать так, чтобы создание события отображалось в теме категории, где ответы являются событиями?

Я вижу, что функция создания события работает при создании новых тем. Однако я хочу иметь календарь внутри темы, где ответы добавляют события. Это частично работает с помощью вставки даты, но не так хорошо, как функция создания события, которая предлагает больше опций.

[eve (Phú)]

В настоящее время пользователи могут выбрать регион в настройках своего профиля.

Я хотел бы дать возможность указывать регион при регистрации, добавив это поле в форму регистрации. Это возможно?

[joo (slower)]

Отображается ли удалённый ответ в календаре?

[tonninseteli (se oli tonnin seteli)]

Я не могу найти никаких настроек для изменения первого дня недели на понедельник. Если такой настройки нет, это легко реализовать?

Другая проблема заключается в том, что ввод времени и даты сломан. Если это событие на весь день, должна быть возможность выбрать это до того, как поля ввода времени исказят даты, и даты, кажется, случайно меняются при редактировании.

Также заметил, что можно ввести 00:00 и во времени, и в дате (что иногда работает, а иногда нет), что приводит к ошибке в календаре. Это, в свою очередь, вызывает конфликт с черновиками, приводя к повторяющейся ошибке 422, пока страница не будет откатана к более ранней версии, а затем снова отредактирована и т. д.

[joo (slower)]

@joo

При активации этой автоматизации в календарь автоматически добавляется содержимое «Последнее изменение от». Я ищу совета: является ли это ошибкой или проблемой моих настроек. Не мог бы кто-нибудь помочь прояснить?

Пожалуйста, ознакомьтесь здесь

[Jagster (Jakke Flemming)]

@tonninseteli

Я не могу найти настройку для изменения первого дня недели на понедельник. Если её нет, это легко реализовать?

Такой настройки нет, и поэтому я не пользуюсь этим. И я готов поспорить, что команда исправит эту ошибку, если это будет простая трюковая правка.