Des smileys dans SPIP

Ce script, cette bidouille, ce hack, ce mod, cette contrib’, appelez cela comme vous voulez s’inspire de Smiley II, lui même déjà inspiré de Smiley.

Je rajoute donc a smiley II :
  La possibilité de cliquer directement sur les emoticons pour les utiliser dans le forum. Pas de glisser-déposer hasardeux, et nécessitant d’employer le texte et pas l’image (pas évident). J’ai fait ca avec un peu de Javascript très inspiré de ce que j’ai déjà trouvé sur le net
  La visibilité des smileys lors de la prévisualisation des commentaires dans le forum. Comment voulez-vous que les gens vérifient leur texte si on ne l’interprète pas ? Ce bug est critique dans smiley II, mais pour le corriger j’ai du faire un peu le  !
  L’utilisation de 2 double-points, a savoir avant et après le nom du fichier. Je trouve ca plus propre, mais comme SPIP selon le cas peut avoir interprété le second, le code qui en résulte n’est pas plus propre lui, au contraire. Ainsi, après application du filtre, tout texte de la forme :nom_du_smiley : sera remplacé par le smiley, si celui-ci existe dans votre répertoire smiley.

Les autres bugs existent encore, en particulier il n’y aucune intégration à la partie administrative. Cela ne me gène pas de trop, donc pour le moment je ne suis pas trop près de le coder... Sauf si vous voulez me payer pour ça bien entendu  !

Mise en Place

Pour l’installation, tout pareil que Smiley II, sauf que cette fois-ci, il va falloir modifier le fichier inc-forum.php3. Rien de bien méchant ; il faut juste changer la ligne (aux environs de la 140ième) :

$ret .= "<p />".propre($texte)."<p />";

en $ret .= "<p />".smileys(propre($texte))."<p />";

Pour les fainéants fans d’unix (comme moi ), voici le patch :

--- spip/SPIP-v1-7/inc-forum.php3 Sun Sep 28 23:35:11 2003 +++ inc-forum.php3 Tue Aug 3 04:44:18 2004 @@ -137,7 +137,8 @@ if ($afficher_texte != "non"){ $ret .= "<div style='font-size: 120%; font-weigth: bold;'>".typo($titre)."</div>"; $ret .= "<p /><b><a href='mailto:".entites_html($email_auteur)."'>".typo($auteur)."</a></b>"; - $ret .= "<p />".propre($texte)."<p />"; + // CRADOS HAXOR BY RITTON + $ret .= "<p />".smileys(propre($texte))."<p />"; } $ret .= "<a href='".entites_html($url_site)."'>".typo($nom_site_forum)."</a>";

Pour le reste de l’installation, je vais bêtement recopier ce qui a été dit pour Smiley II, en l’adaptant a peine....

Tout d'abord récupérez des smileys (formats de votre choix) et placez les dans un dossier "smileys/" à la racine de votre site SPIP. Je vous conseille des images pas trop grandes, du style 15x15 px.

Ensuite copiez_collez dans mes_fonctions.php3 le filtre suivant : (si vous avez déjà au moins un filtre, et donc une page mes_fonctions.php3, supprimez les balises <?php et ?> dans ce morceau de code)

<?php /* * +----------------------------------+ * Nom du Filtre : smileys gen. III * +----------------------------------+ * Date : mercredi 14 octobre 2003 * Auteur : Maxime Ritter <airmax@trolleur.net> * basé sur smileys II de BoOz (booz.bloog@laposte.net) * +-------------------------------------+ * Fonctions de ce filtre : * Dans un texte, genere automatiquement le smiley * approprie a la place d'une chaine :nom:. * Ce filtre utilise les smileys disponibles dans * le repertoire smileys/ * Exemple d'application : * [(#TEXTE|smileys)] * +-------------------------------------+ * * Pour toute suggestion, remarque, proposition d'ajout * reportez-vous au forum de l'article : * http://maxime.ritter.eu.org/article.php3?id_article=13 */ function smileys($chaine) { $listimag=array(); $rep1="smileys/"; $listfich=opendir($rep1); while ($fich=readdir($listfich)) { if(($fich !='..') and ($fich !='.') and ($fich !='.DS_Store')) { $nomfich=substr($fich,0,strrpos($fich, ".")); $listimag[$nomfich]= '<img class="smiley" alt="smiley" src="/smileys/' . $fich . '" />' ; } } ksort($listimag); reset($listimag); while (list($nom,$chem) = each($listimag)) { // Malheureusement, il arrive aux filtres internes de SPIP de perturber // ce que nous cherchons, d'où les 2 formats $chaine = str_replace(":".$nom."&nbsp;:", $chem , $chaine); $chaine = str_replace(":".$nom.":", $chem , $chaine); } return $chaine; } ?>

Pour finir votre installation, téléchargez le fichier inc_tableau_smileys.php3 et placez le à la racine de votre site spip. Le code de ce fichier permet d’afficher les smileys. Si vous regardez le code source, vous noterez l’apparition d’un peu de JavaScript depuis la version Smiley II !

Utiliser le filtre dans les squelettes

Maintenant que le filtre est en place il vous faut modifier les squelettes qui doivent prendre en compte ce filtre. Plus précisément ce sont sur les balises spip, affichant du texte (pouvant contenir des smileys), que vous devez appliquer ce filtre, par exemple dans vos squelettes de forums utilisez :

[(#TEXTE|smileys)]

on peut également utiliser d’autres filtres en même temps que celui là, par exemple :

[(#TEXTE|justifier|smileys|autres_filtres)]

Pour plus de détails sur l’utilisation des filtres, voir : Les filtres de SPIP (dans la documentation officielle).

Tableau récapitulatif

Il faut aussi penser à montrer à vos rédacteurs ou visiteurs les smileys qui seront filtrés, et qu’ils peuvent utiliser. Par exemple, dans le squelette "forum.html" qui permet d’écrire un nouveau message, ajoutez le tableau récapitulatif ci-dessous.

Utilisez la commande

<INCLURE(inc_tableau_smileys.php3)>;

Ce fichier appelle le fichier inc_tableau_smiley.html qui affiche la liste des smileys disponibles dans un tableau transparent.