Documentation du script [MOD] [HFR] Édition du wiki partout mod_r21 (version 3.3.1) par roger21
Auteur original : toyonos Titre original : [HFR] Edition rapide du Wiki smilies
Description : Permet d'afficher les mots-clés des smileys persos en passant la souris sur le smiley et permet de modifier facilement les mots-clés des smileys persos via un double-clic sur le smiley.
Modification : Simplification des étapes de modification des mots-clés, réécriture et modernisation du code.
Lien d'installation du script : https://raw.githubusercontent.com/r [...] 21.user.js
Page de présentation du script : http://roger21.free.fr/hfr/
Documentation : https://forum.hardware.fr/forum2.ph [...] e=66847185
Compatibilités connues : ff ch gm vm tm
Incompatibilités connues :
Popularité : ███████████████████████ (23 personnes ont déclaré utiliser ce script)
Dernière mise à jour connue : 11/03/2025
L'installation du script se fait en cliquant sur le « Lien d'installation du script » ci-dessus après avoir installé une extension Greasemonkey, Violentmonkey ou Tampermonkey pour votre navigateur. Voir la partie « Mini FAQ » du premier post et la FAQ complémentaire pour plus d'informations.
Ce script permet de consulter les mots-clés des smileys persos du forum en passant la souris sur les smileys (et en attendant une demi-seconde) et permet de modifier ces mots-clés en double-cliquant sur les smileys. Et ceci à peu près partout sur le forum.
Consultation des mots-clés :
Édition des mots-clés :
Les mots-clés des smileys persos sont gérés par le « wiki smilies », ce script étant une interface simplifiée (et améliorée) vers ce wiki (d'où le nom du script « Édition du wiki partout »).
Le but de ce mod a d'abord été de simplifier les étapes d'éditions des mots-clés en supprimant une étape de validation (le script en comptait deux) et en réduisant le délai d’affichage de la popup de confirmation (qui était un peu longuet).
Une des premières modifications apportées par ce mod a aussi été la possibilité de consulter les mots-clés sur la page des profils.
Ont ensuite suivi toute une série de petites améliorations et optimisations du code ainsi que des petites corrections de bug et améliorations de l'interface avec notamment la gestion des smileys dans des liens, la gestion des smileys temporaires, la gestion des posts roses, le passage au https ou encore la gestion des pages ne permettant pas l'édition.
Puis vint une refonte complète du code et de l'interface (avec la version 3.0.0) avec principalement pour buts de gérer la compatibilité tous navigateurs et toutes extensions, de sécuriser le nombre de demandes simultanées d'accès aux mots-clés et d'utiliser une mini-popup HTML pour la consultation des mots-clés afin d'éviter les contraintes imposées par l'utilisation de l'infobulle (ou tooltip) native du navigateur.
Ont encore suivi 2 apports importants, l'utilisation d'un champ d'édition multi-ligne pour les mots-clés au lieu d'un champ d'édition d'une seule ligne initialement (avec la version 3.1.0) et la possibilité de modifier les mots clés sur des pages qui ne le permettaient pas avant, la page des profils et l'aperçu de la page de réponse et d'édition normale (avec la version 3.2.0) avec également plusieurs corrections concernant la gestion de la disparition de la mini-popup de consultation des mots-clés.
Et enfin une nouvelle petite série d'améliorations (l'ajout du bouton d'accès à la page individuelle du smiley sur la mini-popup d'édition, la gestion des smileys verrouillés et l'ajout d'un message d'erreur spécifique pour les sanctions) et de corrections ont fini de valider la refonte complète du code et de l'interface et ont amené le script à sa version 3.3.0 (qui est la dernière assurément puisque ce script est parfait maintenant
).
- C'est quoi le wiki smilies
Chaque membre du forum peut ajouter jusqu'à 11 smileys persos dans son profil (Profil -> Gestion d'images -> Gérer ses smilies personnalisés). Une fois ajoutés (et validés par un administrateur), ces smileys sont utilisables par tous les membres du forum. Il y a actuellement plus de 31 500 smileys persos sur le forum.
Pour s'y retrouver parmi tous ces smileys, il est possible de leur associer des mots-clés, soit depuis sa page de gestion des smileys dans son profil, soit directement depuis le wiki smilies. Le wiki smilies (ou « wiki smileys » ou simplement « le wiki ») permet donc d'ajouter, de modifier et de supprimer des mots-clés, sur un ou plusieurs smileys à la fois et cela peut être fait par n'importe qui (à condition d'être membre, connecté, de ne pas être sanctionné et de respecter les contraintes d'édition).
Mais le wiki smileys permet surtout de rechercher les smileys que l'on souhaite utiliser, soit avec le code du smiley (depuis la page du wiki uniquement), soit surtout, avec un ou plusieurs mots-clés. On retrouve la fonction de recherche des smileys par mots-clés sur la page du wiki bien sûr mais surtout sur la page de réponse et d'édition normale (dans la colonne de gauche) et elle est aussi intégrée à la réponse et l'édition rapide par les scripts « [HFR] Wiki smilies & raccourcis dans la reponse/edition rapide » version 1 et 2 et par le script modifié « [HFR] wiki smileys et raccourcis mod_r21 ».
Enfin, le wiki smileys conserve l'historique de toutes les modifications faites sur les mots-clés des smileys persos (avec leur auteur), ces historiques sont consultables depuis les pages individuelles de chaque smiley (exemple ici).
- Quelques conseils, rappels et infos sur les mots-clés et la recherche de smileys
- seuls les mots-clés de 3 caractères au moins sont pris en compte, les mots-clés comme « le », « o », « tt » ou « up » sont complètement ignorées du coup on remplace en général « o » par « ooo », « tt » par « ttt » et « up » par « upp » par exemple et on laisse tomber les mots-clés de 2 lettres sans importance ;
- seuls les caractères alphanumériques et les caractères d'autres alphabets sont pris en compte dans les mots-clés, tous les autres caractères (avec quelques rares exceptions) sont considérés comme des séparateurs de mots-clés ainsi « mots-clés » ou « aujourd'hui » par exemple sont à chaque fois 2 mots-clés, on utilise en général l'espace pour séparer les mots-clés mais la virgule, le tiret ou d'autres symboles ont le même effet (mais l'espace reste le plus clair) ;
- les accents et les majuscules sont ignorés, une recherche avec « gerard » permettra de trouver indifféremment les smileys ayant pour mot-clé « gérard », « Gerard » ou « Gérard » ;
- lorsque l'on fait une recherche avec plusieurs mots-clés, tous les smileys qui ont au moins l'un des mots-clés sont retournés, pour ne rechercher que les smileys qui ont tous les mots-clés fournis il faut les faire précéder d'un « + » (sans espace), par exemple « +ooo +lol » permettra de trouver exclusivement les smileys qui ont à la fois les mots-clés « ooo » et « lol », similairement il est possible d'utiliser le « - » (sans espace) pour exclure des mots-clés ;
- il peut être intéressant parfois de fusionner les mots-clés pour faciliter la recherche, ainsi on peut utiliser « noirblanc » ou « noiretblanc » par exemple (pour les smileys en noir et blanc) il y a des cas plus pertinents et des cas où c'est moins pratique, à voir au cas par cas... ;
- il y a environ 8,5% de « doublons » (c-a-d de smileys identiques) dans les smileys persos, pour les exclure des résultats de la recherche on leur donne pour seul et unique mot-clé le mot-clé « doublon » cela permet de les identifier et de ne pas encombrer inutilement les résultats de la recherche ;
- certains smileys sont verrouillés, c-a-d qu'on ne peut plus modifier leurs mots-clés cela est principalement utilisé pour les smileys « doublon » justement ;
- il n'est pas possible de modifier successivement les mots-clés d'un même smileys, il faut attendre 5 min entre 2 modifications (sauf si c'est pour ses propres smileys persos et depuis sa page de gestion des smileys persos) ;
- il n'est pas possible non plus de modifier les mots-clés d'un smiley si on est sous le coup d'une sanction ;
- tout le monde peut rajouter des mots-clés librement et, même s'il y a quelques abus, il est de manière générale préférable d'avoir trop de mots-clés que pas assez ;
- enfin le wiki smileys est connu pour avoir de nombreux bugs et anomalies, néanmoins ce script ne permet en aucun cas d'exploiter une éventuellement faille ni de contourner les contraintes d'éditions sur les mots-clés ;
Pour consulter les mots-clés d'un smiley perso il suffit de passer la souris sur le smiley et d'attendre une demi-seconde. Les mots-clés apparaissent alors dans une mini-popup à proximité du smiley (plutôt au-dessus et à droite du smiley, ou à gauche s'il n'y a pas assez de place à droite).
En plus des mots-clés
, la mini-popup de consultation rappelle aussi le nom/code du smiley
. Par défaut et pour éviter la redondance d'information qui nuirait à la clarté, le script supprime l'infobulle (ou tooltip) générée par le forum sur les smileys persos et qui rappelle également le nom/code du smiley.
La taille de la mini-popup de consultation s'adapte à son contenu pour permettre d'afficher tous les mots-clés :
Pour faire disparaître la mini-popup de consultation il suffit de déplacer la souris en dehors du smiley ou sur la mini-popup elle-même ou sur un autre smiley ou encore de cliquer (n'importe où) ou enfin de presser la touche « echap ». La mini-popup de consultation disparaît également lorsque l'on ouvre la mini-popup d'édition.
Pour modifier les mots-clés d'un smiley perso il suffit de double cliquer sur le smiley. La mini-popup d'édition des mots-clés apparaît alors (plutôt en dessous et à droite du smiley, ou à gauche s'il n'y a pas assez de place à droite).
La mini-popup d'édition des smileys contient un champ d'édition des mots-clés
, le nom/code du smiley
, les boutons de validation et d'annulation
et une poignée de redimensionnement
.
Le nom/code du smiley
sur la mini-popup d'édition est aussi un bouton qui permet d'ouvrir, dans un nouvel onglet, la page individuelle du smiley sur le wiki (qui contient l'historique de toutes les éditions des mots-clés faites sur ce smiley et qui permet aussi d'éditer directement les mots-clés) :
La mini-popup d'édition s'ouvre toujours avec la même taille mais la poignée de redimensionnement
permet de l'agrandir librement pour pouvoir voir et modifier clairement tous les mots-clés, lorsque la mini-popup est trop petite pour afficher tous les mots-clé, une barre de défilement verticale est présente :
En dehors du bouton de validation
, il est possible de fermer la mini-popup d'édition en cliquant sur le bouton d'annulation/fermeture
ainsi qu'en pressant la touche « echap ». Attention, la mini-popup d'édition disparaît également si vous en ouvrez une autre, il ne peut y avoir qu'une seule mini-popup d'édition ouverte à la fois. Au besoin, le wiki smileys ainsi que la page de gestion des smileys dans son profil permettent d'éditer les mots-clés de plusieurs smileys la fois.
Par défaut, la mini-popup d'édition rajoute une espace après le dernier mot-clé, cela permet de rajouter directement un ou plusieurs nouveaux mots-clés sans se soucier de les séparer des mots-clés déjà présents (les espaces superflues éventuellement restantes sont nettoyées lors de la validation).
Le bouton de validation
permet d'enregistrer dans le wiki les modifications faites sur les mots-clés du smiley.
La validation est suivie de l'affichage d'un indicateur d'activité
qui remplace les boutons de validation
et d'annulation
:
Lorsque la demande de validation des modifications aboutit (cela ne prend qu'un instant), l'indicateur d'activité est remplacé par un message en couleur qui indique le résultat de la validation.
Soit en vert lorsque la validation s'est bien passée :
Soit en orange lorsque la règle des 5 minutes n'est pas respectée (dans ce cas les modifications sont perdues) :
Soit en rouge lorsque l'édition est impossible (plusieurs cas possibles) :
Ces messages restent affichés une seconde et demie puis la mini-popup disparaît.
Un cas particulier de la mini-popup d'édition existe lorsque l'utilisateur ne s'est jamais connecté (après avoir installé le script) :
Dans ce cas la mini-popup peut être fermée en cliquant directement dessus (et toujours en pressant la touche « echap »).
Enfin lorsqu'un smiley est verrouillé les minis-popups prennent une teinte rouge et l'édition n'est pas possible :
Ce script fonctionne avant tout sur les smileys présents dans les messages du forum, mais il fonctionne aussi sur :
- les smileys persos de la colonne de gauche de la page de réponse et d'édition normale, que ce soient ses propres smileys persos, ses smileys favoris ou les smileys résultants d'une recherche sur le wiki.
- les smileys présents dans l'aperçu du message en cours d’édition de la page de réponse et d'édition normale (mais seulement avec Tampermonkey ou Violentmonkey).
- les smileys de la page des profils avec en plus une remise en forme de l'affichage des smileys :
->
Et enfin il fonctionne aussi sur les smileys du wiki smileys lui-même (Yo Dawg, I herd you like to edit keywords, so I put « [HFR] Édition du wiki partout mod_r21 » in the wiki smileys so you can edit keywords while you edit keywords
).
Par ailleurs, ce script n’interagit avec aucun autre script, y compris avec des scripts qui géreraient des smileys persos ou des aperçus. Cela veut dire que ce script n'a pas d'autres cas de fonctionnement que ceux exclusivement listés ci-dessus.
Ce script ne possède aucune fonctionnalité de configuration, mais il possède 3 paramètres dans le code qui s'adressent aux utilisateurs avancés soucieux de modifier le fonctionnement et l’apparence du script. Ces 3 paramètres sont regroupés dans la toute première section du code : « options en dur ». On y trouve :
- le paramètre « in_title » qui peut prendre les valeurs « true » ou « false » et qui est à « false » par défaut. En le passant à « true » ce paramètre permet de remplacer la mini-popup de consultation des mots-clés par une simple infobulle (ou tooltip) native du navigateur :
Dans ce cas l'infobulle (ou tooltip) générée par le forum sur les smileys persos n'est pas supprimée mais simplement modifiée / complétée.
Ce paramètre est un héritage des premières implémentations de la fonctionnalité de consultation des mots-clés dans les scripts qui étaient codées ainsi, ce paramètre s'adresse surtout aux nostalgiques.
- le paramètre « box_shadow » qui peut prendre les valeurs « true » ou « false » et qui est à « true » par défaut. En passant ce paramètre à « false » le script ne mettra pas d'effet d'ombre sous les minis-popups.
- le paramètre « add_final_space » qui peut prendre les valeurs « true » ou « false » et qui est à « true » par défaut. Ce paramètre contrôle l'ajout ou non d'une espace de séparation après le dernier mot-clé dans la mini-popup d'édition des mots-clés. En passant ce paramètre à « false » cette espace supplémentaire n'est pas ajoutée.
- Sécurisation du nombre de demandes simultanées d'accès aux mots-clés
Contrairement aux versions précédentes de ce type de script de consultation et d'édition des mots-clés, l'accès aux mots-clés dans ce script est rigoureusement temporisé et unique.
En effet toutes les demandes d'accès (que ce soit pour une consultation ou une édition) suivent le même traitement, elles sont d'abord temporisées pour respecter un délai d'au moins 250 ms depuis la dernière demande, si une nouvelle demande est faite durant cette temporisation, la nouvelle demande annule la demande en attente et réinitialise la temporisation pour respecter un nouveau délai d'au moins 250 ms depuis la dernière demande. Cela permet de n'avoir qu'une demande en cours à la fois et d'avoir toujours au moins un délai de 250 ms entre 2 exécutions de demandes.
Dans les versions précédentes de ce type de script il était possible de lancer quasiment simultanément une grande quantité de demandes de consultation des mots-clés ce qui pouvait générer un ban IP par le forum (voir aussi les points 16 et 16.1 de la FAQ complémentaire).
- Les scripts qui utilisent cette technologie
Les fonctionnalités de consultation et d'édition des mots-clés des smileys persos proposées par ce script sont réutilisées à l'identique dans les scripts « [HFR] Infos rapides mod_r21 » et « [HFR] Vos smileys favoris mod_r21 » (y compris avec les 3 paramètres de configurations et la sécurisation du nombre de demandes simultanées d'accès aux mots-clés) mais en se limitant exclusivement aux smileys gérés respectivement par ces 2 scripts.
Le support pour ce script se fait sur ce topic en précisant les versions du script, du navigateur et de l'extension que vous utilisez ainsi que le problème rencontré.
---------------
☭ ni patrie ni patron | power concedes nothing without a demand | free luigi | des scripts | des stats | y tho | stew is sus ඞ