# Knop In Winkelwagen Vervangen in PrestaShop Productlijsten: installatie en instellingen

> Overzicht De module vervangt de knop In winkelwagen in productminiaturen (categoriepagina's, zoekresultaten, homepage, carrousels, gerelateerde producten) door een knop die naar de productpagina leidt. Daar kiest de klant het gewicht,…

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

## Overzicht

De module vervangt de knop **In winkelwagen** in productminiaturen (categoriepagina's, zoekresultaten, homepage, carrousels, gerelateerde producten) door een knop die naar de productpagina leidt. Daar kiest de klant het gewicht, de maat of het formaat voordat hij het product toevoegt. U stelt regels in: welke producten het betreft, welke tekst de knop toont en of de laagste combinatieprijs met „Vanaf” wordt getoond.

## Installatie

1. Klik in **Modules > Modulebeheer** op **Een module uploaden** en stuur het bestand `dflistingbutton-1.0.0.zip`.
2. De module maakt de tabellen `ps_dflb_rule`, `ps_dflb_rule_lang`, `ps_dflb_rule_shop`, `ps_dflb_rule_category` en `ps_dflb_rule_product` aan en voegt het menu **Catalogus > Knoppen in productlijsten** toe.
3. Er wordt een uitgeschakelde voorbeeldregel aangemaakt: „Voorbeeld: alle producten met combinaties”. U kunt hem zo inschakelen of verwijderen.
4. Open na het aanmaken of inschakelen van een regel een categoriepagina van de winkel. Verschijnt de knop niet, leeg dan de cache in **Geavanceerde instellingen > Prestaties**.

## Een regel aanmaken

Klik in **Catalogus > Knoppen in productlijsten** op **Regel toevoegen**. Het formulier heeft drie blokken.

### Regel en doelgroep

- **Naam van de regel**: interne naam, niet zichtbaar voor klanten.
- **Actief**: een uitgeschakelde regel wordt genegeerd.
- **Prioriteit**: als meerdere regels op een product van toepassing zijn, wint de regel met het laagste getal. Standaardwaarde: 10.
- **Van toepassing op**: _Alle producten_, _Categorieën_ of _Specifieke producten_.
- **Categorieën**: boom met selectievakjes en een filterveld. Voor dit type regel is minstens één categorie verplicht.
- **Subcategorieën meenemen**: producten van alle subcategorieën van de aangevinkte categorieën vallen er ook onder.
- **Categorie-overeenkomst**: _Product zit in een van de categorieën_ (alle categorieën van het product tellen) of _Alleen de standaardcategorie van het product_.
- **Producten**: voor het type _Specifieke producten_, zoeken op naam, referentie of ID.
- **Voorwaarde**: _Geen voorwaarde_, _Producten met combinaties_ of _Producten met een attribuutgroep_. Met _Producten met combinaties_ houden eenvoudige producten in dezelfde categorie hun knop In winkelwagen.
- **Attribuutgroep**: voor de laatste voorwaarde, bijvoorbeeld Gewicht of Maat. Alleen producten met een combinatie uit deze groep vallen eronder.
- **Uitgesloten producten**: deze producten krijgen nooit de knop van deze regel, wat de doelgroep ook is.
- **Winkelkoppeling**: kies in multistore de winkels waar de regel geldt.

### Knop

- **Knoptekst**: één tekst per taal, bijvoorbeeld „Bekijk alle gewichten”. Een lege taal neemt de eerst ingevoerde tekst over.
- **Stijl**: _Primaire knop van het thema_ (klassen `btn btn-primary`), _Omlijnde knop van het thema_ (`btn btn-outline-primary`) of _Eigen kleuren_, met achtergrondkleur, tekstkleur en voorbeeld.
- **Pictogram**: pijl, opties, weegschaal, oog of geen.
- **Volledige breedte**: de knop beslaat de volle breedte van de miniatuur.
- **Extra CSS-klassen**: toegevoegd aan de knop, handig om een klasse van uw thema te hergebruiken.
- **Aantalkiezer verbergen**: verbergt het aantalveld dat sommige thema's in productlijsten tonen.

### Prijs in productlijsten

Dit blok geldt alleen voor producten met minstens twee combinaties.

- **Laagste combinatieprijs tonen**: PrestaShop berekent de prijs van elke combinatie (btw, klantgroep, specifieke prijzen en kortingen inbegrepen). Wijkt de laagste af van de prijs die het thema toont, dan vervangt hij die, en worden de doorgestreepte oude prijs en het kortingslabel van de miniatuur verborgen.
- **Voorvoegsel Vanaf toevoegen**: verschijnt alleen vóór de prijs als de combinatieprijzen verschillen en de getoonde prijs de laagste is. Als u de vorige optie uitschakelt en de standaardcombinatie niet de goedkoopste is, wordt het voorvoegsel niet getoond, zodat er geen verkeerde prijs wordt aangekondigd.
- **Tekst van het voorvoegsel**: één tekst per taal („Vanaf”, „From”, „Desde” enz.).

## Voorbeeld: kaas en vleeswaren per gewicht

1. Naam: _Kaas per gewicht_. Van toepassing op: _Categorieën_. Vink _Kaas en vleeswaren_ aan en houd _Subcategorieën meenemen_ aan.
2. Voorwaarde: _Producten met een attribuutgroep_, groep _Gewicht_.
3. Knoptekst: „Bekijk alle gewichten” in het Nederlands, „Ver todas las opciones de peso” in het Spaans.
4. Houd _Laagste combinatieprijs tonen_ en _Vanaf_ ingeschakeld en sla op.

In de categorie toont elke kaas per 250 g, 500 g en 1 kg „Vanaf” met de prijs van 250 g en de knop naar de productpagina. Een product dat per stuk wordt verkocht, zonder gewichtscombinatie, houdt zijn knop In winkelwagen.

## Algemene instellingen

De configuratiepagina van de module (knop **Instellingen** boven de lijst met regels) bevat:

- **Module inschakelen**: schakelt alle regels uit zonder ze te verwijderen.
- **Themadetectie**: _Automatisch_ (aanbevolen), _Altijd de AJAX-opvraging gebruiken_ of _Alleen hooks_. Zie de volgende sectie.
- **Ook de standaard link In winkelwagen uitschakelen**: maakt aan de serverkant de winkelwagen-URL van de betrokken producten leeg, via de hook `actionPresentProductListing`. Sommige thema's tonen dan een eigen link „Product bekijken”: krijgt u twee knoppen, laat deze optie dan uit.
- **Knop Snel bekijken verbergen**: alleen bij de betrokken producten.
- **Uitverkochte combinaties negeren voor de laagste prijs**: geldt als voorraadbeheer actief is en het product geen bestellingen zonder voorraad accepteert. Zijn alle combinaties uitverkocht, dan tellen ze allemaal mee.

## Compatibiliteit met uw thema

### Hoe de module producten herkent

Tijdens het tonen van een miniatuur draait de module in de hooks `displayProductPriceBlock` en `displayProductListReviews`, die het thema Classic, Hummingbird en de meeste thema's aanroepen. Voor elk betrokken product schrijft hij een onzichtbare markering. Het script van de module zoekt de miniatuur met de markering, verbergt de winkelwagenknop, het winkelwagenformulier eromheen en de aantalkiezer, en plaatst de nieuwe knop waar de verborgen knop stond.

Toont het thema geen winkelwagenknop in productlijsten (zoals het thema Classic), dan komt de knop direct na het prijsblok.

In de modus _Automatisch_ stuurt het script, als geen enkele miniatuur op de pagina deze hooks heeft geactiveerd, de ID's van de zichtbare producten naar de controller van de module, die de betrokken producten terugstuurt (maximaal 60 producten per verzoek, alleen actieve en zichtbare producten). Miniaturen die na een facetfilter, een sortering of oneindig scrollen verschijnen, worden automatisch verwerkt.

### CSS-selectors

Het blok **Themacompatibiliteit (CSS-selectors)** in de configuratie bevat de selectors van het script:

- **Container van de productminiatuur**: blok dat één product omvat (`.product-miniature`, `.ajax_block_product` enz.).
- **Knop In winkelwagen**: vervangen elementen (`.add-to-cart`, `[data-button-action="add-to-cart"]` enz.).
- **Aantalkiezer**, **Prijs**, **Oude prijs en korting**, **Invoegpunt**, **Knop Snel bekijken**.

Voeg de klassen van uw thema toe aan de lijst, gescheiden door komma's. De knop **Standaardselectors herstellen** zet de oorspronkelijke waarden terug.

### De stijl aanpassen

De knop heeft de klasse `.dflb-btn`, plus `.dflb-full` bij volledige breedte en `.dflb-style-custom` bij eigen kleuren (variabelen `--dflb-bg` en `--dflb-color`). Het prijsvoorvoegsel heeft de klasse `.dflb-from`, en de verwerkte miniatuur krijgt `.dflb-has-btn`.

Test bij een sterk aangepast thema op een kopie van de winkel: categoriepagina, zoekresultaten, homepage en facetfilters.

## Wat de module niet wijzigt

- het hoofdproduct van de productpagina en de snelle weergave ervan;
- de winkelwagen, het afrekenproces en het klantaccount;
- bestanden van de kern en het thema (geen override, geen gewijzigde templates).

## Bekende beperkingen

- De module wijzigt de weergave van productlijsten. Hij blokkeert geen toevoeging aan de winkelwagen via een andere weg (directe link, module van derden).
- De laagste prijs en het voorvoegsel worden in de browser toegepast. De oorspronkelijke HTML en de gestructureerde gegevens van het thema behouden de prijs van de standaardcombinatie.
- Boven 150 combinaties van één product worden alleen de eerste 150 gebruikt voor de laagste prijs.