このガイドでは、Discourseで投票を作成し、ユーザーからあらゆるトピックに関する票を収集する方法を説明します。
必要なユーザーレベル: 全てのユーザー
デフォルトでは、Discourseでは投票は有効になっており、トラストレベル1以上のユーザーが作成できます。サイト管理者は、サイト設定の
poll create allowed groupsで投票を作成できるユーザーを調整したり、サイト設定のpoll enabledで投票を無効にしたりできます。
ツールバーからの投票の作成
投票を作成する最も簡単な方法は、投票ビルダーを使用することです。投票ビルダーには、コンポーザーの ⊕ オプションメニューからアクセスでき、正確な構文を知らなくても投票を作成できます。
詳細オプションを表示するには、
アイコンを押します。これにより、投票の自動クローズ、投票が許可されるグループの設定、棒グラフか円グラフかの選択など、さまざまな投票オプションが表示されます。
投票オプション
投票タイプ:
- 単一選択: デフォルトの投票タイプです。ユーザーは投票から単一の選択肢を選ぶことができます。
- 複数選択: ユーザーは投票から複数の選択肢を選ぶことができます。
- 投票作成者は、ユーザーが選択できる最小および最大の選択肢の数も定義する必要があります。デフォルトでは、最小は 1、最大は投票の選択肢の数になります。
- 数値評価: ユーザーは単一の数値を選択できます。
- 投票作成者は、数値評価の最小値、最大値、およびステップも定義する必要があります。例えば、最小値が
2、最大値が10、ステップが2の場合、選択肢は 2、4、6、8、10 になります。
- 投票作成者は、数値評価の最小値、最大値、およびステップも定義する必要があります。例えば、最小値が
- 順位選択: ユーザーはすべての選択肢を好みの順にランク付けします。勝者は即時決選投票（Instant Run-off Voting）を使用して決定されます — 各ラウンドで、1位の票が最も少ない候補者が失格になり、その票が再配分され、1人の候補者が過半数を達成するか引き分けになるまで続きます。
結果:
- 常に表示: デフォルトの投票結果です。ユーザーは投票したかどうかに関係なく、いつでも投票の結果を見ることができます。
- 投票後のみ: ユーザーは投票してからでないと、投票の結果を見ることができません。
- 投票が締め切られたとき: 投票結果は、投票が締め切られた後にのみ表示されます。
- スタッフのみ: サイトスタッフのみが投票結果を見ることができます。
許可されるグループ:
投票作成者が、どのグループが投票に参加できるかを制限できるようにします。指定されたグループに属していないユーザーは、投票を表示することはできますが、投票はできません。デフォルトでは、すべてのユーザーが参加でき、グループの制限はありません。
チャートタイプ:
単一選択または複数選択の投票の場合、結果を棒グラフまたは円グラフのどちらで表示するかを選択します。数値評価または順位選択の投票では利用できません。
誰が投票したかを表示:
デフォルトで有効になっており、これにより、投票結果を表示できるユーザーは、各投票ユーザーの具体的な選択肢も表示できます。（棒グラフタイプのみ）
投票を自動的に締め切る:
投票作成者が、投票が自動的に締め切られる日時を設定できるようにします。手動で締め切られた投票とは異なり、自動的に締め切られた投票は再開できません。
投稿後にオプションの追加または削除を許可（動的）:
有効にすると、編集ウィンドウが期限切れになった後でも、投票のオプションを追加または削除できます。この際、変更されていないオプションの票はクリアされません。これは、投票が最初に作成されたときに設定する必要があります — 作成後に既存の投票を動的に変換することはできません。
画像を含める
投票には画像を含めることもできます！投票ビルダーを使用して投票を挿入した後、画像を投稿にアップロードし、手動で投票に追加できます。アップロードする画像は小さくするか、表示率を低く調整する必要があります。
[poll type=regular]
* 
* 
* 
[/poll]
[poll type=regular]
* Cat: a small domesticated carnivorous mammal with soft fur, a short snout, and retractile claws.
* Dog: a domesticated carnivorous mammal that typically has a long snout, an acute sense of smell, and a barking, howling, or whining voice.
* Fish: a limbless cold-blooded vertebrate animal with gills and fins and living wholly in water.
[/poll]
- Cat: a small domesticated carnivorous mammal with soft fur, a short snout, and retractile claws.
- Dog: a domesticated carnivorous mammal that typically has a long snout, an acute sense of smell, and a barking, howling, or whining voice.
- Fish: a limbless cold-blooded vertebrate animal with gills and fins and living wholly in water.
相対的な日付を含める
投票には相対的な日付を含めることもできます！画像を追加するのと同じように、投票ビルダーを使用して投票を挿入した後、「日付/時刻の挿入」コンポーザーボタンを使用して、投票オプションに日付を挿入できます。
[poll type=regular]
* [date=2019-10-13 timezone="Europe/Paris"]
* [date=2019-10-12 timezone="Europe/Paris"]
* [date=2019-10-11 timezone="Europe/Paris"]
[/poll]
- 2019-10-12T22:00:00Z
- 2019-10-11T22:00:00Z
- 2019-10-10T22:00:00Z
投稿内の複数の投票
単一の投稿内で複数の投票が使用される場合（まさにこれのように！）、各投票には一意の名前が必要になります。そうしないと機能しません。投票ビルダーを使用すると、追加の各投票には連番が付けられますが、name="poll_name" をパラメーターとして追加することで手動で行うこともできます。
[poll name="poll_1"]
1. option one
2. option two
3. option three
[/poll]
[poll name="poll_3" type=multiple min=2 max=3]
- option one
- option two
- option three
- option four
[/poll]
[poll name="dave" type=number min=2 max=10 step=2]
[/poll]
手動で投票を作成する
投票ビルダーが最も簡単なオプションですが、コンポーザー内で手動で投票を作成・編集することも可能です。
簡単な投票を作成するには、マークダウンリストを [poll] と [/poll] で囲みます。
[poll]
* option one
* option two
* option three
[/poll]
*の代わりにハイフン-や数字を使用するなど、任意のマークダウンリストが機能します。
これにより、次の結果が生成されます。
- option one
- option two
- option three
より複雑な投票を手動で作成するには、投票タグに追加のパラメーターを追加できます。例えば：
[poll type=multiple results=on_vote min=1 max=2 public=true chartType=pie groups=trust_level_1 close=3024-12-31T00:00:00.000Z]
# Do you like polls?
* Yes
* No
* Maybe
[/poll]
- Yes
- No
- Maybe
（ただし、すべてのオプションがすべての投票で理にかなうわけではありません 
）
利用可能なその他の投票タイプには、即時決選投票のための type=ranked_choice があり、投稿後にオプションを変更できるようにするために dynamic=true パラメーターを追加できます。
投票ビルダーを使用することは、これらの追加パラメーターの形式を後で利用するために確認するのに最適な方法です。
FAQ
誰でも投票できますか？
投票自体にグループ投票の制限がない場合でも、参加するには、投票が作成されたトピックに返信できる必要があります。see 専用の権限を持つユーザーは投票できません。
投票は編集できますか？
投票作成者がユーザーが投票した選択肢を変更できないようにするため、投票が編集されるとすべての票がクリアされます。そのため、デフォルトでは、投票は作成後 5 分間の猶予期間のみ編集できます。
投票が編集され、票がクリアされると、票を回復することはできません
これには例外があり、動的投票 (dynamic=true) は、編集ウィンドウの後にオプションを追加または削除することを許可し、既存のオプションへの投票を保持します。
投票データをエクスポートしてさらに分析できますか？
スタッフは、Discourse Data Explorer を使用して、投票データを csv としてエクスポートし、選択したデータ分析プログラムにインポートできます。
