Este guia explica como criar enquetes no Discourse para coletar votos dos usuários sobre qualquer tópico.
Nível de usuário necessário: Todos os usuários
Por padrão, as enquetes estão habilitadas no Discourse e usuários com nível de confiança 1 ou superior podem criá-las. Administradores do site podem ajustar quem pode criar enquetes através da configuração de site
poll create allowed groupse desabilitar enquetes usando a configuração de sitepoll enabled.
Criando uma enquete a partir da barra de ferramentas
A maneira mais fácil de criar uma enquete é usar o construtor de enquetes. O construtor de enquetes pode ser acessado no menu de opções ⊕ no compositor, e permite que você crie uma enquete sem precisar saber a sintaxe exata.
Para mostrar opções avançadas, pressione o ícone 
. Isso mostrará diferentes opções de enquete, como se a enquete se fecha automaticamente, grupos permitidos a votar, escolha de gráfico de barras ou pizza, etc.
Opções da enquete
Tipo de enquete:
- Escolha Única: Tipo de enquete padrão. Os usuários podem selecionar uma única opção da enquete
- Múltipla Escolha: Os usuários podem selecionar múltiplas opções da enquete.
- O criador da enquete também deve definir o número mínimo e máximo de escolhas que um usuário pode fazer. Por padrão, o mínimo será 1, e o máximo será o número de opções da enquete.
- Classificação Numérica: Os usuários podem selecionar um único número.
- O criador da enquete também deve definir o mínimo, máximo e passo para a classificação numérica. Por exemplo, se o mínimo for
2, o máximo for10, e o passo for2, as opções serão 2, 4, 6, 8 e 10.
- O criador da enquete também deve definir o mínimo, máximo e passo para a classificação numérica. Por exemplo, se o mínimo for
- Escolha Ranqueada: Os usuários classificam todas as opções em ordem de preferência. O vencedor é determinado usando Votação de Segundo Turno Instantâneo — em cada rodada, o candidato com menos votos de primeira preferência é eliminado e seus votos redistribuídos, até que um candidato atinja a maioria ou um empate seja alcançado.
Resultados:
- Sempre visíveis: Resultados de enquete padrão. Os usuários podem sempre ver os resultados da enquete, independentemente de terem votado.
- Somente após votar: Os usuários devem votar antes de poderem ver os resultados da enquete.
- Quando a enquete for fechada: Os resultados da enquete só serão revelados quando a enquete for fechada.
- Somente equipe: Somente a equipe do site poderá ver os resultados da enquete.
Grupos permitidos:
Permite que o criador da enquete limite quais grupos podem participar da enquete. Usuários que não estão nos grupos listados poderão visualizar a enquete, mas não votar. O padrão é que todos os usuários possam participar, sem limitação de grupo.
Tipo de gráfico:
Para enquetes de Escolha Única ou Múltipla Escolha, escolha se deseja exibir o resultado em um gráfico de barras ou gráfico de pizza. Não disponível para enquetes de Classificação Numérica ou Escolha Ranqueada.
Mostrar quem votou:
Habilitado por padrão, isso permite que aqueles que podem ver os resultados da enquete vejam também as escolhas específicas de cada usuário na enquete. (Apenas tipo Gráfico de Barras)
Fechar enquete automaticamente:
Permite que o criador da enquete defina uma data/hora para o fechamento automático da enquete. Ao contrário das enquetes fechadas manualmente, enquetes fechadas automaticamente não podem ser reabertas.
Permitir adicionar ou remover opções após a publicação (Dinâmico):
Quando habilitado, opções da enquete podem ser adicionadas ou removidas mesmo após a expiração da janela de edição, sem limpar os votos em opções inalteradas. Isso deve ser definido quando a enquete é criada pela primeira vez — uma enquete existente não pode ser convertida para dinâmica após a criação.
Incluindo imagens
Enquetes podem até incluir imagens! Depois de usar o construtor de enquetes para inserir a enquete, imagens podem ser carregadas no post e adicionadas manualmente à enquete. Imagens carregadas devem ser pequenas, ou ajustadas para serem exibidas em uma porcentagem menor:
[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.
Incluindo datas relativas
Enquetes também podem incluir datas relativas! De forma semelhante à adição de imagens, após usar o construtor de enquetes para inserir a enquete, você pode inserir datas nas opções da enquete através do botão do compositor “Inserir data/hora”:
[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
Múltiplas enquetes em um post
Se múltiplas enquetes forem usadas em um único post (como este!), cada enquete precisará de um nome exclusivo ou não funcionará. Ao usar o construtor de enquetes, cada enquete extra será numerada sequencialmente, mas você também pode fazer isso manualmente adicionando name="nome_da_enquete" como um parâmetro:
[poll name="poll_1"]
1. opção um
2. opção dois
3. opção três
[/poll]
[poll name="poll_3" type=multiple min=2 max=3]
- opção um
- opção dois
- opção três
- opção quatro
[/poll]
[poll name="dave" type=number min=2 max=10 step=2]
[/poll]
Criando uma enquete manualmente
Embora o construtor de enquetes seja a opção mais fácil, também é possível criar e editar enquetes manualmente dentro do próprio compositor.
Para criar uma enquete simples, envolva uma lista markdown com [poll] e [/poll]:
[poll]
* opção um
* opção dois
* opção três
[/poll]
-ou números em vez de asteriscos*.
Isso criará o seguinte resultado:
- option one
- option two
- option three
Para criar manualmente enquetes mais complexas, parâmetros adicionais podem ser adicionados à tag da enquete. Por exemplo:
[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]
# Você gosta de enquetes?
* Sim
* Não
* Talvez
[/poll]
- Sim
- Não
- Talvez
(Embora nem todas as opções façam sentido para todas as enquetes 
)
Outros tipos de enquete disponíveis incluem type=ranked_choice para enquetes de Votação de Segundo Turno Instantâneo, e o parâmetro dynamic=true pode ser adicionado para permitir que opções sejam modificadas após a publicação.
Usar o construtor de enquetes é uma ótima maneira de descobrir o formato desses parâmetros adicionais para uso posterior.
FAQs
Qualquer pessoa pode votar em uma enquete?
Mesmo sem restrições de votação por grupo na enquete, os usuários devem ser capazes de responder ao tópico onde a enquete é criada para participar. Usuários com permissões somente de see (visualização) não poderão votar.
Enquetes podem ser editadas?
Todos os votos são limpos quando uma enquete é editada, para garantir que o criador da enquete não possa alterar as opções nas quais um usuário votou. Como tal, por padrão, as enquetes só podem ser editadas por um período de carência de 5 minutos após serem criadas.
Votos não podem ser recuperados depois que uma enquete é editada e os votos são limpos
Uma exceção a isso são as enquetes dinâmicas (dynamic=true), que permitem que opções sejam adicionadas ou removidas após a janela de edição, preservando os votos nas opções existentes.
Posso exportar dados da enquete para análise posterior?
A equipe pode usar o Discourse Data Explorer para exportar dados da enquete como um csv, que pode ser importado para o programa de análise de dados de sua escolha.