评论中的实时投票

要创建投票，请点击评论编辑器工具栏中的投票按钮。投票编辑器会在文本输入框下方打开，您可以设置：

• 问题，最多 200 个字符。
• 选项，2 到 10 项，每项最多 100 个字符。使用 添加选项 来添加更多。
• 投票结束时间：无结束日期、1 天、3 天或 1 周。结束的投票会显示最终结果，并且不再接受投票。
• 隐私：投票者是匿名、对管理员可见，还是公开。参见 投票者隐私。
• 需要投票才能查看结果：选中后，结果对每个查看者保持隐藏，直到他们投票或投票结束。

像往常一样撰写评论并发布。投票会随评论一起发布。投票可以添加到新评论和回复中。

要在发布前放弃投票，请点击 移除投票。

要投票，请点击一个选项。结果会立即显示，投票会显示目前已有的响应数量。

每个人在每个投票中只能投一次。投票进行期间，投票者可以点击 更改投票 来选择其他选项。

结果实时更新。当页面上的任何人投票时，计数和进度条会为所有查看投票的用户实时更新，无需刷新页面。

除非投票要求先投票才能查看结果，否则观看者可以点击 显示结果 来在投票前查看当前计数。

每个投票都有一个隐私设置，由作者在创建时选择。投票会在选项下显示其设置，以便投票者在投票前了解谁可以看到他们的投票。

• 匿名（默认）：仅显示总计。没有人，包括管理员，能够看到谁投了哪一票。
• 管理员可以看到投票者：只有管理员和版主可以打开 查看投票者，该页面列出每位投票者及其选择。
• 公开：任何查看者都可以点击 查看投票者 并看到谁投了哪一票。

未登录访客的投票会被计入，但没有关联的姓名，因此不会出现在投票者列表中。

投票的作者会在收到回复时收到通知：

• 应用内：当投票收到新回复时，在铃铛图标下显示通知。多人投票时，这些会合并为一条通知。
• 邮件：每天向投票的作者发送一封邮件，告知当天投票收到的新回复。

只有个人的第一次投票算作新回复。更改投票不会发送通知，作者也不会收到关于自己投票的通知。

通知遵循投票的隐私设置。对于匿名投票，仅显示有多少新回复。对于公开投票以及当作者是管理员或版主时可见的投票，会包含投票者的姓名。

邮件中包含一个停止该投票通知的链接。其内容可通过 投票回复通知 模板进行更改，参见 Email Templates。

投票也可以通过 REST API 从您自己的代码进行管理，例如从后端向评论添加投票、关闭投票或导出投票结果：

• Poll Structure 描述投票对象及其限制。
• GET、PUT、PATCH 和 DELETE /api/v1/polls/:commentId 读取、替换、编辑和删除评论上的投票。
• PollVote Structure 描述单个投票。
• GET、POST 和 DELETE /api/v1/poll-votes 列出、投票和删除投票。

也可以通过将 poll 传递给 POST /api/v1/comments 来在创建评论的同时创建投票。

API 的设置与小部件相同：必须启用投票，且未登录用户的投票将被拒绝，除非允许匿名投票。匿名投票的单个投票无法通过 API 读取。