WB Reviews

Classificações por estrelas e críticas moderadas para artigos e páginas.

Extensão

WB Reviews

Classificações por estrelas e críticas moderadas para artigos e páginas.

Categoria: reviews
Estado: Disponível
Versão: 0.3.0
Preço: Desconhecido
Origem: Registro oficial de plugins
Instalação: Plugin sandbox do registro
Verificado: 2026-10-21

Partilhar no X Partilhar no LinkedIn Partilhar no Reddit

Descrição

O WB Reviews adiciona classificações por estrelas e críticas moderadas a artigos e páginas. Os visitantes leem a média, a distribuição das estrelas e as críticas escritas. Membros ou convidados deixam uma crítica por página. Você aprova o que fica publicado.

O que obtém

Classificações em qualquer conteúdo. Assinale pelo nome os tipos de conteúdo do seu próprio site. Nada está ligado às publicações.
Críticas escritas e só estrelas. O texto é opcional. Uma classificação só com estrelas conta na média e não aparece na lista.
Membros ou qualquer pessoa. Os convidados indicam um nome (e um e-mail se o pedir). As críticas de convidados esperam sempre aprovação. Uma crítica por visitante.
Moderação. Páginas Em espera e Publicadas, pesquisa por texto e eliminação das críticas de um convidado por e-mail.
Resposta do proprietário. Uma resposta pública sob uma crítica, escrita na administração.
Motores de pesquisa. A classificação é adicionada à página como dados estruturados.
Um cartão do painel para o que está em espera, mais um e-mail por hora opcional sem texto de crítica e sem ligação.

Como tudo se encaixa

O plugin é o motor: rotas, armazenamento e os ecrãs de administração. Um plugin do EmDash não pode acrescentar páginas ao seu site, pelo que os ecrãs públicos seguem como um kit de site que copia uma só vez. Veja Instalação.

As críticas não são os comentários do núcleo. Os comentários continuam para a conversa. Este plugin acrescenta uma classificação, uma entrada por pessoa, uma média, uma distribuição em barras e uma resposta do proprietário.

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 { sandbox } 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/reviews/) 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

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

A partir da pasta raiz do seu site:

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

Cole as linhas que imprimiu. Reinicie o servidor de desenvolvimento.
Adicione a ligação de menu que imprimiu em Admin, Menus.
Abra Reviews, Waiting.

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

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

Perguntas frequentes

Porque é que não há bloco de críticas após a instalação? O plugin não pode acrescentar páginas nem CSS. Copie os componentes do kit de site para os seus modelos e depois recarregue.

Porque é que não há formulário de crítica numa página? Esse tipo de conteúdo não está assinalado em Admin → Reviews → Settings. Assinale-o, ou o formulário continua oculto.

Os convidados podem escrever uma crítica? Sim, quando Settings indica que qualquer pessoa pode fazer críticas. Um convidado indica um nome, e um e-mail se o pedir. As críticas de convidados esperam sempre aprovação.

As críticas novas ficam publicadas de imediato? Só as dos membros, e só se desativar a aprovação. Com ela ativada, que é a predefinição, uma crítica espera até a aprovar. Uma alteração a uma crítica publicada também espera; o texto publicado mantém-se até aprovar a alteração.

O que é uma classificação só com estrelas? Estrelas sem texto. Conta na média e nas barras, e não aparece na lista de críticas escritas.

Envia e-mail? No máximo um aviso breve por hora quando há críticas em espera, e só se o ativar e o site tiver correio (o plugin oficial Resend). O aviso não inclui texto de crítica nem ligação.

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

Registo de alterações

0.3.0

Melhoria: cada página, ação de administração e pedido de visitante cabe no limite do Cloudflare de 10 pedidos por chamada de plugin. As contagens mudam com cada crítica em vez de voltar a ler todas as críticas da página.
Melhoria: as páginas Em espera e Publicadas dividem-se por data; o Find pesquisa algumas centenas de críticas por pressão. Delete all my reviews e a eliminação por e-mail funcionam por passos.
Correção: as críticas enviadas no mesmo instante são contadas cada uma uma vez. As classificações que a 0.2.0 perdeu são reconstruídas.
Depois de atualizar, abra Reviews na administração: transfere os dados da 0.2 em poucos passos enquanto continua a moderar. Sem permissão nova.

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.3.0 \
    https://github.com/wbcomdesigns/emdash-reviews \
    "$kit/emdash-reviews" &&
  "$kit/emdash-reviews/scripts/add-to-site.sh" .

0.2.2

Correção: voltar a executar scripts/add-to-site.sh num site cuja página de publicação e cujo cartão de publicação já mostram o WB Reviews indica que as linhas já estão no sítio.

0.2.1

Segurança: os convidados fazem críticas apenas onde o anfitrião passa o endereço do visitante (Cloudflare ou trustedProxyHeaders); noutros casos iniciam sessão. O IPv6 conta-se por /64.
Novo: o Waiting mostra Set up visitor pages. O scripts/add-to-site.sh copia o kit e imprime as linhas a colar.
Correção: as críticas em espera já não ocultam as publicadas nem estragam a classificação; as páginas não publicadas não mostram nada.

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