HUSKY - WooCommerce Product Filter Professional

Pagination du filtre WooCommerce qui ne fonctionne pas : causes et solutions

Une pagination du filtre WooCommerce qui ne fonctionne pas se manifeste en général de l’une de ces façons : des liens de pages qui pointent vers /wp-admin/admin-ajax.php?paged=2, une page blanche avec un simple 0, des pages vides ou une erreur 404 à la fin des résultats filtrés, le filtre oublié sur la page 2, ou un défilement infini qui s’arrête après le premier filtrage. Chaque symptôme a sa propre cause, et la plupart viennent de la façon dont le thème construit sa pagination, non du filtre. Commencez par le tableau, puis passez à la section correspondante.

Ce que vous voyezCause probable
Liens vers admin-ajax.php?paged=2, page blanche avec 0Mode AJAX avec un balisage de pagination non standard
Deux paginations ou deux lignes « Affichage de 1–12 sur 40 résultats » après le filtrageLe thème affiche ses propres éléments en dehors de la zone que HUSKY actualise
Plus de pages que de produits, dernières pages en 404 ou videsNombres de « produits par page » différents dans HUSKY, le thème et le constructeur
Grille vide après un changement de filtre depuis la page 3L’ancien numéro de page est repris dans le nouveau lien de filtre
Filtre inactif ou sans mise en forme après le passage à la page 2La pagination AJAX, le bouton « charger plus » ou le défilement infini propre au thème
Filtre absent sur la page 2, ou page 2 qui affiche des produits non filtrésFiltre placé dans le contenu de la page, ou liens de pagination qui perdent le filtre
Aucune pagination après le filtrageModèle personnalisé ou thème qui affiche la pagination en dehors des hooks de la boucle

Liens vers admin-ajax.php : mode AJAX et balisage du thème

Avec Essayer de passer la boutique en AJAX (Try to ajaxify the shop) réglé sur Oui (Yes) (ou [woof_products is_ajax=1] sur une page), HUSKY ne recharge pas la page. Il demande au serveur de nouveaux produits via admin-ajax.php et remplace le bloc de produits, pagination comprise. Comme cette nouvelle pagination est générée à l’intérieur de la requête AJAX, ses liens pointent vers admin-ajax.php?paged=2. Ils ne sont jamais destinés à être suivis : HUSKY intercepte les clics sur .woocommerce-pagination a.page-numbers, lit le numéro de page et charge cette page en AJAX.

Si le thème modifie le balisage de la pagination (une autre classe sur l’élément englobant, des liens sans la classe page-numbers, sa propre fonction de pagination), le clic n’est pas intercepté et le navigateur ouvre le lien brut. WordPress répond par 0 à une requête vers admin-ajax.php sans action, ce qui donne la page blanche. Le balisage attendu par HUSKY est celui de WooCommerce :

<nav class="woocommerce-pagination">
  <ul class="page-numbers">
    <li><span aria-current="page" class="page-numbers current">1</span></li>
    <li><a class="page-numbers" href="https://example.com/shop/page/2/">2</a></li>
    <li><a class="next page-numbers" href="https://example.com/shop/page/2/">&rarr;</a></li>
  </ul>
</nav>

Inspectez votre pagination dans le navigateur et comparez. Un thème qui remplace woocommerce/loop/pagination.php ou utilise sa propre pagination peut être corrigé dans un thème enfant (une simple faute de frappe comme woocmmerce-pagination dans la classe de l’élément englobant suffit à tout casser), mais la solution fiable ne demande aucun code : passez en mode redirection. Ouvrez les réglages du plugin, onglet Options, réglez Essayer de passer la boutique en AJAX (Try to ajaxify the shop) sur Non (No) et enregistrez ; sur les pages contenant le shortcode, utilisez is_ajax=0. Chaque filtrage recharge alors la page, et la pagination est la pagination normale du thème. On ne peut pas désactiver l’AJAX uniquement pour la pagination. Voir aussi problèmes de pagination en mode AJAX.

Si l’option indique qu’elle a été enregistrée mais revient sur Oui (Yes), le mode Turbo est activé. Le mode Turbo ne fonctionne qu’avec l’AJAX et réactive l’option à chaque chargement de page ; désactivez d’abord le mode Turbo.

Pagination en double ou nombre de résultats qui ne se met pas à jour

Certains thèmes affichent le nombre de résultats, le tri ou la pagination en dehors du bloc que HUSKY remplace. Après un filtrage AJAX, vous voyez alors l’élément obsolète du thème à côté du nouveau, ou un nombre qui décrit encore la boutique non filtrée. Pour le nombre de résultats, saisissez son sélecteur, généralement .woocommerce-result-count, dans Avancé → Options → Sélecteur CSS du nombre de résultats (Advanced → Options → Result count css selector) ; HUSKY le redessine alors après chaque filtrage (Sélecteur CSS de la liste de tri (Order dropdown css selector) fait de même pour le tri). Si des doublons subsistent, le mode redirection les supprime.

Pages en trop et erreur 404 à la fin des résultats

WordPress décide si /page/7/ existe à partir de la requête principale de la page : si la requête principale compte six pages, la page 7 est une 404, quoi que montre la grille de produits de cette page. Les problèmes commencent lorsque la grille visible et la requête principale comptent différemment les produits par page, par exemple un widget de constructeur qui affiche 30 produits par page alors que la requête principale utilise les 12 du thème : la pagination et les numéros de page existants ne concordent plus, et des pages sont vides ou finissent en 404 en cours de route. Le réglage propre à HUSKY, Avancé → Options → Produits par page (Advanced → Options → Products per page), ne s’applique que lorsqu’un filtre est actif (sa valeur par défaut, -1, signifie « ne pas gérer »), un décalage avec lui n’apparaît donc qu’après filtrage.

  1. Repérez tous les endroits qui définissent ce nombre : les réglages du catalogue du thème ou de WooCommerce, le widget de produits du constructeur, et Produits par page (Products per page) de HUSKY.
  2. Définissez le même nombre partout, ou réglez celui de HUSKY sur -1 pour qu’il n’interfère pas.
  3. Testez sans le filtre : désactivez HUSKY un instant et ouvrez directement une page élevée, comme /shop/page/17/. Si c’est une 404 à présent, le décalage se situe entre le thème et le constructeur, et non dans le filtre.

Si le nombre de pages reste trop élevé uniquement pendant le filtrage, le thème calcule probablement la pagination à partir d’une autre requête ; corriger une pagination qui affiche trop de pages propose un code qui impose le total issu de la requête filtrée. Avada a son propre cas, décrit dans Avada : filtre perdu dans la pagination.

Page vide après un changement de filtre sur la page 2 ou suivante

Un visiteur est sur la page 3 et modifie un filtre. Le nouveau résultat tient sur une page : si le nouveau lien demande toujours la page 3, la grille est vide ou la page est une 404. HUSKY l’évite pour la pagination standard : il retire /page/N/ et le paramètre product-page de WooCommerce du lien qu’il construit, et en mode AJAX il revient à la page 1 à chaque changement. Les autres paramètres de page de la chaîne de requête sont copiés dans le nouveau lien avec le reste de l’adresse, par exemple ?paged=3 sur les sites aux permaliens simples ou le paramètre de pagination propre à un constructeur de pages. Utilisez des permaliens lisibles (Réglages → Permaliens (Settings → Permalinks), n’importe quelle structure sauf Simple (Plain)) et la pagination standard de WooCommerce, puis vérifiez l’adresse après un changement de filtre : elle ne doit contenir aucun numéro de page.

Pagination AJAX du thème, « charger plus » et défilement infini

De nombreux thèmes ont leur propre boutique AJAX : pagination, boutons « charger plus », défilement infini, tri AJAX ou bascule grille/liste qui remplacent les produits et la barre latérale sans rechargement. HUSKY initialise son formulaire au chargement de la page (et après son propre rafraîchissement AJAX). Lorsque le thème injecte un nouveau HTML de barre latérale, les nouveaux éléments du filtre ne sont jamais initialisés : le filtre cesse de réagir, perd sa mise en forme ou envoie de mauvaises valeurs. La requête « charger plus » d’un thème construit aussi sa propre requête pour « la page suivante » et ignore le filtre, ce qui explique qu’elle puisse ajouter des produits non filtrés à une liste filtrée.

  • Désactivez la pagination AJAX, la boutique AJAX, le défilement infini et les options « charger plus » du thème, puis testez avec la pagination standard. Cela règle la plupart des cas.
  • Pour le défilement infini, HUSKY prend en charge nativement le plugin gratuit YITH Infinite Scrolling : après chaque filtrage AJAX, il réinitialise le défilement et corrige le lien de la page suivante. Utilisez les sélecteurs indiqués dans défilement infini pour les produits filtrés.
  • Tout autre script qui doit redémarrer après un filtrage AJAX peut écouter l’événement woof_ajax_done, décrit dans l’événement woof_ajax_done. L’appel qui le relance dépend de ce script ; interrogez son auteur.
/*
 * Runs after every HUSKY AJAX filtering.
 * Put it in a JavaScript file of your child theme.
 */
jQuery(document).on('woof_ajax_done', function () {
    // call the init function of your infinite scroll or load-more script here
});

Au lieu d’un fichier du thème, le corps de cette fonction peut être placé dans Avancé → Code → Code JavaScript après la fin de l’AJAX (Advanced → Code → JavaScript code after AJAX is done).

Filtre absent ou oublié sur la page 2

  • Le filtre disparaît sur la page 2. Il a été placé dans le contenu de la page de la boutique ou dans la description d’une catégorie. WooCommerce n’affiche l’un et l’autre que sur la première page d’une archive. Placez le filtre dans un widget de barre latérale, dans une zone du thème présente sur chaque page, ou dans un bloc de constructeur situé en dehors de la description.
  • La page 2 affiche des produits non filtrés. En mode redirection, la pagination standard de WooCommerce conserve le filtre dans ses liens (/shop/page/2/?swoof=1&pa_color=red). Survolez un lien de page : si swoof=1 et les valeurs de votre filtre sont absents, le thème construit ses propres liens sans la chaîne de requête ; passez à la pagination standard ou corrigez la fonction de liens du thème.
  • La page 2 redirige vers la boutique ou perd la catégorie. Les plugins et le code personnalisé qui réécrivent les URL de produits ou les slugs d’archives peuvent entrer en conflit avec les liens du filtre. Testez en les désactivant ; pour un cas connu, voir HUSKY et Permalinks Manager Pro.

Aucune pagination après le filtrage

En mode AJAX, le bloc actualisé contient ce que WooCommerce affiche sur le hook woocommerce_after_shop_loop, et c’est là que se trouve la pagination de WooCommerce. Un thème qui retire la pagination de ce hook et affiche la sienne ailleurs la perd après le premier filtrage AJAX ; le mode redirection évite le problème. Si vous avez créé votre propre modèle d’archive, affichez vous-même la pagination après la boucle de produits :

<?php
// In your WooCommerce archive template (child theme), after the product loop:
woocommerce_pagination();
?>

Un modèle personnalisé a aussi besoin des hooks standard de la boucle de la boutique pour que le mode AJAX fonctionne ; l’URL du filtre change mais les produits ne changent pas explique lesquels.

Pour ramener les visiteurs en haut des produits après un changement de page, consultez le défilement automatique après le filtrage AJAX ou, en mode redirection, le défilement automatique vers les produits en mode redirection.

Liste de vérification lorsque la pagination du filtre WooCommerce ne fonctionne pas

  • Testé en mode redirection (Essayer de passer la boutique en AJAX (Try to ajaxify the shop) = Non (No), mode Turbo désactivé, is_ajax=0 dans les shortcodes) après avoir vidé tous les caches.
  • Le balisage de la pagination est nav.woocommerce-pagination avec des liens a.page-numbers.
  • Le nombre de produits par page est le même dans le thème, le constructeur et HUSKY, ou celui de HUSKY est -1.
  • La pagination AJAX du thème, « charger plus » et le défilement infini sont désactivés, ou réinitialisés sur woof_ajax_done.
  • Les liens de pagination d’une page filtrée contiennent swoof=1 et les valeurs du filtre, et aucun ancien numéro de page ne survit à un changement de filtre.
  • Le filtre se trouve dans une barre latérale ou une zone de modèle, et non dans la description de la boutique ou d’une catégorie.

Si la pagination échoue toujours en mode redirection avec la pagination standard du thème, ouvrez un sujet sur le forum d’assistance HUSKY en indiquant le lien de la page et l’adresse d’une page qui échoue.