Projet:Scripts et gadgets/Notices/HotCatsMulti

PROJET SCRIPTS ET GADGETS
Centraliser les fonctions JavaScript, Vue et CSS pour éviter la dispersion du code.

HotCatsMulti est un code javaScript permettant de modifier les catégories d'une page de façon automatisée.

Remarque : Ce script ne s'active pas dans les pages de discussion.

Installation

Wikipédia en français

Autre site utilisant MediaWiki

Fonctionnement

Ce gadget ajoute au chargement de la page différents liens dans la barre de catégories :

Lors de la modification ou l'ajout d'une catégorie, une liste de suggestions de catégories existantes est fournie.

Mode « Normal »

Aperçu de la barre de catégories modifiée en mode « Normal » :

Modification de la clef de tri par défaut

Le lien (D) permet de modifier la clef de tri par défaut. Un clic sur le lien fait apparaître un formulaire comprenant un champ de saisie ainsi que deux boutons OK et Annuler. Un clic sur OK lance l'édition. Un clic sur Annuler ferme le formulaire.

Retrait de catégorie

Les liens (–) permettent de supprimer une catégorie. Une pop-up de confirmation permet d'éviter un clic intempestif. Si confirmé, l'édition se lance et supprime la catégorie.

Modification de catégorie

Les liens (±) permettent de modifier une catégorie. Un clic sur le lien fait apparaître un formulaire comprenant un champ de saisie ainsi que deux boutons OK et Annuler. Durant la frappe, une liste de catégories existantes est suggérée. Un clic sur OK lance l'édition. Un clic sur Annuler ferme le formulaire.

Ajout de catégorie

Le lien (+) permet d'ajouter une catégorie. Un clic sur le lien fait apparaître un formulaire comprenant un champ de saisie ainsi que deux boutons OK et Annuler. Durant la frappe, une liste de catégories existantes est suggérée. Un clic sur OK lance l'édition. Un clic sur Annuler ferme le formulaire.

Catégories-filles et Catégories-mères

Les formulaires créés par les liens (±) et (+) permettent de suggérer les catégories-mères (c'est-à-dire la ou les catégories où est incluse la catégorie inscrite dans le champ de texte) ou les catégories-filles (c'est-à-dire la ou les catégories incluses dans la catégorie inscrite dans le champ de texte), via les boutons ↑ et ↓.

Il est ainsi possible de naviguer dans l'arborescence pour trouver la catégorie souhaitée.

Mode « Multi »

Aperçu de la barre de catégories en mode « Multi », avec les options par défaut :

Le mode « Multi », accessible via le lien (±) situé juste derrière le premier lien « Catégories », permet en une seule opération d'ajouter, modifier ou supprimer une ou plusieurs catégories. Un clic sur le lien ouvre un formulaire composé de deux boutons : Valider (inactif tant qu'aucun changement n'est programmé) et Annuler.

Les autres liens (D), (–), (±) et (+) fonctionnent comme durant le mode « Normal », à ceci près qu'un clic sur OK ne lance pas l'édition mais « mémorise » le changement demandé. Ces changements sont symbolisés par la couleur que prend le lien de la catégorie :

Un clic sur Annuler annule les changements opérés et rétablit la barre en mode « Normal ».

Il est possible d'annuler un changement sans tout annuler : pour une catégorie déjà présente, il suffit de cliquer sur son lien (±) puis sur OK sans modifier le champ (il prend toujours par défaut la catégorie d'origine, même si elle a été modifiée), pour une catégorie ajoutée, il suffit de la supprimer avec son lien (–).

Si aucun changement n'est programmé, ou si tous les changements effectués sont annulés, le bouton Valider est inactif. Une fois les changements souhaités effectués, un clic sur Valider lance une pop-up de confirmation puis l'édition de la page.

En plus de ces nouveaux boutons, le mode « Multi » fournit deux séries de trois boutons radio à cocher. La sélection initiale de ces boutons dépend des paramètres (personnalisables).

Personnalisation

Deux fonctions hotcat_SiteCustom() et hotcat_UserCustom() sont définies pour permettre la personnalisation des différentes variables personnalisables.

Une autre fonction personnalisable, hotcat_EditCustom(), obligatoirement insérée dans une page appelée MediaWiki:Gadget-HotCatsMultiCustomEdit.js, est appelée juste avant l'édition pour contourner certains problèmes dus au wiki local.

Liste des variables personnalisables

Les variables suivantes sont personnalisables au sein des fonctions hotcat_LangCustom(), hotcat_SiteCustom() et/ou hotcat_UserCustom(). Pour les paramètres, le type est indiqué entre parenthèses : texte, nombre entier ou booléen (true ou false).

Les textes sont à entourer d'apostrophes ou de guillemets. Dans le cas où une apostrophe ou un guillemet est présent dans le texte, il doit être « échappé », c'est-à-dire précédé d'un anti-slash (alt gr + 8), sauf à alterner apostrophes et guillemets (à éviter car potentiellement source d'erreurs).
Exemples :

MaVariable = "Mon \"super\" texte";
MaVariable = 'Mon \'super\' texte';
MaVariable = 'Mon "super" texte';
MaVariable = "Mon 'super' texte";
MaVariable = "Mon "super" texte";
MaVariable = 'Mon 'super' texte';

Ces variables doivent être déclarées sans le mot-clef var.

Légende
Paramètres
Textes

Exemples

Personnalisation globale sur un autre site (en anglais)

// Personnalisation locale
window.hotcat_SiteCustom = function(){ 
     hotcat_docURL =  "http://www.MySite.com/wiki/Help:HotCatsMulti";
     hotcat_text_ResumeScript = "[[Help:HotCatsMulti|HotCatsMulti]] : ";
     hotcat_HiddenCatsLinkID = "hiddencats-link";
     hotcat_CaseSensitive = true;
     hotcat_TagGroup = "user";
     hotcat_text_HotCatTag = "HotCats";

     hotcat_list_size = 5;
     hotcat_list_items = 50;
     hotcat_autocommit = true;
     hotcat_list_down = true;
     hotcat_SkipRecap = true;
     hotcat_exists_yes = "http://upload.wikimedia.org/wikipedia/commons/a/a7/Icon_yes.png"; 
     hotcat_exists_no = "http://upload.wikimedia.org/wikipedia/commons/d/d1/Icon_no.png"; 
}

// Import du gadget
mw.loader.load('//fr.wikipedia.org/w/index.php?title=Mediawiki:Gadget-HotCatsMulti.js&action=raw&ctype=text/javascript');

Personnalisation individuelle

window.hotcat_UserCustom = function(){ 
     hotcat_suggestion_delay = 500;
     hotcat_list_size = 5;
     hotcat_list_items = 50;
     hotcat_autocommit = true;
     hotcat_list_down = true;
     hotcat_Minoredit = 1;
     hotcat_Watchthis = 1;
     hotcat_AutoMulti = true;
     hotcat_SkipRecap = true;
     hotcat_exists_yes = "http://upload.wikimedia.org/wikipedia/commons/a/a7/Icon_yes.png"; 
     hotcat_exists_no = "http://upload.wikimedia.org/wikipedia/commons/d/d1/Icon_no.png"; 
}

Traduction

Les textes du gadget peuvent faire l'objet d'une traduction.

Pour cela, il est nécessaire de créer une page de la forme MediaWiki:Gadget-HotCatsMulti.js/i18n/XX.js, où XX est le code de la langue souhaitée (exemple : MediaWiki:Gadget-HotCatsMulti.js/i18n/en.js).

Si vous souhaitez une traduction dans une langue qui n'est pas encore couverte, demandez à un administrateur de créer une telle page sur WP:DIMS en fournissant le code adéquat sur un brouillon.

Si vous souhaitez corriger une traduction existante, demander à un administrateur de le faire sur la page WP:DIMS.

Traductions existantes

Discussions

Notes

  1. ↑ Sur la Wikipedia en français, cette fonction peut être utilisée pour supprimer l'exemple de catégorie insérée dans des commentaires HTML sur les images et qui peut induire le programme en erreur (voir ici)

Boîte Utilisateur

{{{img-alt}}}

Bonjour. Si vous utilisez Hotcat, vous pouvez copier dans votre page personnelle cette boite utilisateur avec la syntaxe suivante : {{Utilisateur Wikipedia/Hotcat}} --Tangopaso (discuter) 7 mars 2017 à 16:58 (CET)

Autres sites utilisant ce gadget

  1. Wikisource en breton