評論中的即時投票

要建立投票，請點擊評論編輯器工具列中的投票按鈕。投票編輯器會在文字輸入框下方開啟，您可以在此設定：

• 問題，最多 200 個字元。
• 選項，介於 2 到 10 個，每個最多 100 個字元。使用 Add option 以新增更多。
• 投票結束時間：無結束日期、1 天、3 天或 1 週。結束的投票會顯示最終結果，且不再接受投票。
• 隱私：投票者是保持匿名、對管理員可見，或是公開。請參閱 Voter Privacy。
• 需要投票才能查看結果：勾選後，結果會對每位觀看者隱藏，直到他們投票或投票結束。

照常撰寫您的評論並發佈。投票會與評論一起發佈。投票可以加入新評論或回覆中。

若要在發佈前取消投票，請點擊 Remove poll。

要投票，請點選一個選項。結果會立即顯示，且投票會顯示目前收到的回應數量。

每人每個投票只能投一次。在投票開放期間，投票者可以點選 Change vote 以選擇其他選項。

結果即時更新。當頁面上的任何人投票時，計數與條形圖會即時為所有觀看投票的使用者更新，且不需重新整理頁面。

除非投票需要先投票才能查看結果，否則觀眾可以點選 Show results 以在投票前查看目前的計數。

每個投票都有隱私設定，由作者在建立時選擇。投票會在選項下顯示其設定，讓投票者在投票前知道誰可以看到他們的投票。

• 匿名（預設）：僅顯示總數。包括管理員在內的任何人都無法看到誰投了哪個選項。
• 管理員可查看投票者：只有管理員和版主可以開啟 查看投票者，其中列出每位投票者及其選擇。
• 公開：任何觀看者都可以點擊 查看投票者，看到誰投了哪個選項。

未登入的訪客投票會被計算，但不會附加姓名，因此不會出現在投票者名單中。

當投票回應進來時，投票的作者會收到通知：

• In-app：當投票收到新回應時，會在鈴鐺圖示下顯示通知。當多人投票時，這些通知會合併為一則通知。
• Email：每天會向投票的作者發送電子郵件，告知當天投票收到的新回應。

只有一個人的第一次投票才算作新回應。更改投票不會發送通知，且作者不會收到關於自己投票的通知。

通知會遵守投票的隱私設定。對於匿名投票，只會顯示有多少新回應。對於公開投票，會包含投票者的姓名；若作者是管理員或版主，對於管理員可見的投票也會顯示投票者姓名。

電子郵件內含一個停止該投票通知的連結。其內容可透過 Poll Response Notification 模板進行更改，請參閱 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 讀取。