oLeGcHaT

versione 0.050 (beta)

Descrizione

oLeGcHaT è una semplice chat per siti web, nata dall'esigenza di poter inserire nel proprio sito una chat che non richieda database, facile da installare ed immediata per gli utenti, ma che nel contempo sia dotata di caratteristiche interessanti, tra le quali:

• oLeGcHaT è realizzata in PHP, HTML e Javascript (naturalmente il tuo server ospite deve supportare il PHP e nel tuo browser deve essere abilitato il codice Javascript);
• La chat funziona senza utilizzare database MySQL, ma tramite files di testo;
• E' dotata di un pannello di amministrazione (accessibile tramite password codificata, modificabile in qualsiasi momento);
• Tutti i colori della chat sono facilmente personalizzabili mediante il pannello di amministrazione;
• I nomi dei files database sono personalizzabili da pannello admin, in modo tale da evitare che i messaggi possano essere letti dall'esterno;
• La chat apre in una finestra indipendente dal resto del sito in cui risiede;
• Autenticazione utenti immediata tramite semplice login e password (codificata). Se un utente con lo stesso nome è già presente in chat, al nuovo viene richiesto di modificare il proprio;
• Possibilità di invio di messaggi privati: cliccando su un nome (nell'elenco degli utenti connessi) si aprirà una finestra da cui è possibile digitare il testo, che sarà visualizzato nella normale finestra messaggi dei soli mittente e destinatario. Un utente è identificato univocamente tramite nome e password, perciò, accedendo in seguito a successive sessioni di chat, egli potrà ritrovare tutti i messaggi privati da lui inviati o ricevuti a patto di accedere alla chat con lo stessa combinazione di nome utente e password;
• Visualizzazione aggiornata ogni 5 secondi dei messaggi e degli utenti connessi;
• Mentre la finestra dei messaggi è limitata ad un massimo di 50 righe per aumentare al massimo la velocità di caricamento, è possibile in qualunque momento visualizzare tutti i messaggi inviati dal momento del primo utilizzo;
• Possibilità di inserimento degli emoticons e relativa lista esplicativa di tutti quelli inseribili;
• I messaggi contenenti indirizzi internet vengono visualizzati come links nella finestra messaggi;
• Ogni evento (messaggi, connessioni e disconnessioni) viene visualizzato nella finestra messaggi assieme al suo orario;
• Tramite pannello admin è possibile impostare il fuso orario di riferimento per gli orari visualizzati nella finestra messaggi;
• Ad ogni evento è associato un suono;
• Non è stata volutamente prevista nessuna disconnessione automatica nel caso in cui l'utente rimanga connesso alla chat per un periodo più o meno lungo;
• Gli utenti di norma dovrebbero disconnettersi manualmente alla fine della sessione di chat;
• Qualora un utente non effettui correttamente la disconnessione all'uscita (ad esempio se chiude la finestra o se interrompe la connessione ad internet senza prima lasciare la chat) viene disconnesso automaticamente dopo 30 secondi: in particolare, ogni utente connesso controlla periodicamente tutti gli altri, disconnettendo automaticamente dalla chat tutti quelli non validi;
• E' possibile espellere gli utenti tramite il pannello di amministrazione;

Installazione

1. Trasferisci tutti i files in una directory del tuo sito (ad esempio /chat) badando (importante!!!) che i permessi (CHMOD) per i files dei dati (di default MESSAGGI.DAT, ARCHIVIO.DAT e UTENTI.DAT) siano impostati a 777;
2. Collega la chat al resto del tuo sito linkando al file /chat/index.html;
3. Configura a piacimento la chat tramite il pannello Amministrazione (la password di default è admin);

Aggiornamento da una versione precedente

Questa versione sostituisce completamente qualsiasi versione precedente. E' possibile tuttavia conservare l'archivio dei messaggi precedenti nel seguente modo:

1. Fai una copia di backup dell'archivio dei messaggi che è presente nel tuo sito (quello il cui nome di default era ARCHIVIO.DAT) copiandolo sull'hard disk e rinominalo in ARCHIVIO.DAT se il nome è differente;
2. Elimina completamente la versione precedente di oLeGcHaT dal tuo sito;
3. Installa la chat come descritto nei primi due punti del paragrafo precedente;
4. Trasferisci il file ARCHIVIO.DAT nella directory remota della chat sovrascrivendo quello già esistente (0 bytes);
5. Configura a piacimento la chat tramite il pannello Amministrazione (la password di default è admin);

Cronologia delle versioni

• 0.050 - E' possibile inviare messaggi privati ad altri utenti; per la gestione dei messaggi privati è stato necessario aggiungere la richiesta di una password al login che identifichi univocamente ogni utente; gli indirizzi internet vengono visualizzati come links nella finestra messaggi
• 0.027 - Aumentata la compatibilità con alcuni server e/o con alcune versioni di PHP
• 0.026 - Corretto un piccolo problema che causava un errore di javascript
• 0.025 - Ottimizzata e corretta la gestione dell'eliminazione automatica degli utenti che non si sono disconnessi correttamente
• 0.020 - Inserito il pannello di amministrazione; la chat adesso si configura completamente tramite il pannello admin e non si deve più editare a mano nessun file di configurazione; è possibile espellere gli utenti; è possibile cambiare il fuso orario di riferimento degli orari visualizzati; piccoli ritocchi al codice
• 0.012 - Corretti piccoli problemi con gli emoticons
• 0.011 - Prima versione rilasciata

Sviluppi futuri

Al più presto verranno implementati:

• Traduzione della chat in lingua inglese;
• ...suggerimenti?...

Modifiche al codice della chat

Puoi liberamente modificare il codice di oLeGcHaT in ogni sua parte. Ti chiedo però di attenerti alle seguenti piccole regole:

• Lascia inalterato il file info.php ed il link ad esso nella finestra principale della chat. Puoi eventualmente inserire delle righe nel file info.php che indichino che si tratta di una versione modificata;
• Non puoi chiedere denaro per distribuire ad altre persone qualsiasi tua realizzazione che si basi su oLeGcHaT;

Note conclusive

oLeGcHaT è ancora in fase di sviluppo. La presente versione deve intendersi un'anteprima di quella che sarà la versione finale.
Inoltre, lo script è stato ottimizzato per l'utilizzo con Internet Explorer. E' stato provato sotto Linux con Mozilla e Konqueror (qui la grafica potrebbe risultare differente da quella voluta). L'utilizzo con altri browser non è mai stato testato.
Segnalazioni di eventuali bug o suggerimenti a questo indirizzo olegnac@hotmail.com saranno gradite.

Se oLeGcHaT ti piace e la stai utilizzando, mandami per favore l'indirizzo del tuo sito web, in modo tale che io possa raccogliere nel mio sito i link di tutte le pagine che ne fanno uso.

Angelo Cingari - 26 luglio 2004