E EmDash CMS Everything Guides, use cases, plugins, templates
Italiano

KnowX Knowledge Base

Una knowledge base ricercabile per EmDash: categorie, feedback sugli articoli e un report su ciò che i lettori cercano.

Estensione

KnowX Knowledge Base

Una knowledge base ricercabile per EmDash: categorie, feedback sugli articoli e un report su ciò che i lettori cercano.

  • Categoria: knowledge base
  • Stato: Disponibile
  • Versione: 0.2.1
  • Prezzo: Sconosciuto
  • Fonte: Registro ufficiale dei plugin
  • Installazione: Plugin sandbox del registro
  • Verificato: 2026-10-21
Apri in Claude Apri in ChatGPT
Condividi su X Condividi su LinkedIn Condividi su Reddit

Descrizione

KnowX trasforma un sito EmDash in un centro assistenza. I visitatori cercano una risposta, sfogliano gli argomenti e dicono se un articolo è stato utile. Tu vedi quali ricerche non trovano nulla e quali articoli ricevono più voti No che Sì.

Cosa ottieni

  • Home dell’assistenza. Una casella di ricerca e schede di argomenti. Quando hai più di una categoria di primo livello, ogni scheda mostra un nome, una breve descrizione e un’icona che scegli tu.
  • Articoli. Indice, copia del link sui titoli, copia sul codice, precedente e successivo, data dell’ultimo aggiornamento, badge di versione facoltativo.
  • Ricerca. La ricerca propria di EmDash, limitata ai tipi di contenuto che selezioni. Risultati istantanei mentre digiti, più una pagina dei risultati. Ogni risultato indica che tipo di contenuto è.
  • FAQ. Una pagina propria, con dati FAQ per i motori di ricerca.
  • Questo articolo è stato utile. Sì o No su ogni articolo. Dopo un No puoi chiedere un breve commento.
  • Ti serve ancora aiuto. Un pulsante di contatto dopo una ricerca vuota e dopo un voto No. Imposti un solo link. Nascosto quando questa impostazione è vuota.
  • Analisi e ricerche. Gli articoli deboli per nome, i commenti come testo semplice, le ricerche principali, le ricerche che non hanno trovato nulla.
  • Scheda della dashboard. Le ricerche vuote di questa settimana e l’articolo meno utile.

Come si incastra il tutto

KnowX è il motore: rotte, archiviazione e schermate di amministrazione. Un plugin EmDash non può aggiungere pagine al tuo sito, quindi le pagine pubbliche vengono fornite come kit per il sito che copi una volta sola. Vedi Installazione.

Gli ospiti cercano, leggono e votano quando l’host fornisce a EmDash l’indirizzo del visitatore (Cloudflare, o trustedProxyHeaders). Altrove gli ospiti vedono un link di accesso per votare, e i membri votano come di consueto.

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 aggiungi sandboxRunner: "@emdash-cms/sandbox-workerd/sandbox", dentro emdash() in astro.config.mjs.
  • Cloudflare: aggiungi import from "@emdash-cms/cloudflare"; e sandboxRunner: sandbox(),. Servono il piano Workers Paid, il binding worker_loaders chiamato LOADER (decommentalo nella tua configurazione Wrangler) e un bucket R2 come storage: r2(...), altrimenti l’installazione si ferma con «Storage error while installing plugin». Poi esegui npm 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 /docs/) mostrano la pagina 404 del tuo sito. È previsto. La copia del kit qui sotto richiede un solo comando.

3. Ti serve Node 22.16 o successivo per il passaggio npx emdash seed.

Verificato su EmDash 1.3.1 con il template blog, su Node e su Cloudflare Workers (installazione dal registro).

Installare

  1. Admin, Registry, cerca KnowX, Install, poi accetta le autorizzazioni.

  2. Dalla cartella radice del tuo sito:

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

  3. Riavvia il server di sviluppo.

  4. In Admin, Menus, aggiungi /docs/ e /docs/faq/.

  5. Apri KnowX, Insights, poi aggiungi gli articoli in Content, Help articles.

Esegui di nuovo il passaggio 2 dopo ogni aggiornamento. Guida: https://github.com/wbcomdesigns/emdash-knowx/blob/v0.2.1/docs/website/getting-started/install.md

FAQ

Perché /docs/ dà un 404 dopo l’installazione? Il plugin non può creare pagine. Esegui le due righe del kit dalla scheda Installation, poi riavvia il server di sviluppo.

I voti o il registro delle ricerche falliscono dopo un’installazione dal registro? Copia il kit per il sito attuale. I kit più vecchi chiamavano solo /plugins/knowx/. Un’installazione dal registro usa un id generato. Il kit attuale prova quell’id, poi il nome.

Gli ospiti possono votare e cercare? Cercare e leggere, sempre. Votare, quando l’host fornisce a EmDash l’indirizzo del visitatore (Cloudflare, o trustedProxyHeaders); altrove gli ospiti vedono un link di accesso e i membri votano.

La ricerca scorre articoli e pagine? Solo i tipi di contenuto che selezioni in Settings. Help articles è attivo per impostazione predefinita. Un tipo con la ricerca disattivata nella sua raccolta non restituirà risultati.

Invia e-mail? No. Il pulsante di contatto è un link che imposti tu: una pagina, un indirizzo http(s) o un indirizzo mailto.

Funziona in modalità scura? Sì. I colori del kit seguono il tema del tuo sito.

Esiste una versione a pagamento? No. Tutto qui è gratuito.

Posso mettere una casella di ricerca dentro un articolo? Non con l’installazione dal registro. Servirebbe un’installazione attendibile, e non fa parte di questa versione.

Registro delle modifiche

0.2.1

Dopo l’aggiornamento dalla 0.1.x, Insights mostra l’avanzamento della migrazione finché non è terminata.

  • Correzione - Insights non mostra più «None yet» mentre i voti della 0.1.x vengono ancora trasferiti.
  • Correzione - Un clic su Sì o No prima che lo script della pagina si carichi viene conservato e inviato. Copia di nuovo il kit.

0.2.0

Ogni pagina di assistenza, voto, ricerca e schermata di amministrazione ora rispetta il limite di Cloudflare di 10 richieste per chiamata di plugin.

  • Novità - Ogni articolo conserva conteggi progressivi di Sì e No, aggiornati con il voto.
  • Novità - Una schermata Searches contiene Top searches e Searches with no results.
  • Novità - I dati della 0.1.x vengono trasferiti un passo alla volta all’apertura di Insights.
  • Miglioramento - Was this helpful risponde subito ai clic e mostra che il voto è in invio. Copia di nuovo il kit.
  • Correzione - Su Cloudflare un voto non mostra più «Something went wrong» dopo essere stato salvato.
  • Correzione - Su Cloudflare, Insights, Settings e le loro azioni non falliscono più su un sito molto trafficato.
  • Correzione - La scheda di configurazione indica dove creare i tipi di contenuto su un sito senza SQLite.

0.1.5

  • Sicurezza: i voti degli ospiti e le ricerche vengono contati solo quando l’host fornisce a EmDash l’indirizzo del visitatore; altrove gli ospiti accedono per votare. Registro delle ricerche limitato a 5000 termini.
  • Novità: un solo comando copia il kit e crea i tipi di contenuto. Insights mostra una scheda Set up visitor pages, e Top searches ha ricerca e paginazione.
  • Correzione: Insights conta ogni ricerca e voto; le pagine di assistenza si allineano alla cornice del tema; i pulsanti in modalità scura raggiungono 4,5:1.

Versioni precedenti: https://github.com/wbcomdesigns/emdash-knowx/blob/main/CHANGELOG.md

Per copiare il kit di questa versione, dalla cartella radice del tuo sito:

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