Page mise à jour le 26/02/2017

Retour au billet

{{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 "&lt;a&gt;".

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.