HUSKY - WooCommerce Product Filter Professional

Filtre WooCommerce et Elementor Loop Grid qui ne fonctionne pas : solutions

Vous cochez un filtre sur une boutique créée avec Elementor et le Loop Grid continue d’afficher tous les produits, n’applique que la première de plusieurs valeurs sélectionnées, ou le modèle de catégorie se transforme en simple liste WooCommerce après le filtrage. Quand le filtre WooCommerce ne fonctionne pas avec Elementor Loop Grid, la cause dépend de deux choses : quel élément Elementor affiche les produits, et si le mode AJAX de HUSKY est activé. Identifiez d’abord l’élément ; chacun a sa propre solution.

Quel élément Elementor affiche vos produits

HUSKY ne dessine pas la grille de produits. Il ajoute ses conditions aux requêtes de produits de WooCommerce : la requête principale de la boutique et des archives de catégories, d’étiquettes et d’attributs, les requêtes construites par le shortcode [products] de WooCommerce, et son propre shortcode [woof_products]. Un élément Elementor qui construit sa propre requête n’entend pas le filtre.

ÉlémentSuit le filtreQue faire
Widget Archive Products, ou widget Products avec Requête actuelle (Current Query), dans une archive de produits du Theme BuilderOui, il utilise la requête principale de la boutiqueLe mode redirection conserve le design ; voir la section sur les archives pour le mode AJAX et les modèles de catégorie
Widget Products avec sa propre source de requête (derniers produits, produits en promotion, produits mis en avant)Normalement oui : le widget repose sur le shortcode des produits de WooCommerceRien de particulier ; le filtrage recharge la page
Loop Grid avec un modèle de boucle de produitsNon, il exécute sa propre requêteFaire suivre le filtre à la requête, ou remplacer l’élément
Grilles de produits des packs de plugins (WooLentor, Premium Addons, Unlimited Elements, JetWooBuilder et similaires)Généralement nonComme pour le Loop Grid
Widget Shortcode avec [woof_products]Oui, y compris avec AJAXFonctionne partout ; utilise la fiche produit WooCommerce du thème

Trois vérifications rapides vous indiquent dans quel cas vous êtes :

  1. L’URL après le filtrage contient swoof=1 et vos choix. Dans ce cas, le filtre a fait sa part ; c’est l’élément qui a ignoré la requête.
  2. Un élément témoin. Placez un widget Shortcode avec [woof_products per_page=4] à côté de votre grille, filtrez et comparez. Si le shortcode filtre et que votre grille ne filtre pas, la grille exécute sa propre requête.
  3. La zone AJAX. Ouvrez le code source de la page (Ctrl+U) et cherchez woof_results_by_ajax. Sans cette zone, le mode AJAX n’a rien à remplacer et chaque modification du filtre recharge la page, même avec AJAX activé.

Loop Grid et widgets de plugins complémentaires : faire suivre le filtre à leur requête

Un Loop Grid interroge lui-même la base de données pour obtenir les produits, et continue donc de lister tout le catalogue. Vous avez trois issues, de « conserver le design de la boucle » à « le moins de code possible ».

Conserver le Loop Grid : restreindre sa requête avec pre_get_posts

Un court extrait de code demande à HUSKY quels produits correspondent au filtre actuel et limite à ceux-ci toutes les autres requêtes de produits de la page. Utilisez la version renforcée présentée dans la solution 2 de « l’URL du filtre change mais les produits ne changent pas » ; copiez-la dans le fichier functions.php du thème enfant ou dans un plugin de snippets de code. Comparée à l’ancien code de la FAQ sur la compatibilité avec Elementor, elle laisse tranquilles les listes de produits de wp-admin, conserve le filtrage sur la page 2 et les suivantes de la grille, et affiche « aucun résultat » au lieu de tout le catalogue lorsqu’aucun produit ne correspond. N’exécutez pas les deux extraits en même temps ; remplacez l’ancien.

Ajustez ensuite la configuration :

  • Le filtrage doit recharger la page : l’extrait filtre la grille pendant le chargement de l’URL filtrée. Un Loop Grid n’a pas de zone AJAX, donc cela se produit tout seul ; si la page en contient aussi une (voir la vérification 3 ci-dessus), réglez Essayer d’utiliser AJAX pour la boutique (Try to ajaxify the shop) sur Non (No) (WooCommerce → Réglages → Products Filter → Options), sinon seule cette zone est mise à jour.
  • Sur une page ordinaire (et non une archive du Theme Builder), le filtre envoie ses résultats vers la page de la boutique, sauf s’il trouve sur la page une liste de produits WooCommerce ou [woof_products] ; or un Loop Grid n’est ni l’un ni l’autre. Dites-lui de rester :
    /**
     * HUSKY: keep filter results on the page with the Loop Grid.
     * Child theme functions.php or a code snippets plugin.
     */
    add_action( 'wp_footer', function () {
        if ( is_page( 123 ) ) { // ID of the page with the Loop Grid
            echo '<script>var woof_not_redirect = 1;</script>';
        }
    } );
  • L’extrait agit sur toutes les requêtes de produits d’une page filtrée, y compris les carrousels de produits « similaires » ou de « meilleures ventes ». Pour le limiter à une seule page, décommentez sa ligne is_page() et saisissez l’ID de cette page.
  • N’ajoutez l’extrait que là où un élément exécute réellement sa propre requête. Là où le widget Archive Products affiche les produits, il n’est pas nécessaire ; supprimez-le si vous l’y aviez ajouté auparavant.
  • Vérifiez le lien vers la page 2 de la grille après le filtrage : il doit toujours contenir swoof=1 et les valeurs sélectionnées. Un mode « charger plus » ou de défilement infini qui récupère la page suivante sans ces paramètres affiche des produits non filtrés à partir de la page 2 ; essayez la pagination numérotée et vérifiez à nouveau ses liens.

Passer au widget Products

Le widget Products d’Elementor Pro suit normalement le filtre sans aucun code : sur les archives avec Requête actuelle (Current Query), ailleurs avec sa propre source de requête. Si le design de sa fiche produit, défini dans les réglages propres du widget, vous suffit, c’est le remplaçant le plus simple d’un Loop Grid.

Utiliser le shortcode [woof_products]

Un widget Shortcode avec le shortcode [woof_products] du plugin filtre sur n’importe quelle page et prend en charge AJAX :

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

Il affiche chaque produit avec la fiche WooCommerce de votre thème (content-product.php), et non avec un modèle de boucle Elementor. Sur une page qui doit afficher une seule catégorie, donnez au filtre et à la liste de produits la même condition : [woof taxonomies=product_cat:25] et [woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1], en remplaçant 25 par l’ID de votre catégorie.

Plusieurs valeurs sélectionnées, mais seule la première s’applique

Avec la logique OR entre les valeurs d’un même attribut, sélectionner rouge, bleu et vert devrait afficher les produits de l’une des trois couleurs. Si un Loop Grid réglé sur Requête actuelle (Current Query) dans un modèle d’archive n’affiche que les produits rouges, c’est que le Loop Grid construit sa requête à partir de la requête HTTP à sa manière et ne garde que la première valeur. Le filtre lui-même est correct : la même requête affiche les bons produits dans le widget Products ou dans [woof_products].

Remplacez le Loop Grid par le widget Products réglé sur Requête actuelle (Current Query), ou par [woof_products]. Vérifiez aussi que l’attribut utilise bien OR : ouvrez les options supplémentaires de l’attribut dans l’onglet Structure et regardez Logique de filtrage (Logic of filtering). AND ne fonctionne que pour les types de filtre qui autorisent plusieurs valeurs, comme les cases à cocher.

Archives du Theme Builder : design perdu et mauvais modèle

Les résultats AJAX ressemblent à une simple liste WooCommerce

Si la zone AJAX existe à l’intérieur d’un widget Archive Products, les produits sont remplacés sur place après chaque modification du filtre, mais le nouveau HTML est généré côté serveur par [woof_products] à partir des composants standard de WooCommerce, en dehors du rendu de la page Elementor. Les classes d’Elementor et les réglages du widget n’y figurent pas : les produits perdent la grille, les espacements et les textes de boutons du widget. La manière dont le mode AJAX reconstruit la grille est expliquée dans Le filtre AJAX casse la mise en page de la grille de produits.

La solution fiable est de régler Essayer d’utiliser AJAX pour la boutique (Try to ajaxify the shop) sur Non (No) : l’URL filtrée est alors rendue par Elementor et ressemble exactement au modèle. Si vous voulez conserver AJAX, corrigez la réponse avec le filtre woof_draw_products_html afin que le CSS de grille d’Elementor s’applique de nouveau :

/**
 * HUSKY AJAX results inside an Elementor Archive Products widget:
 * add the class Elementor's grid styles expect.
 * 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 elementor-grid columns-',
        $html
    );
}, 10, 2 );

Avant de l’utiliser, inspectez la liste de produits sur une page fraîchement chargée et confirmez les noms de classes de ul.products ; reprenez ceux de votre page s’ils diffèrent. Les différences restantes, comme un bouton enveloppé dans un élément supplémentaire ou un libellé modifié, se corrigent plus facilement avec quelques lignes de CSS qu’en PHP. Si le nombre de colonnes change après le filtrage, définissez-le avec loop_shop_columns comme indiqué dans l’article sur la mise en page.

Une page de catégorie filtrée utilise le modèle de la boutique

Tant qu’un filtre est actif, HUSKY marque par défaut la requête comme l’archive du type de contenu produit et désactive l’indicateur « archive de taxonomie » de WordPress. Les conditions d’affichage d’Elementor voient alors la boutique au lieu d’une catégorie : un modèle assigné à « Catégories de produits » est remplacé par le modèle général, et les titres d’archive affichent le nom de la boutique au lieu de celui de la catégorie. Réglez Désactiver l’influence de swoof (Disable swoof influence) sur Oui (Yes) dans Advanced → Options et testez à nouveau. Les détails et les effets secondaires sont décrits dans conserver la page de catégorie lors du filtrage.

Des compteurs qui affichent les chiffres de toute la boutique sur un modèle de catégorie viennent généralement du shortcode du filtre lui-même : un [woof] avec dynamic_recount=0 ne recompte pas pour la catégorie actuelle. Supprimez l’attribut ou réglez-le sur 1.

Le filtre dans une popup ou un panneau hors écran Elementor ne fait rien

HUSKY attache ses scripts au formulaire du filtre une seule fois, quand la page est prête. Si une popup ou un panneau hors écran insère son contenu plus tard, le filtre s’affiche mais les clics ne font rien, car le nouveau formulaire n’a jamais été initialisé. Ouvrez le code source de la page et cherchez woof_redraw_zone : si le balisage du filtre n’y figure pas avant l’ouverture de la popup, c’est votre cas.

Utilisez plutôt le panneau coulissant du plugin : placez [woof_slideout location="left"] dans un widget Shortcode, ou réglez Visibilité globale (Global visibility) sur Afficher (Show) dans l’onglet Slideout pour l’ajouter aux pages de la boutique. Son formulaire fait partie de la page dès le départ, il fonctionne donc comme n’importe quel autre filtre. D’autres options : une popup qui affiche son contenu avec la page, ou une section que vous affichez et masquez avec un bouton.

L’éditeur Elementor ne se charge pas quand HUSKY est actif

L’erreur d’éditeur des anciennes versions (Call to a member function get() on null) est corrigée dans les versions actuelles : lorsque la page est ouverte dans l’éditeur Elementor, [woof_products] ignore les hooks de la boucle de la boutique. Mettez d’abord le plugin à jour. Si l’éditeur se bloque encore uniquement lorsque HUSKY est actif, retirez le widget WordPress classique de HUSKY du panneau d’Elementor ; vous continuez à placer le filtre avec le widget Shortcode :

/**
 * Hide HUSKY's WordPress widget from the Elementor panel.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'elementor/widgets/register', function ( $widgets_manager ) {
    $widgets_manager->unregister( 'wp-widget-woof_widget' );
} );

Cet extrait utilise le hook d’enregistrement des versions actuelles d’Elementor ; l’ancien hook de la FAQ sur le conflit avec l’éditeur Elementor y est déprécié.

Liste de contrôle

  • Vous savez quel élément affiche les produits, et un [woof_products] témoin filtre correctement sur la même page.
  • Loop Grid ou grille de plugin complémentaire : l’extrait pre_get_posts renforcé à la place de l’ancien, le filtrage recharge la page, le lien de la page 2 conserve swoof=1.
  • Plusieurs valeurs d’un même attribut : widget Products ou [woof_products] au lieu d’un Loop Grid avec Requête actuelle (Current Query).
  • Modèle de catégorie du Theme Builder : Désactiver l’influence de swoof (Disable swoof influence) = Oui (Yes) ; AJAX désactivé, ou réponse corrigée avec woof_draw_products_html.
  • Filtre dans une popup : remplacé par [woof_slideout].
  • Caches purgés et résultat testé dans une fenêtre de navigation privée.

Si le shortcode témoin fonctionne et que votre élément Elementor ne fonctionne toujours pas, ouvrez un sujet sur le forum d’assistance de HUSKY avec un lien vers la page ainsi que le nom de l’élément et du plugin qui affiche les produits.