Crea e gestisci sondaggi con WebBlocks Polls

Prepara un sito di prova e un account Super admin per l'installazione. Il pacchetto pubblicato dichiara compatibilità con PHP ^8.3, CMS ^1.106.5 e Laravel ^13.0. La versione CMS può richiedere PHP più recente; questa guida usa PHP 8.4. Controlla il risultato per il tuo host nel catalogo ufficiale di Polls.

Servono anche una pagina modificabile e pubblicabile e il permesso di gestire sondaggi. Il sito principale della dimostrazione è Northstar Studio. Le pagine sono Choose our next workshop, su /workshop-vote, e What would you like to learn?, su /workshop-options.

I sondaggi appartengono ai siti. In 0.1.6, elenco e modulo normali non hanno un selettore del sito: senza contesto esplicito di Polls viene usato il sito principale accessibile. Cambiare sito in Pages non sostituisce la verifica della proprietà del sondaggio. Per integrazioni multisito usa il contesto esplicito della documentazione API di Polls. Il blocco di una pagina elenca solo sondaggi del sito della pagina.

Decidi come usare le risposte, chi leggerà i totali e quando fermare la votazione. Mantieni la domanda breve, le opzioni distinte e non raccogliere informazioni inadatte a un sondaggio pubblico. Polls è utile per feedback semplici; l'impronta del visitatore non dimostra un voto per ogni persona distinta verificata.

1. Apri System → Plugins come Super admin.
2. Scegli Browse Plugin Catalog e cerca WebBlocks Polls.
3. Esamina versione, compatibilità e note prima di usare Install from Catalog.
4. Se l'amministratore fornisce l'archivio pubblicato attendibile, selezionalo in Plugin ZIP e scegli Upload Plugin ZIP.
5. Controlla il pacchetto installato e attivalo.

L'esempio installa lo ZIP ufficiale pubblicato. Un plugin appena installato resta disattivato finché non lo attivi.

Apri i dettagli e scegli Enable Plugin. Installazione e attivazione nel CMS attuale applicano le modifiche al database del plugin. Prima di raccogliere voti, verifica Enabled, uno stato sano e le tabelle pronte. Risolvi prima eventuali avvisi di compatibilità o migrazione.

La barra laterale contiene ora il gruppo Polls con la voce Polls. Aprila. Un'installazione nuova mostra No polls have been created yet. e Add poll.

Polls distingue visualizzazione, gestione ed esportazione:

Concedi al redattore i permessi necessari di visualizzazione e gestione. Aggiungi consapevolmente l'esportazione. L'accesso al sito è un confine separato: i permessi del plugin non aprono i sondaggi di tutti i siti. Consulta Ruoli e permessi prima di modificare un ruolo condiviso.

Per inserire il blocco Poll servono anche i normali permessi di pagina e blocco. Creare il sondaggio e modificare la pagina che lo contiene sono attività distinte.

Scegli Add poll. La prima scheda controlla identità e disponibilità:

L'handle non è l'indirizzo della pagina. Il blocco lo memorizza per trovare il sondaggio: evita di cambiarlo dopo l'inserimento. Rendi il nome chiaro ai colleghi e mantieni stabile l'handle.

Scorri a Poll copy e inserisci:

Domanda, descrizione facoltativa ed etichette sono i testi visibili ai visitatori. In 0.1.6, il modulo normale offre quattro righe: questo editor non ha un comando Add choice. Devi compilare almeno due etichette. Il contratto di integrazione accetta fino a venti righe, ma questo non rende disponibili venti righe nel modulo.

Scegli Save poll e verifica Poll saved.. Torna all'elenco e controlla handle, stato Draft e zero voti.

Nome e domanda ammettono fino a 255 caratteri; handle 100, descrizione facoltativa 2 000 e ciascuna etichetta 255. Domande brevi ed etichette concise sono più leggibili su dispositivi mobili.

Riapri Next Northstar workshop. Locale indica la copia linguistica scritta dal prossimo salvataggio; non è il selettore della lingua di amministrazione. Digitare un altro codice non carica i testi già presenti per quella lingua.

Per aggiungere l'esempio turco:

1. Cambia Locale da en a tr.
2. Sostituisci la domanda con Bir sonraki atölyemiz hangisi olsun?.
3. Traduci descrizione e righe corrispondenti: Fotoğrafçılık, Seramik, İllüstrasyon.
4. Mantieni ogni opzione nella stessa riga e lascia vuota la quarta facoltativa.
5. Conserva i valori condivisi previsti per nome, handle, modalità e disponibilità, poi scegli Save poll.

Salvare una traduzione invia anche i campi operativi condivisi del modulo. Controllali per evitare pubblicazioni o riprogrammazioni accidentali mentre aggiungi testo. L'indirizzo di modifica salvato mantiene ?locale=tr. Usa quella vista per modificare il turco; il normale collegamento nell'elenco apre la lingua predefinita del pannello.

Domanda ed etichette inglesi restano memorizzate. Il blocco pubblico usa la lingua richiesta dalla pagina per domanda, descrizione, opzioni, controlli e messaggi. Se manca un testo, usa prima la lingua di ripiego configurata e poi la prima copia disponibile. Traduci domanda e tutte le opzioni corrispondenti per ogni lingua da pubblicare.

Dopo aver pubblicato sondaggio e pagina nei prossimi passaggi, verifica il percorso tradotto oltre a quello inglese. La lingua pubblica del sondaggio è indipendente dalla lingua di amministrazione dell'operatore. Consulta Aggiungere una lingua al sito per abilitare lingue e tradurre il resto della pagina.

Show results cambia ciò che mostra il blocco Poll. Non elimina i totali salvati e non sostituisce i permessi degli operatori.

L'avviso This poll is closed. può comparire anche se il visitatore ha già votato e la regola nasconde i risultati oppure l'inizio non è ancora arrivato. Questo messaggio generico non prova da solo che l'operatore abbia scelto Status → Closed. Esamina insieme stato, date e regola dei risultati.

Per il primo esercizio mantieni After voting. Offre il modulo prima dell'invio e un risultato visibile dopo.

Apri il sondaggio inglese salvato, cambia Status in Published e scegli Save poll. Lascia vuote entrambe le date per questa prima prova. Torna all'elenco e conferma Published accanto a next-workshop.

Pubblicare il sondaggio lo rende selezionabile nel blocco della pagina. Non crea la pagina, non aggiunge il blocco e non pubblica la pagina. Il voto è aperto solo quando è Published e le eventuali condizioni di inizio e fine lo consentono.

Apri la pagina in Pages, scegli Edit Blocks per lo slot Main e individua il contenitore dove inserire il sondaggio. La nostra pagina ha già titolo e introduzione. Se parti da zero, consulta Pagina, layout, slot e blocco e Creare una pagina.

1. Usa Add child block sul contenitore oppure Add Block in una posizione idonea.
2. Cerca Poll nel catalogo.
3. Scegli Poll, descritto come Places a published poll on a page..

In Block Fields scegli Next Northstar workshop dal selettore Poll. Premi Save New Block.

Il selettore elenca i sondaggi Published del sito della pagina. Se manca quello atteso, controlla prima stato e sito proprietario. Un inizio futuro non rimuove il sondaggio pubblicato dal selettore, ma continua a determinare quando il modulo pubblico accetta voti.

Il blocco fa riferimento al sondaggio originale anziché copiarne domanda e opzioni nella pagina. Le modifiche successive possono influenzare tutte le pagine che usano lo stesso handle. Crea un nuovo sondaggio per una nuova campagna invece di riutilizzarne uno con voti esistenti.

Apri la Preview salvata della pagina. Controlla domanda, descrizione, pulsanti di scelta e regola dei risultati. Verifica che il blocco Poll e i blocchi superiori siano abilitati alla pubblicazione.

Considera un'anteprima con un sondaggio Published attivo come una vera interazione. Un invio di prova non è necessariamente simulato e può aggiungere una scheda reale. Qui esaminiamo l'anteprima e votiamo solo dalla pagina pubblicata localmente.

Quando è pronta, segui Pubblicare una pagina. In Overview usa Publish se il ruolo lo consente oppure il flusso di revisione del team. Apri quindi View Page e verifica il percorso pubblico reale.

Nella nostra pagina pubblicata scegli Photography. Si può selezionare un solo pulsante di scelta alla volta.

Premi una volta Vote e verifica Thank you. Your vote was recorded.. Con After voting, i risultati aggregati sostituiscono il modulo nella sessione corrente.

L'unica scheda di prova dà a Photography 100% (1 votes) e zero alle altre opzioni. La sua barra occupa tutta la traccia; un'opzione a zero lascia la traccia vuota. Ogni barra usa la stessa scala 0–100%. Nome, percentuale e conteggio restano leggibili sopra. L'esempio illustra il flusso, ma non basta per conclusioni reali sulle preferenze dei visitatori.

Ricarica la pagina. Il risultato resta disponibile nella stessa sessione e il modulo non ricompare. La visibilità dopo il voto dipende dallo stato della sessione; un browser che torna dopo un cambio di sessione può vedere un'altra vista. Non promettere accesso personale permanente ai risultati.

Apri la traduzione turca per controllare il testo salvato. Chi non ha votato vede Bir sonraki atölyemiz hangisi olsun?, le opzioni tradotte e il pulsante Oy ver, come sotto. Una sessione che ha già votato vede risultati turchi con After voting. Entrambi i percorsi puntano allo stesso sondaggio: cambiare lingua non crea un altro voto.

Per un confronto visivo separato, l'immagine seguente usa un sondaggio sintetico con 20 schede: 12 scelte per Photography, 6 per Ceramics e 2 per Illustration. Le barre indicano 60%, 30% e 10% sulla stessa scala. Questo insieme è separato dall'esempio con una scheda: non è una ricerca reale sul pubblico e non modifica gli altri conteggi.

Le barre usano elementi meter HTML nativi con lo stile della primitiva condivisa WebBlocks UI. Non richiedono librerie di grafici o JavaScript per rappresentare i valori. Mantieni il testo visibile durante l'esame: colore e lunghezza sono indizi aggiuntivi.

Torna a Polls nel pannello. La colonna Votes conta le schede registrate. Il sondaggio a scelta singola ora ne mostra una.

Per i totali per opzione, apri il sondaggio salvato e scorri sotto le scelte. Seleziona Export CSV accanto a Save poll. Servono il permesso Export poll results e l'accesso al sito proprietario.

L'esportazione contiene dati aggregati: etichetta dell'opzione e numero di selezioni. Non è un elenco dei singoli votanti o dei loro indirizzi IP. L'esempio inglese a scelta singola produce:

L'editor normale di 0.1.6 non ha una dashboard separata dei risultati per opzione. Usa il numero di schede dell'elenco, i totali CSV o l'endpoint aggregato autorizzato della documentazione API di Polls. Il valore pubblico Show results non elimina l'esportazione autorizzata.

Crea un altro sondaggio per conservare significato e voti del primo. Il secondo esempio usa:

Inserisci un blocco Poll in What would you like to learn?, scegli il secondo sondaggio, verifica l'anteprima e pubblica. Il modulo pubblico ora usa caselle di controllo. Seleziona Photography e Illustration.

Premi Vote. Una scheda registra entrambe le scelte.

La percentuale di ogni opzione usa il numero di schede come denominatore. Qui una su una sceglie Photography e una su una Illustration; entrambe mostrano 100% con barre complete. Nella scelta multipla le percentuali non devono sommare a 100%: sono barre indipendenti, non segmenti di una barra unica del 100%. L'elenco conta ancora una scheda, mentre il CSV contiene due voti per le opzioni selezionate.

Dopo il voto riuscito, la sessione non riceve più il modulo normale. Se Back del browser ripristina il modulo precedente e il visitatore lo invia di nuovo, il server controlla anche l'impronta. Il nostro reinvio restituisce You have already voted in this poll. e il totale resta una scheda.

Il plugin usa protezione CSRF, limiti di richieste per rotta e un'impronta HMAC pseudonima basata su sondaggio, sessione, IP della richiesta e user agent. Non memorizza l'IP grezzo come campo della scheda. È un deterrente pratico, non identità verificata: cambiare sessione o altri dati dell'impronta può permettere un altro voto. Quando è essenziale un voto verificato per persona, usa un processo adeguato basato sull'identità.

Se compare una risposta di limite delle richieste, interrompi i reinvii e attendi il periodo normale. Non disattivare il limite per aggirarla. Esercita voto e ripetizioni su un sondaggio usa e getta; non aggiungere prove ai totali che vuoi utilizzare.

A votazione conclusa, riapri il sondaggio, imposta Status → Closed e scegli Save poll. La chiusura conserva schede e traduzioni.

Nel primo esempio impostiamo anche Show results → Never per mostrare un sondaggio chiuso senza totali pubblici.

Ricarica la pagina pubblica. La domanda resta, il modulo non è disponibile e il blocco mostra This poll is closed..

Per rendere pubblici i totali conservati dopo la fine, scegli una regola adatta. Con After closing su questo sondaggio effettivamente Closed, il blocco mostra i conteggi salvati e nessun modulo.

Per riaprire lo stesso sondaggio imposta Status → Published, controlla date e regola e salva. I voti rimangono; riaprire non azzera i votanti precedenti né crea una nuova campagna. Abbiamo verificato la riapertura con la scheda originale conservata. Crea nuovo sondaggio e handle quando la domanda successiva richiede totali indipendenti.

Il sondaggio accetta voti solo se è Published, l'inizio è vuoto o raggiunto e la fine è vuota o ancora futura. La fine deve seguire l'inizio. Chiuderlo manualmente ferma il voto indipendentemente dalle date.

Usa date future adatte al tuo evento. L'esempio separato Scheduled workshop usa novembre 2030 per rimanere chiaramente futuro durante la dimostrazione. Il modulo non indica il fuso orario vicino alle date: conferma quello dell'applicazione con l'amministratore, senza presumere che il fuso di visualizzazione del sito converta automaticamente questi valori.

Con After closing, prima dell'apertura questo sondaggio futuro mostra un avviso di chiusura senza totali o modulo. All'inizio della finestra Published i visitatori possono votare mentre i risultati restano nascosti. Alla scadenza i risultati conservati diventano visibili. Anche lo stato esplicito Closed li consente; Draft non li consente, neppure con date passate.

Scegli After closing per attendere la fine, After voting per mostrare i risultati alla sessione che ha votato o Never per nascondere i totali pubblici. Controlla la pagina reale a ogni confine. Always mostra risultati al posto del modulo e non è una soluzione per raccogliere voti.

Il calcolo aperto/chiuso avviene durante le richieste; non serve un'attività separata per cambiare stato a ogni scadenza. Prova il comportamento reale di inizio e fine sul tuo host prima di affidarti alla programmazione. Controlla anche le cache tra visitatore e applicazione, per evitare che vecchie pagine rappresentino male lo stato attuale.

Prima di invitare visitatori reali, verifica sito proprietario, handle stabile, testo, modalità, permessi, date e regola dei risultati. Controlla separatamente pagina e percorso pubblicato. Invia una scheda di prova in un sondaggio usa e getta, verifica conteggio e CSV, poi creane uno nuovo per i totali effettivi.

Per un lancio multilingue o programmato, verifica ogni lingua prevista e i confini temporali rilevanti. Oltre al modulo salvato controlla la vista reale e i conteggi registrati. Assegna a un operatore la chiusura, l'esportazione e la responsabilità di mantenere appropriati i risultati pubblici.

Prosegui con la documentazione di Polls per l'integrazione, Ruoli e permessi per l'accesso o Pubblicare una pagina per il flusso delle pagine.