WB Reviews
Valutazioni a stelle e recensioni moderate per articoli e pagine.
Estensione
WB Reviews
Valutazioni a stelle e recensioni moderate per articoli e pagine.
Descrizione
WB Reviews aggiunge valutazioni a stelle e recensioni moderate ad articoli e pagine. I visitatori leggono la media, la ripartizione delle stelle e le recensioni scritte. Membri od ospiti lasciano una recensione per pagina. Tu approvi ciò che viene pubblicato.
Cosa ottieni
- Valutazioni su qualsiasi contenuto. Seleziona per nome i tipi di contenuto del tuo sito. Niente è legato agli articoli.
- Recensioni scritte e solo stelle. Il testo è facoltativo. Una valutazione con sole stelle conta nella media e non compare nell’elenco.
- Membri o chiunque. Gli ospiti indicano un nome (e un’e-mail se la chiedi). Le recensioni degli ospiti attendono sempre l’approvazione. Una recensione per visitatore.
- Moderazione. Pagine In attesa e Pubblicate, ricerca per testo ed eliminazione delle recensioni di un ospite tramite e-mail.
- Risposta del proprietario. Una risposta pubblica sotto una recensione, scritta nell’amministrazione.
- Motori di ricerca. La valutazione viene aggiunta alla pagina come dati strutturati.
- Una scheda della dashboard per ciò che è in attesa, più un’e-mail oraria facoltativa senza testo della recensione e senza link.
Come si incastra il tutto
Il plugin è il motore: rotte, archiviazione e schermate di amministrazione. Un plugin EmDash non può aggiungere pagine al tuo sito, quindi le schermate pubbliche vengono fornite come kit per il sito che copi una volta sola. Vedi Installazione.
Le recensioni non sono i commenti del core. I commenti restano per la conversazione. Questo plugin aggiunge una valutazione, una voce per persona, una media, una ripartizione a barre e una risposta del proprietario.
Installazione
Prima di installare
1. Il tuo sito ha bisogno di un runner sandbox. I plugin del registro vengono eseguiti in una sandbox. Finché il sito non ne ha uno, Admin, Plugins mostra «No plugins configured» e nel menu non c’è Registry.
- Node: nel tuo sito esegui
npm install @emdash-cms/sandbox-workerd workerd, poi aggiungisandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",dentroemdash()inastro.config.mjs. - Cloudflare: aggiungi
import { sandbox } from "@emdash-cms/cloudflare";esandboxRunner: sandbox(),. Servono il piano Workers Paid, il bindingworker_loaderschiamatoLOADER(decommentalo nella tua configurazione Wrangler) e un bucket R2 comestorage: r2(...), altrimenti l’installazione si ferma con «Storage error while installing plugin». Poi eseguinpm run deploy.
Ferma il server di sviluppo e riavvialo. Registry ora compare nel menu di amministrazione.
2. Il plugin è il motore. Le pagine per i visitatori provengono dal suo kit per il sito. Un plugin del registro non può aggiungere pagine al tuo sito. Finché non copi il kit, i suoi indirizzi (per esempio /account/reviews/) mostrano la pagina 404 del tuo sito. È previsto. La copia del kit qui sotto richiede un solo comando.
Verificato su EmDash 1.3.1 con il template blog, su Node e su Cloudflare Workers (installazione dal registro).
Installare
-
Admin, Registry, cerca WB Reviews, Install, poi accetta le autorizzazioni.
-
Dalla cartella radice del tuo sito:
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" . -
Incolla le righe stampate. Riavvia il server di sviluppo.
-
Aggiungi il link di menu stampato in Admin, Menus.
-
Apri Reviews, Waiting.
Dopo ogni aggiornamento, esegui il passaggio 2 con il nuovo tag.
Guida: https://github.com/wbcomdesigns/emdash-reviews/blob/v0.3.0/docs/website/getting-started/install.md
FAQ
Perché dopo l’installazione non c’è il blocco delle recensioni? Il plugin non può aggiungere pagine né CSS. Copia i componenti del kit per il sito nei tuoi template, poi ricarica.
Perché non c’è il modulo di recensione su una pagina? Quel tipo di contenuto non è selezionato in Admin → Reviews → Settings. Selezionalo, altrimenti il modulo resta nascosto.
Gli ospiti possono scrivere una recensione? Sì, quando Settings indica che chiunque può recensire. Un ospite indica un nome, e un’e-mail se la chiedi. Le recensioni degli ospiti attendono sempre l’approvazione.
Le nuove recensioni vengono pubblicate subito? Solo quelle dei membri, e solo se disattivi l’approvazione. Con l’approvazione attiva, cioè l’impostazione predefinita, una recensione attende finché non la approvi. Anche una modifica a una recensione pubblicata attende; il testo pubblicato resta finché non approvi la modifica.
Che cos’è una valutazione con sole stelle? Stelle senza testo. Conta nella media e nelle barre, e non compare nell’elenco delle recensioni scritte.
Invia e-mail? Al massimo un breve avviso all’ora quando ci sono recensioni in attesa, e solo se lo attivi e il sito dispone di posta (il plugin ufficiale Resend). L’avviso non contiene né testo della recensione né link.
Esiste una versione a pagamento? No. Tutto qui è gratuito.
Registro delle modifiche
0.3.0
- Miglioramento: ogni pagina, azione di amministrazione e richiesta dei visitatori rispetta il limite di Cloudflare di 10 richieste per chiamata di plugin. I conteggi si aggiornano con ogni recensione invece di rileggere tutte le recensioni della pagina.
- Miglioramento: le pagine In attesa e Pubblicate sono suddivise per data; Find cerca alcune centinaia di recensioni a ogni pressione. Delete all my reviews e l’eliminazione tramite e-mail funzionano a passi.
- Correzione: le recensioni inviate nello stesso momento vengono contate ciascuna una volta. Le valutazioni perse dalla 0.2.0 vengono ricostruite.
- Dopo l’aggiornamento apri Reviews nell’amministrazione: trasferisce i dati della 0.2 in pochi passi mentre continui a moderare. Nessuna nuova autorizzazione.
Copia di nuovo il kit dopo l’aggiornamento, dalla cartella radice del tuo sito:
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
- Correzione: rieseguire scripts/add-to-site.sh su un sito la cui pagina dell’articolo e la cui scheda dell’articolo mostrano già WB Reviews segnala che le righe sono già al loro posto.
0.2.1
- Sicurezza: gli ospiti recensiscono solo dove l’host passa l’indirizzo del visitatore (Cloudflare o trustedProxyHeaders); altrimenti accedono. L’IPv6 viene contato per /64.
- Novità: Waiting mostra Set up visitor pages. scripts/add-to-site.sh copia il kit e stampa le righe da incollare.
- Correzione: le recensioni in attesa non nascondono più quelle pubblicate né rompono la valutazione; le pagine non pubblicate non mostrano nulla.
Versioni precedenti: https://github.com/wbcomdesigns/emdash-reviews/blob/main/CHANGELOG.md