# Producten Groeperen als Varianten in PrestaShop: Moduledocumentatie (dfproductlinker)

> De module DF ProductLinker (dfproductlinker) koppelt afzonderlijke productpagina's zodat ze als één artikel verschijnen met een keuze op kleur, maat of een ander attribuut. Elke variant blijft een volledig product…

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

De module **DF ProductLinker** (dfproductlinker) koppelt afzonderlijke productpagina's zodat ze als één artikel verschijnen met een keuze op kleur, maat of een ander attribuut. Elke variant blijft een volledig product met een eigen URL. Het is de omgekeerde beweging van [DF ProductSplitter](https://www.datafirefly.com/nl/product/separer-declinaisons-en-produits-prestashop/), dat een product met combinaties opsplitst in afzonderlijke producten.

## Installatie

1. Download de ZIP uit uw DataFirefly-klantaccount.
2. Ga in de backoffice naar _Modules > Modulebeheer > Een module uploaden_ en upload de ZIP.
3. Bij de installatie maakt de module haar tabellen aan en het tabblad _Catalogus > Gekoppelde varianten_.
4. Open de moduleconfiguratie om de positie van de keuze te controleren.

De module werkt op PrestaShop 8.0 tot 9.x met dezelfde ZIP, in multistore en meertalige installaties. De teksten worden geleverd in het Frans, Engels, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.

Bij een update leegt de module de Smarty-cache. Staat uw winkel op _Templates nooit opnieuw compileren_ en verandert de weergave niet, leeg dan de cache via _Geavanceerde instellingen > Prestaties_.

## Principe: groepen en assen

Een **groep** brengt meerdere producten samen. Een **as** is een standaard attribuutgroep van PrestaShop, bijvoorbeeld Kleur of Maat: waarden, hex-kleuren, texturen en vertalingen uit _Catalogus > Attributen en kenmerken_ worden ongewijzigd hergebruikt. Elk product van de groep krijgt een waarde op elke as.

Een product kan maar bij één groep horen. De producten zelf worden niet gewijzigd: de groep wordt in de tabellen van de module opgeslagen.

## Een groep aanmaken

Ga naar _Catalogus > Gekoppelde varianten_ en daarna _Groep toevoegen_.

1. Vul de **groepsnaam** in. Die dient intern en als reservenaam in de gestructureerde gegevens.
2. Klik onder **Assen** op _As toevoegen_. De module stelt eerst een attribuutgroep van het type kleur voor. Kies per as de **weergave** (automatisch, kleurstaal, productfoto, tekstknop, keuzelijst) en de **eigenschap in gestructureerde gegevens** (kleur, maat, materiaal, patroon of niet opgegeven).
3. Zoek onder **Producten van de groep** op naam, referentie of ID. Met de pijltjestoetsen en Enter kiest u een resultaat. Producten die al in een andere groep zitten, zijn grijs.
4. Controleer per product de waarde van elke as. Die wordt vooraf ingevuld als ze in de productnaam voorkomt. Een ontbrekende waarde wordt oranje gemarkeerd, en de statusregel onder de tabel toont hoeveel producten het betreft of dat twee producten dezelfde waarden hebben.
5. Sla op. De module waarschuwt u als u de pagina verlaat met niet-opgeslagen wijzigingen.

De volgorde van de groepsregels is de volgorde van de stalen in de winkel. De knop _Sorteren op attribuutvolgorde_ zet de regels in de volgorde uit de catalogus, handig voor maten S, M, L, XL.

## Wat de klant ziet

Op elke pagina van de groep toont de keuze de naam van de as en de huidige waarde, bijvoorbeeld _Kleur: Rood_, en daarna de beschikbare waarden. Bij hover toont het label de aangewezen waarde. De huidige waarde is omrand; de andere linken naar de bijbehorende pagina.

- Met meerdere assen opent een klik op een kleur het product met de huidige maat. Bestaat die combinatie niet, dan opent de module de dichtstbijzijnde variant, bij voorkeur een product op voorraad, en krijgt de staal een gestippelde rand.
- Een variant zonder voorraad wordt vervaagd en doorgestreept, of verborgen afhankelijk van de instelling.
- Een kleurwaarde zonder hexcode of textuur wordt als tekst in een langwerpige staal getoond.
- De keuze verschijnt ook in de quick view van categoriepagina's, boven de winkelwagenknop.

## Instellingen van de module

- **Positie van de keuze**: vóór het standaard variantenblok (aanbevolen), erna, in de hook `displayProductAdditionalInfo` of alleen in de thema-hook `displayDfProductLinker`.
- **CSS-selector van het standaard variantenblok**: standaard `.product-variants, .product__variants`. Komt niets overeen in uw thema, dan blijft de keuze in de hook.
- **Aslabel**, **prijs van elke variant** (modi afbeelding en knop), **afbeeldingsformaat** van de miniaturen.
- **Varianten zonder voorraad**: vervaagd of verborgen.
- **Accentkleur**, **vorm** (rond of vierkant met afgeronde hoeken) en **formaat** van de stalen. Het middelste formaat geeft een aanraakzone van 44 px, aanbevolen op mobiel.
- **Stalen in productoverzichten**, maximaal aantal stalen en **wisselende afbeelding bij hover**.
- **Eén product per groep**, zichtbaarheid van de andere producten en getoond product: zie de volgende sectie.
- **Canonieke URL van de varianten** en **gestructureerde gegevens ProductGroup**: zie de sectie SEO.

Voor een eigen plaatsing kiest u de positie _thema-hook_ en voegt u deze regel toe aan het productsjabloon van uw thema: `{hook h='displayDfProductLinker' product=$product}`.

## Eén product per groep in categorieën

Deze optie toont in categorieoverzichten één kaart per groep. De andere producten van de groep krijgen de zichtbaarheid _Alleen zoeken_ (of _Nergens_, afhankelijk van de instelling): hun pagina's blijven online met hun URL en de stalen van de kaart linken ernaar.

- **Getoond product**: het eerste van de groep of het eerste op voorraad. In het tweede geval wordt het bij elke voorraadwijziging opnieuw berekend.
- De oorspronkelijke zichtbaarheid van elk product wordt bewaard. Ze wordt hersteld wanneer u de optie of de groep uitschakelt, een product uit zijn groep haalt of de module verwijdert.
- Wijzigt u met de hand de zichtbaarheid van een verborgen product, dan wordt uw waarde de nieuwe oorspronkelijke waarde.
- De knop _Zichtbaarheid opnieuw synchroniseren_ in de configuratie past de regel opnieuw toe op alle groepen. Gebruik die als een medewerker zonder rechten op de module producten heeft bewerkt, want PrestaShop voert dan de hooks van de module niet uit.

Controleer voor het inschakelen of uw sitemapgenerator producten met zichtbaarheid _Alleen zoeken_ opneemt; anders vallen de verborgen varianten uit de sitemap.

## SEO: gestructureerde gegevens en canonieke URL

De module voegt op elke pagina van de groep een JSON-LD-blok `ProductGroup` toe met `hasVariant` en `variesBy`. Elke variant staat erin met naam, URL, referentie, geldige EAN13, afbeelding, waarde op elke as, de prijs die de klant ziet en de beschikbaarheid. De groepsnaam komt uit de productnaam zonder de waarden, in de taal van de bezoeker. Schakel de optie uit als een andere module dit blok al genereert.

Standaard behoudt elke variant een canonieke URL naar zichzelf: elke kleur wordt apart geïndexeerd. Zijn uw kleurpagina's vrijwel identiek, dan laat de optie _Canoniek naar het hoofdproduct van de groep_ de canonical van alle varianten naar het hoofdproduct wijzen. Dat is het product dat in overzichten wordt getoond als de optie één product per groep actief is, anders het eerste actieve product van de groep.

## Automatische groeperingsassistent

Klik in de lijst met groepen op _Assistent voor automatisch groeperen_. Die vindt producten die hetzelfde artikel zijn in meerdere kleuren of maten.

1. Kies een categorie of de hele catalogus.
2. Vink de te herkennen attribuutgroepen aan, bijvoorbeeld Kleur en Maat. De waarden moeten als attribuutwaarden bestaan en in de productnaam voorkomen.
3. Kies de regel: identieke namen zodra de waarden zijn verwijderd, of referenties met dezelfde stam (TSH01-RED en TSH01-BLUE).
4. Klik op _Voorbeeld_, vink de groepen uit die u niet wilt, en daarna _Geselecteerde groepen aanmaken_.

Producten die al in een groep zitten, worden overgeslagen; de analyse omvat 5.000 producten per keer.

## CSV-import en -export

De knop _CSV-import / -export_ opent de bijbehorende pagina. De export schrijft één regel per product, in hetzelfde formaat als de import. Kolommen:

```
group_id;group_name;group_active;axes;product_id;product_reference;product_name;values
;T-shirt Basic;1;Kleur|Maat;;TSH01-NAVY-M;;Kleur:Marineblauw|Maat:M
```

- Een groep wordt herkend aan `group_id`, anders aan de exacte naam. Elke groep in het bestand wordt vervangen door haar regels; groepen die niet in het bestand staan, blijven ongewijzigd.
- Een product wordt gevonden via `product_id`, anders via `product_reference`, die uniek moet zijn in de catalogus. `product_name` is informatief.
- `values` bevat paren As:Waarde gescheiden door `|`, met de namen van attribuutgroepen en waarden in elke taal van de winkel.
- Het scheidingsteken `;` of `,` wordt automatisch herkend. UTF-8-bestand, maximaal 5 MB.

De import verloopt in twee stappen: _Bestand analyseren_ toont de aangemaakte of vervangen groepen, de attribuutwaarden die worden aangemaakt en elke afgewezen regel met reden; _Import starten_ voert hem daarna uit. Twee opties: _Producten verplaatsen die al bij een andere groep horen_ en _Ontbrekende attribuutwaarden aanmaken_ (hun kleur blijft leeg, aan te vullen in de catalogus).

## Productpagina in de backoffice

In het tabblad Modules van de productpagina toont het paneel DF ProductLinker de groep van het product en de waarde van elk product van de groep, met een link om de groep te bewerken. Hoort het product bij geen enkele groep, dan maakt een link een groep aan vanuit dit product.

## Veelgestelde vragen

### De keuze verschijnt niet op een pagina

Controleer of de groep actief is, of de pagina bij de groep hoort, of minstens twee producten van de groep actief zijn en of minstens één as twee verschillende waarden heeft. Hebt u de positie thema-hook gekozen, dan moet de hook `displayDfProductLinker` in het productsjabloon staan.

### De keuze verschijnt onder de winkelwagenknop

De CSS-selector van het standaard variantenblok komt met geen enkel element van uw thema overeen. Vul de klasse van het variantenblok van uw thema in de configuratie in.

### Er verschijnen geen stalen in de overzichten

De optie moet actief zijn en de eerste as van de groep moet als kleurstaal of fotominiatuur worden weergegeven. Uw thema moet de standaard hook `displayProductListReviews` aanroepen in de productminiatuur, zoals het thema Classic doet.

### Kan ik de module combineren met standaard combinaties?

Ja. Een veelvoorkomend geval: één product per kleur, elk met maatcombinaties. De keuze van de module regelt de kleuren, het standaard blok regelt de maten.
