Introduzione
Lo script si presenta non proprio facilissimo da installare, ma dalle funzionalità sicuramente interessanti. Possiamo gestire più mailing list, utenti iscritti, personalizzare le email e molto altro. Il suo punto di forza è sicuramente la facilità di gestione.
Lo script è gratuito, anche se non à chiaro il tipo di licenza utilizzato si consiglia di lasciare intatto il copyright nel caso volessimo fare delle modifiche.
Configurazione dello script
Per prima decomprimere il file scaricato e modificare il file emml_config.php secondo la spiegazione seguente:
$DbHost = "";
Indirizzo del server MySQL; può essere in formato testuale (localhost) o numerico (127.0.0.1).
$DbDatabase = "";
Nome del database MySQL da usare per far funzionare lo script.
$DbUser = "";
Nome utente di accesso al server MySQL.
$DbPassword = "";
Password di accesso al server MySQL.
$emml_path = "/home/yourname/html/emml";
Indirizzo server della directory di installazione dello script.
$emml_admin_path = "/home/yourname/html/emml/admin";
Indirizzo server della directory di amministrazione.
$template_html_path = "/home/yourname/html/emml/template";
Indirizzo server della directory dei template.
$emml_temp_file = "/home/yourname/html/emml/admin/emml.temp";
Indirizzo server del file temporaneo da utilizzare.
$emml_url = "http://www.yourdomain.com/emml";
Indirizzo internet della directory di installazione dello script
$emml_admin_url = "http://www.yourdomain.com/emml/admin";
Indirizzo internet della directory di amministrazione.
$emml_image_url = "http://www.yourdomain.com/emml/images";
Indirizzo internet della directory contenente le immagini
$php_path = "/usr/bin/php";
Indirizzo server dove è installato il PHP.
$emml_msg["db_err"] = "Database Error.";
Messaggio di errore che compare quando non si riesce a connettersi al database MySQL.
$emml_msg["invalid_email"] = "Please enter valid email address. (e.g. a@b.com)";
Messaggio di errore che compare quando viene inserito un indirizzo email sbagliato.
$emml_msg["empty_email"] = "Please enter your email address";
Messaggio di errore che compare quando non viene specificato nessun indirizzo email.
Installazione sul server
Adesso dobbiamo installare i dati nel database MySQL; per questo bisogna appurarci di aver inserito i dati corretti nel file di configurazione e quindi, utilizzare un interfaccia tipo PhpMyAdmin per caricare il file emml.sql che si trova nella cartella "sql". Ne riportiamo la struttura qui di seguito:
CREATE TABLE emml_email_template (
id int(10) DEFAULT '0' NOT NULL auto_increment,
name varchar(250) DEFAULT '' NOT NULL,
subject varchar(100),
message text,
html_message text,
charset varchar(30),
PRIMARY KEY (id)
);
CREATE TABLE emml_mail_subscribe (
emailid int(10),
maillistid int(10)
);
CREATE TABLE emml_maillist (
id int(10) DEFAULT '0' NOT NULL auto_increment,
listdesc text,
listname varchar(200),
ispublic char(1),
PRIMARY KEY (id)
);
CREATE TABLE emml_list (
id int(10) DEFAULT '0' NOT NULL auto_increment,
listname varchar(250) DEFAULT '' NOT NULL,
template_html_path varchar(250),
maillist text,
default_maillist text,
sub_frommail varchar(250),
sub_template int(10),
unsub_frommail varchar(250),
unsub_template int(10),
flag char(1),
PRIMARY KEY (id)
);
CREATE TABLE emml_login_session (
username char(20),
string char(32),
lastupdatedtime datetime
);
CREATE TABLE emml_options (
option_key varchar(200),
option_value text
);
CREATE TABLE emml_sendmail (
id varchar(32) DEFAULT '' NOT NULL,
todesc varchar(250) DEFAULT '',
toemail varchar(250) DEFAULT '',
fromemail varchar(250) DEFAULT '',
charset varchar(30) DEFAULT '',
subject varchar(100) DEFAULT '',
message text,
html_message text,
senddate datetime,
completeddate datetime,
status char(1),
PRIMARY KEY (id)
);
CREATE TABLE emml_subscriber (
id int(10) DEFAULT '0' NOT NULL auto_increment,
emailaddress varchar(250),
jointime datetime DEFAULT '0000-00-00 00:00:00',
PRIMARY KEY (id)
);
Configurazione
Infine dobbiamo settare i chmod relativi ai file che compongono lo script, seguire quindi lo schema proposto, ricordandosi che BINARY indica che il file deve essere caricato in "Binary Mode", mentre ASCII indica che il file deve essere caricato in "Ascii Mode":
emml (chmod 755, ascii)
|____admin (chmod 755, ascii)
| |___admin.php (chmod 755, ascii)
| |___admin_func.php (chmod 644, ascii)
| |___auth.php (chmod 644, ascii)
| |___auth_func.php (chmod 644, ascii)
| |___emml_mail.php (chmod 755, ascii)
| |___emml.temp (chmod 666, ascii)
|____template(chmod 755, ascii)
| |___admin (chmod 755, ascii)
| | |___template_emml_admin.html (chmod 644, ascii)
| | |___template_emml_email_template_add.html (chmod 644, ascii)
| | |___template_emml_email_template_delete.html (chmod 644, ascii)
| | |___template_emml_email_template_row.html (chmod 644, ascii)
| | |___template_emml_email_template_table.html (chmod 644, ascii)
| | |___template_emml_email_template_update.html (chmod 644, ascii)
| | |___template_emml_htmlcode_add.html (chmod 644, ascii)
| | |___template_emml_htmlcode_delete.html (chmod 644, ascii)
| | |___template_emml_htmlcode_html.html (chmod 644, ascii)
| | |___template_emml_htmlcode_row.html (chmod 644, ascii)
| | |___template_emml_htmlcode_table.html (chmod 644, ascii)
| | |___template_emml_htmlcode_update.html (chmod 644, ascii)
| | |___template_emml_login_form.html (chmod 644, ascii)
| | |___template_emml_maillist_add.html (chmod 644, ascii)
| | |___template_emml_maillist_delete.html (chmod 644, ascii)
| | |___template_emml_maillist_export_email.html (chmod 644, ascii)
| | |___template_emml_maillist_import_email.html (chmod 644, ascii)
| | |___template_emml_maillist_row.html (chmod 644, ascii)
| | |___template_emml_maillist_subscriber_table.html (chmod 644, ascii)
| | |___template_emml_maillist_table.html (chmod 644, ascii)
| | |___template_emml_maillist_update.html (chmod 644, ascii)
| | |___template_emml_maillist_view_subscriber_row.html (chmod 644, ascii)
| | |___template_emml_maillist_view_subscriber_table.html (chmod 644, ascii)
| | |___template_emml_sendmail.html (chmod 644, ascii)
| | |___template_emml_sendmail_build.html (chmod 644, ascii)
| | |___template_emml_sendmail_preview.html (chmod 644, ascii)
| | |___template_emml_sendmail_status.html (chmod 644, ascii)
| | |___template_emml_sendmail_status_row.html (chmod 644, ascii)
| | |___template_emml_sendmail_viewdetails.html (chmod 644, ascii)
| | |___template_emml_setting.html (chmod 644, ascii)
| | |___template_emml_subscriber_add.html (chmod 644, ascii)
| | |___template_emml_subscriber_delete.html (chmod 644, ascii)
| |
|___template_emml_subscriber_maillist_row.html (chmod 644, ascii)
| | |___template_emml_subscriber_maillist_table.html (chmod 644, ascii)
| | |___template_emml_subscriber_row.html (chmod 644, ascii)
| | |___template_emml_subscriber_search.html (chmod 644, ascii)
| | |___template_emml_subscriber_table.html (chmod 644, ascii)
| | |___template_emml_subscriber_update.html (chmod 644, ascii)
| |___template_emml.html (chmod 644, ascii)
| |___template_emml_form.html (chmod 644, ascii)
| |___template_emml_subscribe_form.html (chmod 644, ascii)
| |___template_emml_subscribe_row.html (chmod 644, ascii)
| |___template_emml_thankyou.html (chmod 644, ascii)
| |___template_emml_unsubscribe.html (chmod 644, ascii)
|____images
| |___emlogo.gif (binary)
| |___emml_corner_bottom_left.gif (binary)
| |___emml_corner_bottom_right.gif (binary)
| |___emml_corner_upper_left.gif (binary)
| |___emml_corner_upper_right.gif (binary)
| |___width.gif (binary)
|____class.fasttemplate.php (chmod 644, ascii)
|____class.html.mime.mail.php (chmod 644, ascii)
|____emml.php (chmod 755, ascii)
|____emml_common_func.php (chmod 644, ascii)
|____emml_config.php (chmod 644, ascii)
|____emml_default.php (chmod 644, ascii)
|____emml_email_func.php (chmod 644, ascii)
|____emml_html_func.php (chmod 644, ascii)
|____emml_msg.php (chmod 644, ascii)
|____sql_func.php (chmod 644, ascii)
Pannello di amministrazione
A questo punto possiamo accedere all'amministrazione puntando all'indirizzo del tipo http://www.tuosito.it/emml/admin/admin.php ed inserendo (per il primo login) come nome utente "admin" e come password "admin".
Ricordarsi di cambiare la password per evitare accessi indesiderati
Lo schema seguente spiega in maniera sommaria le funzioni principali di amministrazione:
Subscribers
Visualizza la lista di tutti gli utenti iscritti tramite questo script ad una o più mailing list.
Mailing Lists
Crea/Modifica/Elimina le Mailing List che vogliamo usare.
Send Email
Permette di comporre una mail da spedire ad una o più mailing list presenti.
Email Status
Questa sezione ci dice quali messaggi sono stati mandati, a quali utenti della mailing list e quando ciò è stato fatto.
Email Templates
Crea/Modifica/Elimina i Template da utilizzare quando inviamo una mail.
Multiple Mailing List Form
Generatore automatico della form da inserire nelle proprie pagine HTML.
Settings
Da qui possiamo settare i parametri generali, cambiare la password e modificare la password principale dell'amministratore.
Logout
Esce dall'area di amministrazione dello script.
Considerazioni Finali
Questo Mailing List Manager ha un'unica pecca: è in inglese; per il resto dobbiamo dire che la struttura dello script permette, dopo un'installazione laboriosa, un utilizzo immediato ed una alta configurabilità. Possiamo ad esempio aggiungere/togliere utenti, creare una o più mailing list, gestire uno o più messaggi predefiniti, creare le form adeguate per le nostre mailing list. Da installare se si necessita di uno script ottimo sotto molti punti di vista.
