État de la version : stable | |
|---|---|
| Implémentation | Balise,Fonction d'analyseur |
| Description | Affiche une liste à puces des éléments les plus récents de la catégorie ou l'intersection de plusieurs catégories. |
| Auteur(s) | IlyaHaykinson &Amgine |
| Dernière version | Continuous updates |
| Politique de compatibilité | Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière. |
| MediaWiki | 1.23+ |
| PHP | 5.4+ |
| Modifie la base de données | Non |
| Licence | Licence publique générale GNU v2.0 ou supérieur |
| Téléchargement | |
| Exemple |
|
| |
<DynamicPageList> | |
| Traduire l’extension DynamicPageList | |
| Problèmes | Tâches ouvertes ·Signaler un bogue |
L'extensionDynamicPageList permet aux utilisateurs du wiki de créer une liste de pages qui sont listées dans un ensemble de catégories.
Il a été initialement développé pourWikinews. Il est actuellement installé sur la plupart des projets Wikinews (voirDynamicPageList), Meta, MediaWiki.org, et quelques autres petits projets.Ilne sera plus installé sur d'autres wikis Wikimedia à cause des problèmes de performance.
Cette extension était précédemment connue sous le nom deDynamicPageList/old et plus tardIntersection. Vous pourriez également être intéressé parDynamicPageList3, qui a plus de fonctionnalités.
intersection dans votre dossierextensions/.cdextensions/gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/intersectionwfLoadExtension('intersection');
L'extension prend également en charge quelques variables de configuration. Normalement, vous ne voudriez pas changer la valeur par défaut, mais si vous le faites, vous pouvez les ajouter à votreLocalSettings.php aprèswfLoadExtension( 'intersection' ). Voici les variables de configuration prises en charge avec leurs valeurs par défaut :
# variables de configuration. Attention: elles utilisent DLP au lieu de DPL# pour des raisons historiques (supposé pour la liste dynamique des pages)$wgDLPmaxCategories=6;// nombre maximum de catégories à chercher$wgDLPMaxResultCount=200;// nombre maximum de résultats autorisés$wgDLPAllowUnlimitedResults=false;// résultats illimités$wgDLPAllowUnlimitedCategories=false;// catégories illimitées// pages en cache en utilisant DPL en secondes. Par défaut 1 jour.// false utilise le quota normal du cache des pages (plus efficace)// 0 désactive le cache (peu efficace mais les résultats sont toujours actuels)$wgDLPMaxCacheTime=60*60*24;// Durée des pages en cache (secondes)
DynamicPageList peut être utilisé avec une syntaxe de type XML dans la vue d'édition de wiki. Les paramètres contrôlent les pages en mode liste, ordre et affichage. Consultez les sections suivantes pour plus d'informations sur chaque paramètre. Par exemple, voici les cinq pages les plus anciennes de ce wiki qui ont été récemment déplacées sur MediaWiki.org.
<DynamicPageList>category = Pages recently transferred from Metacount = 5order = ascendingaddfirstcategorydate = true</DynamicPageList>
Exemple DynamicPageList très complexe :
<DynamicPageList>category=foocount=20namespace=file,mainaddfirstcategorydate=ymdimagewidth=70galleryshowfilesize=yesgalleryshowfilename=yesimagesperrow=7gallerycaption=Galleries!ordermethod=sortkeyorder=ascendingmode=galleryoffset=12</DynamicPageList>
Répertorie les pages de la 12e à 31e de l'espace de noms des fichiers qui sont également dans la catégoriefoo, en les mettant en forme dans une galerie d'images avec la date à laquelle elles ont été ajoutées dans la catégoriefoo dans la légende au format année mois jour, et pour lesquelles les images ont une largeur de 70 pixels
category liste les catégories dont on veut l'intersection. DynamicPageList liste les pages trouvées danschaque catégorie listée. Un nombre minimum et maximum d'entrées à lister est défini dans le code source de l'extension. Vous pouvez utiliser desmots magiques comme {{CURRENTMONTHNAME}} dans le nom de la catégorie.
La syntaxe estcategory =category name
<DynamicPageList>category = Democategory = Demo 1</DynamicPageList>
notcategory restreint la liste des pages à cellesqui ne sont pas dans une catégorie particulière. Vous pouvez utiliser des mots magiques comme {{CURRENTMONTHNAME}} dans le nom de la catégorie.
<DynamicPageList>category = Demonotcategory = Demo 1</DynamicPageList>
namespace restreint la liste des pages spécifiées ci-dessus à celles d'un espace de noms particulier spécifié par son nom ou son numéro (voir laListe des espaces de noms par défaut). Tout nom qui n'est pas valide est équivalent à l'espace de noms de l'article principal.
<DynamicPageList>category = Demonamespace = Help, user, main</DynamicPageList>
redirects détermine s'il faut ou non inclure lespages de redirection.La valeur peut être $1 (par défaut, on ne liste pas les redirections), $2 (les redirections sont listées), ou $3 (ne pas lister les pages qui ne sont pas des redirections).
exclude -default, don't list redirectsinclude -list redirectsonly -don't list pages that aren't redirects<DynamicPageList>category = Demoredirects = only</DynamicPageList>
stablepages détermine s'il faut inclure ou non les pages stables (marquées) lors de l'utilisation deExtension:FlaggedRevisions.La valeur peut être $1 (ne pas lister), $2 (lister les stables et les non stables — c'est la valeur par défaut), ou $3 (lister uniquement les stables). Nécessite l'installation de FlaggedRevs pour fonctionner.
exclude -don't listinclude -list stable and non-stable.defaultonly -only list stable pagesRequires FlaggedRevs to be installed to work.
count restreint le nombre de résultats affichés. Par défaut, les pages ajoutées à la catégorie la plus récente sont affichées (voirorder). Notez que l'extension ne listera pas plus de résultats que le maximum défini dans le code source de l'extension.
<DynamicPageList>category = Democount = 2</DynamicPageList>
offset commence la liste à un endroit différent de la première page de la liste.Par exemple ceci peut être utilisé aveccount pour créer des affichages sur plusieurs colonnes.
<DynamicPageList>category = Demooffset = 2</DynamicPageList>
Démonstration de colonne
<table><tr><thcolspan="3"> recent articles in[[:category:Demo|:category:Demo]]</th></tr><tr><td><DynamicPageList>category = Democount=5</DynamicPageList></td><td><DynamicPageList>category = Demooffset = 5count= 5</DynamicPageList></td><td><DynamicPageList>category = Demooffset = 10count=5</DynamicPageList></td></tr></table>
shownamespace affiche l'espace de noms dans les noms de page.La valeur peut êtretrue (par défault, on affiche l'espace de noms dans le nom :Help:Contents) oufalse (l'espace de noms n'apparaît pas :Contents).
<DynamicPageList>category = Demoshownamespace = false</DynamicPageList>
addfirstcategorydate indique la date à laquelle chaque article a été ajouté à la catégorie. La valeur peut êtretrue (date d'affichage),false (par défaut, ne pas afficher la date) ou un spécificateur de date (ymd, md, dm, dmy, mdy et ISO 8601). Si de nombreuses catégories sont spécifiées, elle utilise la première catégorie. Les noms de pages liées sont précédés de la date formatée selon vos préférences d'affichage de date MediaWiki locales.
<DynamicPageList>category = Demoaddfirstcategorydate = true</DynamicPageList>
mode détermine le format de la liste.La valeur peut être :
<gallery>unordered:<DynamicPageList>category = Demomode = unordered</DynamicPageList>ordered:<DynamicPageList>category = Demomode = ordered</DynamicPageList>none:<DynamicPageList>category = Demomode = none</DynamicPageList>inline:<DynamicPageList>category = Demomode = inline</DynamicPageList>
gallery est un mode spécial où la sortie est une galerie d'images.SiExtension:PageImages est installé, l'image de la page si elle existe, sera utilisée pour les pages qui ne sont pas dans File: .Dans le cas contraire, les pages des espace de noms autres que File: ne seront qu'un espace vide.
<DynamicPageList>category = Demomode = gallerynamespace= file</DynamicPageList>
Le modegallery prend également en charge les options $1 (largeur des images dans la galerie, vous devrez peut-être aussi définir hauteur d'image si vous utilisez cela), $2 (hauteur de l'image), $3 (montrer la taille d'image, comme sur les pages de catégorie), $4 (montrer le nom de fichier sur les pages de catégorie), $5 (nombre d'images par ligne dans la galerie), $6 (légende pour la galerie).
imagewidth -how wide the images should be in gallery, you may need to also setimageheight if using thisimageheight -how high the image should begalleryshowfilesize -show the image size, like on category pagesgalleryshowfilename -show filename like on category pagesimagesperrow -number of images per row in gallerygallerycaption -caption for gallerySi addfirstcategorydate est utilisé, la date est ajoutée à la légende de l'image.
Note, gallerycaption at the moment cannot accept links. (but it can accept things like {{CURRENTMONTHNAME}})
Un exemple complexe de galerie pourrait être :
<DynamicPageList>count=20namespace=fileaddfirstcategorydate=ymdimagewidth=70galleryshowfilesize=yesgalleryshowfilename=yesimagesperrow=7gallerycaption=Look at my pretty gallery.mode=galleryshownamespace=false</DynamicPageList>
suppresserrors masque les erreurs. La valeur peut êtretrue (masquer les erreurs) oufalse (par défaut, afficher les erreurs).
true:<DynamicPageList>category = Demsuppresserrors = true</DynamicPageList>false:<DynamicPageList>category = Demsuppresserrors = false</DynamicPageList>
nofollow définitrel="nofollow" sur les liens.Cela empêche les intrus d'accéder à la page via le lien de la DynamicPageList.En général, cela est inutile, car les intrus pourront soit indexer la page à partir d'autres liens, ou pas du tout à cause de robots.txt/$wgDefaultRobotPolicy.En général, vous ne devez pas utiliser cette option à moins de savoir ce que vous faites et d'avoir une bonne raison.Le principal cas d'utilisation est que sur le Wikinews en anglais, Google News considère tout ce qui est lié depuis la page principale comme un article.
<DynamicPageList>category = Demonofollow = true</DynamicPageList>
C'est un ajout pour Wikinews. Auparavant, Google News considérait uniquement les articles comportant des chiffres comme des articles de presse[1], donc ceci ajoute?dpl_id=<id of article> à la fin des URL de la liste.Vous ne devez pas utiliser cette option à moins d'avoir une bonne raison de le faire (mais cela ne fera rien de mal).Cela remplace l'option showcurid qui n'est plus prise en charge.
<DynamicPageList>category = Demogooglehack = true</DynamicPageList>
ordermethod détermine l'ordre et la date à afficher. La valeur peut être :
categorysortkeyIl faut noter quelastedit trie réellement en fonctions de la dernière fois où la page a été touchée.Dans certains cas, ce n'est pas équivalent à la dernière modification (par exemple, cela inclut les modifications d'autorisation, la création ou la suppression de pages liées et la modification de modèles contenus).Si vous ne spécifiez pas de catégorie, certaines de ces méthodes d'ordre ne fonctionneront pas — en particulier,categoryadd etcategorysortkey se replient surcreated s'il n'y a pas de clausecategory.
<DynamicPageList>category = Demoaddfirstcategorydate = trueordermethod = lastedit</DynamicPageList>
exemple alphabétique :
<DynamicPageList>category = Demoordermethod = sortkey</DynamicPageList>
order indique le sens du tri.La valeur peut êtredescending (par défaut, du plus récent au plus ancien) ouascending (du plus ancien au plus récent).
<DynamicPageList>category = Demoorder = ascending</DynamicPageList>
A utiliser dans un modèle en passant les paramètres, utiliser les fonctions d'analyse, etc., utiliser la fonction{{#tag: :
{{#tag:DynamicPageList|category={{{1}}}count ={{#if:{{{2|}}}| 10| 20}}ordermethod = sortkeyorder = ascending}}
La page de modèle elle-même affiche un message d'erreur, car la valeur de catégorie est vide sur la page de modèle, sauf si vous encadrez le modèle avec des balises<includeonly>. Exemple :
Erreur : vous devez inclure au moins une catégorie ou bien préciser un espace de noms !
| Cette extension est utilisée par au moins un desprojets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans leCommonSettings.php de Wikimédia et dans le fichier de configurationInitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la pageSpecial:Version de ce wiki. |
| Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : |