# Varianten Opsplitsen in Aparte Producten: volledige gids

> Installatie Plaats de map dfproductsplitter in de map /modules van uw winkel en installeer de module vervolgens vanuit Modules en Diensten in de back-office. U kunt ook direct het meegeleverde…

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

## Installatie

Plaats de map `dfproductsplitter` in de map `/modules` van uw winkel en installeer de module vervolgens vanuit Modules en Diensten in de back-office. U kunt ook direct het meegeleverde ZIP-archief uploaden.

Bij de installatie maakt de module twee tabellen aan, `PREFIX_df_split_job` en `PREFIX_df_split_item`, en voegt ze een tabblad Product Splitter toe onder het menu Catalogus. Er wordt geen klasse- of controllereoverride geplaatst, en er is geen Composer-afhankelijkheid vereist.

De module is compatibel met PrestaShop 8.0 tot 9.x en PHP 7.4 tot 8.4. De tabel- en constantenamen die tussen PrestaShop 8 en 9 verschillen, worden bij de uitvoering automatisch opgelost.

## De interface openen

Ga naar Catalogus en vervolgens Product Splitter. Het scherm bestaat uit vier blokken: het zoeken van het bronproduct, de opsplitsingsstrategie, de generatieopties, en de geschiedenis van de al uitgevoerde opsplitsingen.

De module werkt altijd binnen de context van de winkel die bovenaan de back-office is geselecteerd. De gelezen prijzen, voorraden en varianten zijn die van deze winkel.

## Het bronproduct kiezen

Voer een naam, referentie of productidentifier in het zoekveld in. Alleen producten met minstens één variant in de huidige winkel verschijnen in de resultaten.

Na selectie van het product toont de module zijn prijs, referentie, het aantal varianten en het aantal gebruikte attribuutgroepen. Een link opent de productpagina in een nieuw tabblad ter controle.

### De opsplitsing beperken tot bepaalde varianten

Vink het vakje Beperken tot bepaalde varianten aan om de volledige combinatietabel te tonen, met hun referentie, prijsimpact en voorraad. Vink de combinaties uit die u niet wilt extraheren. Handig om slechts één kleur uit een assortiment te halen en de rest op het oorspronkelijke product te laten.

## De twee opsplitsingsstrategieën

### Eén product per variant

Elke combinatie wordt een eenvoudig product, zonder enige variant. De prijsimpact en de gewichtsimpact van de combinatie worden overgenomen in de basisprijs en het basisgewicht van het nieuwe product. De referentie, de EAN-code, het ISBN, de UPC, de MPN, de minimumhoeveelheid en de beschikbaarheidsdatum van de combinatie worden overgenomen wanneer ze zijn ingevuld; anders dienen de waarden van het bronproduct als terugval.

Deze modus is geschikt wanneer elke combinatie een eigen commercieel bestaan heeft, bijvoorbeeld een parfum in drie inhoudsmaten of software met drie licentieduren.

### Eén product per waarde van een attribuutgroep

U kiest een te extraheren attribuutgroep, bijvoorbeeld Kleur. De module maakt één product per waarde van die groep aan, en de andere groepen blijven varianten van het nieuwe product. Een product met drie kleuren en vijf maten wordt drie producten met elk vijf varianten.

Als het product slechts één attribuutgroep heeft, valt deze modus automatisch terug op de modus per variant. In de preview wordt dan een waarschuwing getoond.

### Hoe de prijzen identiek blijven

In de groepsmodus houdt de module de laagste prijsimpact aan onder de combinaties van elke geëxtraheerde waarde. Die impact wordt in de basisprijs van het nieuwe product gestort, waarna elke resterende impact door aftrekking wordt herberekend.

Voorbeeld. Een product van 89 euro, in het wit en zwart, met de maten S, M en L. De witte combinaties dragen impacts van 0, 3 en 6 euro. Het product Wit wordt aangemaakt op 89 euro, met impacts van 0, 3 en 6 euro op zijn drie maten. Waren de witte impacts 3, 6 en 9 euro geweest, dan zou het product Wit op 92 euro zijn aangemaakt met impacts van 0, 3 en 6 euro. In beide gevallen blijft de prijs die de klant voor een bepaalde maat betaalt ongewijzigd.

Het gewicht volgt exact dezelfde behandeling.

## Generatieopties

### Naamsjabloon

De naam van de aangemaakte producten wordt opgebouwd vanuit een sjabloon. Drie variabelen zijn beschikbaar: de naam van het bronproduct, de opgenomen attribuutwaarden, en de referentie van het bronproduct. Het standaardsjabloon plakt de bronnaam en de attribuutwaarden aan elkaar, gescheiden door een streepje.

De naam wordt in elke winkeltaal apart gegenereerd, met de vertaalde attribuutwaarden. De tekens die PrestaShop in een productnaam verbiedt, worden automatisch verwijderd en het resultaat wordt afgekapt op 128 tekens.

### Referentiesjabloon

Vier variabelen zijn beschikbaar: de referentie van het bronproduct, de referentie van de combinatie, een slug van de attribuutwaarden, en de identifier van het bronproduct. Als het sjabloon een lege string oplevert, valt de module terug op de referentie van de combinatie en daarna op die van het bronproduct.

### URL-herschrijving

Voor elke taal wordt een URL-herschrijving gegenereerd op basis van de productnaam. De module controleert of ze in de betreffende taal nog niet bestaat en voegt indien nodig een numeriek achtervoegsel toe, wat botsingen en dubbele URL's voorkomt.

### Overgenomen afbeeldingen

Er zijn drie modi. Afbeeldingen van de variant dupliceert bij voorrang de afbeeldingen die aan de verwerkte combinaties zijn gekoppeld, met terugval op alle afbeeldingen van het bronproduct wanneer er geen is gekoppeld. Alle afbeeldingen dupliceert systematisch alle afbeeldingen. Geen afbeelding maakt de producten zonder visual aan.

De duplicatie is fysiek. Het originele bestand en alle al gegenereerde miniaturen worden gekopieerd, ongeacht hun formaat, jpg zowel als webp of avif, en de vertaalde bijschriften worden overgenomen. De eerste afbeelding van elk product wordt zijn omslag.

### Over te nemen gegevens

Tien selectievakjes sturen de overname van de voorraden, categorieën, kenmerken, trefwoorden, specifieke prijzen, vervoerders, bijlagen, leveranciers, personalisatievelden en accessoires van het bronproduct. De eerste negen zijn standaard ingeschakeld.

### Aanvullende verwerkingen

De opgenomen attributen omzetten in kenmerken maakt een kenmerk aan met de publieke naam van de attribuutgroep en een waarde met de naam van het attribuut, en koppelt het geheel aan het gegenereerde product. Als het kenmerk of de waarde al bestaat, worden ze hergebruikt. Praktisch om de kleur als filtercriterium te behouden na de opsplitsing.

De gegenereerde producten onderling koppelen voegt elk aangemaakt product toe als accessoire van alle andere uit dezelfde opsplitsing.

De zoekfunctie herindexeren start aan het einde van de verwerking de PrestaShop-zoekindexering opnieuw voor de aangemaakte producten.

### Status van de aangemaakte producten

Naar keuze: identiek aan het bronproduct, alle actief, of alle uitgeschakeld. De uitgeschakelde modus laat u de productpagina's controleren voordat ze online gaan.

## Previewen vóór het schrijven

De knop Preview berekent het volledige plan zonder iets naar de database te schrijven. U krijgt het aantal producten dat zal worden aangemaakt, en voor elk daarvan de naam, het aantal behouden varianten, en de resulterende prijs exclusief btw en het gewicht.

De knop Opsplitsing starten blijft uitgeschakeld zolang er geen preview is uitgevoerd, en wordt opnieuw uitgeschakeld zodra u een optie wijzigt.

## De opsplitsing uitvoeren

Bij het starten registreert de module een job in de database met de volledige configuratie en de lijst van te genereren producten, en verwerkt ze de items vervolgens in opeenvolgende batches via AJAX. Een voortgangsbalk toont de voortgang en een logboek toont elk aangemaakt product met een directe link naar zijn pagina.

Het veld Producten per batch bepaalt het aantal producten dat per verzoek wordt aangemaakt. De standaardwaarde is vijf.

Verlaag op een gedeelde hosting of bij producten met veel afbeeldingen de batchgrootte naar twee of drie. De verwerking duurt iets langer maar loopt geen risico de PHP-uitvoeringstijdslimiet te bereiken.

## Het lot van het bronproduct

Er zijn vier gedragingen mogelijk, toegepast zodra alle producten zijn gegenereerd.

- Ongewijzigd behouden. Het bronproduct blijft actief en onveranderd. U krijgt tijdelijk duplicaten in de catalogus, wat vergelijken mogelijk maakt voordat u beslist.
- Uitschakelen. Het bronproduct gaat offline maar blijft raadpleegbaar in de back-office.
- Uitschakelen en met een 301 redirecten naar het eerste aangemaakte product. Het bronproduct wordt uitgeschakeld, zijn redirecttype gaat naar permanente redirect naar een product, en het doel is het eerste gegenereerde product. Dit is de aanbevolen optie wanneer de oorspronkelijke URL is geïndexeerd of inkomende links ontvangt.
- Definitief verwijderen. Het bronproduct wordt na de generatie verwijderd. Kies deze optie pas nadat u het resultaat op een eerste testopsplitsing hebt gecontroleerd.

## Geschiedenis en annulering

Elke opsplitsing verschijnt in de geschiedenis met haar identifier, het bronproduct, het aantal verwerkte producten, haar status en haar datum. De knop Detail klapt de lijst met gegenereerde producten uit, met hun individuele status en een link naar elke pagina.

De knop Annuleren verwijdert alle door deze job gegenereerde producten en herstelt vervolgens de actieve of inactieve status en de oorspronkelijke redirect van het bronproduct, zoals die vóór de opsplitsing waren. De job krijgt de status geannuleerd.

Als u ervoor hebt gekozen het bronproduct definitief te verwijderen, verwijdert de annulering wel de gegenereerde producten maar kan ze het oorspronkelijke product niet herstellen. Gebruik deze optie alleen wanneer het resultaat is gevalideerd.

## Wat wordt overgenomen, in detail

### Voorraden

De hoeveelheid van elke variant wordt overgedragen naar het overeenkomstige product of de overeenkomstige variant van het gegenereerde product. Het gedrag bij uitverkocht dat op het bronproduct is ingesteld, wordt overgenomen. De voorraad van het bronproduct wordt niet verlaagd.

### Categorieën

Alle categorieën van het bronproduct worden overgenomen, inclusief de standaardcategorie.

### Kenmerken

De kenmerken worden gekopieerd. De aangepaste, productspecifieke waarden worden gedupliceerd zodat elk gegenereerd product zijn eigen waarde heeft.

### Specifieke prijzen

De specifieke prijzen van het bronproduct worden gekopieerd. Die voor alle varianten worden als zodanig overgenomen. Die voor een specifieke variant worden alleen overgenomen als die variant deel uitmaakt van het gegenereerde product, en gelden dan voor het hele product.

### Leveranciers

De leveranciersregels worden op productniveau overgenomen. Duplicaten tussen varianten van eenzelfde leverancier worden gededupliceerd.

### Multistore

De gegenereerde producten worden aan dezelfde winkels gekoppeld als het bronproduct.

## Bijzondere gevallen en beperkingen

- Productpakketten kunnen niet worden opgesplitst. De module meldt dit vóór elke verwerking.
- Virtuele en downloadbare producten worden normaal verwerkt.
- Bestellingen die op het bronproduct zijn geplaatst, worden niet gewijzigd. Ze blijven verwijzen naar het oorspronkelijke product en de oorspronkelijke variant.
- Klantbeoordelingen die aan het bronproduct zijn gekoppeld, worden niet overgedragen.
- De regel voor canonieke URL's van uw thema kan na een grote opsplitsing een cache-leging vereisen.

## Probleemoplossing

### De verwerking stopt onderweg

Verlaag het aantal producten per batch. Producten met veel afbeeldingen of veel varianten zijn het duurst. De job blijft in de database, maar kan niet vanuit de interface worden hervat: annuleer hem vanuit de geschiedenis om de al aangemaakte producten te verwijderen, en start opnieuw met een kleinere batchgrootte.

### De afbeeldingen worden niet gekopieerd

Controleer de schrijfrechten op de map met productafbeeldingen, `img/p`. De module maakt de benodigde submappen aan maar kan geen beperking van het bestandssysteem omzeilen.

### De prijzen komen niet overeen met wat ik verwachtte

Controleer de preview, die de berekende prijs exclusief btw voor elk product toont. In de groepsmodus komt de basisprijs van een product overeen met de bronprijs verhoogd met de minimale impact van de geëxtraheerde groep voor die waarde, wat niet noodzakelijk de impact van de standaardvariant is.

### Twee producten dragen dezelfde URL-herschrijving

De module controleert de uniciteit bij het aanmaken en voegt bij een botsing een numeriek achtervoegsel toe. Als het conflict achteraf ontstaat, komt het waarschijnlijk van een andere module of een import. Wijzig de herschrijving vanuit het tabblad SEO van de productpagina.

## Deïnstallatie

Het deïnstalleren verwijdert het tabblad, de instellingen en de twee tabellen van de module. De door uw opsplitsingen gegenereerde producten blijven behouden. Wilt u ze verwijderen, annuleer dan eerst de betreffende jobs vanuit de geschiedenis en deïnstalleer daarna de module.
