Collegare un form a una newsletter in 3… 2… 1

Come fidelizzare i fan del blog? Semplice. Con una newsletter che li tenga aggiornati sulle nuove uscite. In questo “In 3 2 1” vediamo come modificare un qualsiasi form di contatto aggiungendo una checkbox per l’iscrizione alla vostra newsletter.

La soluzione che vi propongo non utilizza alcun plugin proprio ma si appoggia direttamente a Contact Form 7 e CFDB (che sicuramente avrete già installato per creare i form di contatto e salvare i dati degli utenti in una apposita tabella del database).

Ho scelto MailUp come servizio di email marketing ma, con modifiche minime, la soluzione è applicabile anche ad altri provider (es. MailChimp). MailUp possiede una funzionalità che vi consente di creare un form di registrazione da incollare sul vostro sito ma è una soluzione completamente svincolata dal database di WordPress. In pratica i dati dei vostri utenti saranno salvati solo sui server di MailUp.

3) Iscrizione su MailUp

Per utilizzare MailUp è necessario attivare un account a pagamento ma è comunque possibile eseguire un test gratuito della piattaforma. Dopo aver completato l’iscrizione potrete loggarvi da un indirizzo web detto MailUp Console Host che ci servirà tra poco per collegare il form di contatto a MailUp.

L’account di base (web) prevede l’utilizzo di una sola lista di destinatari (tabella nella quale confluiscono i dati utente raccolti dai form), mentre gli altri account (pro ed enterprise) consentono la creazione di ulteriori liste per suddividere gli iscritti secondo le esigenze. Noi prenderemo in considerazione il caso base e la lista di default che ha come identificativo il numero 1.

 

2) Creazione del form di iscrizione

Per prima cosa verifichiamo di aver istallato e attivato i plugin Contact Form 7 e Contact Form DB.

Prendiamo come esempio il modulo di contatto che viene automaticamente proposto da Contact Form 7 quando creiamo un nuovo form:

<label>Il tuo nome (richiesto)
[text* your-name]
</label>
<label>La tua email (richiesto)
[email* your-email]
</label>
<label>Oggetto
[text your-subject]
</label>
<label> Il tuo messaggio
[textarea your-message]
</label>
[submit "Invia"]

Inseriamo quindi la nostra nuova checkbox con la richiesta di iscrizione alla newsletter prima del bottone di submit:

<label> Vuoi iscriverti alla nostra newsletter?
[checkbox mailup "Si"]
</label>

1) Collegamento del form al vostro account MailUp

Il collegamento tra il vostro form di contatto e l’account MailUp avviene per mezzo dell’url della MailUp Console che altro non è che l’indirizzo web al quale vi collegate per fare il login sull’account di MailUp. Ha una forma del tipo

xxxxxx.mailupclient.com

dove xxxxxx è una stringa alfanumerica che vi è stata associata al momento dell’iscrizione al servizio di MailUp.

Per realizzare la magia dobbiamo sfruttare un hook messo a disposizione da Contact Form DB. Un hook non è altro che un appiglio, previsto dagli sviluppatori del plugin, al quale è possibile attaccarsi per aggiungere una nuova funzionalità da noi decisa che sarà eseguita in una particolare condizione. Per farla semplice quello che dobbiamo fare è dire a Contact Form DB che ogni qual volta salverà un nuovo utente nel database (a seguito di una compilazione di un form) dovrà anche eseguire una iscrizione dello stesso utente ad una nostra lista di destinatari MailUp.

L’hook al quale aggrapparsi per eseguire il nostro compito si chiama cfdb_form_data e questo è il codice che andrà inserito in coda al solito functions.php (file del tema che esegue le personalizzazioni):

function mailup_subscription($formData) {
    $data = $formData->posted_data;
    if ($data['mailup'] == 'Si') {
        /* imposto i parametri */
        $mailup_console_url = 'xxxxxx.mailupclient.com'; /* MODIFICA CON IL TUO MailUp Console Host */
        $pars = 'list=1'; /* identificativo della lista di default */
        $pars .= '&email='.$data['your-email']; /* salva la mail */
        $pars .= '&confirm=true'; /* richiede la conferma dell'iscrizione */
        $pars .= '&csvFldNames=campo1';
        $pars .= '&csvFldValues='.$data['your-name']; /* salva il nome utente */
        $mailup_subscription_url = "http://{$mailup_console_url}/frontend/xmlSubscribe.aspx?".$pars;
        /* eseguo la chiamata a MailUp */
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $mailup_subscription_url);
        curl_setopt($ch, CURLOPT_HEADER, 0);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        $result = curl_exec($ch);
        curl_close($ch);
    }
    return $formData;
}
add_filter('cfdb_form_data', 'mailup_subscription');

Quello che sto facendo è recuperare i dati del modulo al momento del suo salvataggio e passare alla console di MailUp l’email e il nome utente di chi lo ha compilato. Questi dati saranno salvati nella lista di default di MailUp e all’utente verrà inviata una mail che richiederà la conferma di iscrizione.

Ora non vi resta che creare la vostra newsletter e inviarla ai nuovi fan 😉

Nota: per informare MailUp che stiamo richiedendo una iscrizione dal nostro sito dobbiamo indicargli qual’è l’indirizzo IP del nostro server (che possiamo chiedere al nostro fornitore di hosting) accendendo alla console di MailUp e andando su  Gestione (ingranaggio) > Opzioni Avanzate > Opzioni Sviluppatore > Web services. A questo punto basta selezionare Frontend dal menu a tendina, abilitare Web Service e cliccare su Aggiungi IP.

[Aggiornamento 05/2017] Se vogliamo usare Gravity Forms invece di Contact Form 7 il procedimento è molto simile; cambia ovviamente l’hook da utiilizzare – in questo caso gform_after_submission – e il modo con cui si recuperano i dati dal form

function mailup_subscription( $entry, $form) {
    $email = rgar( $entry, '1' ); /* recupero il campo mail dal form */
    $mailup_console_url = 'xxxxxx.mailupclient.com'; /* MODIFICA CON IL TUO MailUp Console Host */
    $pars = 'list=1'; /* identificativo della lista */
    $pars .= '&email='.$email; /* salva la mail */
    $pars .= '&confirm=true'; /* richiede la conferma dell'iscrizione */
    $mailup_subscription_url = "http://{$mailup_console_url}/frontend/xmlSubscribe.aspx?".$pars;
    /* eseguo la chiamata a MailUp */
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $mailup_subscription_url);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $result = curl_exec($ch);
    curl_close($ch);
}
add_action( 'gform_after_submission', 'mailup_subscription', 10, 2 );