(c) PyG : dev@cornalys.com -- v2.1 du 10/09/2003
Code sous licence GNU/GPL

Objectif

Un chat alternatif à celui proposé par Ganesha.

Screenshots / Démonstration

• Saisie multilignes
• Chat privé
• Archives : menu
• Archive : contenu

Fonctionnalités

• Addon compatible GASP
• Le chat devient un chat par groupe (les stagiaires d'un même groupe partagent le même chat)
• Possibilité de faire des chats "privés" (2 par 2)
• Les chats privés se font en popup (possibilité de surfer ailleurs en même temps) et sans accès à la base de données.
• Gestion de smileys ;)
• Possibilité de saisie multi-lignes
• Archivage des sessions de chat (groupe et privées) accessibles par les tuteur
• Possiblité de limiter le nombre d'utilisateurs simultanés (1 limite pour l'ensemble des chat et 1 limite par chat " groupe").
• Possibilité de configurer le chat suivant les besoins via un fichier de config (délais entre les refresh, type d'alerte, logs des surcharges...)
• Orientation "Optimisation de la charge" afin de ne pas perturber le bon fonctionnement de la plateforme.

Démo non-interactive

Procédure d'installation  

Mise en place de l'addon :

- Téléchargez le fichier

- Dans /chat/index.php, sous :

/**
* include des fichiers + verification de la cnx
*/
file_exists('./anema.inc.php')?include_once("./anema.inc.php"):include_once("../anema.inc.php");

... ajoutez

// Debut modif [chatouille2]
if ( (defined("ADDON_CHATOUILLE2")) && (ADDON_CHATOUILLE2_STATE==1) ) {
Header("Location: ".HTTP_ADDONS.ADDON_CHATOUILLE2_DIR."/index".$ext."?connexion=".$_GET['connexion'] );
exit;
}
// Fin modif [chatouille2]

- Ajoutez dans votre base de données (via PhpMyAdmin ou autre) les 2 tables suivantes ('chatouille' et 'chatouille_connectes') :

#
# Table structure for table 'chatouille'
#

DROP TABLE IF EXISTS `crl_chat`;
CREATE TABLE `crl_chat` (
`msg` text NOT NULL,
`ping` int(14) unsigned NOT NULL default '0',
`groupe` tinyint(3) unsigned default NULL
) TYPE=MyISAM;

#
# Table structure for table 'crl_connectes'
#

DROP TABLE IF EXISTS `chatouille_connectes`;
CREATE TABLE `crl_connectes` (
`idSession` varchar(11) NOT NULL default '',
`nick` varchar(30) NOT NULL default '',
`arrive` int(14) NOT NULL default '0',
`ping` int(14) NOT NULL default '0',
`lignes` tinyint(4) NOT NULL default '0',
`bip` tinyint(4) NOT NULL default '0',
`groupe` tinyint(3) unsigned default NULL,
`id_user` tinyint(3) unsigned NOT NULL default '0',
`type_user` tinyint(3) unsigned NOT NULL default '0'
) TYPE=MyISAM;

NB : vous pouvez utiliser d'autres noms de tables si vous répercutez la modification dans le fichier config.inc.php de chatouille2.

- Si nécéssaire, uploadez le tout.

- Enfin, soyez sûr de bien donner les droits en lecture/écriture sur le dossier /chatouille/121/msg/ (ainsi que surcharge.txt et debug.txt) qui contiendra les messages privés.

That's it !

Configuration

Voilà les principaux paramètres et leur description (éditez config.inc.php). Les valeurs par défaut devraient être correctes pour la plupart des configurations.

// Paramètres généraux
$CHAT['type'] = "1"; // 0 = commun à tous les groupes (désactivé); 1 = chat par groupe
$CHAT['refresh1'] = 6; // Refresh par défaut (10 secondes) de la page "Chat"
$CHAT['refresh2'] = 30; // Refresh par défaut (10 secondes) de la page "liste"
$CHAT['max_gp'] = 8; // Nb max d'utilisateurs par groupe sur le chat. Défaut = 8
$CHAT['max_all'] = 16; // Nb max d'utilisateurs sur le chat simultanément (tout groupe confondus). Défaut = 12
$CHAT['max_dec'] = 300; // Nb secondes avant de considérer qq1 comme déconnecté (defaut = 300 = 5mn) Attention : Doit être > à $CHAT['refresh2']
$CHAT['max_old'] = 18000; // Nb secondes avant de considérer que quelqu'un s'est mal déconnecté (18000 = 5h)
$CHAT['max_archive'] = 700000; // Nb de secondes d'archivage des msg dans la table chat avant leur effacement Defaut = 700000 (8 jours*24H*60mn*60s)
$CHAT['lignes'] = 60; // Nb de lignes affichées par sessions (defaut = 20)
$CHAT['compress'] = 1; // Indique si la sortie du contenu doit être compressée par ob_gzhandler() (gain de temps)
$CHAT['bip_alerte'] = 0; // Indique si l'arrivée d'un nouvel arrivant se voit notifiée par une alerte javascript
$CHAT['bip_prive'] = 0; // Indique si la connexion privée doit afficher un msg js (inactif pour l'instant)
$CHAT['pf'] = "CAREL"; // Nom de la plateforme (défaut = GANESHA)
$CHAT['droits'] = "0755"; // Droits à appliquer sur les fichier de chat privé (défaut = 0755)
$CHAT['fermeture'] = 200; // Délai en millisecondes d'affichage de la popup quand on quitte (pour laisser le temps aux requetes de s'executer)
$CHAT['heure'] = 0; // 0 = masque l'heure du message dans le chat (plus lent); 1 = affiche l'heure des msg (par defaut)
$CHAT['log_surcharge'] = 1; // Les surcharges doivent-elles être logguées dans /121/msg/surcharges.txt ? 0 = non; 1 = oui (defaut)
$CHAT['debugSQL'] = 0; // Loggue les requetes SQL dans /archives/debug.txt Defaut=désactivé=0 ! A N'ACTIVER QU'EN CONNAISSANCE DE CAUSE !


// Paramètre du chat privé (121)
$CHAT['prives_multiple'] = 0; // 0 (defaut) = limite le chat prive multiple entre stagiaires ; 1 = autorise le chat prive multiple entre stagiaires
$CHAT['121']['rootdir'] = "121";// Dossier du chat privé
$CHAT['121']['msgdir'] = "msg"; // Indique le dossier dans lequel se trouve les messages
$CHAT['121']['ext'] = ".txt"; // extension des fichiers de msg
$CHAT['121']['refresh'] = 10; // Refresh par défaut (10 secondes) de la page "Chat privé"
$CHAT['121']['height'] = 250; // Taille du chat privé (hauteur)
$CHAT['121']['width'] = 600; // Taille du chat privé (largeur)
$CHAT['121']['top'] = 50+rand(5,15); // positionement (depuis le haut) du chat privé
$CHAT['121']['left'] = 50+rand(5,15); // positionnement (depuis la gauche) du chat privé

// Réécriture dynamique des messages à l'aide d'expressions régulières
// Attention : l'activation de ces fonctions réclament un temps de traitement plus long !
$CHAT['avertissement'] = 2; // Type d'avertissement quand on demande un chat privé : 0 = aucun ; 1 = visible par tout le groupe ; 2 = visible par les personnes concernées seulement (plus lent)

// Smileys
$CHAT['smileys'] = 1; // Activation des smileys (0 = non ; 1 = oui (plus lent))

Utilisation

En cas de forte charge :

• jouez sur les paramètres $CHAT['refresh1'] et $CHAT['refresh2'] (ralenti le rafraichissement, donc la fréquence des requêtes).
• vous pouvez aussi limiter le nb d'utilisateurs avec $CHAT['max_gp'] et $CHAT[' max_all']
• enfin désactivez les fonctions de réécriture dynamique : $CHAT['avertissement'] et $CHAT['smileys'], cela n'aura pas d'incidence sur la base de données mais devrait permettre un affichage un poil plus rapide des pages.
• La surveillance de la charge peut se faire via la page "archivage" :
  • si $CHAT['log_surcharge'] est activé, le fichier /121/msg/surcharge.txt contiendra les dates des surcharges (+ qq infos).
  • Pour analyser plus finement la charge, vous pouvez aussi activer $CHAT['debugSQL'] et observer le fichier /121/msg/debug.txt (Attention, cette manipulation sera couteuse en terme de temps / poids de fichier et n'est donc à activer qu'à des fins de debuggage/test)
  • Enfin le code source de la fenêtre principale de chat comporte différents timers permettant de connaitre le temps d'execution/interpretation de la page.

TodoList 

• Il doit bien rester pas mal de bugs à supprimer :-/
• Meilleure optimisation des requetes SQL
• Possibilité de faire tourner le chat sur une autre base, voire sur un autre site/hebergeur afin d'éviter toute charge superflue sur la base de la plateforme.
• Ajout de fichiers de langue + traductions
• Utilisation de la couche DB de Ganesha
• Fichier d'installation des 2 tables

ChangeLog

• 10/09/2004 : GASPisation, adaptations à la 2.1, chatouille.inc.php devient config.inc.php
• 19/03/2004 : Adaptations pour la V2 (Aymeric)
• 25/09/2004 : première version