Mydonor® webconnector & phplist

myDonor速 webConnector & PHPlist

www.mydonor.org

Guida applicativa utente

myDonor® webConnector & PHPlist

Data 05/10/2011

Versione: A1/01 Pagina 2 di 10 Autore: MDI Guida applicativa utente

myDonor® webConnector & PHPlist Introduzione a myDonor® - DataBase webConnector E’ un modulo progettato e sviluppato da myDonor Italia per facilitare ed assicurare una completa interoperabilità tra ambiente web e ambiente gestionale.

Nella fattispecie le Web Service permettono un efficiente scambio di informazioni tra diverse applicazioni software su diverse piattaforme hardware utilizzano standard e protocolli "open". I protocolli ed il formato dei dati è, in formato testuale, cosa che li rende di più facile comprensione ed utilizzo da parte degli sviluppatori mediante l'uso di HTTP per il trasporto dei messaggi. I Web Service non necessitano, normalmente, che vengano effettuate modifiche alle regole di sicurezza utilizzate come filtro sui firewall, possono essere facilmente utilizzati, in combinazione l'uno con l'altro (indipendentemente da chi li fornisce e da dove vengono resi disponibili) per formare servizi "integrati" e complessi. Consentono il riutilizzo di infrastrutture ed applicazioni già sviluppate e sono indipendenti da eventuali modifiche delle stesse. I moduli applicativi sviluppati sul web (servizi) possono ora interscambiare dati omogenei con il data base centrale di myDonor®. Tramite l’ “internet service bus connector”, i servizi operanti sul web non debbono curarsi dei dati elaborati, leggono e scrivono su di un unico Data Base (mySQL o msSQL indifferentemente) ed è compito poi di myDonor® Data Base webConnector prendersi cura che questi vengano trasferiti e sincronizzati con il Data Base centrale di myDonor®. Il contenuto del Data Base webConnector locato sul web sarà sempre un sottoinsieme omogeneo del Data Base centrale.

Utilizzato per integrare PHPlist consente l’invio di newsletter estraendo i target dal Data Base di myDonor® e riportando poi in forma di contatto le informazioni statistiche su ogni componente selezionato.

Introduzione a Phplist Phplist è un sistema per la creazione e gestione di liste di spedizione, newsletter, notifiche e pubblicità. Il programma permette di classificare gli indirizzi di posta dei destinatari in liste ed effettuare velocemente invii di newsletter personalizzate. Phplist consente anche la visualizzazione di statistiche sui messaggi inviati e sui link presenti nella email.

Documentazione ad uso interno strettamente confidenziale © 2011 myDonor Italia

myDonor® webConnector & PHPlist

Data 05/10/2011

Versione: A1/01 Pagina 3 di 10 Autore: MDI Una volta effettuato il login sulla pagina di amministrazione verrà visualizzato il menù delle funzionalità offerte da phplist.

Il sistema si basa su due concetti fondamentali : gli utenti e le liste. Un utente è per phplist essenzialmente un indirizzo email che può essere usato come destinatario della posta emessa dal sistema. Una lista è una collezione di indirizzi email alla quale l’amministratore può spedire messaggi. Le liste non si comportano come normali mailing-list perché non permettono di realizzare discussioni, ma possono essere usate per spedire messaggi in una sola direzione (dall’amministratore ai destinatari).

Creare una mailing list Da Tabelle/MRM vado a creare una Campagna con almeno un’azione di tipo Newletter PHPlist.

Questa e condizione essenziale per poter poi aver attivi i meccanismi di trasferimento dei dati estratti via webConnector a PHPlist.

Selezionato l’azione si va ad estrarre il target secondo i criteri previsti e si procede a creare il lotto.

Il numero del lotto sarà la chiave della mailing list creata dal webConnector in PHPlist.

Documentazione ad uso interno strettamente confidenziale © 2011 myDonor Italia

myDonor® webConnector & PHPlist

Data 05/10/2011

Versione: A1/01 Pagina 4 di 10 Autore: MDI

Terminata la selezione con il tasto visualizza si passa al form conclusivo dell’estrazione e con il tasto connector alla generazione del lotto.

Documentazione ad uso interno strettamente confidenziale © 2011 myDonor Italia

myDonorÂŽ webConnector & PHPlist

Data 05/10/2011

Versione: A1/01 Pagina 5 di 10 Autore: MDI

Da qui con il tasto Conferma si trasferisce la lista estratta su di una tabella di transito del webConnector per il PHPlist per generare poi una mailing list con numero uguale al n.ro di lotto. Dal Menu Connector /Pannello d controllo selezionando <Newsletter> accedo a PHPlist.

Documentazione ad uso interno strettamente confidenziale Š 2011 myDonor Italia

myDonor® webConnector & PHPlist

Data 05/10/2011

Versione: A1/01 Pagina 6 di 10 Autore: MDI Con il tasto trasferisco i dati su PHPList creando la mailing list ed aprendo il browser. Se l’indirizzo mail trasferito on è presente viene creato un nuovo utente in PHPlist. Viene trasferito dal Data Base di myDonor® anche nome e cognome così da poter personalizzare il testo della newsletter. Viene crato per ciascun donatore selezionato un contatto <Inviato a mailing list> con data campagna e lotto.

Con il tasto una volta terminato l’invio trasferisco il risultato del mailing sotto forma di contatto a ciascun anagrafica in precedenza estratta.

Gli utenti in Phplist È possibile accedere all’elenco degli utenti selezionando la voce “utenti” del menù laterale. Questo elenco riporta tutti gli indirizzi registrati nel sistema come destinatari di posta elettronica. Facendo click sull’email di un utente vengono visualizzate ulteriori informazioni.

Figura 1 - Dettagli utente

Documentazione ad uso interno strettamente confidenziale © 2011 myDonor Italia

myDonor® webConnector & PHPlist

Data 05/10/2011

Versione: A1/01 Pagina 7 di 10 Autore: MDI Le liste È possibile accedere all’elenco delle liste selezionando la voce “liste” del menù laterale.

Figura 2 - Elenco delle liste Per ogni lista è possibile modificarne il nome, cancellarla e visualizzarne i membri. Le liste sono collezioni di utenti, intesi come indirizzi email destinatari dei messaggi.

I messaggi In phplist è possibile mandare messaggi di posta elettronica ai soli indirizzi presenti nella sezione utenti. Come ogni email, un messaggio deve avere un mittente, un oggetto e un contenuto. In phplist è inoltre possibile associare ad un messaggio una veste grafica chiamata template.

I template Un template è un layout standard che può essere riutilizzato per diversi messaggi ed è tipicamente costituito da un’intestazione, un logo dell’associazione, uno sfondo, ecc… Non include al contrario il contenuto del messaggio che varia da un invio di newsletter all’altro.

Documentazione ad uso interno strettamente confidenziale © 2011 myDonor Italia

myDonor® webConnector & PHPlist

Data 05/10/2011

Versione: A1/01 Pagina 8 di 10 Autore: MDI

Figura 3 - Modifica di un template Ogni template deve contenere il segnaposto [CONTENT] da qualche parte. Questa parola chiave viene sostituita al momento dell’invio con il contenuto specificato per quel messaggio. Nel template in Figura 3 sono presenti altri segnaposto: [Nome] [Cognome] [Titolo] variano a seconda del destinatario del messaggio e corrispondono agli attributi omonimi del singolo utente (vedi Figura 1).

Il segnaposto [FOOTER] è la parola chiave predefinita da phplist per indicare la posizione della parte finale del messaggio (anche’essa come [CONTENT] variabile a seconda dell’invio di newsletter).

Il segnaposto [USERTRACK] deve esser inserito nel template (o nel testo del messaggio) se vogliamo raccogliere statistiche sull’apertura e la consultazione da parte del destinatario dei link presenti nella mail.

Un segnaposto molto utile offerto da phplist è [VIEWMESSAGEURL]. In Figura 4 la frase “Se non visualizzi correttamente la newsletter clicca qui” è un collegamento il cui URL di riferimento è espresso da [VIEWMESSAGEURL]. Quando un utente riceverà un messaggio con questo template potrà all’occorrenza fare click sul link per visualizzare il messaggio in un browser. Ciò può essere molto utile nel caso l’utente abbia dei problemi nella visualizzazione del messaggio con un programma di gestione della posta elettronica (come Outlook Express).

Documentazione ad uso interno strettamente confidenziale © 2011 myDonor Italia

myDonor® webConnector & PHPlist

Data 05/10/2011

Versione: A1/01 Pagina 9 di 10 Autore: MDI

Figura 4 - Collegamento [VIEWMESSAGEURL]

Creazione di un messaggio Per creare un nuovo messaggio è sufficiente fare click sulla voce “invia un messaggio” del menù laterale. Nel tab principale “Contenuto” è possibile inserire l’oggetto, il mittente del messaggio, il contenuto (che andrà a sostituire il segnaposto [CONTENT] nel template) ed il piede del messaggio (che sostituirà la parola [FOOTER]).

Tab per la creazione del messaggio

segnaposto

Figura 5 - Creazione di un messaggio In Figura 5 sono riportati nel Footer degli ulteriori segnaposto:

Documentazione ad uso interno strettamente confidenziale © 2011 myDonor Italia

myDonor® webConnector & PHPlist

Data 05/10/2011

Versione: A1/01 Pagina 10 di 10 Autore: MDI -

[UNSUBSCRIBE] viene sostituito nel messaggio recapitato con un link alla pagina predefinita di phplist per effettuare la cancellazione di un utente dalla lista.

[FORWARD] viene sostituito con la pagina per inviare ad un amico il messaggio ricevuto.

È possibile usare il tasto “Manda un messaggio di prova” per fare un test di invio del messaggio all’indirizzo specificato di seguito. Anche se si tratta di una mail di test, il destinatario deve comunque essere incluso tra gli utenti.

Prima di passare ai tab successivi è necessario “Salvare le modifiche” del tab corrente altrimenti andranno perse. Il tab “Formato” permette di specificare se l’invio deve esser fatto in html o testo semplice e quale template si desidera usare tra quelli creati. Nel tab “Lista” è possibile specificare la/le lista/e a cui il messaggio deve essere recapitato. Cliccando “Invia il messaggio alle newsletter selezionate” la mail verrà messa nella coda dei messaggi in uscita, ma non ancora spedita. Per effettuare l’effettivo invio è necessario fare successivamente click su “processa la coda”. Ciascun messaggio sarà inviato alla lista di destinatari specificata al suo interno. È possibile visualizzare i messaggi inviati, salvati come bozza e messi in coda (ma non ancora inviati) selezionando la voce “messaggi” del menù a lato.

Le statistiche Phplist offre la possibilità di visualizzare un serie di statistiche sui messaggi recapitati selezionando la voce “statistiche” dal menù a lato.

La voce “overview” permette di visualizzare per ogni messaggio: il numero di invii effettuati,il numero di rimbalzi (“bounce”) che il messaggio ha subito (un messaggio viene rimbalzato quando il destinatario risulta inesistente), il numero di visualizzazioni (cliccando su quest’ultimo viene mostrato per ogni utente la data in cui ha aperto il messaggio) e la percentuale (“rate”) di visualizzazioni in relazione agli invii.

La voce “visualizza click per url” riporta per ogni link inserito in una mail quante volte è stato aperto e da quali utenti. Selezionando la voce “visualizza click per messaggio” vengono invece visualizzate le aperture dei link raggruppati a seconda del messaggio contenitore.

Infine “statistiche di dominio” analizza gli indirizzi nell’elenco degli utenti e riporta i domini di cui si anno più di 5 mail.

Documentazione ad uso interno strettamente confidenziale © 2011 myDonor Italia