HUSKY - WooCommerce Product Filter Professional

L’URL du filtre WooCommerce change mais pas les produits : la solution

Vous cochez une couleur ou une catégorie, le loader apparaît, la barre d’adresse devient quelque chose comme /shop/?swoof=1&pa_color=red, et la grille de produits affiche toujours les mêmes produits. Quand l’URL du filtre WooCommerce change mais que les produits ne changent pas, le filtre a fait sa part : il a construit la requête de recherche. Le template qui affiche les produits ne l’a simplement jamais lue. Ce guide montre comment le confirmer en deux minutes et comment faire réagir au filtre un thème, un constructeur de pages ou un template personnalisé.

Pourquoi l’URL du filtre WooCommerce change mais pas les produits

HUSKY ne dessine pas la grille de produits de votre boutique. Il ajoute ses conditions (taxonomies, prix, champs meta, texte) aux requêtes de produits que WooCommerce exécute déjà, et uniquement à celles-ci :

  • la requête principale de la page boutique et des archives de catégories, d’étiquettes et d’attributs de produits (l’étape woocommerce_product_query de WooCommerce) ;
  • le shortcode [woof_products] du plugin ;
  • les shortcodes de produits de WooCommerce comme [products], via woocommerce_shortcode_products_query.

Une liste de produits qui construit son propre WP_Query sort de ce circuit. Les grilles de produits des constructeurs de pages, les cartes d’articles et les répéteurs, les éléments « query loop », les mises en page d’archives du thème avec leur propre requête et les boucles écrites à la main dans un template PHP interrogent tous la base de données à leur manière ; ils continuent donc d’afficher tout le catalogue, quoi que dise le filtre. Rien n’est cassé dans le filtre ; la liste ne l’écoute simplement pas.

Deux symptômes liés ont la même origine. Sur une page ordinaire où le script du filtre ne trouve aucune liste de produits WooCommerce, il envoie le visiteur vers la page boutique pour afficher les résultats. Et sur une « page de catégorie » qui est en réalité une page WordPress créée avec un constructeur, le filtre ne connaît pas la catégorie courante : il propose donc tous les termes et cherche dans tout le catalogue.

Confirmez la cause en deux minutes

  1. Lisez l’URL après le filtrage. Si elle contient swoof=1 et vos choix (/swoof/ suivi de ceux-ci quand les URL SEO sont activées, ou seulement min_price et max_price quand le prix est le seul choix), le filtre a fonctionné. Si l’URL ne change pas du tout, le filtre n’a jamais envoyé la requête : cherchez d’abord une erreur JavaScript dans la console du navigateur.
  2. Essayez la même requête sur la page boutique standard. Copiez tout à partir de ?swoof=1 et ajoutez-le à l’URL de votre page boutique WooCommerce. Des produits filtrés là et non filtrés sur votre page désignent directement la liste de produits de votre page.
  3. Testez avec un shortcode simple. Sur une page en brouillon, placez [woof] et, en dessous, [woof_products per_page=12], ou le [products limit="12"] de WooCommerce. Si ceux-ci filtrent correctement, utilisez l’une des solutions ci-dessous pour votre vraie page.
  4. Vérifiez de quel type de page il s’agit. Regardez l’écran d’édition : une Page WordPress contenant une grille de produits n’est pas une archive de produits, même si son URL ressemble à /category/shoes/.

Solution 1 : afficher les produits avec [woof_products]

La solution la plus fiable consiste à laisser le plugin afficher les produits. Remplacez l’élément produit du constructeur par un widget ou un bloc Shortcode contenant [woof_products] :

[woof_products per_page=12 columns=4 is_ajax=1]

Le shortcode réagit au filtre sur n’importe quelle page, prend en charge le mode AJAX avec is_ajax=1 et affiche chaque produit avec la carte produit WooCommerce habituelle de votre thème (le fichier de template content-product.php), de sorte que le rendu est celui de la boutique. Pour utiliser un autre fichier de template, modifiez-le avec le filtre woof_template_part.

Pour une page qui ne doit lister qu’une seule catégorie, donnez la même condition aux deux shortcodes, sinon le filtre propose les termes de tout le catalogue :

[woof taxonomies=product_cat:25]
[woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1]

Remplacez 25 par l’ID de la catégorie (visible dans l’URL quand vous modifiez la catégorie). Le shortcode [products] de WooCommerce est filtré lui aussi, mais seulement avec un rechargement de la page. Si vous en avez besoin en mode AJAX, écrivez-le [products_woof limit="12" columns="4"] : le plugin l’enveloppe pour que les résultats puissent être remplacés sans rechargement.

Solution 2 : faire écouter le filtre par une grille de constructeur ou un WP_Query personnalisé

Si vous voulez conserver le design de carte du constructeur, faites en sorte que sa requête utilise le résultat du filtre. Le snippet ci-dessous se branche sur pre_get_posts, demande à HUSKY quels produits correspondent au filtre courant et limite la requête de la grille à ces produits. C’est une version renforcée du code de Rendre filtrables les constructeurs de pages et les templates personnalisés : elle laisse tranquilles les listes de produits de wp-admin, préserve la pagination de la grille, respecte une sélection fixe de produits de l’élément et affiche « aucun produit » au lieu de tout le catalogue quand rien ne correspond.

/**
 * HUSKY: apply the active filter to product lists that run their own query
 * (page builder grids, post cards, query loops, custom templates).
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'pre_get_posts', function ( $query ) {
    static $busy = false;

    if ( $busy || ! function_exists( 'woof' ) || $query->is_main_query() ) {
        return;
    }
    // Keep the product lists in wp-admin untouched.
    if ( is_admin() && ! wp_doing_ajax() ) {
        return;
    }
    // Product queries only.
    if ( ! in_array( 'product', (array) $query->get( 'post_type' ), true ) ) {
        return;
    }
    // WooCommerce archives and [woof_products] are filtered already.
    if ( 'product_query' === $query->get( 'wc_query' ) ) {
        return;
    }
    // Only while a filter is active: ?swoof=1, an SEO URL,
    // or ?min_price=...&max_price=... when only the price is set.
    $request = woof()->get_request_data();
    if ( ! isset( $request[ woof()->get_swoof_search_slug() ] ) && ! isset( $request['min_price'] ) ) {
        return;
    }
    // Optional: limit to one page.
    // if ( ! is_page( 123 ) ) { return; }

    $was_doing = isset( $_REQUEST['woof_products_doing'] );
    $args      = woof()->woof_products( array( 'get_args_only' => 1 ) );

    // All matching IDs, whatever page of the grid is open.
    $args['fields']         = 'ids';
    $args['posts_per_page'] = -1;
    $args['paged']          = 1;
    $args['no_found_rows']  = true;
    $args['orderby']        = 'ID';
    unset( $args['meta_key'] );

    $busy = true;
    $ids  = ( new WP_Query( $args ) )->posts;
    $busy = false;

    if ( ! $was_doing ) {
        unset( $_REQUEST['woof_products_doing'] );
    }

    // Respect a fixed product selection of the element itself.
    $own = array_filter( array_map( 'intval', (array) $query->get( 'post__in' ) ) );
    if ( $own ) {
        $ids = array_values( array_intersect( $ids, $own ) );
    }

    // No match: show "no products" instead of the whole catalog.
    $query->set( 'post__in', $ids ? $ids : array( 0 ) );
} );

Fonctionnement : woof()->woof_products( array( 'get_args_only' => 1 ) ) renvoie les arguments de requête que [woof_products] utiliserait pour la requête courante, sans l’exécuter. Le snippet les transforme en une liste d’ID de produits correspondants et la transmet à la grille sous forme de post__in. La grille conserve sa propre mise en page, son tri et son nombre d’éléments par page. Le même hook couvre un WP_Query que vous écrivez vous-même dans un template, tant qu’il interroge le type de contenu product.

Toutes les requêtes de produits d’une page filtrée suivent désormais le filtre, y compris les carrousels comme « meilleures ventes » ou « produits similaires » dans un pied de page. Si ce n’est pas ce que vous voulez, décommentez la ligne is_page() et indiquez l’ID de la page contenant la grille ; cela évite aussi une requête de base de données supplémentaire pour chaque autre liste de produits de la page.

Le mode AJAX a besoin des deux hooks de la boucle boutique

Avec Essayer de passer la boutique en AJAX (Try to ajaxify the shop) réglé sur Oui (Yes) (WooCommerce → Réglages → Products Filter → Options), le plugin enveloppe la liste de produits dans son propre conteneur. Il ouvre le conteneur sur le hook woocommerce_before_shop_loop et le ferme sur woocommerce_after_shop_loop. Après chaque changement de filtre, il demande au serveur du nouveau HTML et remplace le contenu de ce conteneur. Le template d’archive standard de WooCommerce appelle les deux hooks ; de nombreuses mises en page de constructeurs et templates personnalisés ne le font pas. Le résultat est l’un de ces trois symptômes :

  • Aucun des deux hooks n’est appelé : il n’y a pas de conteneur à remplacer, donc chaque changement de filtre recharge toute la page.
  • Seul le premier hook est appelé : le conteneur ouvert n’est jamais fermé et engloutit le reste de la mise en page, par exemple la deuxième colonne ou la barre latérale, qui apparaît soudain à l’intérieur de la colonne des produits.
  • Les cartes changent d’aspect après le filtrage : les résultats AJAX sont générés côté serveur par [woof_products] avec la carte produit WooCommerce standard, et non avec le design de carte du constructeur. Des champs de quantité par défaut ou des boutons d’ajout au panier apparaissent là où le constructeur les avait masqués.

Si vous maîtrisez le code du template, appelez les deux hooks autour de la boucle :

<?php
// Product list part of your theme template.
do_action( 'woocommerce_before_shop_loop' );

woocommerce_product_loop_start();
while ( have_posts() ) {
    the_post();
    wc_get_template_part( 'content', 'product' );
}
woocommerce_product_loop_end();

do_action( 'woocommerce_after_shop_loop' );

Tout ce qui se trouve entre les deux hooks est remplacé à chaque requête AJAX ; le balisage d’enveloppe que vous souhaitez autour de chaque produit doit donc se trouver dans content-product.php, et non dans le template d’archive. Les conditions personnalisées de votre propre boucle (par exemple « produits des 60 derniers jours ») ne font pas partie du résultat AJAX, car le serveur le génère avec [woof_products] ; ajoutez de telles conditions avec le hook woof_products_query ou utilisez le mode de redirection.

Si vous ne pouvez pas modifier le template, ce qui est le cas habituel avec les constructeurs, réglez Essayer de passer la boutique en AJAX (Try to ajaxify the shop) sur Non (No). En mode de redirection, chaque changement de filtre charge l’URL filtrée, et le snippet de la solution 2 fait afficher les bons produits à la grille du constructeur. Avec l’envoi automatique activé, chaque choix est appliqué immédiatement, mais avec un chargement de page au lieu d’un remplacement AJAX.

Le filtre saute vers la page boutique ou ignore la catégorie

Les résultats s’ouvrent sur la page boutique. Sur une page qui n’est pas une archive de produits, le script du filtre cherche une liste de produits WooCommerce : un élément de classe products dans un conteneur .woocommerce, ou la sortie propre au plugin. S’il n’en trouve aucune, il envoie la recherche vers la page boutique, et le filtre de votre page semble disparaître. La solution 1 règle le problème ; les configurations par shortcode pour les pages d’atterrissage et la page d’accueil sont décrites dans le filtre de produits sur une page personnalisée. Si la grille de votre constructeur réagit déjà au filtre grâce à la solution 2 mais utilise un balisage différent, dites au script de rester sur la page :

/**
 * HUSKY: keep filter results on this page instead of the shop page.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'wp_footer', function () {
    if ( is_page( 123 ) ) { // ID of the page with the product grid
        echo '<script>var woof_not_redirect = 1;</script>';
    }
} );

Le filtre propose des termes d’autres catégories. Le plugin prend la catégorie courante auprès de WordPress (l’objet interrogé d’une archive de taxonomie de produits). Une page WordPress conçue pour ressembler à une catégorie n’en a pas, et le filtre travaille donc avec tout le catalogue. Utilisez la vraie archive de catégorie et mettez-la en forme avec le template d’archive ou le theme builder de votre constructeur, ou transmettez taxonomies=product_cat:ID aux deux shortcodes comme indiqué dans la solution 1. Un thème personnalisé développé sans prise en charge de WooCommerce peut avoir le même effet sur de vraies archives ; déclarer add_theme_support( 'woocommerce' ) dans un callback after_setup_theme corrige la détection, même si les templates de produits du thème devront peut-être être ajustés. Si la page est une vraie archive et que la catégorie n’est toujours pas détectée, réglez Vérification supplémentaire de la page de catégorie (Additional check of the category page) sur Oui (Yes) dans Advanced → Options. Les thèmes de blocs bénéficient automatiquement de cette vérification. Pour masquer les termes sans produits dans la catégorie courante, voyez comment n’afficher que les options de filtre de la catégorie courante.

Conflits de routage : URL SEO et permaliens

Avec l’extension SEO URL request activée, le filtre fait partie du chemin, par exemple /shop/swoof/color-red/, au lieu d’une chaîne de requête. Certains constructeurs résolvent eux-mêmes les URL et les templates (Bricks en est un cas connu) et ne reconnaissent pas ce chemin : l’interface du filtre fonctionne alors alors que les produits ne changent jamais, ou la page retombe sur un template non filtré. Pour tester, ouvrez Advanced → SEO URL request et réglez Activer/Désactiver (Enable/Disable) sur Non (No), videz tous les caches et filtrez de nouveau. Si les liens simples ?swoof=1&... fonctionnent, le routage est en cause ; gardez alors les URL SEO désactivées sur ce site.

Les URL SEO exigent aussi des permaliens lisibles. Si le réglage sous Réglages → Permaliens est Simple (Plain), choisissez une autre structure, enregistrez et testez de nouveau.

Situations courantes avec les constructeurs

Ce qui affiche les produitsQue faire
Grille de produits de constructeur, cartes d’articles, répéteur ou élément query loop (Avada Post Cards, Oxygen Repeater, Bricks query loop, bloc Query Loop avec requête personnalisée)Solution 2, mode de redirection. Ou remplacez l’élément par [woof_products].
Mise en page de theme builder qui remplace le template de la boutique ou des catégories (mises en page Avada, YOOtheme, Flatsome, Beaver Themer, Breakdance)Fonctionne en mode de redirection quand la mise en page utilise la boucle WooCommerce. Mode AJAX seulement si la mise en page appelle les deux hooks de la boucle boutique ; sinon, réglez Essayer de passer la boutique en AJAX (Try to ajaxify the shop) sur Non (No).
Widgets de produits et grilles de boucle ElementorVoir rendre filtrables les grilles de produits Elementor.
WP_Query écrit à la main dans un template PHPLa solution 2 le couvre ; pour le mode AJAX, ajoutez les deux hooks.
Un autre plugin qui remplace la requête ou le template de produitsDésactivez-le pour un test. Si le filtre fonctionne alors, ce plugin doit utiliser la requête WooCommerce standard.

Si cela ne fonctionne toujours pas

  • Testez déconnecté, dans une fenêtre de navigation privée. Un cache de pages qui ignore la chaîne de requête sert le même HTML non filtré pour chaque URL de filtre ; excluez du cache de pages les URL contenant swoof.
  • Après avoir ajouté le snippet, ouvrez directement une URL de filtre. Si la grille n’est toujours pas filtrée, l’élément n’interroge probablement pas le type de contenu product, ou il charge ses produits plus tard par sa propre requête AJAX sans les paramètres du filtre (certains boutons « charger plus » font cela).
  • Si la première page se filtre correctement mais que la page 2 affiche une 404 ou des produits non filtrés, les liens de pagination de la grille perdent les paramètres du filtre. Vérifiez que le lien de la page 2 contient toujours swoof=1 et vos choix ; d’autres causes sont décrites dans la pagination du filtre ne fonctionne pas.

Si le test par shortcode de la première section fonctionne et que votre template ne fonctionne toujours pas, ouvrez un sujet sur le forum de support de HUSKY avec un lien vers la page, le thème ou le constructeur utilisé et l’élément qui affiche les produits.