(c) PyG : dev@cornalys.com -- v0.2 du 25/09/2003 (spéciale dédicace à Julien Gosset ;) - 19/03/2004 - Chatouille compatible V2.0 ? Merci Aymeric
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

• 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  

Utilisateurs de la V2, suivez plutôt les instructions en rouge (encore un grand merci à Aymeric)

Mise en place de l'addon :

- Téléchargez le fichier
Si vous utilisez la V2 de Ganesha, téléchargez plutôt ce fichier : chatouilleV2.zip

- S'il n'existe pas, créez un dossier /addons à la racine de ganesha

- Ajoutez dans /ganesha/inc/config.inc.php (avant //Gestion dynamique des noms de tables de la bdd ) :
- Ajoutez dans /ganesha/inc/define.inc.php (avant //Gestion dynamique des noms de tables de la bdd ) :

// ADDONS
$HTTP['addons'] = $HTTP['main']."addons/";
$RP['addons'] = $RP['main']."addons/";
// Fin ADDONS

- Décompressez chatouille.zip et placez-le dans /addons

- Ajoutez dans le /ganesha/inc/config.inc.php (plutôt à la fin) :
- Ajoutez dans le /ganesha/inc/define.inc.php (plutôt à la fin) :

// debut modif [addon Chatouille]
define("GCONF_CHATOUILLE", 1); // 0=inactif; 1=actif
$HTTP['chat2'] = $HTTP['addons']."chatouille/"; // Pour l'addon "chatouille"
$RP['chat2'] = $RP['addons']."chatouille/"; // Pour l'addon "chatouille"
$prefix_carel = "crl_";
$TBL['chat2'] = $prefix_carel.'chat'; // pour le chat
$TBL['connectes2'] = $prefix_carel.'connectes'; // liste des connectés au chat
// fin modif [addon Chatouille]

- Dans /chat/index.php, sous :

include ("./ganesha.inc.php");
//include ("./anema.inc.php"); // si vous utilisez la V2
if ( !isset($connexion) || !Init($connexion,'','')) {
Header("Location: ".$HTTP['commun']."p_error".$ext );
exit;
}

... ajoutez

// Debut modif [chatouille]
if ( GCONF_CHATOUILLE=="1" ) {
Header("Location: ".$HTTP['chat2']."index".$ext."?connexion=".$_GET['connexion'] );
exit;
}
// Fin modif [chatouille]

- Ajoutez dans votre base de données les 2 tables suivantes ("crl_chat" et "crl_connectes") :

#
# Table structure for table 'crl_chat'
#

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 `crl_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 ganesha.

- 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 chatouille.inc.php)

// 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.