Modèle:Articles manquants/Documentation

Fonctions

Ce modèle est destiné à créer un tableau triable à partir des pages d'une catégorie (typiquement Portail:TRUC/Articles liés, mais cela peut être n'importe quelle catégorie). Le tableau est inséré entre les modèles {{Articles manquants}} et {{Articles manquants fin}} dans un cadre défilant à la hauteur paramétrable pour faciliter l'inclusion dans un cadre de portail ou de projet.

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

Paramètres

• {{{pageportail}}} : Titre de la page à mettre à jour par le script (obligatoire)
• {{{catégorie}}} : catégorie à checker ( catégorie:Portail:TRUC/Articles liés ) (obligatoire)
• {{{defilant}}} : mettre « non » pour annuler le cadre défilant (facultatif).
• {{{hauteur}}} : hauteur du cadre défilant créé, en pixels (facultatif : 250px par défaut)

Exemples

L'exemple ci-dessous est celui d'un modèle avec comme instructions pour le script de vérifier la catégorie Catégorie:Portail:Colombie/Articles liés, d'extraire les liens rouges de chaque page, puis de créer et d'apposer (ou mettre à jour) deux tableaux triables sur la page Projet:Colombie/Articles à créer. Les tableaux seront insérés entre leurs balises de commentaires respectives.

{{Articles manquants
|pageportail=Projet:Colombie/Articles à créer
|catégorie=Catégorie:Portail:Colombie/Articles liés
|defilant=oui
|hauteur=300
}}
<!-- Ce tableau est créé automatiquement par un robot. Articles Manquants DEBUT -->
<!-- Ce tableau est créé automatiquement par un robot. Articles Manquants FIN -->
{{Articles manquants fin}}
{{Articles manquants
|pageportail=Projet:Colombie/Articles à créer
|catégorie=Catégorie:Portail:Colombie/Articles liés
|defilant=oui
|hauteur=300
}}
<!-- Ce tableau est créé automatiquement par un robot. Pages Rouges DEBUT -->
<!-- Ce tableau est créé automatiquement par un robot. Pages Rouges FIN -->
{{Articles manquants fin}}

Il est tout à fait possible de créer ces tableaux 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 du tableau lors de sa mise à jour. S'il ne les trouve pas, le script ajoutera le tableau et le modèle (pour la mise à jour) au début de la page.

Mise à jour

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 common.js (ou autre suivant l'habillage choisi) .
L'utilisation du script permet l'affichage d'un bouton au-dessus du tableau qui lance le processus de mise à jour :

2. Deux pop-up successives permettent de commander le début de la mise à jour :
   • La première permet de donner une limite basse à la future liste de pages demandées. Par défaut, cette limite est à 10.
   • La deuxième permet de choisir si un deuxième tableau récapitulatif doit être crée. Pour les catégories importantes, il est préférable de ne pas créer ce tableau, la publication de la modification pouvant échouer.
   • À partir de là, le script tourne tout seul, la publication du tableau est automatique. Durant le processus, cliquer à nouveau sur le bouton (qui aura changé d'apparence), provoque l'arrêt du processus et le rechargement de la page.

Pour utiliser le code de mise à jour, ajouter à votre page common.js le code suivant :

obtenir('ArticlesManquants');

Remarques

• Script testé avec Firefox et Google Chrome.
• Script indifférent à l'habillage utilisé

Voir aussi

• {{Utilisateur:OrlodrimBot/Articles manquants}} (version courte, mise à jour par bot)
• {{Articles récents}}
• {{Images utilisées}}
• {{Maintenance de catégorie}}
• {{Vérification évaluation}}
• {{Page au hasard}}