Pagination WordPress : comment résoudre les problèmes

Pour résoudre un problème de pagination WordPress, vérifiez d’abord le nombre d’articles affichés par page et enregistrez à nouveau vos permaliens. Si les liens restent absents, affichent une erreur ou répètent les mêmes articles, examinez le thème, les extensions et le code qui génère la liste.

Reconnaître un problème de pagination WordPress

La pagination répartit une liste d’articles sur plusieurs pages. Elle permet par exemple de passer de la première page du blog aux suivantes grâce à des numéros ou à des liens « Précédent » et « Suivant ». Elle peut être intégrée au thème, ajoutée par une extension ou créée avec du code personnalisé.

Plusieurs signes peuvent indiquer un problème :

• les liens de pagination ne s’affichent pas alors que la liste comporte assez d’articles ;
• la page suivante renvoie une erreur 404 ;
• chaque page affiche les mêmes articles ;
• les liens apparaissent, mais leur présentation ou leur destination est incorrecte.

Le nombre d’articles par page peut aussi rendre la navigation moins pratique. Une liste très longue peut ralentir son chargement, tandis qu’un nombre trop faible oblige les visiteurs à parcourir davantage de pages.

Si d’autres liens du site sont également touchés, consultez notre guide sur les problèmes de liens de navigation WordPress.

Vérifier les réglages de lecture et les permaliens

Avant de modifier le thème ou d’installer une extension, contrôlez les réglages généraux de WordPress :

1. Dans l’administration, ouvrez Réglages > Lecture.
2. Vérifiez la valeur du champ Les pages du site doivent afficher au plus. Elle détermine le nombre d’articles affichés par page dans les listes concernées.
3. Modifiez ce nombre si nécessaire, puis enregistrez les changements.
4. Ouvrez Réglages > Permaliens, puis cliquez sur Enregistrer les modifications, même si vous ne changez pas la structure.
5. Retournez sur le blog et testez les liens vers la première page et les pages suivantes.

Une pagination peut ne pas apparaître si le nombre total d’articles publiés ne dépasse pas la limite définie. À l’inverse, un thème ou une liste personnalisée peut utiliser ses propres réglages et ne pas suivre cette valeur générale.

Après chaque changement, vérifiez aussi que les articles affichés diffèrent d’une page à l’autre. Si le problème persiste, un dépannage de votre site WordPress peut permettre d’en rechercher la cause.

Tester le thème et les extensions

Le thème est souvent responsable de l’affichage des liens de pagination. Une extension peut également modifier les listes d’articles ou entrer en conflit avec le thème.

Avant les tests, effectuez une sauvegarde et, si possible, travaillez sur une copie du site. Certains changements peuvent modifier temporairement l’apparence ou les fonctionnalités du site en ligne.

1. Notez le comportement exact : liens absents, erreur 404, articles répétés ou autre affichage incorrect.
2. Désactivez temporairement les extensions susceptibles de modifier les listes ou la pagination, puis testez à nouveau.
3. Si le problème disparaît, réactivez les extensions une par une en testant après chaque activation.
4. Si nécessaire, activez temporairement un thème WordPress par défaut et vérifiez la pagination.
5. Rétablissez le thème et les extensions après vos essais, puis examinez le composant identifié.

Ces vérifications aident à distinguer un défaut du thème d’un conflit entre extensions WordPress. Si le thème ne prend pas correctement en charge la pagination de la liste concernée, il peut être nécessaire de le modifier ou d’en choisir un autre.

Ajouter ou adapter la pagination avec une extension

Une extension peut ajouter des liens de pagination ou permettre d’en personnaliser l’apparence et le comportement. L’article d’origine citait notamment WP-PageNavi et WP-Paginate. Leur utilisation dépend toutefois du thème et de la liste d’articles que vous souhaitez modifier.

Pour essayer cette solution :

1. Dans Extensions > Ajouter, recherchez l’extension choisie.
2. Consultez ses instructions et vérifiez qu’elle convient à votre installation.
3. Installez-la et activez-la, puis examinez ses réglages.
4. Testez la pagination sur les différentes pages de la liste.

Certaines extensions ou certains thèmes peuvent nécessiter une modification des fichiers du thème pour afficher les liens. Installer une extension ne corrigera donc pas nécessairement une erreur présente dans une requête personnalisée.

Les liens vers l’article précédent ou suivant servent aussi à la navigation, mais ils ne remplacent pas la pagination d’une liste d’articles. De même, un fil d’Ariane peut aider les visiteurs à se repérer sans corriger une pagination défaillante.

Vérifier le code personnalisé et l’affichage des liens

Si votre thème utilise une liste d’articles personnalisée, vérifiez le code qui construit la requête et celui qui affiche les liens de pagination. Une erreur de syntaxe, une mauvaise prise en compte de la page demandée ou une incompatibilité avec le thème peut provoquer des pages identiques ou des liens incorrects.

Le fichier functions.php du thème peut contenir des réglages ou des fonctions liés à la pagination. Examinez également le modèle qui affiche la liste concernée. Avant toute modification, sauvegardez les fichiers et privilégiez un thème enfant pour ne pas perdre vos changements lors d’une mise à jour du thème.

Testez ensuite la première page, plusieurs pages suivantes et le retour à la page précédente. Si le code produit une erreur ou si vous ne savez pas quelle fonction modifier, évitez de procéder directement sur le site en production. Notre guide sur la personnalisation d’un thème WordPress présente d’autres points à vérifier.

Masquer la pagination avec du CSS

Le code suivant masque un élément nav ayant la classe pagination :

nav.pagination {
  display: none;
}

Il ne répare pas la pagination et peut empêcher les visiteurs d’accéder aux pages suivantes depuis la liste. Son effet dépend aussi des classes utilisées par le thème. Utilisez-le seulement si vous souhaitez masquer ces liens et qu’un autre moyen de navigation est disponible.

Questions fréquentes

Article rédigé avec l’aide d’une IA à partir des sources citées et de notre pratique de la maintenance WordPress. Notre méthode éditoriale.