Qu’est-ce que Jappix Mini ?
Jappix Mini est un script à embarquer dans le code de vos pages. Lorsqu’il est présent, un onglet « Discussion » apparaît en bas à droite de la page, et permet aux visiteurs d’entrer sur un ou plusieurs salons de discussion.
Les salons sont de type Jabber (XMPP), ce qui permet également d’entrer sur les salons IRC car la plupart des serveurs Jabber fournissent une passerelle entre les deux.
Que fait ce plugin ?
Le programme Jappix Mini est déjà pensé pour être très simple d’intégration. Ce plugin va un peu plus loin en proposant un formulaire de réglages, ainsi qu’une intégration sous forme de modèle, utilisable dans vos squelettes si vous êtes webmestre, et même dans vos textes d’articles, descriptions de rubrique, etc. pour les auteurs de l’espace privé.
Configuration
Si vous avez installé le plugin CFG, vous verrez une petite icône à côté de Jappix Mini dans la liste des plugins. Cliquez dessus pour arriver au formulaire de configuration.
Voici une explication sur les différents champs :
URL de Jappix. Jappix Mini se base sur une instance de Jappix pour fonctionner. Vous pouvez utiliser l’instance fournie par le site jappix.com (auquel cas il suffit de laisser cette case vide), ou installer la vôtre.
Compte Jabber. La connexion à un salon de discussion requiert un compte Jabber.
- Si vous souhaitez utiliser un compte « réel », vous pouvez indiquer le nom d’utilisateur, le serveur et le mot de passe du compte. Lors de l’utilisation du mini-chat, vous aurez même le plaisir de voir vos contacts en plus des salons de discussion !
- Sinon, vous pouvez utiliser un serveur dit « anonyme », qui ne requiert ni utilisateur ni mot de passe car il créera un compte « jetable » lors de la connexion. Dans ce cas, renseignez uniquement le nom du serveur anonyme à utiliser. Si vous laissez également ce champ vide, c’est le serveur anonyme fourni par le site jappix.com (anonymous.jappix.com) qui sera utilisé.
Attention : Si vous utilisez un compte « réel » (non-anonyme), ayez conscience que le mot de passe que vous indiquerez apparaîtra en clair dans le code source de la page HTML. Cela est donc à éviter si le site est public, car toute personne en possession du mot de passe pourra modifier la liste de contacts, changer le mot de passe, supprimer le compte, etc.
Un mot sur la ressource : Valeur peu cruciale, il s’agit d’une chaîne de caractères choisie par le client Jabber lors de la connexion, anonyme ou pas. Cette chaîne est visible lorsqu’un visiteur arrive sur le salon (seulement par les administrateurs du salon ou par tout le monde, suivant la configuration du salon). Dans le cas d’un minichat sur une page web, cela peut permettre par exemple de donner une information de contexte indiquant l’origine des visiteurs, en indiquant le nom du site par exemple. Si vous laissez cette case vide, Jappix Mini utilisera un texte par défaut ("Jappix Mini" ou toute autre valeur configurée dans Jappix).
Les salons. La liste des salons est évidemment le paramètre le plus important. Indiquez l’adresse de chaque salon à rejoindre automatiquement, un par ligne. Une adresse de salon Jabber (appelé MUC pour Multi-User Chat) est de la forme nom-du-salon@domaine, où domaine est le serveur qui héberge le salon. Si vous indiquez uniquement un nom, le salon sera cherché « en local » sur le serveur configuré dans Jappix (par exemple muc.jappix.com si vous utilisez l’instance de jappix.com).
Certains salons sont protégés par une clé, pour restreindre leur accès à certaines personnes. La zone mots de passe permet d’indiquer les clés respectives des salons, le cas échéant. Attention : tout comme pour les mots de passe des comptes Jabber, il faut avoir conscience que si vous entrez des clés de salons, elles seront visibles en clair par les visiteurs ; à utiliser avec intelligence donc.
Vous pouvez également demander à ce que le visiteur entre immédiatement dans le ou les salons lors du chargement de la page : pour cela, cochez la case correspondante (sans blague ?).
Le champ Pseudo prédéfini force l’utilisation d’un certain pseudo. Si vous utilisez cette fonctionnalité, ayez conscience des conflits de nom possibles, car tous les visiteurs arriveront avec le même pseudo ou des variantes du type « toto_ », « toto__ », etc.
La case à cocher Ouvrir automatiquement permet de dérouler le panneau de chat lors de la connexion au salon (et pas lors du chargement de la page, nuance).
Enfin, le paramètre Langue définit la langue de l’interface. La valeur par défaut permet de se caler sur la langue de la page (#LANG plus exactement) si Jappix Mini sait la parler, mais vous pouvez vouloir forcer une certaine langue via ce paramètre.
Intégration via les squelettes
Ce qui nous intéresse, ne l’oublions pas, c’est que le minichat apparaisse sur le site (ah oui). Pour cela, il suffit d’appeler le modèle minichat dans l’entête HTML (<head>...</head>) des pages que l’on souhaite doter de cette fonctionnalité. En réalité, il est même possible de le mettre où on veut dans la page, mais je crois que c’est mieux dans le <head>. Enfin c’est vous qui voyez, quoi.
Au cas où un doute subsiste, la syntaxe est la suivante :
- #MODELE{minichat}
Les paramètres réglés dans le formulaire de configuration (voir section précédente) seront automatiquement appliqués. Cependant, vous pourriez avoir envie de les modifier au coup par coup, par exemple pour choisir le pseudo ou même la liste des salons en fonction du contexte. Voici les noms des variables d’environnement (pour des explications détaillées sur leur rôle, se référer à la section précédente) :
-
url: URL de Jappix -
lang: Langue de l’interface -
salons: Liste des salons à rejoindre, séparés par des points-virgules ( ;) -
pass_salons: Clés des salons, le cas échéant -
pseudo: Pseudo à utiliser sur les salons -
ressource: Ressource de la connexion Jabber -
connecter: Entrer automatiquement sur le salon lors du chargement. Valeurs possibles : true ou false. -
ouvert: Ouvrir le panneau de chat lors de l’entrée sur le salon. Valeurs possibles : true ou false. -
user: Nom d’utilisateur de la connexion Jabber, si l’on souhaite une connexion non-anonyme. -
domaine: Serveur Jabber. -
pass: Mot de passe de la connexion Jabber, si l’on souhaite une connexion non-anonyme.
En exploitant astucieusement ces variables d’environnement, vous pourrez allier la simplicité de Jappix Mini avec la puissance du langage de squelettes de SPIP. Par exemple, vous pourriez définir un pseudo en accord avec le login ou le nom de l’auteur connecté, ou encore un choix de salons en fonction de la page en cours.
Intégration via les articles
Le plugin Jappix Mini fournissant un modèle <minichat>, il est également possible pour les auteurs SPIP d’intégrer celui-ci dans les articles, les descriptifs de rubriques, etc. Les paramètres sont les mêmes que pour #MODELE{minichat}.
Exemple d’utilisation : <minichat|salons=ratatouille>.
Multilinguisme
Depuis la version 0.2, ce plugin permet d’utiliser des blocs <multi> dans les champs de configuration. Cela permet par exemple de configurer un salon (ou même serveur) différent suivant la langue, de personnaliser le pseudo à utiliser, la ressource, etc. Par exemple, sur Plaztika en français, l’onglet vous emmènera sur le salon francophone, et si vous changez de langue (menu de langue tout en haut), vous arriverez toujours sur le salon adapté.
À vous !
Si vous utilisez ce plugin, n’hésitez pas à partager vos idées et astuces dans le forum de cet article !
Jappix Mini au format .zip
Vos commentaires
# Le 28 avril à 05:17, par PRX
En réponse à : Jappix Mini
Bonjour,
et simplement, dans un site géré par Sarka-spip : comment fait-on pour intégrer ce plugin utile ?
merci d’avance
Répondre à ce message
# Le 10 mars 2011 à 03:31, par Suske
En réponse à : Jappix Mini
Trois retours après quelques tests :
- l’insertion du modèle sans paramètre particulier dans un
#TEXTEdoit (comme pour tous les modèles je crois) comporter un chiffre à la fin ou être terminé par « | » :<minichat0>ou<minichat|>. Sans quoi, le modèle ne retourne rien...- l’usage « aucune configuration sauf la définition de plusieurs salons (un seul par ligne) » entraîne la sélection d’office du dernier... Je m’attendais à ce que plusieurs s’ouvrent si on en indique plusieurs mais ce n’est pas le cas.
- pour que les usagers du minichat puisse converser entre eux et avec les utilisateurs connectés via leur compte jabber, il faut que le salon de discussion soit paramétré de manière à autoriser le « private messaging ». A défaut et en l’état actuel (v. 0.3) de Jappix-Mini, les visiteurs du site peuvent voir les autres utilisateurs et afficher une fenêtre de discussion privée mais la conversation ne s’établit pas (et c’est logique).
# Le 24 mars à 10:07, par marjorie
En réponse à : Jappix Mini
Bonjour,
j’ai essayé de comprendre la dernière partie de ton message (à propos des « private messaging », car j’aimerais bien proposer cette possibilité à mes utilisateurs en plus du chat. J’ai donc lu la doc proposée sur ce site, et sur le wiki de jappix, mais je ne comprends pas bien comment m’y prendre. Comment je fais pour activer le « private messaging » sur mon salon ?
# Le 24 mars à 12:26, par Suske
En réponse à : Jappix Mini
Il faut donc créer un salon de discussion jabber, avec un client jabber, et le paramétrer pour que les utilisateurs du salon soient autorisés à se contacter en privé. Si je me souviens bien...
# Le 24 mars à 13:07, par marjorie
En réponse à : Jappix Mini
Merci pour ta réponse suske
Si je suis bien :
- je me suis créé un compte sur jabber
- j’ai créé un salon et je l’ai paramétré (il a donc une adresse en nomdusalon@muc.jappix.com)
Je crois que c’est ensuite que je pèche... je n’arrive pas à comprendre quels champs de CFG je dois remplir...
# Le 24 mars à 14:44, par Suske
En réponse à : Jappix Mini
Je suis pas spécialiste... Avec le client Pidgin, quand tu as créé un salon, taper /help donne des indications d’aide... De là, je vois que taper /config ouvre une fenêtre incluant une liste de paramétrages... Là dedans, tu peux autoriser le « private messaging » et plein d’autres choses. Fait des essais (ou compte sur qq’un d’autre) car je suis à bloc de mes capacités là :-p J’ai chipoté pas mal sur jabber il y a une bonne année de ça pour une association mais depuis ça tourne tout seul et j’ai un peu oublié...
Répondre à ce message
# Le 23 mars à 23:36, par marjorie
En réponse à : Jappix Mini
Bonjour,
j’ai installé le plugin un site en spip 2.1.12, en laissant la plupart des champs vides (sauf le nom d’un salon). La fenêtre jabber se place bien, mais toute le monde est en mode « déconnecté », si bien que l’on ne peut pas utiliser le chat. Quelqu’un a-t-il une idée de l’’erreur que j’aurais pu faire ? (pour info : http://www.radiohead.fr/-forum-)
# Le 24 mars à 09:42, par marjorie
En réponse à : Jappix Mini
je me réponds à moi même car j’ai réussi à avancer :
j’avais mis un titre de salon avec un espace, et quand je l’ai retiré, ça fonctionnait.
Répondre à ce message
# Le 1er juin 2011 à 14:46, par Rainer Müller
En réponse à : Jappix Mini
Merci beaucoup pour ce plugin.
Je n’ai pas de trouver de documentation sur Jappix Mini, alors je pose ma question ici, est-ce qu’il est possible de créer une liste d’amis, décider quel utilisateurs doit être visible ans sa liste ?
Est-il possible de rajouter un menu des smileys
Rainer
# Le 1er juin 2011 à 21:23, par davux
En réponse à : Jappix Mini
Si tu configures un compte jabber (avec JID et mot de passe) au lieu d’un compte anonyme, tu auras automatiquement sa liste de contacts (appelée « roster » dans la terminologie Jabber).
Pour ce qui est des smileys, il faudrait demander la fonctionnalité sur le gestionnaire de tickets.
Sinon pour la doc tu peux regarder sur le site officiel ou la doc technique.
# Le 3 juin 2011 à 12:08, par Rainer Müller
En réponse à : Jappix Mini
super, merci
Répondre à ce message
# Le 31 janvier 2011 à 10:06, par michel
En réponse à : Jappix Mini
Tout d’abord, merci beaucoup pour ce plugin !
Je débute sur spip et j’ai quelques difficultés à le configurer. J’aimerai que le module de chat s’affiche en permanence pour les utilisateurs connectés et que la connexion se fasse automatiquement avec le login de l’utilisateur en cours. J’arrive à le faire pour l’espace public en insérant :
dans le squelette du pied de page.
Par contre, je sèche pour l’espace privé. La structure des squelettes de l’espace privé me semble un peu obscure. Peut-être est-ce parce que l’espace privé n’est pas encore complètement « squelettisé » ? Par exemple je ne trouve pas de squelette pour le pied de page de l’espace privé. Où se trouve-t-il ?
Quelqu’un voit une solution à mon problème ?
# Le 4 février 2011 à 09:22, par michel
En réponse à : Jappix Mini
Je me répond : la solution que j’ai posté plus haut affiche le chat aussi pour les visiteurs non-connectés et leurs demande de saisir un pseudo. Pour que seuls les rédacteurs et admins voient le chat, c’est plutôt :
À mettre dans le squelette du pied de page (ou n’importe quelle partie de la page qui est affichée en permanence.
Ceci ne marche que dans la partie publique, pour obtenir la même chose dans l’espace privé, j’ai procédé un peu différemment, sans utiliser le plugin. J’ai ajouté :
tout à la fin du fichier ecrire/inc/bandeau.php .
# Le 5 février 2011 à 04:17, par davux
En réponse à : Jappix Mini
Pour le même résultat, au lieu de
|ouitu peux peut-être utiliser :C’est-à-dire des parenthèses autour de l’appel à
#SESSION{login}, avec les crochets autour de#MODELEpour que tout le modèle soit zappé si#SESSION{login}n’existe pas. Je n’ai pas testé, mais sauf blague du compilateur ça devrait fonctionner.En ce qui concerne l’espace privé, ça serait effectivement bien de le fournir en natif dans le plugin. Je ne sais pas comment faire ; si quelqu’un sait... gogogo ! :)
# Le 20 avril 2011 à 17:55, par bubu
En réponse à : Jappix Mini
Une piste avec le pipeline ’header_prive’ :
Ajouter dans plugin.xml :
Puis dans le fichier jappix_mini_prive.php :
Par contre les paramètres renseignés via CFG ne sont pas pris en compte.
Répondre à ce message
# Le 11 février 2011 à 20:34, par davux
En réponse à : Jappix Mini
Le plugin passe en version 0.2 avec une gestion du multilinguisme (voir section « Multilinguisme » à la fin de cet article).
Répondre à ce message
# Le 25 janvier 2011 à 20:58, par chrisgaillard
En réponse à : Jappix Mini
Merci pour ce plugin qui va m’être très utile.
y’a t’il une démo en ligne quelque part, ou est-ce que quelqu’un l’a installé ?
# Le 25 janvier 2011 à 21:17, par davux
En réponse à : Jappix Mini
Tu peux tester Jappix Mini en général sur plein de sites, notamment le site officiel.
Sinon en ce qui concerne le plugin SPIP spécifiquement, je l’ai installé sur le site plaztika.com. Le salon Jabber qui s’ouvre est arte@chat.plaztika.com, salon hispanophone ayant pour thématique générale les arts plastiques (d’ailleurs si vous connaissez des gens que ça peut intéresser, on cherche du monde pour lancer ça !).
# Le 27 janvier 2011 à 00:00, par ?
En réponse à : Jappix Mini
super plugin !
qqu aurait il un moyen simple pour automatiser la connexion automatique d’un nouvel utilisateur enregistré sur le site ?
merci par avance,
je continue d’essayer d’en comprendre le fonctionnement
par contre le système de login du site jappix est bien mieux que celui proposé par défaut par le plugin :/
# Le 27 janvier 2011 à 03:48, par davux
En réponse à : Jappix Mini
(ça aurait été bien de plutôt démarrer un nouveau fil)
Je ne comprends pas ce que tu veux dire. Tu peux automatiser la connexion en cochant la petite case qui va bien, ou avec le paramètre
connecterdu modèle. Mais je ne comprends pas le rapport avec un nouvel utilisateur.Ou bien est-ce que tu parles de se connecter automatiquement à un compte Jabber suivant l’utilisateur ? Pour cela, tu as besoin de stocker le JID et le mot de passe de chaque personne. C’est ce que je compte faire pour plaztika.com, car je fournis un compte Jabber à chaque artiste. (Mais stocker le mot de passe est problématique : l’idéal serait de pouvoir réutiliser le mot de passe SPIP, mais il est stocké en base de façon chiffrée.)
Mais tu parles d’un nouvel utilisateur, du coup vraiment il faudrait que tu expliques. :)
Oui. Comme ça ne fait pas partie du programme Jappix Mini lui-même, je n’ai pas pensé à l’inclure. Mais effectivement, ça serait pas mal si quelqu’un veut fournir une mire de login comme ça sous forme de modèle.
# Le 27 janvier 2011 à 05:19, par davux
En réponse à : Jappix Mini
(ou formulaire)
# Le 27 janvier 2011 à 23:00, par ?
En réponse à : Jappix Mini
non je voulais dire que l’utilisateur une fois identifié sur le site, soit connecté automatiquement à jappix
possible ?
# Le 31 janvier 2011 à 20:42, par ?
En réponse à : Jappix Mini
pas de réponses ?
# Le 31 janvier 2011 à 20:48, par davux
En réponse à : Jappix Mini
Apparemment pas.
Je ne comprends toujours pas ce que tu veux dire par « être connecté à jappix ».
Et il suffit de poser la question une fois, pas la peine d’insister.
# Le 1er février 2011 à 23:42, par ?
En réponse à : Jappix Mini
ben qu’une fois identifié sur le site spip il apparaisse sous ce nom la dans le salon activé par mini-jappix
# Le 1er février 2011 à 23:44, par ?
En réponse à : Jappix Mini
mais en fait que crois que la réponse a été donnée par michel...
Répondre à ce message