Discourse 日历（与事件）

[Discourse]

	摘要	Discourse 日历和事件 为您的 Discourse 站点添加了动态且交互式的日历和事件功能。
	安装指南	此插件已捆绑在 Discourse 核心中。无需单独安装该插件。

由于这是由 Discourse 团队维护的 official 插件，#support、#bug、ux 和 #feature 请求可以在 Meta 的相应分类中提出，并打上适当的插件标签。点击下方的链接即可开始。

 支持  Bug  UX  功能

启用日历（和事件）

可以通过切换开关或从其设置中启用日历插件，两者均可从您的 admin/plugins 页面访问：

功能

somewhat 不出所料，Discourse 日历（和事件） 为您的 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 Event) plugin. To use this feature: Enable the Calendar (and Event) plugin Configure related settings For detailed instruct…

请勿将其与 Pavilion 的 Events 插件（注意是复数）混淆

日历设置

名称	描述
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	未指定开始时间的事件将在此时间开始。格式为 HH:mm。对于上午 6:00，请输入 06:00
all day event end time	未指定结束时间的事件将在此时间结束。格式为 HH:mm。对于下午 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	延长（以分钟为单位）事件结束后的一段时间，在此期间，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。历史上，Calendar 插件本身需要额外的设置，但现在已经简化。

默认情况下，侧边栏日历将如下所示。

如果您不想要时间，可以在组件的块设置中添加一个空的 timeFormat 值。

由我们托管？此插件可在我们的商业版和企业版中提供 Calendar | Discourse - Civilized Discussion

---

1. categoryId 是日历将显示在其顶部的分类。postId 是您使用 [calendar][/calendar] 放置日历的帖子。 ↩︎

2. 它可以在日历的右上角显示时区选择器。默认为 false，您可以使用 tzPicker=true 启用它。 ↩︎

3. 它可以隐藏日历中的周六和周日。默认为 true。您可以使用 weekends=false 将其设置为 false。 ↩︎

4. defaultView 将设置日历的视图（天、周等）。可以设置为：
   defaultView=agendaDay
defaultView=agendaWeek
defaultView=month（默认）
   defaultView=listNextYear ↩︎