Product Roadmap
Una roadmap pubblica in cui le persone votano le idee e ne propongono di proprie, con un registro delle modifiche di ciò che è stato rilasciato.
Estensione
Product Roadmap
Una roadmap pubblica in cui le persone votano le idee e ne propongono di proprie, con un registro delle modifiche di ciò che è stato rilasciato.
Descrizione
Una roadmap pubblica per qualsiasi sito EmDash. I visitatori vedono cosa stai valutando, costruendo e hai rilasciato. Possono votare e possono inviare un’idea che attende la tua approvazione.
Cosa ottieni
- Una bacheca con fasi che nomini tu. Inizia con Under review, Planned, In progress e Done. Aggiungile, nascondile, rinominale o riordinale.
- Votazione. Un voto per persona per elemento. Fai di nuovo clic per ritirarlo.
- Suggerimenti con approvazione. Un’idea viene salvata come bozza. La approvi per metterla sulla bacheca oppure la rifiuti.
- Ospiti o membri. Scegli tu chi può votare e suggerire. Gli ospiti indicano un nome. Le idee scritte attendono sempre la revisione.
- Un registro delle modifiche. Una seconda raccolta con una pagina elenco e una pagina per ogni release.
- Commenti. La pagina dell’elemento usa i commenti propri di EmDash. Nulla in più da moderare.
- Unione. Unisci un duplicato all’elemento che conservi. I voti si spostano, uno per persona.
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 pagine pubbliche vengono fornite come kit per il sito che copi una volta sola. Vedi Installazione.
L’e-mail oraria richiede un provider di posta. La scheda della dashboard mostra comunque quante idee sono in attesa quando la posta è disattivata.
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 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 /roadmap/) 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
-
Admin, Registry, cerca Product Roadmap, Install, poi accetta le autorizzazioni.
-
Dalla cartella radice del tuo sito:
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.4.0 \ https://github.com/wbcomdesigns/emdash-roadmap \ "$kit/emdash-roadmap" && "$kit/emdash-roadmap/scripts/add-to-site.sh" . -
Niente da incollare. Riavvia il server di sviluppo.
-
Aggiungi i link stampati in Admin, Menus.
-
Apri Admin, Roadmap, Ideas.
Dopo ogni aggiornamento, esegui il passaggio 2 con il nuovo tag. Guida completa: https://github.com/wbcomdesigns/emdash-roadmap/blob/v0.4.0/docs/website/getting-started/install.md
FAQ
Perché /roadmap/ dà un 404 dopo l’installazione?
Il plugin non può creare pagine. Esegui il comando del kit dalla scheda Installation (o da Admin, Roadmap, Ideas) con il tag della versione che hai installato, poi riavvia il server di sviluppo.
La bacheca dice che non è stato possibile caricarla. Copia di nuovo il kit dal tag della versione che hai installato. Il kit e il plugin vengono rilasciati insieme.
Gli ospiti possono votare e suggerire idee?
Sì, quando Settings è impostato su Anyone (predefinito) e l’host fornisce a EmDash l’indirizzo del visitatore: Cloudflare, oppure trustedProxyHeaders nella configurazione del sito. Altrimenti gli ospiti vedono un link di accesso e Settings lo dice. Ogni idea attende la tua approvazione.
Un ospite vede un 401 nella console del browser. È previsto: la pagina controlla prima i voti di un membro connesso. La pagina è a posto.
Come sposto un elemento in un’altra fase? Nella schermata di modifica dell’elemento, usa il pannello Stage a destra.
Le nuove idee vanno online subito? No. Un suggerimento viene salvato come bozza. Approvalo in Ideas per metterlo sulla bacheca.
Cosa succede se rinomino una fase? La bacheca usa il nuovo nome. Gli elementi restano in quella colonna. Non devi modificare ogni elemento.
Funziona in modalità scura? Sì. I colori del kit seguono il tema del tuo sito.
Invia e-mail? Un breve avviso all’ora quando ci sono idee in attesa, se il sito ha un provider di posta. L’avviso non contiene il testo dell’idea né link. La scheda della dashboard mostra sempre il conteggio.
Esiste una versione a pagamento? No. Tutto qui è gratuito.
Registro delle modifiche
0.4.0
Ogni pagina, voto e schermata di amministrazione ora resta entro il limite di Cloudflare di 10 richieste per chiamata di plugin su un sito di prova molto trafficato. Cloudflare resta segnato come non supportato finché non viene verificato lì. Nessuna nuova autorizzazione.
- Novità: ogni elemento conserva un conteggio progressivo dei voti; i conteggi della 0.3.0 vengono ricostruiti al caricamento della pagina Ideas e ogni ora.
- Miglioramento: l’unione, la cancellazione dei voti Roadmap e la pulizia oraria vengono eseguite a passi.
- Correzione: su Cloudflare un voto di un ospite veniva rifiutato con «not on the board».
- Correzione: lo script del kit non afferma più che i tipi di contenuto siano stati creati su un sito Cloudflare.
Copia di nuovo il kit dopo l’aggiornamento. Fino ad allora, una bacheca filtrata per categoria mostra ogni elemento e Take back all my votes si ferma con un errore dopo 7.
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.4.0 \
https://github.com/wbcomdesigns/emdash-roadmap \
"$kit/emdash-roadmap" &&
"$kit/emdash-roadmap/scripts/add-to-site.sh" .
0.3.0
Nuova autorizzazione: Read retained content revision history, in modo che il pannello Stage possa vedere e spostare un elemento mentre ha modifiche non pubblicate. La approvi una volta all’aggiornamento. Gli ospiti hanno bisogno di un indirizzo del visitatore per votare. Copia di nuovo il kit dopo l’aggiornamento:
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.3.0 \
https://github.com/wbcomdesigns/emdash-roadmap \
"$kit/emdash-roadmap" &&
"$kit/emdash-roadmap/scripts/add-to-site.sh" .
- Novità: scheda Set up visitor pages; scripts/add-to-site.sh copia l’intero kit.
- Miglioramento: il pannello Stage è l’unico posto per impostare la fase.
- Correzione: conteggi di Ideas, modulo annidato, allineamento, modalità scura.
- Sicurezza: nessuna scrittura da parte degli ospiti senza un indirizzo del visitatore; un ospite per IPv4 o IPv6 /64; hash cancellati dopo 30 giorni.
0.2.1
- Correzione: il file My votes non ha più lo stesso nome di quello di WB Polls, così entrambi i kit possono stare su uno stesso sito. Copia di nuovo il kit dopo l’aggiornamento.
Versioni precedenti: https://github.com/wbcomdesigns/emdash-roadmap/blob/main/CHANGELOG.md