+-------------------------------------------------+
|        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        |
| Création  :  8 juin 2001                        |
| Modif.    : 28 Janvier 2002                     |
+-------------------------------------------------+


1. Objet du module
Ce script permet de gérer un chat en langage PHP4 associé à une base de
données 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 connectés ou des 
   messages. Les pages ne sont jamais rechargées. Seuls les calques sont 
   rafraichis.
 - Tous les libellés et toutes les couleurs sont personnalisables. Il est 
   donc possible de le traduire complètement sans toucher au code.
 - Les fonctionnalités classiques d'un chat sont supportées :
     - messages de couleur, smileys,
     - Liste des connectés en temps réel,
     - paramétrage du nombre maxi de connectés simultanés.


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 données, surcharge du serveur,
      ...) liés à l'utilisation de ce module.


4. Installation
* Copier l'ensemble des fichiers dans un répertoire de votre site. Votre
  site doit accepter le PHP4 et la base de données MySQL.
* Le module nécessite l'accès à la librairie mysql.php qui contient la
  fonction Connection() qui assure la connexion à la base de données.
  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 - Détecter la présence de tables nécessaires (chat_XXX)
   2 - En l'absence de ces tables, lancer leur création
   3 - Si ces tables existent déjà, soit l'installation est faite, soit ces
       tables ont une autre utilité. Changez leur nom dans le fichier param.php
* Une fois les tables créées, lancez le fichier index.php. Le module est
  directement utilisable.


5. Paramétrage
L'apparence et le paramétrage sont complètement personnalisables dans le
fichier param.php.
Vous pouvez modifier les libellés texte, les titres et les messages de
statut.
Vous pouvez également modifier les couleurs et les dimensions du chat.
La déclaration des styles se fait dans le fichier chat.css.
Conseil pour le paramètrage.
Un module de chat est assez gourmand en ressource côté serveur car tous les
connectés scrutent à intervalles réguliers les nouveaux messages et la liste
des connectés. Plus cet intervalle est court, meilleur sera l'impression de
temps réel, mais plus grande sera la charge.
Par défaut le délai est fixé à 5 secondes. Même si ce module a été optimisé
pour limiter le nombre de requetes, il est conseillé de conserver cette
durée 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 envisagées :
* Permettre l'utilisation du module sans base de données, avec un simple jeu
  de fichiers texte.
    => Utile pour les sites sans base de données
    => Optimisation des performances
* Permettre l'historisation des séances de chat intéressantes pour les
  retranscrire en pages web directement accessibles.
    => Sauver une scéance avec un invité important.
* Autoriser l'enregistrement de pseudos accessibles uniquement par mot de
  passe.
    => Protéger certains pseudos
    => S'assurer de l'identité des participants
* Envoyer des messages privés
    => Ca peut être sympa
    => Implique de pouvoir ignorer certains connectés pour éviter les parasites


8. Versionning
V0.95 : 28 Janvier 2002
Traduction en anglais

V0.9b : 14 juillet 2001
Première version publique en libre téléchargement.


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



Olivier HONDERMARCK
http://www.toutjavascript.com