Page mise à jour le 26/02/2017
- Les marqueurs de template,
- Les classes CSS utilisées.
{{tpl:PaginationLinks}}
Paramètres :
mrvbPagination enrichit l'usage du marqueur de template {{tpl:PaginationLinks}} proposé par advancedPagination grâce à l'ajout de paramètres optionnels :
- jump : nombre de pages composant le groupe de liens
= "7" par défaut - before : texte cliquable pour aller au groupe précédent
= "<" par défaut - after : texte cliquable pour aller au groupe suivant
= ">" par défaut - etc : contient le texte séparant le groupe actuel de la première et de la dernière page
= "..." par défaut - margin : texte placé à gauche et à droite de chaque n° de page
= "" (vide) par défaut - margin-left : texte placé à gauche de chaque n° de page
= "" (vide) par défaut - margin-right : texte placé à à droite de chaque n° de page
= "" (vide) par défaut
Remarques :
- Il est préférable d'affecter un nombre entier impair à "jump" afin d'avoir une symétrie d'affichage de part et d'autre du n° de page courante.
- "margin" ne sera pris en compte que si "margin-left" et "margin-right" ne sont pas renseignés (c'est à dire vides)
- Tous les caractères spéciaux contenus dans "before", "after", "etc", "margin", "margin-left" et "margin-right" seront automatiquement convertis. Par exemple "<a>" deviendra "<a>".
Mise en œuvre :
Il suffit de remplacer l'intégralité du bloc
<tpl:Pagination> (...) </tpl:Pagination>
par
<tpl:Pagination> {{tpl:PaginationLinks}} </tpl:Pagination>
dans tous les fichiers du thème qui peuvent afficher une liste paginée de billets comme :
- category.html,
- home.html,
- search.html
- tag.html.
- ...
(La liste exacte des fichiers concernés dépend du thème choisi.)
Par défaut :
{{tpl:PaginationLinks}}
équivaut à
{{tpl:PaginationLinks jump="7" before="<" after=">" etc="..."}}
qui peut être personnalisé (c'est un exemple à adapter à vos souhaits) en
{{tpl:PaginationLinks jump="9" before="<<" after=">>" etc="==" margin-left="[" margin-right="]"}}
Autres marqueurs de template :
- IfFirstPage
affiche ce qui est placé entre <tpl:IfFirstPage> et </tpl:IfFirstPage> seulement dans le contexte d'une première page, - IfLastPage
affiche ce qui est placé entre <tpl:IfLastPage> et </tpl:IfLastPage> seulement dans le contexte d'une dernière page, - IfMoreOnePage
affiche ce qui est placé entre <tpl:IfMoreOnePage> et </tpl:IfMoreOnePage> seulement s'il y a plus d'une page. - IfOnlyOnePage
affiche ce qui est placé entre <tpl:IfOnlyOnePage> et </tpl:IfOnlyOnePage> seulement s'il y a une seule page. - IfOtherPage
affiche ce qui est placé entre <tpl:IfOtherPage> et </tpl:IfOtherPage> seulement dans le contexte d'une autre page que la première ou la dernière. - LastPageRank
{{tpl:LastPageRank}} retourne le rang de la dernière page. - NumberOfEntries
{{tpl:NumberOfEntries}} retourne le nombre d'entrées concernées. - PageAfterURL
{{tpl:PageAfterURL}} retourne l'URL de la page qui suit la page courante. Si la page courante est la dernière, alors retourne son URL. - PageBeforeURL
{{tpl:PageBeforeURL}} retourne l'URL de la page qui précéde la page courante. Si la page courante est la première, alors retourne son URL. - ThisPageRank
{{tpl:ThisPageRank}} retourne le rang de la page courante.
Remarques :
- ces marqueurs ne sont fonctionnels et pertinents que s'ils sont utilisés dans une boucle <tpl:Entries>.
- IfFirstPage, IfLastPage n'affichent quelque chose que s'il y a au moins deux pages.
- IfOtherPage n'affiche quelque chose que s'il y a au moins trois pages.