SDI Campagne Feedback

Plugin WordPress per distribuire file o collegamenti agli utenti registrati e raccogliere successivamente un feedback tramite campagne ed email differite.

Requisiti

• WordPress 6.4 o successivo
• PHP 7.4 o successivo

Autore

Stefano Degl’Innocenti (SDI-sw)

Manuale

La documentazione operativa e tecnica completa è disponibile in MANUALE.md.

Funzioni principali

• campagne associate a un file privato oppure a un collegamento;
• accesso alla risorsa riservato agli utenti autenticati;
• registrazione del primo accesso dell’utente alla risorsa;
• cinque modelli di questionario predefiniti e riutilizzabili;
• domande con valutazione da 1 a 5 stelle;
• commento libero facoltativo o obbligatorio;
• modelli email HTML modificabili con l’editor visuale di WordPress;
• invito differito e massimo un promemoria tramite WP-Cron;
• motore email autonomo con anteprima, coda persistente, tentativi progressivi e registro degli esiti;
• limiti orari e giornalieri configurabili;
• accesso al questionario consentito soltanto all’utente che ha utilizzato il materiale;
• un solo feedback per coppia utente-campagna;
• area personale con feedback da compilare e già completati;
• statistiche essenziali;
• backup JSON delle singole campagne;
• integrazione con gli strumenti WordPress per esportazione e cancellazione dei dati personali;
• anteprima nel back-end del riquadro prodotto dallo shortcode della risorsa.

Il plugin non richiede SDI LS Comunicazioni: anteprima, coda e registro delle email sono gestiti internamente.

Installazione e configurazione

1. Caricare e attivare il plugin.
2. Scegliere o creare un questionario in SDI Feedback → Questionari.
3. Personalizzare e verificare i messaggi in SDI Feedback → Modelli email.
4. Creare una campagna e associarvi la risorsa, il questionario e i modelli email.
5. Inserire lo shortcode della campagna nella pagina dalla quale deve essere offerta la risorsa.
6. Creare una pagina contenente [sdi_feedback].
7. Selezionare questa pagina in SDI Feedback → Impostazioni.
8. Configurare mittente e coda delle email.
9. Verificare il funzionamento di wp_mail(), WP-Cron e del Registro email.

Shortcode

Risorsa associata a una campagna

[sdi_risorsa campagna="123"]

Mostra agli utenti registrati il riquadro per aprire o scaricare la risorsa e ne registra l’accesso.

Questionario o riepilogo personale

[sdi_feedback]

Con il riferimento personale presente nel collegamento email mostra il questionario. Senza tale riferimento mostra il riepilogo dei feedback dell’utente autenticato.

Area personale dei feedback

[sdi_feedback_utente]

Mostra tutte le richieste associate all’utente corrente, comprese quelle ancora da compilare.

Sicurezza e riservatezza

I file sono serviti da PHP soltanto dopo il controllo dell’utente. Il plugin crea una regola .htaccess nella cartella privata. Sui server Nginx l’amministratore deve bloccare direttamente:

/wp-content/uploads/sdi-campagne-feedback-private/

I backup JSON possono contenere dati personali e devono essere conservati in modo sicuro. L’eventuale file della risorsa non viene incorporato nel JSON e deve essere archiviato separatamente.

Versione 1.0.1

• aggiunto MANUALE.md, riferito alla versione 1.0.1, con flusso di lavoro, configurazione, sicurezza, privacy e struttura del database;
• nessuna modifica alle funzionalità del plugin rispetto alla versione 1.0.0.

Versione 1.0.0

• incorporato un motore email autonomo con anteprima effettiva, coda persistente, invio a blocchi, tentativi progressivi, recupero delle elaborazioni interrotte, limiti prudenziali e registro amministrativo;
• aggiunte le impostazioni del mittente e della coda;
• eliminata la dipendenza da SDI LS Comunicazioni;
• riservato il feedback all’utente autenticato che ha utilizzato il materiale;
• rimossa la compilazione anonima tramite token;
• resa univoca la coppia campagna-utente, con consolidamento prudente degli eventuali duplicati storici;
• esteso il backup della campagna al registro dei messaggi email;
• riorganizzata la pagina Campagne mostrando prima le campagne esistenti e poi il modulo di inserimento;
• aggiunte le anteprime del riquadro front-end per le campagne esistenti e per quella in compilazione;
• aggiunti e aggiornati readme.md e readme.txt;
• impostato l’autore a Stefano Degl’Innocenti (SDI-sw).

Versioni precedenti

0.5.0

• backup JSON, cancellazione completa delle campagne, gestione dei dati utente e blocco email dopo la cancellazione di un contributo.

0.4.0

• data di fine, deduzione automatica dello stato Passata e legenda operativa degli stati.

0.3.0

• ID e copia shortcode, colori degli stati, stelle interattive, area feedback personale e messaggio per i questionari già compilati.

0.2.0

• menu interno, dati dimostrativi, questionari predefiniti e modelli email HTML con editor WordPress.

0.1.0

• prima versione funzionale.

Licenza

GPL-2.0-or-later.