Календарь и события в Discourse

[Discourse]

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

Поскольку это #официальный плагин, поддерживаемый командой Discourse, запросы на Support, Contribute > Bug, Contribute > UX и Contribute > Feature можно отправлять в соответствующих категориях на Meta, используя соответствующий тег плагина. Нажмите на ссылку ниже, чтобы начать.

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

Включение календаря и событий

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

Возможности

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

Календари

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

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

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

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

События

Функция «События» позволяет вставлять в темы интерактивные элементы, которые ваши участники могут использовать для регистрации на участие в мероприятиях вашего сообщества. Все это сводится в отдельный общесайтовый календарь с возможностью добавить удобную ссылку в меню навигации. Более подробную информацию о том, как создавать и использовать эту функцию, вы можете найти здесь:

Создание и управление событиями

Это руководство объясняет, как создавать и управлять событиями с помощью плагина «Календарь и события» в 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, чтобы предотвратить личные сообщения между пользователями
• Не создавайте другие каналы чата

Создание события с прямой трансляцией

Чтобы создать событие с прямой трансляцией:

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

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

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

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

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

Предварительные требования для вебинаров Zoom

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

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

Чтобы получить ключ и секрет SDK встречи Zoom:

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

   

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

   

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

   

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

   

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

Чтобы вебинар Zoom работал корректно в Discourse:

• Вебинар не должен требовать регистрации или кода доступа для присоединения.

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

  

Создание события с прямой трансляцией вебинара Zoom

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

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

Как и другие события с прямой трансляцией, это событие будет создано с сопроводительным каналом чата 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 в настройку блока компонента.

Хостинг у нас? Этот плагин доступен в наших тарифах Business и Enterprise Calendar | Discourse - Civilized Discussion

---

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

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

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