コメント内のライブ投票
ライブ投票とは何か 
Live Pollsでは、コメント内でコミュニティに質問を直接投げかけることができます。投票はコメントに添付され、コメント内に表示され、ページ上の全員がスレッドを離れることなくその場で投票できます。
投票が入るたびに結果がリアルタイムで更新され、ページをリフレッシュする必要はありません。投票の作成者は締切日を設定したり、誰かが投票するまで結果を非表示にしたり、投票者を匿名にするかどうかを選択できます。
投票機能は FastComments のコメントウィジェットに組み込まれているため、ウィジェットがインストールされているすべてのサイトで追加コードなしで動作します。
ライブ投票デモを試す で投票に参加し、あなた自身の投票を投稿できます。
投票の有効化
投票機能はデフォルトで無効です。有効にするには、ウィジェットのカスタマイズ設定に移動し、Enable Polls にチェックを入れます。
これにより、コメントエディタのツールバーに投票ボタンが追加されます。投票はコメント内に表示され、閲覧者はその場で投票できます。
他のウィジェット設定と同様に、これをサイト全体または特定のページやドメインにのみ適用できます。
後で投票機能をオフにすると、投票ボタンは消え、既存の投票はウィジェット内での表示が停止します。投票とその投票数は保持され、再度投票機能をオンにすれば再び表示されます。
誰が投票を作成できるか
投票が有効になると、Who Can Create Polls 設定はコメントツールバーに投票ボタンが表示される対象を制御します：
- Admins/Moderators Only (デフォルト): サイトの管理者とモデレーターだけがコメントに投票を添付できます。
- Everyone: すべてのコメント投稿者が自分のコメントに投票を添付できます。
この設定は投票を作成できるユーザーのみを制御します。投票できるユーザーは別途設定されます。次のセクションをご覧ください。
匿名投票の許可
デフォルトでは、ログインしているユーザーのみが投票できます。ログインしていない訪問者は、投票ボタンの代わりに 投票するにはログイン プロンプトが表示されます。
Allow Anonymous Poll Votes をチェックして、アカウントなしで誰でも投票できるようにします。
結果の公平性を保つため、投票の匿名投票は IP アドレスごとに1時間あたり最大3件に制限されています。
これは、コメントの賛成・反対投票を制御する Allow Anonymous Voting とは別です。
投票の作成
投票を作成するには、コメントエディタのツールバーにある投票ボタンをクリックします。テキスト入力の下に投票エディタが開き、以下を設定できます：
- 質問、最大200文字。
- 選択肢、2〜10個、各最大100文字。Add option を使用して追加できます。
- 投票の締め切り：期限なし、1日、3日、または1週間。締め切られた投票は最終結果を表示し、投票は受け付けなくなります。
- プライバシー：投票者が匿名のままか、管理者に表示されるか、公開されるかを設定します。Voter Privacy を参照してください。
- 結果を見るには投票が必要：チェックすると、投票または投票の締め切りまで各閲覧者に結果が非表示になります。
通常通りコメントを書いて投稿します。投票はコメントと一緒に投稿されます。投票は新しいコメントや返信にも追加できます。
投稿前に投票を破棄するには、Remove poll をクリックします。
投票とライブ結果
投票するには、オプションをクリックしてください。結果はすぐに表示され、投票は現在までに何件の回答があるかを示します。
各ユーザーは投票ごとに1票しか投じられません。投票が開かれている間、投票者は Change vote をクリックして別のオプションを選択できます。
結果はリアルタイムで更新されます。ページ上の誰かが投票すると、カウントとバーがページをリロードせずに投票を閲覧している全員に対して更新されます。
投票結果を見るのに投票が必要でない限り、閲覧者は Show results をクリックして投票前に現在のカウントを確認できます。
投票者のプライバシー
すべての投票には、作成時に作者が選択するプライバシー設定があります。投票はオプションの下に設定を表示するので、投票者は投票する前に誰が自分の投票を見ることができるかを知ることができます。
- Anonymous (the default): 合計のみが表示されます。管理者を含む誰も、誰が何に投票したかを見ることはできません。
- Admins can see who voted: 管理者とモデレーターだけが See who voted を開くことができ、各投票者とその選択が一覧表示されます。
- Public: 任意の閲覧者が See who voted をクリックして、誰が何に投票したかを見ることができます。
ログインしていない訪問者からの投票もカウントされますが、名前が付随しないため、投票者リストには表示されません。
投票通知
投票の作成者は、回答が入るたびに通知されます：
- In-app: 投票に新しい回答があると、ベルアイコンの下に通知が表示されます。多数の人が投票すると、これらは1つの通知にまとめられます。
- Email: その日の投票に新しい回答があった場合、投票の作成者に毎日メールが送られます。
人の最初の投票だけが新しい回答としてカウントされます。投票を変更しても通知は送られず、作成者は自分の投票について通知されません。
通知は投票のプライバシー設定を尊重します。匿名投票の場合、通知には新しい回答数のみが表示されます。公開投票や、作成者が管理者またはモデレーターである場合に表示可能な投票では、投票者の名前が含まれます。
メールにはその投票の通知を停止するリンクが含まれています。その内容は Poll Response Notification テンプレートで変更でき、Email Templates を参照してください。
投票 API
Polls can also be managed from your own code with the REST API, for example to add a poll to a comment from your backend, close a poll, or export the votes:
- Poll Structure は投票オブジェクトとその制限を説明します。
- GET, PUT, PATCH, and DELETE
/api/v1/polls/:commentIdはコメント上の投票を取得、置換、編集、削除します。 - PollVote Structure は単一の投票を説明します。
- GET, POST, and DELETE
/api/v1/poll-votesは投票の一覧取得、投票、削除を行います。
A poll can also be created along with its comment by passing poll to POST /api/v1/comments.
The API follows the same settings as the widget: polls must be enabled, and votes without a logged in user are rejected unless anonymous poll votes are allowed. Individual votes on anonymous polls cannot be read through the API.
結論として
Live Polls のドキュメントをご覧いただきありがとうございます！質問があれば以下にお知らせください。