DataFirefly Catalog Merge: dubbele kenmerken en eigenschappen samenvoegen

<h2>Installatie</h2>
<p>Installeer de module via <strong>Modules > Modulebeheer > Een module uploaden</strong> met het ZIP-bestand, of plaats de map <code>dfcatalogmerge</code> in de map <code>/modules/</code> van uw winkel en klik op Installeren.</p>
<p>Bij de installatie maakt de module haar twee tabellen aan (posities van eigenschapwaarden en geschiedenis van samenvoegingen), registreert ze de hook <code>filterProductContent</code> en voegt ze een tabblad <strong>Catalogus samenvoegen</strong> toe onder het menu Catalogus.</p>
<div class=”df-callout warn”><p>Deze module wijzigt uw catalogusgegevens definitief. Maak een back-up van uw database voor uw eerste opschoonactie. Samenvoegingen zijn niet omkeerbaar.</p></div>

<h2>Module-instellingen</h2>
<p>De instellingen staan op de configuratiepagina van de module. Vier opties, standaard allemaal ingeschakeld.</p>
<h3>Volgorde op de productpagina’s afdwingen</h3>
<p>Past de ingestelde posities toe op de eigenschapwaarden die op de productpagina worden getoond. Deze optie is noodzakelijk op PrestaShop 8, waarvan de kern eigenschapwaarden niet sorteert. Op PrestaShop 9 vult de module daarnaast de native positiekolom, en de optie garandeert hetzelfde resultaat ongeacht de winkelinstelling <code>PS_FEATURE_VALUES_ORDER</code>.</p>
<h3>Dubbele combinaties samenvoegen</h3>
<p>Worden twee combinaties van hetzelfde product na een samenvoeging identiek, dan brengt de module ze automatisch samen. Schakel deze optie alleen uit als u die gevallen met de hand wilt afhandelen, in het besef dat PrestaShop twee combinaties met exact dezelfde kenmerken slecht verwerkt.</p>
<h3>Tabellen van andere modules bijwerken</h3>
<p>De module doorzoekt de database naar alle tabellen buiten de kern met een kolom <code>id_attribute</code> of <code>id_feature_value</code>, met name de index van de facetzoekfunctie, en zet de betrokken rijen om of verwijdert ze. Zonder deze optie kunnen na een samenvoeging spookfilters achterblijven.</p>
<h3>Geschiedenis van samenvoegingen bewaren</h3>
<p>Legt elke toegepaste samenvoeging vast: bronwaarde, doelwaarde, aantal gewijzigde rijen, medewerker en datum. Te raadplegen in het tabblad Geschiedenis.</p>

<h2>Kenmerkwaarden samenvoegen</h2>
<p>Open <strong>Catalogus > Catalogus samenvoegen</strong>, tabblad <strong>Kenmerkwaarden</strong>. Kies de op te schonen kenmerkgroep en de taal waarin u de labels wilt lezen.</p>
<p>De tabel toont de waarden van de groep met per waarde het aantal producten en combinaties dat ze gebruikt. Vink de te verwijderen duplicaten aan, kies de te behouden waarde in de lijst “Voeg de geselecteerde waarden samen in” en klik op <strong>Simuleren</strong>.</p>
<h3>Het simulatierapport lezen</h3>
<p>De simulatie schrijft niets weg. Het rapport toont het aantal om te zetten combinatieregels, de betrokken producten, de combinaties die de doelwaarde al dragen en die welke na de samenvoeging identiek worden. Bevalt het rapport u, klik dan op <strong>Deze samenvoeging toepassen</strong>.</p>
<h3>Wat er met de combinaties gebeurt</h3>
<p>Alle combinaties die een verwijderde waarde gebruiken, gaan over naar de behouden waarde. Drie bijzondere gevallen worden automatisch afgehandeld:</p>
<ul>
<li>Een combinatie droeg de doelwaarde en het duplicaat al: de dubbele regel wordt verwijderd, de rest van de combinatie blijft ongemoeid.</li>
<li>Twee combinaties van hetzelfde product worden identiek: ze worden samengebracht. Hoeveelheden worden per winkel opgeteld, afbeeldingen en specifieke prijzen overgezet, de standaardcombinatie blijft behouden en de voorraad van het hoofdproduct wordt opnieuw gesynchroniseerd.</li>
<li>Openstaande winkelwagens die naar de verwijderde combinatie verwijzen, worden omgezet naar de blijvende.</li>
</ul>
<div class=”df-callout note”><p>De samen te voegen waarden moeten tot dezelfde kenmerkgroep behoren als de doelwaarde. De module weigert een samenvoeging over twee groepen heen, die inconsistente combinaties zou opleveren.</p></div>

<h2>Eigenschapwaarden samenvoegen</h2>
<p>Het tabblad <strong>Eigenschapwaarden</strong> werkt op dezelfde manier: kies een eigenschap, vink de duplicaten aan, kies de doelwaarde, simuleer en pas toe.</p>
<p>De productkoppelingen worden omgezet naar de behouden waarde. Droeg een product al beide waarden, dan wordt de dubbele koppeling verwijderd. Op PrestaShop 9 worden de aan combinaties gekoppelde eigenschapwaarden tegelijk behandeld.</p>
<h3>Aangepaste waarden</h3>
<p>PrestaShop laat toe een eigenschapwaarde in te voeren die bij één enkel product hoort, in de tabel gemarkeerd als <em>aangepast</em>. Die waarden zijn na een import de eerste bron van duplicaten. U kunt ze net als elke andere waarde samenvoegen in een gedeelde waarde. Was de doelwaarde zelf aangepast en blijkt ze na de samenvoeging door meerdere producten gebruikt, dan maakt de module er automatisch een gedeelde waarde van.</p>

<h2>Duplicaten automatisch opsporen</h2>
<p>Het tabblad <strong>Duplicaten zoeken</strong> doorzoekt de hele catalogus en groepeert waarden waarvan het label identiek is zodra hoofdletters, accenten, leestekens en dubbele spaties worden genegeerd. “Rood”, “rood” en “ROOD” vormen dus één groep, net als “Bio katoen” en “bio-katoen”.</p>
<p>Voor elke groep wordt de meest gebruikte waarde als doel voorgesteld, met voorkeur voor gedeelde boven aangepaste waarden. De knop <strong>Deze samenvoeging simuleren</strong> stuurt de groep naar het simulatiescherm, waar u de eindkeuze in handen houdt.</p>
<p>De analyse verloopt in de geselecteerde taal. Voer ze in een meertalige catalogus opnieuw uit per taal: een duplicaat kan in slechts één vertaling bestaan.</p>

<h2>De volgorde instellen</h2>
<p>In de eerste twee tabbladen heeft elke rij links een greep. Sleep een rij om de positie te wijzigen: de nieuwe volgorde wordt meteen opgeslagen, zonder de pagina te herladen.</p>
<p>De knop <strong>Automatisch sorteren</strong> ordent de waarden zonder handwerk. Kledingmaten volgen de reeks XS, S, M, L, XL, XXL in plaats van de alfabetische volgorde, en numerieke waarden volgen de natuurlijke volgorde: 2 voor 10, 39 voor 41.</p>
<h3>Wat de klant ziet</h3>
<p>Voor kenmerkwaarden is de positie die welke de combinatiekiezer op de productpagina gebruikt, zowel op PrestaShop 8 als op PrestaShop 9. Een extra instelling is niet nodig.</p>
<p>Voor eigenschapwaarden geldt de volgorde voor de eigenschappentabel van de productpagina zolang de optie “Volgorde op de productpagina’s afdwingen” aan staat. Op PrestaShop 9 wordt de native positie parallel gevuld, waardoor dezelfde volgorde ook in de andere back-officeschermen verschijnt.</p>
<div class=”df-callout tip”><p>Verandert de volgorde in de front office niet na een wijziging, leeg dan de cache van de winkel. Productpagina’s worden zowel door PrestaShop als door de meeste performancemodules gecachet.</p></div>

<h2>Geschiedenis van samenvoegingen</h2>
<p>Het tabblad <strong>Geschiedenis</strong> toont de toegepaste samenvoegingen, de nieuwste eerst: datum, type, bronwaarde met haar id, behouden waarde en aantal gewijzigde rijen. De id’s blijven bewaard zodat u kunt vergelijken met een databaseback-up als u iets handmatig moet terugdraaien.</p>

<h2>Goede gewoonten</h2>
<ul>
<li>Maak een back-up van de database voor een opschoonactie, zeker bij een catalogus van enkele duizenden producten.</li>
<li>Simuleer altijd. Het rapport toont u de combinaties die door samenvoeging verdwijnen voordat het gebeurt.</li>
<li>Werk groep per groep in plaats van in één keer, zodat de rapporten leesbaar blijven.</li>
<li>Herbouw na een grote samenvoeging de index van de facetzoekfunctie als u die module gebruikt.</li>
<li>Voer samenvoegingen op een drukke winkel uit tijdens rustige uren: het omzetten van combinaties vergrendelt de betrokken tabellen kort.</li>
</ul>

<h2>Probleemoplossing</h2>
<h3>De samenvoeging wordt geweigerd met een melding over de kenmerkgroep</h3>
<p>Alle aangevinkte waarden moeten tot dezelfde kenmerkgroep behoren als de doelwaarde, of tot dezelfde eigenschap bij eigenschapwaarden. Controleer of u geen gelijknamige waarde uit een andere groep hebt aangevinkt.</p>
<h3>De volgorde van eigenschapwaarden verandert niet op de productpagina</h3>
<p>Controleer of de optie “Volgorde op de productpagina’s afdwingen” aan staat en leeg daarna de cache. Toont uw thema de eigenschappen via een module van derden in plaats van via de native variabelen van de productpagina, dan wordt de volgorde mogelijk niet overgenomen: neem contact met ons op met de naam van het thema.</p>
<h3>Een samenvoeging is afgebroken</h3>
<p>De schrijfacties verlopen binnen een transactie: bij een fout keert de database terug naar de oorspronkelijke staat en gaat geen enkel gegeven verloren. De foutmelding boven aan het scherm bevat de oorzaak. De tabellen moeten InnoDB zijn om het terugdraaien te laten werken.</p>
<h3>Facetfilters tonen de verwijderde waarde nog steeds</h3>
<p>Controleer of de optie “Tabellen van andere modules bijwerken” aan stond tijdens de samenvoeging en herbouw daarna de index van de facetnavigatiemodule via haar configuratiepagina.</p>

<h2>Compatibiliteit</h2>
<ul>
<li>PrestaShop 8.0 tot 9.x, dezelfde ZIP dekt beide takken.</li>
<li>Multistore en meertalig.</li>
<li>ModuleAdminController-architectuur, zonder Composer-afhankelijkheid.</li>
<li>Interface beschikbaar in het Nederlands, Frans, Engels, Spaans, Duits, Italiaans, Pools en Portugees.</li>
</ul>