Rotozoom Product Filter — Manuel

Filtrage de produits AJAX ultra-rapide pour WooCommerce. Product Filter permet à vos clients d'affiner votre catalogue par catégorie, prix, attributs, stock et note — les résultats se mettent à jour instantanément, sans recharger la page.

• Version gratuite : filtrage AJAX complet sur tous les attributs de produits (sans limite), curseur de prix, filtres de stock/en promotion/nouveau/note, contexte de catégorie, et compatibilité avec les thèmes classiques, en blocs et XStore.
• Version Pro : correspondance avec toutes les valeurs sélectionnées d'un attribut (logique ET), vos propres choix de produits par page, une couleur exacte pour chaque valeur de pastille, et un cache de résultats pour répéter le filtrage plus rapidement. La version Pro nécessite l'édition téléchargée depuis rotozoom.com, qui installe Rotozoom Connect automatiquement — vous vous y connectez avec votre compte Rotozoom.
• Prix Pro : 47 € / an par site, TVA incluse.

---

Pour les débutants : ce que fait ce plugin

Lorsqu'une boutique compte plus de quelques produits, les clients ont besoin d'un moyen de trouver rapidement ce qu'ils veulent. Un filtre est le panneau — généralement à gauche de la page boutique — avec des cases à cocher et des curseurs comme Prix, Couleur ou Marque. À mesure que le client coche des cases, la grille de produits se réduit.

Product Filter ajoute ce panneau à votre boutique et le rend instantané : la grille se met à jour dès qu'une case est cochée, sans rechargement de page. Il conserve aussi les filtres choisis dans l'adresse web (l'URL), pour qu'un client puisse mettre en favori ou partager une vue filtrée.

Configuration

1. Préparez vos données

Les filtres ne valent que ce que valent vos données produit, alors assurez-vous d'abord que vos produits ont :

• Des catégories attribuées (sous chaque produit ou via Produits → Catégories).
• Des attributs comme Couleur, Taille, Puissance, Culot (définis sous Produits → Attributs, puis attribués aux produits).

Astuce : gardez les slugs d'attributs en lettres ASCII simples (par exemple socket, wattage). Les slugs non latins peuvent être mal encodés dans l'URL.

2. Placez le filtre

Le filtre apparaît automatiquement sur vos pages de boutique, de catégorie, d'étiquette et de recherche. Pour le placer ailleurs — sur n'importe quelle page ou publication — utilisez le shortcode [rotozoom_filter] (options : category, per_page, columns, orderby, sidebar="0", bar="0") ; [rotozoom_filter_bar] affiche seule la barre de tri/par page. Le filtre respecte automatiquement la page sur laquelle il se trouve — sur une page de catégorie, il filtre au sein de cette catégorie.

3. Choisissez les filtres à afficher

Dans les réglages du plugin (Rotozoom → Product Filter), vous choisissez quels contrôles apparaissent — catégories, fourchette de prix, attributs individuels, statut de stock et note — et dans quel ordre.

Référence des fonctionnalités

Filtrage AJAX avec synchronisation de l'URL

Chaque changement de filtre déclenche une requête AJAX — un appel en arrière-plan au serveur qui ne renvoie que les produits correspondants et les insère dans la grille, sans rechargement complet de la page. Les filtres actifs sont écrits dans l'URL, de sorte que :

• Le bouton Retour du navigateur fonctionne comme prévu.
• Une vue filtrée peut être mise en favori ou partagée.
• Arriver directement sur une URL filtrée affiche les bons résultats, déjà filtrés.

Curseur de fourchette de prix

Un curseur à deux poignées permet aux clients de définir un prix minimum et maximum. La fourchette s'étend sur les prix de toute la catégorie actuelle (y compris ses sous-catégories), ou de toute la boutique sur les pages de boutique et de recherche ; elle ne se réduit pas lorsque d'autres filtres sont sélectionnés.

Filtres d'attributs

Chaque attribut WooCommerce peut devenir un groupe de filtres (cases à cocher). Les clients peuvent en combiner plusieurs — par exemple Culot : E27 et Température de couleur : Blanc chaud — pour affiner les résultats avec précision.

• Version gratuite : chaque attribut peut servir de filtre — il n'y a aucune limite. Les produits correspondent s'ils ont au moins une des valeurs sélectionnées d'un attribut (OU).
• Version Pro : pour chaque attribut, vous pouvez choisir Tous (ET) dans les Sections, de sorte que les produits doivent posséder chaque valeur sélectionnée — idéal pour les catalogues techniques aux nombreuses propriétés.

Filtres de stock, de note et spéciaux

Filtres intégrés au-delà des attributs :

• En stock — masquer les articles en rupture.
• Note — n'afficher que les produits à partir d'une note en étoiles (désactivé par défaut ; activez-le dans Sections → Visibilité des sections).
• En promotion — mettre en avant les promotions.
• Nouveau — afficher les produits récemment ajoutés.

Contexte de page de catégorie

Lorsque le filtre se trouve sur une archive de catégorie, il limite automatiquement les résultats à cette catégorie, de sorte que les clients affinent au sein de la section qu'ils parcourent plutôt que sur toute la boutique.

Suppléments Pro

• Correspondance ET — exige toutes les valeurs sélectionnées d'un attribut.
• Produits par page — propose à vos clients vos propres choix par page.
• Couleurs de pastille exactes — définit la couleur précise affichée pour chaque valeur de couleur.
• Cache des résultats — les résultats des filtres répétés pour les visiteurs déconnectés sont servis à partir d'un cache sur votre propre site, actualisé lorsque les produits ou le stock changent.

Free vs Pro en un coup d'œil

Fonctionnalité	Free	Pro
Filtrage AJAX avec synchronisation de l'URL	✓	✓
Curseur de fourchette de prix	✓	✓
Filtres de stock, en promotion, nouveau et de note	✓	✓
Contexte de page de catégorie	✓	✓
Filtres de tous les attributs de produits (sans limite)	✓	✓
Thèmes classiques, en blocs et XStore	✓	✓
Correspondance ET par attribut	—	✓
Choix personnalisés de produits par page	—	✓
Couleur exacte par valeur de pastille	—	✓
Cache des résultats	—	✓

Notes avancées

• Compatibilité XStore (Gratuit et Pro) : XStore génère les pages boutique avec son propre balisage ; le plugin inclut une intégration spécifique pour que le filtre s'accroche correctement à la grille de produits et à l'AJAX de XStore. Sur les thèmes standard/génériques, le filtre fonctionne sans cela.
• Requêtes pilotées par l'URL : les filtres modifient la requête principale de produits, de sorte que les résultats sont de vraies requêtes WooCommerce (pagination, tri et comptes corrects) plutôt qu'une astuce d'affichage/masquage côté client.
• Performance : le filtrage utilise le contexte de catégorie pour garder les requêtes ciblées et rapides, même sur de grands catalogues.

Dépannage

• Un attribut n'est pas proposé comme filtre — vérifiez qu'il s'agit d'un attribut global (sous Produits → Attributs) et qu'il est attribué aux produits.
• Les URL filtrées semblent cassées ou doublement encodées — vérifiez que les slugs d'attributs sont en ASCII simple.
• Le filtre apparaît sans style sur XStore — assurez-vous que le filtre se trouve sur une page de boutique ou de catégorie WooCommerce et videz tout cache de page.

Pour activer la version Pro (téléchargez-la depuis rotozoom.com et connectez-vous via Rotozoom Connect), consultez Installer et mettre à jour les plugins.