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 met een eigen URL. Het is de omgekeerde beweging van DF ProductSplitter, 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.

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.

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.