Introduzione
Questa chat risulta graficamente piacevole e piuttosto funzionale. Si appoggia ad un database MySQL (o ad un semplice file di testo) e permette di utilizzare le emoticons (dette anche faccine), scegliendo tra una vasta gamma di colori disponibili. L'autore gradisce essere contattato se utilizziamo il suo script e non vieta la modifica, a patto di mantenere il copyright intatto.
Configurazione dello script
Una volta decompresso il file scaricato, andare a modificare il file shoutboxconf.php e seguire le istruzioni seguenti:
include_once ("shoutbox_csv.php");
Decommentare questa linea se si utilizza CSV (Comma Seperated Values) per l'utilizzo dello script.
include_once ("shoutbox_mysql.php");
Commentare questo file (utilizzando //) se si utilizza CSV, altrimenti lasciare così se si utilizza MySQL.
$showamount = 20;
Numero di messaggi da visualizzare nella pagina principale.
$linelength = 19;
Lunghezza massima in caratteri della linea quando una parola viene spezzata.
$maxshoutlen = 120;
Lunghezza massima in caratteri per ogni messaggio.
$emoticons = TRUE;
Abilita l'utilizzo delle emoticons o, chiamate gergalmente, faccine all'interno della chat.
$emoticon_theme = "orange";
Seleziona il tema da usare per le faccine; sono disponibili "beige", "blue", "clearblack", "clearwhite", "gray", "green", "orange", "purple", "red", "turquoise", "yellow".
$emoticon_text = "w";
Permette di selezionare se usare il testo bianco ("w") o nero (lasciare vuoto "") per eventuali faccine che contengano del testo.
$direction = 1;
Seleziona la direzione con la quale visualizzare i messaggi; "1" mette i nuovi messaggi in fondo; "-1" mette i nuovi messaggi in testa.
$checkurl = TRUE;
Abilita (TRUE) o disabilita (FALSE) il controllo degli URL per verificare che siano corretti.
include_once ("shoutbox_langpack_english.php");
Include il file che contiene la lingua da utilizzare per lo script. Verificare nella cartella principale l'esistenza del file che vogliamo utilizzare.
Bisogna ricordarsi anche di moficare il file shoutbox_csv.php se si usa CSV o il file shoutbox_mysql.php se si usa MySQL. Poichè per il CSV dobbiamo inserire solamente l'indirizzo server del file di testo da utilizzare, prendiamo in esame la configurazione del file per MySQL:
$databasehost = "localhost";
Indirizzo del server MySQL da utilizzare, può essere in formato testuale (localhost) o numerico (127.0.0.1).
$databasename = "shoutbox";
Nome del database MySQL da utilizzare.
$tablename = "shoutbox";
Nome della tabella del database da usare per registrare i dati della conversazione.
$dbuser = "root";
Nome utente di accesso al database MySQL.
$dbpass = "password";
Password di accesso al database MySQL.
Installazione sul server
Caricare tutti i file sul proprio spazio server; poichè lo script decompresso occupa circa 1 Mb (per la maggior parte occupato dalle faccine) tenere presente che tale procedura potrebbe portare via approssimativamente dai 5 ai 10 minuti.
Configurazione
L'unica operazione che dobbiamo portare a termine una volta caricati i file sul server, è quella di eseguire lo script per il database MySQL (sempre che venga usato). Andare all'indirizzo del tipo http://www.tuosito.it/shoutbox/setup-mysql.php ed inserire la password di accesso al database MySQL per conferma; lo script installerà automaticamente la tabella di cui ha bisogno la chat.
Se utilizzate CSV, dovete creare il file di nome shouts.txt e dovete settarne il chmod a 777.
Una raccomandazione, se volete inserire la chat in un file dovete inserire questo codice.
<!-- copy this segment -->
<iframe bgcolor="#000033" src="viewshoutbox.php" width="150" height="300" frameborder="0">
<font color="#FFFFFF"><a href="expanded.php">View the shoutbox</a></font>
</iframe>
<!-- END copy-->
Naturalmente potete personalizzare a piacimento la larghezza (width) e la lunghezza (height) dell'IFRAME utilizzato.
Considerazioni Finali
Abbiamo di fronte una chat che offre abbastanza dal punto di vista tecnico; infatti possiamo appoggiarci ad un database MySQL o un file CSV. Anche la grafica risulta piacevole, soprattutto grazie ad un sapiente uso dei CSS e alle emoticons a disposizione che sono molte. L'impressione è che tale script possa evolversi in meglio, aggiungendo ad esempio ulteriori moduli per database, aumentando il numero di lingue supportate, ma soprattutto creando un'interfaccia di amministrazione adeguata. Per adesso vi consigliamo di provarla.
