WooCommerce filters werken niet: vier symptomen, vier oorzaken

Waar het filter zijn gegevens vandaan haalt

Een filter in de webshop toont waarden van attributen, dus kenmerken als kleur, maat of materiaal. WooCommerce kent twee soorten attributen, en die bepalen of het filter überhaupt iets ziet.

De WooCommerce-documentatie over categorieën, tags en attributen legt uit dat attributen dienen om producten te filteren en variaties te bouwen. De documentatie van het attribuutfilterblok in de zoekextensie zegt het nog duidelijker: het attribuutfilterblok ondersteunt alleen globale attributen.

Symptoom 1: het filter toont geen producten

Een klant klikt op “Rood” en ziet een lege lijst, terwijl de webshop rode producten heeft.

Oorzaak: bij de rode producten staat de kleur als eigen attribuut of in de beschrijving, niet als term van een globaal attribuut. Het filter zoekt producten die aan de term “Rood” in de globale lijst gekoppeld zijn en vindt er geen.

Controleer het tabblad Attributen bij een van die producten. Een globaal attribuut heeft een naam uit de lijst en termen die je kiest uit een keuzelijst. Een eigen attribuut heeft een tekstveld met waarden gescheiden door een verticale streep.

Symptoom 2: een waarde of een heel attribuut ontbreekt in het filter

Je hebt vijf kleuren, en het filter toont er drie. Of er is helemaal geen filter op maat.

Er zijn meestal drie oorzaken. Sommige producten hebben een eigen attribuut in plaats van een globaal. De term staat in de lijst, maar geen enkel gepubliceerd product op voorraad heeft hem, dus het filter verbergt hem. Of het filterblok is op maar één attribuut ingesteld. In blokthema’s stel je filterblokken in onder Weergave → Editor, in het sjabloon van de catalogus, en de documentatie over het productfilterblok beschrijft hoe ze werken.

Symptoom 3: dezelfde waarden staan er dubbel in

Het filter toont “Zwart”, “zwart” en “Zwrat”. Of “XL” en “xl”. Elke waarde leidt naar een andere set producten.

Oorzaak: imports uit meerdere bestanden, of waarden die met de hand zijn toegevoegd. Voor WooCommerce zijn dat aparte termen. De oplossing: kies er één, koppel alle producten daaraan, en verwijder pas daarna de lege. De volgorde telt, want als je een term verwijdert die nog producten heeft, wordt hij van die producten losgekoppeld.

Met een CSV-import maak je ook makkelijk een eigen attribuut aan in plaats van een globaal. De handleiding van Barn2 over attributen importeren legt uit hoe je dat voorkomt.

Symptoom 4: het filter toont verkeerde of verouderde resultaten

Het filter toont een product dat er niet hoort, een uitverkochte maat, of de stand van een paar dagen geleden.

De oorzaken zijn technisch:

• de cache van een cacheplugin of van de filterplugin zelf,
• de opzoektabel voor attributen van WooCommerce, die na een import achter kan lopen; in nieuwere versies genereer je die opnieuw onder WooCommerce → Status → Gereedschap,
• een filterplugin die naar de attributen van het product kijkt in plaats van de voorraad van een bepaalde variatie,
• een conflict tussen twee filterplugins, of tussen een filterplugin en een zoekplugin.

Hier beslissen de instellingen en de documentatie van de filterplugin. Het overzicht van Themeisle behandelt ook de ingebouwde filterblokken en hun grenzen.

Een attribuut voor filters, voor de beschrijving of voor variaties

Elk attribuut op de productpagina heeft twee vinkjes, en beide bepalen wat de klant ziet.

“Zichtbaar op de productpagina” toont het attribuut in het tabblad met extra informatie. Het heeft geen invloed op het filter, maar helpt klanten producten te vergelijken.

“Gebruikt voor variaties” maakt het attribuut de basis voor variaties, bijvoorbeeld maten van een hoodie. Zo’n attribuut kan nog steeds in het filter werken als het globaal is. Maar dan gaan filter en voorraad van elkaar afhangen: een product met een uitverkochte XL kan verschijnen als XL is gekozen, afhankelijk van de filterplugin.

Een goede regel: houd de kenmerken waarop klanten producten kiezen, zoals kleur, maat, materiaal of merk, als globale attributen. Beschrijvende details die bij één product horen, kunnen eigen attributen blijven of in de beschrijving staan. Gebruik categorieën en tags voor groepen producten, niet voor kleuren en maten.

Zo ruim je attributen stap voor stap op

Een volgorde waarbij je geen gegevens kwijtraakt:

1. Zet de globale attributen onder Producten → Attributen op een rij, met hun termen.
2. Zoek producten met eigen attributen die globaal zouden moeten zijn.
3. Zoek dubbele termen en kies welke blijft.
4. Koppel producten aan de juiste globale termen, te beginnen met één categorie.
5. Controleer het filter op die categorie in een privévenster van de browser.
6. Verwijder de lege dubbele termen.
7. Leeg de cache en controleer de filters in de andere categorieën.

Bij een paar producten doe je dit in de backoffice. Bij een paar honderd betekent het vele avonden producten een voor een openen.

Zo helpt de chat

De TellMyShop-plugin voor WordPress en WooCommerce leest de lijst met attributen en hun termen, en de productgegevens, al in de gratis versie TellMyShop Free. Je chat (Claude of ChatGPT) vindt producten zonder attributen, met eigen attributen in plaats van globale en met dubbele termen, en maakt dan een plan om op te ruimen.

In TellMyShop Pro stelt de chat productattributen in zodra de licentie is geactiveerd, zonder schakelaars, in batches van maximaal 50 producten. Elke batch heeft een voorbeeld, opslaan gebeurt na jouw akkoord, en in de wijzigingsgeschiedenis kun je elke wijziging ongedaan maken. Een voorbeeldgesprek, met voorbeeldwaarden: