Modèle:Maintenance de catégorie

 Documentation[voir] [modifier] [historique] [purger]

Fonctions modifier

Ce modèle est destiné à créer un tableau triable avec les pages d'une catégorie. Le tableau est inséré entre les modèles {{Maintenance de catégorie}} et {{Maintenance de catégorie fin}} dans un cadre qui peut être défilant et à la hauteur paramétrable pour faciliter l'inclusion dans un cadre de portail, de projet, ou dans l'entête d'une catégorie.

Un code javascript permet de mettre à jour le tableau de façon automatisée.

Informations récoltées pour chaque page de la catégorie ciblée :

  • Présence ou non d'un bandeau d'ébauche
  • Liste des éventuels bandeaux d'avertissement
  • Liste des bandeaux de portail
  • Présence ou non d'un bandeau de portail particulier (dans ce cas le nom du portail est écrit en gras)
  • Nombre d'images utilisées
  • Nombre de liens rouges
  • Nombre de catégories
  • Nombre de liens inter-langues
  • Nombre de liens inter-projets

Paramètres modifier

  • {{{page}}} : Titre de la page à mettre à jour par le script (obligatoire)
  • {{{catégorie}}} : catégorie à analyser ( catégorie:TRUC ) (obligatoire)
  • {{{portail}}} : Portail dont le script doit vérifier la présence du bandeau, sans l'espace de noms, les espaces remplacés par des underscore (facultatif[1])
  • {{{défilant}}} : mettre « non » pour annuler le cadre défilant (facultatif).
  • {{{hauteur}}} : hauteur du cadre défilant créé, en pixels (facultatif : 250px par défaut)
  1. Si ce paramètre est vide, tous les portails seront écrits en gras, sinon seul le portail correspondant au paramètre sera écrit en gras

Exemple modifier

L'exemple ci-dessous est celui d'un modèle avec comme instruction pour le script de vérifier la catégorie Catégorie:Article potentiellement de qualité, de vérifier chaque page et d'en extraire les informations recherchées, puis d'apposer (ou mettre à jour) sur la page : Modèle:Maintenance de catégorie/Exemple le tableau triable dans un cadre défilant de 250 pixels de hauteur et un tableau récapitulatif au-dessus.

<!-- Ce tableau est créé automatiquement par un robot. Maintenance de catégorie Statistiques DEBUT -->
<!-- Ce tableau est créé automatiquement par un robot. Maintenance de catégorie Statistiques FIN -->
{{Maintenance de catégorie
|page=Modèle:Maintenance de catégorie/Exemple
|catégorie=Catégorie:Article potentiellement de qualité
|portail=
|défilant=oui
|hauteur=250
}}
<!-- Ce tableau est créé automatiquement par un robot. Maintenance de catégorie DEBUT -->
<!-- Ce tableau est créé automatiquement par un robot. Maintenance de catégorie FIN -->
{{Maintenance de catégorie fin}}

Il est tout à fait possible de créer un tableau de la sorte sans forcément ajouter le modèle (et le cadre défilant qui va avec) dans la page à modifier, mais il reste nécessaire d'ajouter le modèle correctement paramétré sur une page quelconque pour avoir accès au lien de mise à jour. En d'autres termes, le modèle et le tableau créé sont parfaitement dissociables.

Par contre, les commentaires sont importants car ce sont eux que le script recherche pour détecter le début et la fin des tableaux lors de leur mise à jour. S'il ne les trouve pas, le script ajoutera le modèle, et les tableaux au début de la page.

Rendu modifier

Pages sans bandeau d'ébauche ██████████100 %
Pages sans bandeaux d'avertissement ██████████100 %
Pages avec bandeau de portail ██████████100 %
Pages avec images ██████████100 %
Pages sans liens rouges ██████████38 %
Pages avec catégories ██████████100 %
Pages avec liens inter-langues ██████████100 %
Pages avec liens inter-projets ██████████62 %
██████████100 %
Catégorie:Article potentiellement de qualité
Catégorie : Article potentiellement de qualité - 13 pages - Tableau mis à jour le 11/11/2014 à 16:25
Page Ébauche Bandeaux d'avertissement Bandeaux de portail Images Liens rouges Catégories Inter-langues Inter-projets Références
American curl non 12 0 1 22 1 35
Éclaireurs de la Garde impériale non 14 6 4 4 0 53
Enceinte gallo-romaine de Tours non 24 0 4 2 1 117
La Horde sauvage (film, 1969) non 20 1 12 24 2 264
Invasion anglo-russe de la Hollande non 11 0 5 6 0 94
Kabylie non 61 4 1 33 2 309
Livres de Samuel non 6 4 2 39 0 73
Max Mosley non 20 6 7 23 1 258
Mystères d'Osiris non 65 1 2 4 0 215
Mythologie bretonne non 25 1 1 7 1 353
Union sportive quevillaise non 7 4 1 16 0 119
Requin balestrine non 6 0 3 20 2 31
Requin gris de récif non 10 0 3 29 3 33

Mise à jour modifier

La mise à jour se fait à l'aide d'un code javascript dont le fonctionnement s'apparente à celui d'un bot. Il est à copier dans sa page monobook.js (ou autre suivant l'habillage choisi) .
L'utilisation du script permet l'affichage d'un lien au-dessus du tableau qui lance le processus de mise à jour :

  1. Un "tableau de bord" apparaît et deux pop-up successives permettent de commander le début de la mise à jour :
    • La première permet de choisir le renouvellement automatique du processus. Cliquer OK pour lancer en mode automatique, annuler pour une mise à jour simple (dans ce cas, une pop-up de confirmation apparaît avant la sauvegarde).
    • La deuxième récapitule les paramètres du futur tableau. Il est possible d'annuler ou de poursuivre. Après cela, le script fonctionne tout seul sans interruption jusqu'à la publication
  2. Requête ajax de la catégorie cible (renouvelée autant de fois qu'il y a de pages) pour créer une liste de toutes les pages.
  3. Requête ajax de chaque page, récolte des informations et création de la future rangée du tableau final.
  4. Lancement de l'édition de la page, création du tableau triable, mise à jour entre les balises de commentaire
    • Si mode "manuel" : pop-up de confirmation puis publication.
    • Si mode "auto" : publication puis renouvellement de l'étape 2.

Remarques modifier

  • À tout moment, un gros bouton rouge permet de recharger la page et ainsi d'arrêter le processus.
  • Lors de l'analyse de la catégorie, s'il y a plusieurs pages à analyser, il peut arriver que le navigateur détecte un script qui ne répond plus, il faut alors lui préciser de le laisser continuer.
  • Script testé avec Firefox uniquement.
  • Script indifférent à l'habillage utilisé

Voir aussi modifier

/*

Code JavaScript modifier

  • Licence : Domaine public
  • Pour installer, ajouter la ligne suivante dans votre /common.js :
obtenir('MaintenanceCategorie');