Aide:DynamicPageList

Cette fonctionnalité n'est pas disponible par défaut, mais elle peut être activée sur requête.

DPL, aussi connu sous le nom de l'extension DynamicPageList, est une puissante extension de MediaWiki qui permet de créer des listes de pages en utilisant divers critères comme l'appartenance à une certaine catégorie ou l'inclusion d'un modèle en particulier. Ces listes sont dites dynamiques car elles sont automatiquement mises à jour quand les utilisateurs ajoutent des catégories à des pages.

Si, par exemple, vous souhaitez trouver tous les épisodes de The West Wing écrits par Aaron Sorkin et avec Hal Holbrook en guest star, DPL pourrait vous les trouver en un éclair. Ou si vous devez répondre à la question : « Y a-t-il des civils vulcains à moitié humains dans Star Trek ? » DPL pourrait vous aider à trouver les personnages dans la Catégorie:Vulcains et dans la Catégorie:Semi-humains mais pas dans le Catégorie:Officiers.

Du fait de sa grande puissance, DPL augmente la charge du serveur et peut conduire à une diminution significative du chargement des pages qui l'utilisent. Et comme DPL a de nombreux paramètres et applications, nous ne pouvons pas l'expliquer dans une seule page d'aide. C'est pourquoi Fandom vous encourage vivement à lire certaines sections de cet article : « Utiliser DPL efficacement » et « En savoir plus sur DPL ».

Fandom utilise DynamicPageList3. Vous pouvez trouver la documentation complète ici.

Avantages de DPL[]

DPL est très efficace car un tout petit bout de code peut générer une liste d'informations longue et détaillée qui aurait pris beaucoup de temps à faire manuellement. En voici la liste :

• Crée une liste de pages dynamique basée sur divers paramètres comme les titres de page, les espaces de noms, l'appartenance à une catégorie, l'inclusion d'un modèle et bien plus. Par exemple, vous pouvez créer une page qui liste toutes les pages se trouvant dans deux catégories mais pas dans une troisième.
• Capable d'inclure des informations sur la page comme la date de la dernière modification, le nom d'utilisateur du dernier contributeur et bien plus.
• Capable d'afficher les données sous forme de tableaux, de listes à puces ou de listes numérotées, suivant le style d'une page de catégorie ou en chaîne.
• Permet la création de listes avec des styles personnalisés et de formater des objets placés entre-deux.

Un exemple de page peut être trouvé dans Aide:Index.

Comment inclure DPL sur une page[]

Une requête DPL commence avec la balise <dpl> et se ferme avec la balise </dpl>. Entre ces deux balises, les utilisateurs peuvent ajouter divers paramètres pour personnaliser et adapter la requête à leurs besoins. Vous pouvez aussi utiliser la fonction parser {{#dpl: … }} si vous devez faire développer les fonctions parser dans les paramètres DPL avant que la requête ne soit faite.. Vous devez utiliser l'éditeur « source » pour créer des requêtes DPL, consultez Aide:Mode édition source pour savoir comment y accéder depuis votre éditeur préféré.

Voici un exemple de requête de DPL basique :

<dpl>
    category = Personnages
</dpl>

Cette requête va retourner une liste de toutes les pages se trouvant dans la catégorie « Personnages ».

Cette requête peut être encore plus personnalisée :

<dpl>
    category    = Personnages
    notcategory = Personnages de la saison 1
    namespace   = Personnage
    mode        = ordered
</dpl>

Cette requête va retourner toutes les pages se trouvant dans l'espace de noms « Personnage » et qui se trouvent dans la catégorie « Personnages » à condition qu'elles ne se trouvent pas aussi dans la catégorie « Personnages de la saison 1 ». Cette liste sera également imprimée comme une liste numérotée (<ol>) au lieu d'une liste à puces (<ul>) par défaut.

Une liste complète de tous les paramètres pour DPL est disponible ici et des informations supplémentaires à propos de l'extension se trouvent sur MediaWiki.org.

Utiliser DPL efficacement[]

DPL peut alourdir la charge du serveur, ralentissant le site tout entier. Cette section apporte quelques conseils pour éviter le problème.

Premièrement, demandez-vous si l'utilisation de DPL est réellement nécessaire. Si vous voulez juste une liste des membres d'une catégorie, un lien vers la page de la catégorie fera l'affaire. Si vous souhaitez l'utiliser simplement parce que c'est « cool », vous devriez être en mesure de trouver une autre solution tout aussi cool, comme une vidéo, etc.

Deuxièmement, si vous décidez que DPL est le meilleur outil pour ce que vous souhaitez faire, autorisez la mise en cache des résultats ! Pour cela, ajoutez la ligne suivante à votre requête DPL :

allowcachedresults = true

(Note : en raison de la charge excessive au niveau du serveur, cette option est toujours réglée sur vrai, indépendamment de la valeur définie par l'utilisateur. Afin de mettre à jour le cache pour voir les nouveaux résultats, vous devrez purger le cache de la page).

Autres outils[]

Créer des listes simples d'une catégorie

Pour créer des listes simples d'une catégorie, vous pouvez utiliser la balise <categorytree> (documentation). Par exemple, pour obtenir une liste des pages de la catégorie « Communauté », utilisez le code suivant :

<categorytree mode="pages" hideroot="on">Communauté</categorytree>

Contenu aléatoire

Utilisez RandomSelection.

Listes d'utilisateurs

Utilisez Spécial:Liste des utilisateurs pour cela.

Liste des sous-pages

Utilisez Spécial:Index. Par exemple, pour générer une liste à puces des sous-pages de Aide:Infoboxes, vous pouvez utiliser {{Spécial:Index|prefix=Aide:Infoboxes/|stripprefix=1}}, qui correspond aux pages avec le préfixe « Aide:Infoboxes/ ».

Liste des pages de l'espace de noms

Utilisez Spécial:Index. Par exemple, pour lister toutes les pages de l'espace de noms « Aide », utilisez {{Spécial:Index|prefix=Aide:|stripprefix=1}} ou {{Spécial:Index|stripprefix=1|namespace=12}}. Le paramètre hideredirects=1 peut être utilisé pour supprimer les redirections du résultat (qui sont par ailleurs en italique), tandis que stripprefix=1 supprime le préfixe ou le nom de l'espace de noms du résultat, et namespace restreint le résultat à un identifiant d'espace de noms spécifique (IDs d'espace de noms).

Forums de type wiki

Consultez Aide:Forums de type wiki pour la syntaxe <forum>…</forum>. Ce système utilise DPL en coulisses, mais avec des fonctionnalités adaptées à la création d'un système de forum basé sur des pages wiki.

Utilisations avancées

Pour des utilisations plus avancées, veuillez vérifier s'il n'existe pas une extension spécialisée avant d'utiliser DPL. Par exemple, au lieu de créer un calendrier avec DPL. Si vous n'êtes pas sûr ou ne voyez aucune extension qui correspond à vos besoins, contactez un Représentant de Wiki sur Discussions, nous serons ravie de vous aider.

Choses à éviter[]

Merci d'éviter excessivement :

• des fonctions utilisant « randomcount » ; - elles ne peuvent pas être mises en cache
• des modèles qui sont utilisés sur tout le site ; cela crée des appels de DPL cachés sur toute la communauté
• pour de longues requêtes ; n'affichez pas 500 résultats si 20 suffisent
• plus d'une ou deux requêtes par page

Il est parfois nécessaire de purger le cache[]

Si vous voyez que DPL retourne quelque chose d'étrange ou non à jour, essayez de d'ajouter ?action=purge (ou &action=purge, si ? est déjà utilisé) à la fin de votre URL et rechargez l'URL. Cela forcera le cache du serveur à se vider pour la page.

Utilisations courantes de DPL[]

Galeries[]

DPL peut être utilisé pour créer des galeries qui se maintiennent d'elles-mêmes :

<dpl>
    namespace          = Fichier
    category           = NomDeCatégorieIci
    format             = <gallery widths="150" spacing="small">,%PAGE%\n,,</gallery>
    allowcachedresults = true
</dpl>

Si vous utilisez la version fonction parseur de DPL, vous devez utiliser ce correctif pour générer des galeries.

Travail en attente[]

DPL peut être utilisé pour créer une liste de choses qui ont besoin d'être modifiées :

<dpl>
    category           = Ébauches
    format             = ,#%PAGE%\n,,
    allowcachedresults = true
</dpl>

DPL peut être utilisé pour créer une liste d'images qui ont besoin de catégories :

<dpl>
    namespace          = Fichier
    notcategory        = Saison 1
    notcategory        = Saison 2
    notcategory        = Saison 3
    notcategory        = Saison 4
    format             = <gallery widths="150" spacing="small">,%PAGE%\n,,</gallery>
    allowcachedresults = true
</dpl>

Notes[]

• Fandom ne soutient pas l'utilisation de fonctionnalités basées sur le nombre de vues d'une page.
• Le cache DPL et le cache du serveur de la page doivent être mis à jour pour que les changements soient pris en compte.
• Il y a une limite de 500 articles qui peuvent être affichés par DPL. Au-delà, il faut définir le paramètre « offset ».

En savoir plus sur DPL[]

• Le manuel DPL 3 sur Fandom.
• FAQ sur la conversion des anciennes fonctions DPL vers l'UCP
• Le manuel pour la version utilisée par Fandom avant l'UCP
• L'archive du manuel DPL
• La page d'aide originale de Memory Alpha, qui inclut de nombreux exemples d'utilisation du DPL sur Fandom.

Plus d'aide

• Parcourez et recherchez d'autres pages d'aide sur Aide:Contenu
• Visitez le Centre des communautés pour plus d'aide
• Consultez Aide:Contacter Fandom pour savoir comment signaler des erreurs ou des points à éclaircir sur cet article