# Module Sticky Winkelwagen & Cross-sell met AI: installatie en configuratie

> De module Sticky Winkelwagen & Cross-sell met AI voor PrestaShop 8 en 9 installeren en instellen: Ajax-paneel, eigen aanbevelingsmotor, balk voor gratis verzending en optionele AI-laag.

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

## Overzicht

De module **Sticky Winkelwagen & Cross-sell met AI** (`dfstickycart`) voegt aan uw PrestaShop-winkel een zijpaneel met de winkelwagen toe, dat bij elke toevoeging via Ajax opent zonder de pagina te herladen. Het toont de inhoud van de winkelwagen, een voortgangsbalk voor gratis verzending en een blok met kruisverkoopvoorstellen die uit uw werkelijke bestellingen worden berekend, met een optionele AI-laag.

De aanbevelingsmotor draait volledig op uw eigen server: de module werkt zonder enige API-sleutel. De AI is alleen een optionele laag die de volgorde bijstelt.

## Compatibiliteit

- PrestaShop 8.0 tot 9.x
- Eén winkel en multistore
- 5 talen: FR, EN, ES, DE en IT
- Geen enkele afhankelijkheid (geen Composer, geen framework)

## Installatie

1. Open in de backoffice **Modules > Modulebeheer**.
2. Klik op **Een module installeren** en kies het bestand `dfstickycart.zip`.
3. Klik na de installatie op **Configureren**.

De module registreert zijn hooks automatisch (`actionFrontControllerSetMedia`, `displayHeader` en `displayFooter`) en maakt bij de installatie zijn cachetabel aan. Bij het verwijderen verdwijnt die tabel.

## Configuratie

### Algemeen

- **De module inschakelen**: toont of verbergt het paneel en de zwevende knop.
- **Positie van het paneel**: rechts of links op het scherm.
- **Automatisch openen**: opent het paneel bij elke toevoeging aan de winkelwagen.
- **Zwevende knop**: toont een blijvende winkelwagenknop met de artikelteller.
- **Hoofdkleur**: de accentkleur van het paneel, de knoppen en de balk.

### Aanbevelingen

- **De aanbevelingen inschakelen**: toont het kruisverkoopblok in het paneel.
- **Aantal producten**: het aantal getoonde voorstellen (standaard 3).
- **Strategie**: _Auto_ (alleen de eigen motor) of _AI_ (herschikking door kunstmatige intelligentie).
- **Bericht bij een lege winkelwagen**: de tekst wanneer de winkelwagen nog geen artikel bevat.

### Gratis verzending

Vul de **drempel voor gratis verzending** in de standaardvaluta in. De voortgangsbalk toont automatisch het resterende bedrag (« Nog X € voor gratis verzending ») en rekent dat om naar de actieve valuta van de klant. Vul 0 in om de balk te verbergen.

### Kunstmatige intelligentie (optioneel)

- **Aanbieder**: standaard Mistral, of elke dienst die met OpenAI samengaat.
- **Endpoint**: de URL van de completion-API (standaard het chat-endpoint van Mistral).
- **Model**: de naam van het model (bijvoorbeeld een licht Mistral-model).
- **API-sleutel**: uw sleutel. Die wordt nooit opnieuw getoond en blijft bewaard als u het veld bij een update leeg laat.

Ontbreekt de sleutel of antwoordt de API niet, dan valt de module stilzwijgend terug op zijn eigen motor. Een AI-fout blokkeert het paneel dus nooit.

## Werking van de aanbevelingsmotor

De voorstellen komen uit een productpool die op drie bronnen steunt, in volgorde van voorrang:

1. **Samen gekocht (market-basket)**: producten die werkelijk samen met die in de winkelwagen zijn besteld, op basis van de geldige bestellingen (het zwaarste gewicht).
2. **Categorieaffiniteit**: producten uit dezelfde categorieën als die in de winkelwagen.
3. **Bestsellers**: de terugval wanneer de historiek te dun is.

Het resultaat komt per samenstelling van de winkelwagen in de cache, gedurende een instelbare tijd, om het rekenwerk te beperken. Staat de strategie op _AI_, dan herschikt de AI-laag die pool en schrijft zij bij elk product een korte, persoonlijke reden.

## Prestaties

De inhoud van het paneel wordt pas bij het openen via Ajax geladen: zolang de klant de winkelwagen niet opent, vertrekt er geen enkel extra verzoek. De aanbevelingen in de cache voorkomen dat de motor bij elke weergave opnieuw moet rekenen.

## FAQ en probleemoplossing

### Het paneel opent niet

Controleer of de module aanstaat, leeg de PrestaShop-cache (**Geavanceerde parameters > Prestaties**) en ga na of het thema jQuery aan de frontzijde wel laadt.

### Er verschijnt geen enkele aanbeveling

Bij een jonge winkel zonder bestelhistoriek steunt de motor op de categorieaffiniteit en daarna op de bestsellers. Zorg dat er actieve, zichtbare producten in de catalogus staan.

### De AI-voorstellen veranderen niet

De resultaten komen per samenstelling van de winkelwagen in de cache. Verlaag de cacheduur tijdens uw tests, of wijzig de winkelwagen om een nieuwe cachesleutel te krijgen.