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

[Discourse]

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

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

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

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

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

Возможности

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

Календари

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

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

Creating and managing calendars

This guide explains how to create and manage calendars in Discourse using the Calendar (and Event) plugin. Required user level: All users Calendars are a powerful feature in Discourse that allow you to organize and display events within your community. This guide will walk you through the process of creating calendars, adding events, and managing them effectively. Summary Enable the Calendar plugin Create a calendar in a topic or category Add events to you…

События

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

Creating and managing events

This guide explains how to create and manage events using the Calendar and Event plugin in Discourse. It covers how to create events, set event options, interact with events, and view the upcoming events calendar. Required user level: All users (with appropriate permissions) Enabling events Events are a feature of the Calendar and Events plugin. To use this feature: Enable the Calendar and Events plugin Configure related settings For detailed instructions…

Не путайте это с плагином 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

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

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

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

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

Размещено нами? Этот плагин доступен на тарифах Business и Enterprise: Calendar | Discourse - Civilized Discussion

---

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

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

3. может скрывать субботы и воскресенья из календаря. По умолчанию включено (True). Можно отключить с помощью 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

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

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