Installation du module de tchat zeolia sur votre site

Les outils pour webmasters

Si vous désirez installer un tchat sur votre site ou afficher les statistiques de votre salon, ou les deux d'ailleurs, voici les guides à suivre.
N'hésitez pas à nous demander de l'aide et à nous faire vos retours et suggestions.
N.B. : dans tous les exemples, il faut remplacer CANAL par le nom de votre canal sans le # initial

Utiliser notre formulaire

La méthode la plus simple pour intégrer un tchat sur votre site est d'utiliser notre formulaire. Une seule ligne de code:
<script type="text/javascript" src="https://zeolia.chat/applet.php?chan=CANAL"></script>

Ceci chargera le formulaire et ouvrira le tchat dans une nouvelle fenêtre.

Options

Toutes les options sont cumulables, sauf mention contraire.

Popup or not popup ?
Vous pouvez aussi choisir de l'ouvrir dans la même page en ajoutant l'option inline=1, ce qui donnera:

<script type="text/javascript" src="https://zeolia.chat/applet.php?chan=CANAL&inline=1"></script>

Le formulaire est extrêmement simple, ce qui vous permet d'y appliquer la feuille de style que vous désirez.

Connexion très simplifiée
Il est possible de retirer le champ mot de passe avec l'option nopass=1:

<script type="text/javascript" src="https://zeolia.chat/applet.php?chan=CANAL&nopass=1"></script>

Feuille de style

Si vous avez des soucis pour créer la feuille de style, voici quelques informations utiles:

  • Le formulaire utilise le nom et l'id ztchat.
  • Les champs nick (pour le pseudonyme) et pass (pour le mot de passe) sont respectivement dans les label lnick et lpass.
  • Le bouton de validation est un élément button ayant pour nom et id btchat.

Bien entendu, nous restons à votre disposition sur le canal #aide pour vous aider à mettre au point votre formulaire.

Votre système

Vous pouvez aussi utiliser votre propre système, il vous suffit de configurer le bon serveur (irc.zeolia.chat) et le bon port (de 6665 à 6670, connexion SSL sur le port 6697).
N.B. : dans tous les exemples, il faut remplacer CANAL par le nom de votre canal sans le # initial

Il existe actuellement 3 types de statistiques utilisables pour votre canal:

  • le nombre de connectés,
  • le topic du canal,
  • la liste des utilisateurs présents.
Pour afficher ces informations, il suffit d'utiliser un simple JavaScript.

Sujet du canal

Code:
<script type="text/javascript" src="https://zeolia.chat/scripts.php?chan=CANAL&action=topic"></script>
Rendu:

Nombre de connectés

Affichage basique
Code:
<script type="text/javascript" src="https://zeolia.chat/scripts.php?chan=CANAL"></script>
Rendu:
Sans les robots
Avec l'option nobot=1, le nombre affiché ne tiendra pas compte des robots de service et des eggdrops déclarés comme tels.
Code:
<script type="text/javascript" src="https://zeolia.chat/scripts.php?chan=CANAL&nobot=1"></script>
Rendu:

Liste des utilisateurs

Rappel: l'option nobot=1 peut aussi être ajoutée dans tout les modes qui suivent afin de ne pas avoir les robots dans la liste des utilisateurs
Affichage initial
Ceci affiche la liste de tous les utilisateurs ainsi que le temps depuis lequel ils sont connectés.
Code:
<script type="text/javascript" src="https://zeolia.chat/scripts.php?chan=CANAL&action=users"></script>
Rendu:
Statut des utilisateurs
Vous pouvez choisir d'afficher les utilisateurs avec leur statut sur le canal (opérateur, semi-opérateur, voice) en ajoutant l'option status=1.
Code:
<script type="text/javascript" src="https://zeolia.chat/scripts.php?chan=CANAL&action=users&status=1"></script>
Mode simplifié
Avec l'option mode=short, vous obtenez la liste simplifiée des utilisateurs, c'est à dire seulement leurs pseudonymes.
Code:
<script type="text/javascript" src="https://zeolia.chat/scripts.php?chan=CANAL&action=users&mode=short"></script>
N'oubliez pas que vous pouvez utiliser nobot=1 et status=1
Rendu:
Version JSon
En utilisant l'option mode=json, vous obtiendrez la version json de la liste des utilisateurs.
Exemple d'utilisation:
<?php $online = file_get_contents('https://zeolia.chat/scripts.php?chan=CANAL&action=users&mode=json'); ?>
Le format des données:
{
	"<pseudo en minuscules>" : {
		"nick" : <pseudo>,
		"realname" : <nom réel>,
		"statut" : <statut (@, %, + ou rien)>,
		"signon": <dateconnexion YYYY-MM-DD HH:mm:ss>,
		"delay": <durée de connexion lisible>,
	},
	"crazycat" : {
		"nick" : "CrazyCat",
		"realname" : "crazycat",
		"statut" : "@";,
		"signon": "2021-03-18 08:08:57,
		"delay": "3 heures et 36 minutes",
	},
	...
}