# AI Size & Fit Advisor: complete handleiding

> AI Size & Fit Advisor adviseert de juiste maat op basis van lengte en gewicht van de klant, of van zijn met een meetlint gemeten maten. Deze handleiding behandelt installatie,…

- Pagina: <https://www.datafirefly.com/nl/documentation/ai-size-fit-advisor/>
- Taal: nl
- Bijgewerkt op: 2026-09-29
- Andere talen: [fr](https://www.datafirefly.com/documentation/ai-size-fit-advisor/index.md), [en](https://www.datafirefly.com/en/documentation/ai-size-fit-advisor/index.md), [es](https://www.datafirefly.com/es/documentation/ai-size-fit-advisor/index.md), [de](https://www.datafirefly.com/de/documentation/ai-size-fit-advisor/index.md), [it](https://www.datafirefly.com/it/documentation/ai-size-fit-advisor/index.md), [pl](https://www.datafirefly.com/pl/documentation/ai-size-fit-advisor/index.md), [pt](https://www.datafirefly.com/pt/documentation/ai-size-fit-advisor/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

AI Size & Fit Advisor adviseert de juiste maat op basis van lengte en gewicht van de klant, of van zijn met een meetlint gemeten maten. Deze handleiding behandelt installatie, configuratie, maattabellen, de klantroute, de opvolging van retouren en de optionele AI-laag. Ze beschrijft versie 1.2.0.

## Installatie en update

1. Download het modulearchief vanuit uw DataFirefly-account.
2. PrestaShop-back-office, **Modules**, **Een module uploaden**: verstuur de ZIP.
3. De module maakt haar tabellen aan, registreert haar hooks en voegt het tabblad **Catalogus > Maattabellen** toe.
4. Leeg de cache via **Geavanceerde instellingen > Prestaties**.

Voor een update vanaf 1.0 installeert u het nieuwe archief over het oude. De updatescripts maken de nieuwe tabellen aan, zetten de koppeling van elke bestaande maattabel over en registreren de nieuwe hooks.

Compatibel met PrestaShop 8.0 tot 9.x, PHP 7.2.5+ (PS8) en 8.1+ (PS9). Geen override, geen externe afhankelijkheden. Inbegrepen vertalingen: Frans, Engels, Spaans, Duits, Italiaans, Nederlands, Pools, Portugees.

## Configuratie

Open **Modules > AI Size & Fit Advisor > Configureren**. De pagina toont het prestatiepaneel en twee blokken instellingen.

### Prestatiepaneel

Het vat de laatste 30 dagen samen: aanbevelingen en klanten, bestellingen na een aanbeveling, aandeel bestellingen in de aanbevolen maat, retourpercentage in de aanbevolen en in een andere maat, aandeel aanbevelingen alleen op basis van lengte en gewicht, aandeel AI-antwoorden en meest geadviseerde producten.

### Maatadvies

- **Weergavehook**: `displayProductActions` (naast de winkelwagenknop), `displayProductAdditionalInfo`, of de eigen hook `displayDfSizeFit`, die u overal in het producttemplate plaatst met `{hook h='displayDfSizeFit' product=$product}`.
- **Knoptekst**: één per taal. Laat leeg voor "Vind mijn maat".
- **Knopstijl**: omlijnd, gevuld of tekstlink. **Accentkleur**: voor de knop, de aanbevolen maat en de actieve keuzes.
- **Eenheid van uw maattabellen**: centimeter of inch. Klanten kunnen in het maatadvies toch wisselen tussen cm/kg en in/lb.
- **Pasvormvoorkeur vragen**: voegt de keuze nauwsluitend, normaal of ruim toe.
- **Klantprofiel onthouden**: vult het maatadvies vooraf in en toont bij latere bezoeken "Uw maat: M" op de productpagina. Opgeslagen in de browser en, na inloggen, in het klantaccount.
- **Tabblad maattabel tonen** en **Knop om de aanbevolen maat te selecteren**.
- **Aanbevelingen opslaan (statistieken)**: nodig voor het prestatiepaneel en de opvolging van retouren.

### AI-laag

- **AI-laag inschakelen**: uitgeschakeld gebeurt er geen externe oproep.
- **AI-aanbieder**: Mistral, OpenAI of Anthropic. **Model**: bijvoorbeeld `mistral-small-latest`, `gpt-4o-mini` of `claude-haiku-4-5`.
- **API-sleutel**: verborgen veld, opgeslagen op de server. Laat leeg om de opgeslagen sleutel te behouden.
- **AI-aanroepen per bezoeker per uur**: daarboven antwoordt alleen de deterministische engine. 0 heft de limiet op.
- **Opslaan en verbinding testen**: controleert sleutel en model en toont zo nodig de fout van de aanbieder.

Antwoordt de AI niet, duurt het te lang of stelt ze een maat voor die niet in de tabel staat, dan wordt haar antwoord genegeerd en antwoordt de deterministische engine. Er is altijd een aanbeveling beschikbaar.

## Een maattabel maken

Open **Catalogus > Maattabellen > Nieuw**.

### Beginnen met een sjabloon

Zes sjablonen vullen de tabel en het geslacht in: dameskleding (bovenwijdte, taille, heupen), herentops (borst, taille), herenjeans (taille), schoenen EU (voetlengte), kinderen op lengte, hoeden (hoofdomtrek). Pas daarna de waarden aan uw merk aan. Werkt uw winkel in inch, dan worden de sjablonen omgerekend.

### Geldt voor

- **Alle producten**: standaardtabel.
- **Categorieën**: vink een of meer categorieën aan in de boom.
- **Merken**: selecteer een of meer merken.
- **Producten**: zoek producten op naam, referentie of ID.

Passen meerdere tabellen bij een product, dan kiest de module in deze volgorde: de tabel van het product, die van zijn merk, die van zijn categorie (eerst de standaardcategorie, dan de diepste) en ten slotte de tabel "Alle producten".

### Geslacht en pasvorm van het model

- **Dames** of **Heren**: de module schat de maten voor dat lichaamstype.
- **Alle** of **Unisex**: de klant kiest "Dames" of "Heren" in het maatadvies.
- **Kinderen**: geen schatting volgens lichaamstype. Gebruik een kolom lengte of gewicht.

De **pasvorm van het model** geeft aan of het artikel normaal, klein of groot valt. De engine verschuift de aanbeveling dan met ongeveer 3,5% en de klant leest "Dit model valt klein: het advies houdt daar rekening mee".

### De tabel

- Voeg een kolom per maat toe: borstomvang, bovenwijdte, tailleomvang, heupomvang, schouderbreedte, mouwlengte, binnenbeenlengte, halsomvang, dijomvang, voetlengte, hoofdomtrek, lichaamslengte of gewicht.
- Voeg een rij per maat toe (S, M, L, 38, 40...) en vul in elke cel een bereik minimum / maximum in.
- Vul lichaamsmaten in, geen kledingmaten.

Een bereik waarvan het minimum boven het maximum ligt, wordt rood gemarkeerd en bij het opslaan omgedraaid. Vermijd gaten tussen twee opeenvolgende maten.

### De tabel testen

Onder de tabel voert het blok **Deze tabel testen** de echte engine uit op de tabel die u bewerkt, ook vóór het opslaan. Vul geslacht, lengte en gewicht in: u krijgt de aanbevolen maat, de overeenkomstscore, de naburige maat en de geschatte maten (gemarkeerd met een sterretje).

In de lijst met tabellen maakt de actie **Dupliceren** een uitgeschakelde kopie met dezelfde koppelingen, om een tabel per merk of pasvorm af te leiden.

## De klantroute

Op de productpagina opent de knop "Vind mijn maat" een venster met twee tabbladen, "Mijn maat" en "Maattabel". Op mobiel opent het als paneel vanaf de onderkant van het scherm.

### Lengte en gewicht

Standaardroute. De klant geeft lengte, gewicht, postuur (slank, gemiddeld of fors) en, bij een unisex-tabel, of hij voor dames of heren koopt. Een meetlint is niet nodig.

### Mijn maten

De klant vult zijn met een meetlint gemeten maten in. Een silhouet markeert de huidige maat en toont de bijbehorende instructie. Lengte en gewicht blijven optioneel: ze vullen de lege maten aan.

### Het resultaat

De klant ziet de aanbevolen maat, de overeenkomstscore, de naburige maat om te overwegen, een uitleg en het overzicht per maat (past goed, nauwsluitend of ruim, met de vermelding "geschat" als de waarde uit lengte en gewicht komt). De knop "Maat M kiezen" selecteert de overeenkomende combinatie op de productpagina. Het tabblad "Maattabel" toont de tabel met de aanbevolen maat gemarkeerd, in de eenheid die de klant koos.

### Onthouden profiel

Bij latere bezoeken toont de knop op de productpagina meteen "Uw maat: M". De link "Mijn maten vergeten" wist het profiel uit de browser en het klantaccount.

## Hoe de maat wordt berekend

1. **Schatting**: zonder meetlintwaarden worden de omtrekken (bovenwijdte, borst, taille, heupen, hals, dij) geschat met een regressie op de body-mass-index per geslacht, bijgesteld volgens postuur. Lengtematen zijn evenredig met de lichaamslengte.
2. **Vergelijking**: elke maat krijgt een score volgens de afstand van de maten tot het midden van elk bereik, met een straf buiten het bereik. Gewenste pasvorm en pasvorm van het model verschuiven de maten vóór de vergelijking.
3. **Overeenkomst**: per maat berekend en verlaagd als waarden geschat zijn.
4. **Naburige maat**: de maat net erboven of eronder in de tabel, aan de kant waar het lichaam van de klant zit.
5. **AI (optioneel)**: de aanbieder bevestigt of corrigeert de maat en schrijft de uitleg in de taal van de klant.

## Voorraad, bestellingen en retouren

Bij actief voorraadbeheer controleert de module de combinaties waarvan de naam overeenkomt met de maten uit de tabel. Is de aanbevolen maat in alle combinaties uitverkocht, dan ziet de klant "Maat M is momenteel uitverkocht", stelt de knop de naburige maat voor als die beschikbaar is en toont de productpagina "Uw maat: M (uitverkocht)".

Bij de bevestiging van een bestelling wordt de laatste aanbeveling van de klant (30 dagen) voor elk product gekoppeld aan de bestelling, met de werkelijk bestelde maat. Door de klant aangevraagde productretouren en in de back-office aangemaakte creditnota's markeren de aanbeveling daarna als geretourneerd. Zo ontstaat het retourpercentage in het prestatiepaneel.

## AVG en gegevens

- Profielen en aanbevelingen worden in uw winkel opgeslagen.
- Met de module psgdpr omvatten export en verwijdering van klantgegevens ook profiel en aanbevelingen.
- Met de AI-laag gaan alleen de maten die nodig zijn voor de berekening naar de aanbieder, zonder naam of e-mail.

## FAQ en probleemoplossing

**De knop verschijnt niet op de productpagina.** Controleer of een actieve tabel voor het product geldt en of de gekozen hook in uw thema aanwezig is. Bij `displayDfSizeFit` voegt u de hook-oproep toe aan het producttemplate.

**De knop "Maat kiezen" verschijnt niet.** De naam van de attribuutwaarde moet overeenkomen met de maat in de tabel (bijvoorbeeld "M" aan beide kanten).

**Het maatadvies vraagt meer maten.** In de modus "Mijn maten" is minstens één maat nodig die overeenkomt met de kolommen van de tabel. In de modus "Lengte en gewicht" zijn lengte, gewicht en geslacht vereist.

**Het retourpercentage blijft leeg.** Schakel "Aanbevelingen opslaan" in. Het percentage verschijnt na de eerste bestellingen die aan een aanbeveling gekoppeld zijn.

**De AI antwoordt niet.** Gebruik "Opslaan en verbinding testen" om de fout van de aanbieder te lezen. Intussen antwoordt de deterministische engine.