Projet:Scripts et gadgets/Notices/CatRename

PROJET SCRIPTS ET GADGETS

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

CatRename est un gadget permettant de renommer automatiquement une catégorie, c'est-à-dire :

de modifier toutes les pages et sous-catégories incluses dans la catégorie ;
de déplacer la page de la catégorie vers le nouveau nom (pour garder le crédit des auteurs) ; ce renommage peut se faire sans créer de redirection (droit réservé aux bots et aux administrateurs) ;
de demander la suppression immédiate de l'ancienne catégorie (non-administrateurs) si une redirection a été créée.

Le comportement du script est celui d'un bot, quasi-automatique, fonctionnant grâce à des requêtes Ajax. De ce fait, ses capacités sont bridées lorsqu'il est utilisé avec un compte non-bot. Ce script fonctionne correctement sous les habillages vector, timeless et monobook (notamment). Il remplace complètement depuis avril 2018 l'ancien script RenommageCatégorie.

Installation

Sur Wikipédia en français

Pour bénéficier de ce gadget, allez dans l'onglet gadgets (paragraphe « Maintenance ») de vos préférences et cochez la case à coté de CatRename.

Sur un autre wiki

Cette section est vide, insuffisamment détaillée ou incomplète. Votre aide est la bienvenue ! Comment faire ?

Fonctionnement

0. Onglet

Dans toute page de l'espace de noms Catégorie:, un lien CatRename est ajoutée permettant de lancer le processus. Il se situe :

dans le menu déroulant de l'onglet Plus sous vector ;
dans le menu latéral Outils de page sous timeless ;
directement dans la barre des onglets sous monobook.

1. Paramètrage

Un clic sur ce lien provoque l'apparition d'une « pop-up », permettant de paramétrer le renommage :

Indiquez le nouveau nom de la catégorie dans le premier champ de texte (obligatoire) ;
Précisez la raison de ce changement dans le second (obligatoire).

En complément, vous pouvez configurer les options suivantes :

une case à cocher pour demander s'il sera nécessaire de confirmer avant chaque publication ;
une case à cocher pour demander s'il sera nécessaire de suivre les pages modifiées.

2. Modes d'édition

Une fois le renommage paramétré, deux options s'offrent à vous :

Lancer directement le renommage avec votre compte utilisateur, grâce au bouton bleu Renommer en haut à droite (conseillé pour de petites catégories) :
- le gadget effectuera à la fois le renommage de la catégorie et le déplacement de chaque page ; cette méthode est soumise à certaines limitations (voir section suivante) et nécessite de garder l'onglet ouvert jusqu'à la fin de l’opération ;
Déléguer l'opération à un bot, au moyen du bouton blanc en bas à gauche (conseillé pour de plus grosses catégories) :
- le gadget s'occupera alors de renommer la catégorie, et fera automatiquement une demande à un bot pour le déplacement des pages incluses dans cette dernière ; cette méthode n'est soumise à aucune limitation
- la demande serra alors ajoutée à Wikipédia:Bot/Requêtes/Catégories, ce qui déclenche la modification de chaque page de la catégorie par un bot dans les heures qui suivent.

3. Limitations

CatRename permet de modifier un grand nombre de pages en très peu de temps, de manière automatique. Pour éviter de surcharger les modifications récentes ou les listes de suivi des autres contributeurs, certaines limitations ont été mises en place. Lorsque vous optez pour la première méthode (cf. ci-dessus), trois bridages sont utilisés :

Temporisation : un délai de cinq secondes est appliqué entre chaque édition ;
Limite journalière : le nombre de modifications est restreint à 250 éditions par période de 24 h pour ce script ;
Séquentielle : si vous lancez des renommages dans plusieurs onglets, ceux-ci se feront successivement, un onglet après l'autre.

Une fois la limite journalière atteinte, il vous est toujours possible de continuer à renommer des catégories, mais au moyen du second mode d'édition.

Note : Si vous utilisez ce gadget depuis un compte bot, aucune de ces limitations ne s'applique et vous pourrez utiliser le gadget à pleine vitesse.