 |
Resumo | O plugin Discourse Surveys permite criar pesquisas diretamente nas suas postagens do fórum Discourse usando sintaxe Markdown simples. |
 |
Link do Repositório | \u003chttps://github.com/discourse/discourse-surveys\u003e |
 |
Guia de Instalação | Como instalar plugins no Discourse |
O Plugin Discourse Surveys permite criar pesquisas diretamente nas suas postagens do fórum Discourse usando sintaxe Markdown simples. O plugin atualmente suporta vários tipos de perguntas, como botões de rádio, caixas de seleção, menus suspensos, entradas numéricas, áreas de texto, classificações por estrelas e classificações de polegar para cima/baixo.
Funcionalidades
-
7 Tipos de Campos Diferentes: Botões de rádio, caixas de seleção, menus suspensos, áreas de texto, seleção numérica, classificações por estrelas e polegar para cima/baixo
-
Campos Obrigatórios/Opcionais: Marque campos como obrigatórios para garantir o preenchimento
-
Suporte a Emoji: Use emojis nas suas opções de pesquisa
-
Suporte a HTML: Formatação de texto rico em perguntas e opções
-
Autenticação de Usuário: Solicitações automáticas de login para usuários anônimos
-
Rastreamento de Respostas: Impede envios duplicados do mesmo usuário
-
Consciência de Permissões: Respeita as permissões de tópico e categoria
-
Responsivo para Dispositivos Móveis: Funciona perfeitamente em todos os dispositivos
Uso
Estrutura Básica da Pesquisa
Todas as pesquisas devem ser envolvidas por tags [survey]:
[survey name="minha-pesquisa" title="Pesquisa de Feedback do Cliente"]
<!-- Os campos da pesquisa vão aqui -->
[/survey]
Atributos da Pesquisa
-
name: Identificador único para a pesquisa (padrão é “survey”) -
title: Título opcional exibido no topo da pesquisa -
public: Define a visibilidade (recurso futuro) -
status: Status da pesquisa (recurso futuro)
Tipos de Campo
1. Botões de Rádio (Escolha Única)
[radio question="Qual é a sua cor favorita?"]
- Vermelho
- Azul
- Verde
- Amarelo
[/radio]
2. Caixas de Seleção (Múltipla Escolha)
[checkbox question="Quais recursos você utiliza? (Selecione todos que se aplicam)"]
- Notificações por e-mail
- Aplicativo móvel
- Notificações de desktop
- Acesso à API
[/checkbox]
3. Seleção Suspensa (Dropdown)
[dropdown question="Qual é a sua faixa etária?"]
- Menos de 18
- 18-24
- 25-34
- 35-44
- 45-54
- 55+
[/dropdown]
4. Área de Texto (Texto Longo)
[textarea question="Por favor, forneça feedback detalhado:" required="false"]
[/textarea]
5. Seleção Numérica
[number question="Avalie este recurso de 1 a 10:" min="1" max="10"]
[/number]
6. Classificação por Estrelas
[star question="Como você avaliaria sua experiência geral?"]
[/star]
7. Polegar para Cima/Baixo
[thumbs question="Você recomendaria isto a outros?"]
[/thumbs]
Atributos de Campo
Todos os tipos de campo suportam estes atributos:
-
question: O texto da pergunta (obrigatório) -
required: Se o campo deve ser preenchido (true/false, padrão étrue) -
min: Valor mínimo para campos numéricos -
max: Valor máximo para campos numéricos
Exemplo Completo
Markdown Básico da Pesquisa
Aqui está um exemplo básico de Markdown de pesquisa incluindo todos os campos disponíveis:
[survey name="awesome-survey-thumbs" title="Pesquisa Incrível"]
[radio question="Escolha apenas uma opção:"]
- gato
- cachorro
[/radio]
[checkbox question="Escolha múltiplas opções:"]
- vermelho
- azul
- verde
[/checkbox]
[dropdown question="Gênero:"]
- Masculino
- Feminino
[/dropdown]
[number question="Avalie esta pesquisa de 1 a 10:"]
[/number]
[textarea question="Qual é o seu feedback sobre xyz?" required="false"]
[/textarea]
[star question="Como você avaliaria a experiência geral?"]
[/star]
[thumbs question="Você ficou satisfeito com nossos serviços?"]
[/thumbs]
[/survey]
Renderização da Pesquisa
Abaixo está um exemplo de como o Markdown acima é renderizado no Discourse:
Uso Avançado
Usando Emojis nas Opções
[radio question="Escolha seu animal favorito:"]
- 🐈 Gato
- 🐶 Cachorro
- 🐦 Pássaro
- 🐠 Peixe
[/radio]
Formatação HTML nas Perguntas
[radio question="Qual \u003cstrong\u003elinguagem de programação\u003c/strong\u003e você prefere?"]
- JavaScript
- Python
- Ruby
- Go
[/radio]
Campos Obrigatórios e Opcionais Misturados
[survey name="mixed-survey"]
[radio question="Qual é a sua função?" required="true"]
- Desenvolvedor
- Designer
- Gerente
- Outro
[/radio]
[textarea question="Alguns pensamentos adicionais?" required="false"]
[/textarea]
[/survey]
Resultados da Pesquisa
Atualmente, este plugin não possui uma UX de backend para visualizar os resultados da pesquisa diretamente. Em vez disso, você pode contar com as consultas do Data Explorer para buscar e analisar as respostas da pesquisa. Aqui está um exemplo de consulta:
-- [params]
-- text :survey_name = survey
SELECT
s.id,
s.name,
s.post_id,
sf.question,
COALESCE(sr.value, sfo.html) AS value,
sr.user_id,
sr.created_at AS responded_at
FROM
surveys s
JOIN survey_fields sf ON sf.survey_id = s.id
JOIN survey_responses sr ON sr.survey_field_id = sf.id
LEFT JOIN survey_field_options sfo ON sfo.id = sr.survey_field_option_id
WHERE
s.name = :survey_name
ORDER BY
s.id DESC
Permissões e Segurança
-
Login Obrigatório: Usuários anônimos devem fazer login antes de enviar respostas
-
Uma Resposta por Usuário: Cada usuário pode enviar apenas uma resposta por pesquisa
-
Permissões de Tópico: Os usuários devem ter acesso de leitura ao tópico para visualizar pesquisas
-
Permissões de Postagem: Os usuários devem ter permissões de postagem no tópico para enviar respostas
-
Tópicos Arquivados: Pesquisas em tópicos arquivados não podem aceitar novas respostas
-
Posts Excluídos: Pesquisas em posts excluídos não são mais acessíveis
Limitações
-
Apenas uma pesquisa é permitida por postagem
-
A estrutura da pesquisa não pode ser modificada após o recebimento de respostas
-
Todas as perguntas dos campos da pesquisa devem ser exclusivas dentro de uma única pesquisa
-
As perguntas dos campos da pesquisa não podem estar em branco
Detalhes Técnicos
Esquema do Banco de Dados
O plugin cria quatro tabelas principais no banco de dados:
-
surveys: Registros principais da pesquisa -
survey_fields: Campos individuais dentro das pesquisas -
survey_field_options: Opções para campos baseados em escolha -
survey_responses: Respostas do usuário aos campos da pesquisa
Estilização
O plugin inclui CSS responsivo que se adapta ao seu tema. Estilos personalizados podem ser adicionados direcionando estas classes CSS:
-
.survey- Contêiner principal da pesquisa -
.survey-field- Invólucro de campo individual -
.field-[type]- Contêineres de tipos de campo específicos -
.submit-response- Botão de envio
