Panoramica
Il modulo Sondaggi permette di creare questionari online direttamente dal pannello di amministrazione di H2O Shield, senza strumenti esterni. I sondaggi possono essere:
- Anonimi (chiunque può rispondere) o riservati agli utenti loggati
- A pagina singola o multi-sezione con barra di avanzamento
- Limitati per numero massimo di risposte o per data di scadenza
- Pubblicati tramite pagina dedicata oppure shortcode su qualsiasi pagina
I risultati sono disponibili in tempo reale con grafici per ogni domanda e possono essere esportati in formato CSV.
Accedere al pannello di configurazione
Il modulo è accessibile solo agli utenti con il ruolo "Sondaggi - Completo" o agli utenti con ruolo amministrativo.
Percorso: H2O Admin->Sondaggi
Dalla schermata principale si vede la lista di tutti i sondaggi con:
- Titolo e stato (Bozza / Pubblicato)
- Numero totale di risposte ricevute
- Data di creazione
- Azioni rapide: Modifica, Risultati, Esporta CSV, Duplica, Elimina
Creare un sondaggio
- Cliccare il pulsante "Nuovo sondaggio"
- Inserire il titolo e una breve descrizione (facoltativa)
- Aggiungere le domande tramite il builder (vedi sezione 3)
- Configurare le impostazioni (vedi sezione 4)
- Cliccare "Pubblica" per rendere il sondaggio disponibile al pubblico oppure "Salva bozza" per salvarlo senza pubblicarlo
Tipi di domanda
Il builder supporta nove tipi di domanda:
TESTO BREVE (text)
Campo a riga singola. Adatto per nome, email, brevi risposte.
TESTO LUNGO (textarea)
Area di testo multi-riga. Per commenti o descrizioni libere.
DATA (date)
Selettore calendario. Per raccogliere date specifiche.
SCELTA SINGOLA (radio)
L'utente sceglie una sola opzione tra quelle proposte.
Supporta logica condizionale (vedi sezione 5).
SCELTA MULTIPLA (checkbox)
L'utente può selezionare più opzioni contemporaneamente.
MENU A TENDINA (dropdown)
Come la scelta singola ma visualizzata come select.
Utile quando le opzioni sono molte.
SCALA LINEARE (linearScale)
Scala numerica configurabile (es. da 1 a 10).
Si possono aggiungere etichette ai due estremi
(es. "Per niente soddisfatto" / "Molto soddisfatto").
STELLE (rating)
Valutazione da 1 a 5 stelle tramite click.
GRIGLIA A MATRICE (grid)
Tabella righe x colonne con scelta singola o multipla per riga.
Utile per valutare più aspetti con la stessa scala.
Per ogni domanda è possibile:
- Impostare il campo come obbligatorio (asterisco rosso nel frontend)
- Aggiungere un testo di descrizione/aiuto visualizzato sotto il campo
- Configurare la logica condizionale (solo per radio)
Impostazioni del sondaggio
Le impostazioni si trovano nel pannello in basso nell'editor.
AUTENTICAZIONE
[ ] Richiede login
Se attivo, solo gli utenti registrati e loggati possono rispondere.
Nel frontend compare il badge "Richiede login".
Se disattivo, il sondaggio è anonimo (badge "Anonimo").
RISPOSTE MULTIPLE
[ ] Consenti più risposte dallo stesso utente
Se disattivo (default), il sistema previene i duplicati:
- Per utenti loggati: controlla lo user_id nel database
- Per utenti anonimi: usa un identificatore nel browser (localStorage)
DATA DI INIZIO / FINE
Permettono di schedulare automaticamente l'apertura e la chiusura del sondaggio. Prima della data di inizio o dopo la data di fine il sondaggio non è accessibile nel frontend.
NUMERO MASSIMO DI RISPOSTE
Limite assoluto al numero di risposte accettate.
Impostare 0 per nessun limite.
MESSAGGIO DI RINGRAZIAMENTO
Testo personalizzato mostrato dopo l'invio del modulo.
Supporta HTML base (grassetto, corsivo, link).
Logica condizionale
Disponibile solo per le domande di tipo "Scelta singola" (radio). Permette di saltare automaticamente a una sezione diversa in base alla risposta dell'utente.
Configurazione:
Condizione: "è uguale a" / "è diverso da" / "contiene"
Valore: l'opzione che attiva il salto
Azione: Salta alla sezione N / Vai direttamente all'invio
Sezione: numero della sezione di destinazione (se "salta a sezione")
Esempio pratico:
Domanda: "Hai già usato il servizio?"
Opzione: "No" → Salta alla sezione 3 (salta le domande di dettaglio)
Sezioni multiple
Un sondaggio può essere diviso in più sezioni (pagine).
Per aggiungere una sezione cliccare "+ Aggiungi sezione" in fondo all'editor. Ogni sezione può avere:
- Un titolo
- Una descrizione opzionale
- Le proprie domande
Nel frontend viene mostrata una barra di avanzamento (stepper) con i nomi delle sezioni. L'utente naviga con i pulsanti "Avanti" e "Indietro". La validazione avviene sezione per sezione prima di procedere.
Pubblicare e incorporare il sondaggio
PAGINA DEDICATA
Il tema include il template "Sondaggi" da assegnare a una pagina WordPress.
Creare una pagina con slug "sondaggi"
Nella schermata di modifica della pagina selezionare il template "Sondaggi"
La pagina mostrerà automaticamente la lista dei sondaggi attivi
Ogni sondaggio ha un link "Compila" che apre il questionario
URL lista: https://sito.it/sondaggi/
URL singolo: https://sito.it/sondaggi/?id=123
SHORTCODE
Per inserire un singolo sondaggio in qualsiasi pagina o articolo:
[h2o_sondaggio id=123]
Sostituire 123 con l'ID del sondaggio (visibile nell'URL dell'editor).
Risultati e analisi
Dalla lista sondaggi cliccare l'icona "Risultati" per accedere alla schermata di analisi.
SCHEDE RIEPILOGATIVE
In cima alla pagina tre indicatori:
- Risposte totali ricevute
- Durata media di compilazione
- Numero di domande
GRAFICI PER DOMANDA
Per ogni domanda viene mostrato automaticamente il tipo di grafico più adatto:
- Torta (Pie chart): scelta singola, menu a tendina
- Barre (Bar chart): scelta multipla, scala lineare, stelle
- Lista testuale: testo breve, testo lungo, data
- Tabella chip: griglia a matrice
RISPOSTE INDIVIDUALI
Tabella con tutte le risposte ricevute. Mostra per ciascuna:
- ID risposta
- Utente (o "Anonimo")
- Data e ora di invio
- Riepilogo delle risposte alle singole domande
EXPORT CSV
Il pulsante "Esporta CSV" scarica un file con:
- Una riga per risposta
- Una colonna per domanda (intestazione = testo della domanda)
- Il file e' in formato UTF-8 con BOM, compatibile con Excel.
DUPLICA SONDAGGIO
Crea una copia del sondaggio (schema e impostazioni) senza risposte.
Utile per riutilizzare la struttura di un questionario esistente.
Eliminare un sondaggio
L'eliminazione è permanente e rimuove anche tutte le risposte associate. Prima di confermare viene mostrato il numero di risposte che verranno cancellate. Questa operazione non è reversibile.