Un filtre AJAX WooCommerce casse la grille de produits : causes et solutions
La boutique s’affiche correctement jusqu’au premier clic sur le filtre. Ensuite, trois colonnes deviennent quatre, des trous apparaissent dans les lignes, les fiches produit perdent les badges ou les boutons du thème, ou la barre latérale glisse sous les produits. Quand un filtre AJAX WooCommerce casse la grille de produits, les produits eux-mêmes sont corrects ; ce qui a changé, c’est le HTML qui les affiche. Voici ce que remplace le mode AJAX de HUSKY, pourquoi le balisage propre au thème se perd en route, et le remède pour chaque symptôme.
Ce que remplace le mode AJAX, et ce qu’il ne peut pas copier
Avec Essayer d’ajaxifier la boutique (Try to ajaxify the shop) réglé sur Oui (Yes) (WooCommerce → Réglages → Products Filter → Options), le plugin délimite la zone des produits des pages de la boutique et des catégories. Sur le hook woocommerce_before_shop_loop (priorité 2), il ouvre un conteneur <div class="woocommerce woocommerce-page woof_shortcode_output"> contenant <div id="woof_results_by_ajax">, et sur woocommerce_after_shop_loop (priorité 10), il ferme les deux.
Quand un visiteur modifie le filtre, le script envoie une requête à /wp-admin/admin-ajax.php avec l’action woof_draw_products. Le serveur génère le rendu de [woof_products is_ajax=1] et le script remplace le conteneur par le résultat. Ce résultat est construit uniquement à partir d’éléments WooCommerce standard :
- le hook
woocommerce_before_shop_loop(avis, nombre de résultats, menu déroulant de tri) ; woocommerce_product_loop_start(), qui affiche<ul class="products columns-N">;- la partie de modèle
content-product.phppour chaque produit ; woocommerce_product_loop_end()et le hookwoocommerce_after_shop_loop(pagination).
Deux choses en découlent. D’abord, tout ce que le modèle d’archive de votre thème affiche lui-même entre les deux hooks (conteneurs supplémentaires, classe de grille, habillage de boucle d’un constructeur) ne figure pas dans le nouveau HTML. Ensuite, le nouveau HTML est produit dans une requête admin-ajax, et non sur la page de la boutique. Le code qui s’exécute pendant le chargement de la page de la boutique, sur l’action wp ou template_redirect, dans le modèle d’archive ou seulement quand is_admin() est faux, ne s’exécute jamais pour elle. Les scripts du thème qui ont mis en forme la grille une fois au chargement de la page ne se relancent pas non plus.
Trouver ce qui a changé : comparer le balisage avant et après
Ouvrez la boutique dans une fenêtre de navigation privée, faites un clic droit sur le premier produit et choisissez Inspecter (Inspect). Notez les classes de ul.products, de ses éléments parents et du premier li.product. Appliquez un filtre et inspectez de nouveau le même endroit. La différence indique la solution :
| Symptôme après le filtrage | Cause | Section |
|---|---|---|
Nombre de colonnes différent, columns-4 au lieu de columns-3 | Le réglage de colonnes du thème n’est pas appliqué dans la requête AJAX | Colonnes et trous |
| Lignes de 3, puis 1, puis 3 ; trous dans la grille | Les classes de ligne first/last sont comptées pour un autre nombre de colonnes | Colonnes et trous |
| La barre latérale ou le pied de page se déplace, disparaît ou se répète ; produits affichés deux fois | Le thème n’appelle pas les deux hooks de la boucle de la boutique autour de la boucle | Hooks de la boucle de la boutique |
Classe manquante sur ul.products, boutons ou badges de retour, vue grille/liste perdue, images vides | Balisage du thème, conditions PHP ou scripts du thème | Fonctionnalités des fiches du thème |
Le nombre de colonnes change après le filtrage et des trous apparaissent
[woof_products] prend son nombre de colonnes dans le filtre loop_shop_columns de WooCommerce, qui se rabat sur Produits par ligne (Products per row) dans Apparence → Personnaliser → WooCommerce → Catalogue de produits. Les thèmes qui ont leur propre option de colonnes ne l’appliquent souvent que pendant le chargement d’une page de la boutique. Dans la requête AJAX, ce code ne s’exécute pas ; les résultats reviennent donc avec la valeur de WooCommerce : souvent 4 là où la boutique en affiche 3.
Les trous ont la même origine. WooCommerce donne au premier produit de chaque ligne la classe first et au dernier la classe last, comptées à partir de ce nombre de colonnes, et la grille classique à flottants commence une nouvelle ligne à chaque first. Si le CSS du thème prévoit 3 produits par ligne et que le HTML AJAX en compte 4, chaque quatrième produit force une nouvelle ligne : 3 produits, puis 1 seul, puis de nouveau 3.
Définissez le nombre de colonnes une fois pour toutes les requêtes, avec le nombre que votre boutique affiche sur ordinateur :
/**
* Same number of columns on shop pages and in HUSKY AJAX results.
* Child theme functions.php or a code snippets plugin.
*/
add_filter( 'loop_shop_columns', function () {
return 3; // products per row on desktop
}, 999 );
Ne l’enveloppez pas dans is_shop() ou dans des vérifications similaires, sinon il sera ignoré dans la requête AJAX. La priorité 999 le fait l’emporter sur le filtre propre au thème. La courte FAQ forcer les résultats filtrés à utiliser un nombre de colonnes donné emploie le même filtre. Sur une page personnalisée, [woof_products columns=3] définit directement le nombre. Les téléphones et les tablettes sont mis en forme par les media queries CSS du thème dans les deux cas.
Si la classe indique columns-3 après le filtrage et que les largeurs restent fausses, le thème dimensionne les produits à l’aide d’une classe de son propre conteneur, située en dehors de la zone remplacée. Ajoutez du CSS pour le conteneur AJAX dans Apparence → Personnaliser → CSS additionnel ou dans le champ Code CSS personnalisé (Custom CSS code) du plugin (Avancé → Code) :
/* HUSKY AJAX results: 3 products per row in a float-based grid */
#woof_results_by_ajax ul.products li.product {
width: 30.75%;
margin-right: 3.8%;
clear: none;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n) {
margin-right: 0;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n+1) {
clear: both;
}
Si votre thème dispose ul.products avec une grille CSS plutôt qu’avec des flottants, une seule règle suffit : #woof_results_by_ajax ul.products { grid-template-columns: repeat(3, 1fr); }. Placez l’une ou l’autre version dans une media query pour ordinateur si le thème utilise moins de colonnes sur téléphone.
Barre latérale sous les produits, pied de page cassé, résultats en double : les hooks de la boucle de la boutique
Le mode AJAX exige que le thème appelle woocommerce_before_shop_loop directement avant la liste de produits et woocommerce_after_shop_loop directement après elle, comme le fait le modèle standard de WooCommerce. Quand ce n’est pas le cas :
- Le hook de fermeture est absent. Les deux conteneurs ne sont jamais fermés, et le navigateur ne les ferme qu’à la fin de leur élément parent. La barre latérale, la seconde colonne ou le pied de page se retrouvent à l’intérieur de la zone des produits : souvent la barre latérale se trouve déjà sous les produits au chargement de la page, et après le premier clic sur le filtre, tout ce qui est dans le conteneur, barre latérale avec le filtre comprise, est remplacé par les résultats.
- Les hooks sont appelés ailleurs. Si le thème les déclenche dans une barre d’outils et affiche la boucle de produits après
woocommerce_after_shop_loop, les résultats AJAX atterrissent dans le conteneur tandis que la grille d’origine reste en dessous, et les produits apparaissent donc deux fois. - Des conteneurs du thème chevauchent les conteneurs de HUSKY. Un élément que le thème ouvre sur
woocommerce_before_shop_loopet ferme surwoocommerce_after_shop_loopdoit se trouver entièrement à l’intérieur des conteneurs de HUSKY (ouvert après la priorité 2, fermé avant la priorité 10) ou entièrement à l’extérieur. Tout ce qui se situe entre les deux les chevauche et casse l’imbrication.
Pour vérifier, ouvrez le code source de la page (Ctrl+U), cherchez woof_results_by_ajax et suivez le HTML vers le bas : après le </ul> fermant des produits et la pagination, il doit y avoir deux </div> avant le début de la barre latérale ou du pied de page. Dans le dossier du thème, cherchez woocommerce_after_shop_loop dans les modèles d’archive. La partie produits d’un modèle compatible avec le mode AJAX ressemble à l’archive-product.php de WooCommerce :
<?php
if ( woocommerce_product_loop() ) {
do_action( 'woocommerce_before_shop_loop' );
woocommerce_product_loop_start();
if ( wc_get_loop_prop( 'total' ) ) {
while ( have_posts() ) {
the_post();
do_action( 'woocommerce_shop_loop' );
wc_get_template_part( 'content', 'product' );
}
}
woocommerce_product_loop_end();
do_action( 'woocommerce_after_shop_loop' );
} else {
do_action( 'woocommerce_no_products_found' );
}
Faites la modification dans une copie du modèle placée dans un thème enfant, ou demandez à l’auteur du thème d’ajouter le hook manquant. Les mises en page de constructeurs de pages appellent rarement les deux hooks ; pour elles, le mode redirection, décrit plus bas, est le choix réaliste. Les produits qui ne changent pas du tout sont traités dans l’URL du filtre change mais les produits ne changent pas, et les modèles Elementor dans Elementor Loop Grid et modèles d’archive qui ne filtrent pas.
Fonctionnalités des fiches du thème perdues : badges, boutons, classes de grille, scripts
Modifications que votre PHP n’applique que sur les pages de la boutique
Le code qui masque les boutons d’ajout au panier, ajoute une ligne de catégorie ou un badge, et qui en décide sur wp ou template_redirect avec is_shop(), ne s’exécute pas dans la requête AJAX ; la fiche par défaut revient donc après le filtrage. Exécutez-le aussi pour la requête de HUSKY. admin_init se déclenche dans chaque requête admin-ajax :
/**
* Card changes for shop pages AND for HUSKY AJAX results.
* Child theme functions.php or a code snippets plugin.
*/
function my_shop_card_changes() {
// Example: no add-to-cart buttons in the product grid
remove_action( 'woocommerce_after_shop_loop_item', 'woocommerce_template_loop_add_to_cart', 10 );
}
// Normal page loads of the shop and product archives
add_action( 'wp', function () {
if ( is_shop() || is_product_taxonomy() ) {
my_shop_card_changes();
}
} );
// HUSKY AJAX filtering, sent through admin-ajax.php
add_action( 'admin_init', function () {
if ( wp_doing_ajax() && isset( $_REQUEST['action'] ) && 'woof_draw_products' === $_REQUEST['action'] ) {
my_shop_card_changes();
}
} );
Les options du thème qui modifient la fiche (une ligne de catégorie, une image au survol, un bouton d’aperçu rapide) sont souvent appliquées de la même façon à l’intérieur du thème. Si elles disparaissent après le filtrage et que le thème n’a pas de hook couvrant aussi les requêtes AJAX, utilisez le mode redirection.
Classes que le thème ajoute à la liste de produits
Si la comparaison montre sur ul.products une classe qui existe au chargement de la page et qui manque après le filtrage, ajoutez-la à la réponse AJAX avec le filtre woof_draw_products_html. Il reçoit le HTML sur le point d’être envoyé au navigateur :
/**
* Add the theme's grid class to the product list in HUSKY AJAX results.
* Child theme functions.php or a code snippets plugin.
*/
add_filter( 'woof_draw_products_html', function ( $html, $shortcode_str ) {
return str_replace(
'<ul class="products columns-',
'<ul class="products my-theme-grid columns-', // use the class from your page
$html
);
}, 10, 2 );
La chaîne recherchée correspond au fichier loop/loop-start.php de WooCommerce ; si votre thème remplace ce fichier, copiez la balise ouvrante depuis le code source de la page. Quand le thème affiche les fiches avec une partie de modèle autre que content-product.php, renvoyez son nom avec le filtre woof_template_part : la valeur product-grid charge content-product-grid.php depuis le dossier woocommerce de votre thème.
Scripts du thème : images différées, hauteurs égales, masonry, aperçu rapide
Les scripts qui s’exécutent une seule fois au chargement de la page (images chargées en différé, fiches de hauteur égale, masonry, sélecteurs de vue grille/liste, boutons d’aperçu rapide) ne voient pas les nouveaux produits. HUSKY déclenche l’événement jQuery woof_ajax_done après chaque remplacement ; placez-y l’appel d’initialisation du thème, dans un fichier JS du thème ou dans Code JavaScript après la fin d’AJAX (JavaScript code after AJAX is done) (Avancé → Code). L’auteur du thème peut vous indiquer le nom de la fonction ; plus de détails sur l’événement dans woof_ajax_done.
jQuery(document).on('woof_ajax_done', function () {
// Many layout scripts recalculate on resize
jQuery(window).trigger('resize');
// Call your theme's own init function here if it has one
});
Nombre de résultats ou tri affiché en double
Un thème qui affiche sa propre barre de nombre de résultats et de tri en dehors de la zone des produits peut quand même recevoir les copies par défaut de WooCommerce à l’intérieur des résultats AJAX. Masquez les copies intérieures, uniquement si ce sont réellement des doublons :
#woof_results_by_ajax .woocommerce-result-count,
#woof_results_by_ajax .woocommerce-ordering {
display: none;
}
Si le nombre de résultats propre au thème, situé en dehors de la zone, ne se met pas à jour après le filtrage, placez son sélecteur CSS dans Sélecteur CSS du nombre de résultats (Result count css selector) (Avancé → Options) : le plugin envoie alors un nombre actualisé avec chaque réponse AJAX et remplace l’élément qu’il trouve.
Quand renoncer à AJAX : mode redirection et mode Turbo
Certaines mises en page ne peuvent pas être reconstruites à partir des éléments WooCommerce standard : habillages de boucle de constructeurs, carrousels, modèles de thème sans les hooks. Réglez Essayer d’ajaxifier la boutique (Try to ajaxify the shop) sur Non (No). Chaque changement de filtre charge alors l’URL filtrée et votre thème génère toute la page comme d’habitude, de sorte que la grille est identique à celle de la boutique non filtrée. Vous perdez la mise à jour sur place. Pour ne recharger qu’une fois par recherche au lieu de le faire après chaque clic, réglez Envoi automatique (Autosubmit) sur Non (No) afin que le filtre attende son bouton, et consultez défilement automatique vers les produits en mode redirection pour amener le visiteur sur les résultats.
Si Essayer d’ajaxifier la boutique (Try to ajaxify the shop) repasse sur Oui (Yes), c’est que le mode Turbo est activé : il active le mode AJAX à chaque chargement de page. Réglez d’abord Activer le mode Turbo (Enable turbo mode) sur Non (No) dans son onglet, puis désactivez AJAX, et videz le cache des pages pour que les visiteurs obtiennent le nouveau réglage.
Liste de contrôle
- Balisage comparé avant et après le filtrage dans l’inspecteur du navigateur.
loop_shop_columnsrenvoie le nombre de colonnes de la boutique sans conditions de page.- Le code source de la page montre les deux conteneurs HUSKY se fermant juste après les produits et la pagination.
- Les modifications de fiches en PHP s’exécutent aussi pour la requête
woof_draw_products; les scripts du thème se relancent surwoof_ajax_done. - Si la mise en page diffère encore : Essayer d’ajaxifier la boutique (Try to ajaxify the shop) = Non (No), avec le mode Turbo désactivé et les caches vidés.
Si la mise en page reste cassée avec un thème par défaut comme Storefront et HUSKY seul actif, ouvrez un sujet sur le forum d’assistance HUSKY en indiquant un lien vers la page de la boutique et une description de ce qui change après le filtrage.