+-------------------------------------------------+
|        TJSChat Version 0.95                     |
|        MODULE DE CHAT en PHP4-MySQL             |
+-------------------------------------------------+
| Auteur    : Olivier HONDERMARCK                 |
| Web       : http://www.toutjavascript.com       |
|           : http://www.toutjavascript.com/chat  |
| Mail      : webmaster@toutjavascript.com        |
| Cration  :  8 juin 2001                        |
| Modif.    : 19 Mars 2004                        |
+-------------------------------------------------+


1. Objet du module
Ce script permet de grer un chat en langage PHP4 associ  une base de
donnes MySQL.
Avantages par rapport aux autres chats en PHP :
 - Utilisation du DHTML qui limine tout clignotement lors du 
   rafraichissement de l'affichage de la liste des connects ou des 
   messages. Les pages ne sont jamais recharges. Seuls les calques sont 
   rafraichis.
 - Tous les libells et toutes les couleurs sont personnalisables. Il est 
   donc possible de le traduire compltement sans toucher au code.
 - Les fonctionnalits classiques d'un chat sont supportes :
     - messages de couleur, smileys,
     - Liste des connects en temps rel,
     - paramtrage du nombre maxi de connects simultans.


2. Fonctionnement
Vous pouvez voir le chat en fonctionnement sur mon site
http://www.toutjavascript.com/chat
Le chat fonctionne et a t test avec les navigateurs IE5 et plus et
Netscape 6.
Le chat ne peut pas fonctionner avec Netscape 4.X


3. Conditions d'utilisation
Vous pouvez utiliser ce module de chat  condition de :
  1 - laisser accessible et visible le lien sur le logo du script en bas 
      gauche.
  2 - m'envoyer un mail pour indiquer sur quel site le script de chat est
      install.
  3 - accepter tous les risques (perte de donnes, surcharge du serveur,
      ...) lis  l'utilisation de ce module.


4. Installation
* Copier l'ensemble des fichiers dans un rpertoire de votre site. Votre
  site doit accepter le PHP4 et la base de donnes MySQL.
* Le module ncessite l'accs  la librairie mysql.php qui contient la
  fonction Connection() qui assure la connexion  la base de donnes.
  IL FAUT DONC COMMENCER PAR DEFINIR LES PARAMETRES DE CONNEXION DANS LE
  FICHIER MYSQL.PHP
* Lancez le fichier install.php dans votre navigateur qui va :
   1 - Dtecter la prsence de tables ncessaires (chat_XXX)
   2 - En l'absence de ces tables, lancer leur cration
   3 - Si ces tables existent dj, soit l'installation est faite, soit ces
       tables ont une autre utilit. Changez leur nom dans le fichier param.php
* Une fois les tables cres, lancez le fichier index.php. Le module est
  directement utilisable.


5. Paramtrage
L'apparence et le paramtrage sont compltement personnalisables dans le
fichier param.php.
Vous pouvez modifier les libells texte, les titres et les messages de
statut.
Vous pouvez galement modifier les couleurs et les dimensions du chat.
La dclaration des styles se fait dans le fichier chat.css.
Conseil pour le paramtrage.
Un module de chat est assez gourmand en ressource ct serveur car tous les
connects scrutent  intervalles rguliers les nouveaux messages et la liste
des connects. Plus cet intervalle est court, meilleur sera l'impression de
temps rel, mais plus grande sera la charge.
Par dfaut le dlai est fix  5 secondes. Mme si ce module a t optimis
pour limiter le nombre de requetes, il est conseill de conserver cette
dure pour ne pas surcharger le serveur.


6. Bugs et volutions
Le module est en constante volution.
Il est tout  fait possible que le chat ne fonctionne pas correctement dans
certaines situations.
Merci d'adresser vos remarques et suggestions sur le site
www.toutjavascript.com/chat.


7. Evolutions utiles envisages :
* Permettre l'utilisation du module sans base de donnes, avec un simple jeu
  de fichiers texte.
    => Utile pour les sites sans base de donnes
    => Optimisation des performances
* Permettre l'historisation des sances de chat intressantes pour les
  retranscrire en pages web directement accessibles.
    => Sauver une scance avec un invit important.
* Autoriser l'enregistrement de pseudos accessibles uniquement par mot de
  passe.
    => Protger certains pseudos
    => S'assurer de l'identit des participants
* Envoyer des messages privs
    => Ca peut tre sympa
    => Implique de pouvoir ignorer certains connects pour viter les parasites


8. Versionning

V0.96 : 19 Mars 2004
Compatible avec PHP configur en register_globals = off

V0.95 : 28 Janvier 2002
Traduction en anglais

V0.9b : 14 juillet 2001
Premire version publique en libre tlchargement.

V0.5b : 8 juin 2001
Teste sur le site www.toutjavascript.com par les visiteurs.



Olivier HONDERMARCK
http://www.toutjavascript.com


