WebBlocks Polls

Crea sondaggi multilingue a scelta singola o multipla, inseriscili nel sito con il blocco nativo Poll e consulta i risultati aggregati. Questa guida documenta Polls 0.1.4.

Usa PHP 8.3 o successivo e WebBlocks CMS ^1.92.1. Scarica lo ZIP compatibile dalla pagina di Polls nel catalogo. Installalo in Sistema → Plugin, attivalo e verifica il completamento della configurazione del database. Apri Sondaggi e scegli il sito a cui apparterrà il sondaggio.

Scegli Aggiungi sondaggio e inserisci un nome interno e un identificatore stabile, ad esempio next-workshop. I blocchi memorizzano questo identificatore: evita di cambiarlo dopo l'inserimento. Scrivi la domanda e almeno due opzioni non vuote. Un sondaggio supporta fino a venti righe di opzioni.

Seleziona Scelta singola per consentire un'opzione per votante oppure Scelta multipla per consentirne diverse. Mantieni domanda, descrizione facoltativa ed etichette per ogni lingua pubblicata. Il plugin include traduzioni delle interfacce di gestione e voto per le sei lingue del CMS; domanda e opzioni sono contenuti tuoi.

Per esempio, un sondaggio sui laboratori potrebbe chiedere «Quale laboratorio dovremmo organizzare prossimamente?» con Fotografia, Ceramica e Illustrazione. Salvalo come Bozza mentre rivedi testi e traduzioni.

Il sondaggio ha tre stati: Bozza, Pubblicato e Chiuso. I valori facoltativi Inizio e Fine delimitano il periodo di voto. Pubblica il sondaggio quando è pronto e verifica le date prima di invitare a votare.

Nel page builder aggiungi il blocco nativo Poll del plugin e seleziona il sondaggio del sito. L'identificatore del tipo di blocco è webblocks-polls::poll; i blocchi creati tramite API salvano l'identificatore stabile del sondaggio in plugin_settings.poll. Visualizza l'anteprima, verifica domanda e opzioni e segui la normale procedura di pubblicazione. Pubblicare un sondaggio non pubblica la pagina che contiene il suo blocco.

Configura Mostra risultati in base all'esperienza desiderata:

• Sempre (always): mostra risultati aggregati al posto del modulo di voto.
• Dopo il voto (after_vote): mostra i risultati dopo il voto del visitatore.
• Dopo la chiusura (after_close): mostra i risultati quando il sondaggio non è aperto.
• Mai (never): non mostra pubblicamente i risultati.

Queste impostazioni controllano la visibilità pubblica. Gli operatori autorizzati possono comunque consultare risultati ed esportare dati CSV aggregati. Visualizzare sondaggi, Gestire sondaggi ed Esportare risultati sono permessi separati del plugin.

In 0.1.4, Dopo la chiusura usa il calcolo attuale di apertura/chiusura. Può quindi mostrare risultati anche per una bozza o un sondaggio con inizio futuro. Non inserire bozze in pagine pubblicate; usa Dopo il voto o Mai se i risultati di un sondaggio programmato devono restare nascosti prima dell'apertura.

Il voto usa protezione CSRF, limiti di frequenza per rotta e un'impronta HMAC pseudonima del votante. Il plugin non conserva gli indirizzi IP grezzi dei visitatori. La protezione dai voti ripetuti è un deterrente pratico: cambiare sessione o rete può consentire un altro voto. Usa un processo diverso se è necessario garantire un solo voto verificato per persona.

Il plugin attivo aggiunge le proprie rotte alla discovery del CMS e a OpenAPI:

• GET /webadmin/api/polls e GET /webadmin/api/polls/{poll} richiedono polls.read.
• POST /webadmin/api/polls e PATCH /webadmin/api/polls/{poll} richiedono polls.write.
• GET /webadmin/api/polls/{poll}/results richiede polls.read.

Fornisci contesto del sito autorizzato e lingua insieme a domanda ed etichette tradotte. Usa la discovery per il contratto dati della versione installata. Le API di gestione richiedono autenticazione con token e non sostituiscono il flusso pubblico di voto protetto da CSRF.

Se il blocco non mostra il sondaggio atteso, controlla identificatore selezionato, sito proprietario, attivazione del plugin, stato di pubblicazione e date. Se i risultati sono nascosti, verifica Mostra risultati prima di modificare il sondaggio. Se il salvataggio fallisce, controlla che almeno due opzioni abbiano un'etichetta e che la fine sia successiva all'inizio.

Torna alla panoramica dei plugin, consulta la versione del catalogo oppure usa il riferimento dell'Internal Content API.