E EmDash CMS Everything Guides, use cases, plugins, templates
Português

WB Polls

Crie sondagens, deixe visitantes ou membros votar uma vez e mostre resultados em direto em qualquer lugar do seu site.

Extensão

WB Polls

Crie sondagens, deixe visitantes ou membros votar uma vez e mostre resultados em direto em qualquer lugar do seu site.

  • Categoria: polls
  • Estado: Disponível
  • Versão: 0.5.0
  • Preço: Desconhecido
  • Origem: Registro oficial de plugins
  • Instalação: Plugin sandbox do registro
  • Verificado: 2026-10-21
Abrir no Claude Abrir no ChatGPT
Partilhar no X Partilhar no LinkedIn Partilhar no Reddit

Descrição

O WB Polls permite ao proprietário de um site colocar uma pergunta e mostrar resultados em direto em qualquer página EmDash.

O que obtém

  • Crie uma sondagem com duas a dez respostas, de escolha única ou múltipla.
  • Abra-a quando estiver pronto, feche-a quando a votação deve terminar ou defina uma hora de encerramento.
  • Escolha quem pode votar: qualquer pessoa ou apenas os membros com sessão iniciada.
  • Escolha quando os resultados aparecem: sempre, após votar ou depois de a sondagem fechar.
  • Escolha totais anónimos ou resultados com nome que o proprietário do site pode ver.
  • Associe uma sondagem a uma página, a cada entrada de um tipo de conteúdo ou a todo o site. Um programador também pode colocar uma sondagem específica pelo seu id.
  • Copie uma sondagem para um novo rascunho sem votos.

Como tudo se encaixa

O plugin é o motor: armazenamento, rotas de votação e os ecrãs de administração. Um plugin do EmDash não pode acrescentar páginas, pelo que a sondagem visível segue como um kit de site que copia uma só vez. Veja Instalação.

Os convidados podem votar quando permite que vote qualquer pessoa e o seu anfitrião dá ao EmDash o endereço do visitante (Cloudflare, ou trustedProxyHeaders). Os membros votam com a sua conta iniciada. Só você cria e gere as sondagens.

Instalação

Antes de instalar

1. O seu site precisa de um executor de sandbox. Os plugins do registo correm numa sandbox. Enquanto o site não tiver um, Admin, Plugins mostra «No plugins configured» e não há Registry no menu.

  • Node: no seu site, execute npm install @emdash-cms/sandbox-workerd workerd e depois acrescente sandboxRunner: "@emdash-cms/sandbox-workerd/sandbox", dentro de emdash() em astro.config.mjs.
  • Cloudflare: acrescente import from "@emdash-cms/cloudflare"; e sandboxRunner: sandbox(),. Precisa do plano Workers Paid, da ligação worker_loaders chamada LOADER (descomente-a na sua configuração do Wrangler) e de um bucket R2 como storage: r2(...), ou a instalação pára com «Storage error while installing plugin». Depois execute npm run deploy.

Pare o servidor de desenvolvimento e volte a iniciá-lo. Registry aparece agora no menu de administração.

2. O plugin é o motor. As páginas dos visitantes vêm do seu kit de site. Um plugin do registo não pode acrescentar páginas ao seu site. Até copiar o kit, os seus endereços (por exemplo /account/votes) mostram a página 404 do seu site. É o esperado. A cópia do kit abaixo demora um único comando.

Verificado no EmDash 1.3.1 com o modelo blog, em Node e no Cloudflare Workers (instalação a partir do registo).

Instalar

  1. Admin, Registry, pesquise WB Polls, Install e aceite as permissões.

  2. A partir da pasta raiz do seu site:

    kit="$(mktemp -d)" &&
  git clone --depth 1 \
    --branch v0.5.0 \
    https://github.com/wbcomdesigns/emdash-polls \
    "$kit/emdash-polls" &&
  "$kit/emdash-polls/scripts/add-to-site.sh" .

  3. Cole as linhas que imprimiu. Reinicie o servidor de desenvolvimento.

  4. Adicione a ligação de menu que imprimiu em Admin, Menus.

  5. Abra Polls na administração.

Após uma atualização, execute o passo 2 com a nova etiqueta.

Guia: https://github.com/wbcomdesigns/emdash-polls/blob/v0.5.0/docs/website/getting-started/install.md

Perguntas frequentes

Atualizei o plugin e a votação parou. Volte a copiar o kit de site. Uma instalação a partir do registo responde num id, não em /polls/. O kit atual encontra esse id.

Porque é que não há nenhuma sondagem na página depois de criar uma? Uma sondagem recém-criada é um rascunho. Abra a sondagem a partir da lista. Depois associe-a a uma página, a um tipo de conteúdo ou a todo o site, e coloque um espaço de sondagem nesse modelo.

Os convidados podem votar? Sim, quando define Who can vote como Anyone e o anfitrião dá ao EmDash o endereço do visitante: no Cloudflare, ou com trustedProxyHeaders definido para um cabeçalho que o seu proxy escreve e substitui por si (atrás do nginx, x-real-ip; nunca um X-Forwarded-For acrescentado no fim). Sem isso, é pedido aos convidados que iniciem sessão, e o ecrã Polls di-lo. Um voto por visitante. Os membros com sessão iniciada votam como eles próprios.

Um 401 na consola do navegador é um problema? Não. Um convidado recebe um 401 por sondagem da verificação do boletim de membro, e outro em My votes. É assim que a sondagem fica a saber que o visitante não iniciou sessão. Depois mostra a vista de convidado.

Quem vê os nomes dos votantes? Só você, e apenas numa sondagem com nome. Os convidados continuam anónimos. As sondagens anónimas nunca guardam um nome.

Funciona no modo escuro? Sim. O kit segue a definição do sistema do visitante.

Posso pôr uma sondagem no meio de um artigo? Não com a instalação a partir do registo. Associe-a acima ou abaixo do conteúdo, ou coloque “ num modelo. Um bloco dentro do texto precisa de uma instalação de confiança; esse caminho é opcional e não altera o produto do registo.

Existe uma versão paga? Não. Tudo o que está aqui é gratuito.

Porque é que pede para ler o meu conteúdo? Para que uma sondagem associada a um rascunho continue oculta até publicar essa página. O WB Polls apenas verifica se uma página está publicada e lista os seus tipos de conteúdo pelo nome.

Registo de alterações

0.5.0

Cada página de sondagem, voto e ecrã de administração cabe agora no limite do Cloudflare de 10 pedidos por chamada de plugin.

  • Novo - Cada sondagem mantém um total acumulado, pelo que os resultados aparecem com uma só leitura numa sondagem de qualquer tamanho.
  • Novo - O Results inclui Recount votes, que volta a contar uma sondagem a partir dos votos guardados.
  • Melhoria - Eliminar uma sondagem oculta-a de imediato; os seus votos, nomes incluídos, são removidos ao abrir os ecrãs de administração.
  • Melhoria - As horas de abertura e encerramento são lidas das datas da sondagem em cada vista.
  • Correção - No Cloudflare, um voto de convidado já não mostra «Something went wrong» depois de ter sido guardado.
  • Correção - No Cloudflare, o ecrã Polls, o Results, o My votes e o painel Poll já não falham num site com muito tráfego.

Uma sondagem de uma versão anterior é contada na primeira vez que é aberta. Volte a copiar o kit depois de atualizar, a partir da pasta raiz do seu site:

kit="$(mktemp -d)" &&
  git clone --depth 1 \
    --branch v0.5.0 \
    https://github.com/wbcomdesigns/emdash-polls \
    "$kit/emdash-polls" &&
  "$kit/emdash-polls/scripts/add-to-site.sh" .

0.4.0

  • Novo: a permissão Read your content, para que uma sondagem numa página em rascunho continue oculta até a publicar.
  • Novo: um cartão Set up visitor pages e scripts/add-to-site.sh copiam o kit com um só comando.
  • Segurança: os convidados votam apenas onde o anfitrião dá o endereço do visitante. Dois votos enviados em simultâneo por um mesmo votante contam uma vez.

0.3.0

  • Novo: estatísticas das sondagens na lista, um gráfico de barras dos resultados e um bloco opcional This page’s poll para o texto das publicações.

Versões anteriores: https://github.com/wbcomdesigns/emdash-polls/blob/main/CHANGELOG.md