||||\n-|-|-|\n:discourse2: | Riepilogo | Il plugin Discourse Surveys ti consente di creare sondaggi direttamente nei tuoi post del forum Discourse utilizzando una semplice sintassi Markdown.\n:hammer_and_wrench: | Link Repository | \u003chttps://github.com/discourse/discourse-surveys\u003e\n:open_book: | Guida all’installazione | Come installare i plugin in Discourse\n\nIl plugin Discourse Surveys ti consente di creare sondaggi direttamente nei tuoi post del forum Discourse utilizzando una semplice sintassi Markdown. Il plugin attualmente supporta una varietà di tipi di domande come pulsanti di opzione, caselle di controllo, menu a discesa, input numerici, aree di testo, valutazioni a stelle e valutazioni pollice su/giù.\n\n## Funzionalità\n\n- 7 Tipi di Campo Diversi: Pulsanti di opzione, caselle di controllo, menu a discesa, aree di testo, selezione numerica, valutazioni a stelle e pollice su/giù\n\n- Campi Obbligatori/Opzionali: Contrassegna i campi come obbligatori per garantirne il completamento\n\n- Supporto Emoji: Utilizza emoji nelle opzioni del tuo sondaggio\n\n- Supporto HTML: Formattazione di testo ricco nelle domande e nelle opzioni\n\n- Autenticazione Utente: Richieste di accesso automatiche per gli utenti anonimi\n\n- Tracciamento Risposte: Impedisce invii duplicati dallo stesso utente\n\n- Consapevole dei Permessi: Rispetta i permessi di topic e categoria\n\n- Responsive per Mobile: Funziona perfettamente su tutti i dispositivi\n\n## Utilizzo\n\n### Struttura Base del Sondaggio\n\nTutti i sondaggi devono essere racchiusi tra i tag [survey]:\n\nmarkdown\n\n[survey name=\"my-survey\" title=\"Customer Feedback Survey\"]\n\n\u003c!-- I campi del sondaggio vanno qui --\u003e\n\n[/survey]\n\n\n\n### Attributi del Sondaggio\n\n- name: Identificatore univoco per il sondaggio (predefinito su "survey")\n\n- title: Titolo opzionale visualizzato in cima al sondaggio\n\n- public: Imposta la visibilità (funzionalità futura)\n\n- status: Stato del sondaggio (funzionalità futura)\n\n### Tipi di Campo\n\n#### 1. Pulsanti di Opzione (Scelta Singola)\n\nmarkdown\n\n[radio question=\"Qual è il tuo colore preferito?\"]\n\n- Rosso\n\n- Blu\n\n- Verde\n\n- Giallo\n\n[/radio]\n\n\n\n#### 2. Caselle di Controllo (Scelta Multipla)\n\nmarkdown\n\n[checkbox question=\"Quali funzionalità utilizzi? (Seleziona tutto ciò che si applica)\"]\n\n- Notifiche email\n\n- App mobile\n\n- Notifiche desktop\n\n- Accesso API\n\n[/checkbox]\n\n\n\n#### 3. Selezione a Discesa\n\nmarkdown\n\n[dropdown question=\"Qual è la tua fascia d'età?\"]\n\n- Sotto i 18\n\n- 18-24\n\n- 25-34\n\n- 35-44\n\n- 45-54\n\n- 55+\n\n[/dropdown]\n\n\n\n#### 4. Area di Testo (Testo Lungo)\n\nmarkdown\n\n[textarea question=\"Fornisci un feedback dettagliato:\" required=\"false\"]\n\n[/textarea]\n\n\n\n#### 5. Selezione Numerica\n\nmarkdown\n\n[number question=\"Valuta questa funzionalità da 1 a 10:\" min=\"1\" max=\"10\"]\n\n[/number]\n\n\n\n#### 6. Valutazione a Stelle\n\nmarkdown\n\n[star question=\"Come valuteresti l'esperienza complessiva?\"]\n\n[/star]\n\n\n\n#### 7. Pollice Su/Giù\n\nmarkdown\n\n[thumbs question=\"Lo consiglieresti ad altri?\"]\n\n[/thumbs]\n\n\n\n### Attributi del Campo\n\nTutti i tipi di campo supportano questi attributi:\n\n- question: Il testo della domanda (obbligatorio)\n\n- required: Se il campo deve essere compilato (true/false, predefinito su true)\n\n- min: Valore minimo per i campi numerici\n\n- max: Valore massimo per i campi numerici\n\n### Esempio Completo\n\n### Markdown Base del Sondaggio\n\nEcco un esempio base di Markdown per il sondaggio che include tutti i campi disponibili:\n\n\n[survey name=\"awesome-survey-thumbs\" title=\"Awesome Survey\"]\n\n[radio question=\"Scegli una sola opzione:\"]\n- gatto\n- cane\n[/radio]\n\n[checkbox question=\"Scegli più opzioni:\"]\n- rosso\n- blu\n- verde\n[/checkbox]\n\n[dropdown question=\"Genere:\"]\n- Maschio\n- Femmina\n[/dropdown]\n\n[number question=\"Valuta questo sondaggio da 1 a 10:\"]\n[/number]\n\n[textarea question=\"Qual è il tuo feedback su xyz?\" required=\"false\"]\n[/textarea]\n\n[star question=\"Come valuteresti l'esperienza complessiva?\"]\n[/star]\n\n[thumbs question=\"Sei rimasto soddisfatto dei nostri servizi?\"]\n[/thumbs]\n\n[/survey]\n\n\n### Rendering del Sondaggio\n\nDi seguito è riportato un esempio di come viene renderizzato il Markdown sopra in Discourse:\n\n
markdown\n\n[radio question=\"Scegli il tuo animale preferito:\"]\n\n- 🐈 Gatto\n\n- 🐶 Cane\n\n- 🐦 Uccello\n\n- 🐠 Pesce\n\n[/radio]\n\n\n\n### Formattazione HTML nelle Domande\n\nmarkdown\n\n[radio question=\"Quale \u003cstrong\u003elinguaggio di programmazione\u003c/strong\u003e preferisci?\"]\n\n- JavaScript\n\n- Python\n\n- Ruby\n\n- Go\n\n[/radio]\n\n\n\n### Campi Obbligatori e Opzionali Misti\n\nmarkdown\n\n[survey name=\"mixed-survey\"]\n\n[radio question=\"Qual è il tuo ruolo?\" required=\"true\"]\n\n- Sviluppatore\n\n- Progettista\n\n- Manager\n\n- Altro\n\n[/radio]\n\n[textarea question=\"Ulteriori pensieri?\" required=\"false\"]\n\n[/textarea]\n\n[/survey]\n\n\n\n## Risultati del Sondaggio\n\nAttualmente, questo plugin non dispone di un’interfaccia utente backend per visualizzare direttamente i risultati del sondaggio. Invece, puoi fare affidamento sulle query di Data Explorer per recuperare e analizzare le risposte al sondaggio. Ecco un esempio di query:\n\nsql\n-- [params]\n-- text :survey_name = survey\n\nSELECT s.id, s.name, s.post_id, sf.question, COALESCE(sr.value, sfo.html) AS value, sr.user_id, sr.created_at as responded_at\nFROM surveys s\nJOIN survey_fields sf ON sf.survey_id = s.id\nJOIN survey_responses sr ON sr.survey_field_id = sf.id\nLEFT JOIN survey_field_options sfo ON sfo.id = sr.survey_field_option_id\nWHERE s.name = :survey_name\nORDER BY s.id DESC\n\n\n## Permessi e Sicurezza\n\n- Accesso Richiesto: Gli utenti anonimi devono accedere prima di inviare risposte\n\n- Una Risposta per Utente: Ogni utente può inviare una sola risposta per sondaggio\n\n- Permessi Topic: Gli utenti devono avere accesso in lettura al topic per visualizzare i sondaggi\n\n- Permessi di Pubblicazione: Gli utenti devono avere i permessi di pubblicazione nel topic per inviare risposte\n\n- Topic Archiviati: I sondaggi nei topic archiviati non possono accettare nuove risposte\n\n- Post Eliminati: I sondaggi nei post eliminati non sono più accessibili\n\n## Limitazioni\n\n- È consentito un solo sondaggio per post\n\n- La struttura del sondaggio non può essere modificata dopo aver ricevuto risposte\n\n- Tutte le domande dei campi del sondaggio devono essere univoche all’interno di un singolo sondaggio\n\n- Le domande dei campi del sondaggio non possono essere vuote\n\n## Dettagli Tecnici\n\n### Schema del Database\n\nIl plugin crea quattro tabelle di database principali:\n\n- surveys: Registrazioni principali dei sondaggi\n\n- survey_fields: Campi individuali all’interno dei sondaggi\n\n- survey_field_options: Opzioni per i campi basati su scelta\n\n- survey_responses: Risposte degli utenti ai campi del sondaggio\n\n### Stile\n\nIl plugin include CSS responsive che si adatta al tuo tema. È possibile aggiungere stili personalizzati indirizzando queste classi CSS:\n\n- .survey - Contenitore principale del sondaggio\n\n- .survey-field - Involucro del campo individuale\n\n- .field-[type] - Contenitori specifici per tipo di campo\n\n- .submit-response - Pulsante di invio"