Tags naar kenmerken voor PrestaShop 8 & 9: documentatie

Overzicht

Tags naar kenmerken zet producttags om naar kenmerkwaarden. Tags zijn snel ingevoerd, vaak met duizenden uit een leveranciersbestand, maar PrestaShop kan ze niet gebruiken in facetfilters, catalogusprijsregels of de meeste cross-sellingmodules: die zijn gebaseerd op kenmerken. De module zet de tags om die u al hebt, behoudt de producten waarop ze staan en maakt één waarde per begrip, vertaald in elke taal.

Er wordt niets geschreven voordat u toepast: de wizard toont eerst de impact. Elke wijziging wordt vastgelegd in een logboek en kan exact ongedaan worden gemaakt.

Installatie

1. Klik in Modules > Modulebeheer op Een module uploaden en selecteer het ZIP-bestand van de module.
2. De installatie maakt het tabblad Catalogus > Tags naar kenmerken, de tabellen voor koppelingen en logboek, de standaardinstellingen en een geheim token voor de cron-URL aan.
3. Open Catalogus > Tags naar kenmerken. De module werkt op PrestaShop 1.7.8 tot 9.x, met PHP 7.1 tot 8.5.

Bijwerken vanaf versie 1.0.0

Upload de ZIP 2.0.0 over de geïnstalleerde module en klik in Modulebeheer op Bijwerken als PrestaShop daarom vraagt. De update voegt de logboektabellen en de nieuwe instellingen toe. Opgeslagen koppelingen, instellingen en het cron-token van 1.0.0 blijven ongewijzigd: een bestaande cron-taak blijft werken.

Dashboard

Het tabblad Dashboard vat de catalogus samen: aantal tags, al omgezette tags, kenmerkwaarden die de module beheert, waarden die op synchronisatie wachten en bewerkingen van de afgelopen 30 dagen. Het blok Statuscontrole meldt wat aandacht vraagt: omgezette kenmerken die ontbreken in de sjablonen van gefacetteerd zoeken, producten die op de zoekindex wachten, niet-gesynchroniseerde koppelingen, de laatste cron-aanroep. De meest gebruikte tags die nog niet zijn omgezet, staan vermeld met een knop om ze om te zetten.

Tags omzetten

Het tabblad Omzetten opent de omzettingswizard, in vier stappen.

Stap 1: tags selecteren

De taglijst wordt aan de serverkant gepagineerd en blijft snel, ook met tienduizenden tags. Zoek op naam, filter op taal en status (omgezet of niet), sorteer op naam of aantal producten. Vink de om te zetten tags aan, of gebruik de knop die alle resultaten van de huidige zoekopdracht selecteert.

Selecteer de tag in elke taal: in een meertalige winkel is hetzelfde begrip in elke taal een andere tag, en de module voegt deze vertalingen samen tot één meertalige waarde.

Stap 2: doelkenmerk en opties

• Nieuw kenmerk: voer de naam in elke taal in. Een lege taal neemt de naam van de standaardtaal over.
• Bestaand kenmerk: waarden waarvan de naam al in het kenmerk bestaat, worden hergebruikt in plaats van gedupliceerd.
• Modus Toevoegen: producten behouden hun huidige waarden van het kenmerk en krijgen er de nieuwe bij. Modus Vervangen: de andere waarden van dit kenmerk worden van de betrokken producten verwijderd, pas nadat de nieuwe waarden zijn geplaatst.
• Koppeling bewaren en synchroniseren: de tag behoudt zijn kenmerkwaarde en later getagde producten krijgen die ook (zie Koppelingen hieronder).
• Tags daarna wissen: de omgezette tags verdwijnen van de producten en uit de winkel. Het logboek bewaart alles wat nodig is om ze te herstellen.
• Tonen in gefacetteerd zoeken: voegt het kenmerk na de omzetting toe aan de filtersjablonen van de module Gefacetteerd zoeken.

Stap 3: voorbeeld van de impact

Klik op Impact bekijken. De module berekent op de huidige catalogus, zonder iets te schrijven, de producten die veranderen, de nieuwe toewijzingen, de aangemaakte en hergebruikte waarden, de producten met meerdere geselecteerde tags en, in vervangmodus, de waarden die worden verwijderd, met hun namen.

Elke rij is een toekomstige kenmerkwaarde. Met Vertalingen automatisch samenvoegen vormen tags in verschillende talen op exact dezelfde producten één rij. De modus Bijna dezelfde producten (80 % of meer) voegt ook tags samen waarvan de producten voor minstens 80 % overlappen, bij onvolledige tagging; deze rijen worden gemarkeerd. U kunt ook Samenvoegen met een andere rij of Deze rij splitsen: de aantallen worden aan de serverkant opnieuw berekend.

Open Vertalingen van de waarde om de naam van de waarde in elke taal te bewerken. Talen die uit een andere taal zijn gekopieerd, omdat er in die taal geen tag bestond, zijn gemarkeerd zodat u ze kunt vertalen. Zoeken en vervangen en Hoofdletter aan het begin werken op alle rijen tegelijk. Vink een rij uit om die over te slaan.

Het aantal producten van een rij opent een zijpaneel met elk product, zijn huidige waarden van het kenmerk en de waarde die het krijgt.

Stap 4: toepassen

Klik op Omzetting toepassen. Het werk loopt in korte batches met een voortgangsbalk, fase per fase: geen enkel verzoek bereikt de tijdslimiet van de hosting, hoe groot de selectie ook is. Houd de pagina open tot het einde. Bij een onderbreking staan de al doorgevoerde wijzigingen in het logboek en kunnen ze ongedaan worden gemaakt.

Het resultaat toont de aangemaakte waarden, de toegevoegde en verwijderde toewijzingen en de knoppen Deze omzetting ongedaan maken en Toevoegen aan gefacetteerd zoeken wanneer het kenmerk nog in geen enkel filtersjabloon staat.

Koppelingen en synchronisatie

Als Koppeling bewaren en synchroniseren aan staat, blijft elke omgezette tag gekoppeld aan zijn kenmerkwaarde. Het tabblad Koppelingen toont de Opgeslagen koppelingen per kenmerk gegroepeerd, met het aantal te synchroniseren producten per waarde.

• Een product dat met een gekoppelde tag wordt aangemaakt, bewerkt of geïmporteerd, krijgt de waarde bij het opslaan als Een product synchroniseren bij het opslaan aan staat in de instellingen.
• Nu synchroniseren voor een waarde, of Alles synchroniseren, toont eerst wat wordt toegevoegd (+) en verwijderd (−) en past het daarna in batches toe.
• Waarden van producten die hun tag kwijt zijn, blijven behouden, tenzij Waarde ook verwijderen als de tag wordt verwijderd aan staat.
• De koppelingen van een waarde verwijderen wijzigt geen enkel product: het stopt alleen de synchronisatie.

Tags opschonen

Het tabblad Tags opschonen ruimt de tags zelf op, vóór of na een omzetting.

• Waarschijnlijke duplicaten: tags in dezelfde taal die alleen verschillen in accenten, hoofdletters, koppeltekens of spaties. Tags samenvoegen verplaatst de producten naar de tag die u behoudt.
• Ongebruikte tags: tags zonder product, met één klik gewist.
• Met de volledige lijst kunt u elke tag hernoemen, samenvoegen of wissen. Hernoemen naar een naam die in de taal al bestaat, stelt voor beide tags samen te voegen. Alleen tags in dezelfde taal kunnen worden samengevoegd.

Elke wijziging wordt in het logboek vastgelegd: gewiste, samengevoegde of hernoemde tags worden bij ongedaan maken hersteld met hun producten en ID’s.

Logboek en ongedaan maken

Het tabblad Logboek toont elke schrijfactie van de module: omzettingen, synchronisaties (handmatig, bij opslaan en via cron), samenvoegingen, hernoemingen en verwijderingen van tags, toevoegingen aan gefacetteerd zoeken en ongedaan gemaakte bewerkingen. Filter op type en periode.

Klik op een bewerking om de details te zien: elke productwijziging, de aangemaakte waarden en kenmerken, de betrokken tags. CSV exporteren downloadt de volledige lijst.

Ongedaan maken herstelt precies de vorige toestand: toegevoegde toewijzingen worden verwijderd, verwijderde teruggezet, aangemaakte waarden en kenmerken gewist als niets ze nog gebruikt, gewiste tags komen terug met hun producten en ID’s, en koppelingen en filtersjablonen worden hersteld. Heeft een latere bewerking dezelfde producten of tags gewijzigd, dan vraagt de module u die eerst ongedaan te maken, te beginnen met de meest recente.

Instellingen en cron

Deze instellingen gelden voor alle winkels.

• Een product synchroniseren bij het opslaan (standaard aan): uitgeschakeld worden later toegevoegde tags pas bij de volgende synchronisatie omgezet.
• Waarde ook verwijderen als de tag wordt verwijderd (standaard uit).
• Zoekindex na elke bewerking bijwerken (standaard aan): gewijzigde producten worden meteen in batches opnieuw geïndexeerd, zodat de nieuwe waarden gevonden worden.
• Standaardopties van een nieuwe omzetting: Vertalingen automatisch samenvoegen en Hoofdletter aan het begin.
• Bewerkingen bewaren gedurende: standaard 180 dagen, 0 bewaart ze voor altijd. Oudere bewerkingen worden gewist en kunnen niet meer ongedaan worden gemaakt.

Het blok Geplande taak (cron) toont de Cron-URL, de laatste aanroep en een voorbeeldregel voor crontab. De cron is optioneel: hij voert een volledige synchronisatie van de koppelingen uit, indexeert de gewijzigde producten en schoont het logboek op. De URL bevat een geheim token; genereer een nieuw token als de URL is gedeeld.

0 3 * * * curl -fsS "https://uw-winkel.nl/…cron-URL gekopieerd uit het tabblad Instellingen…" >/dev/null

Winkel en gefacetteerd zoeken

De omgezette waarden verschijnen in de specificaties op de productpagina, in de taal van de bezoeker.

Een nieuw kenmerk verschijnt pas in de filters wanneer het is toegevoegd aan een filtersjabloon van de module Gefacetteerd zoeken (ps_facetedsearch 3.x of 4.x). De module meldt omgezette kenmerken die in de sjablonen ontbreken. Aan filters toevoegen voegt het kenmerk als selectievakjesfilter, na de bestaande filters, toe aan de sjablonen die u kiest. Het vorige sjabloon blijft in het logboek: ongedaan maken herstelt het precies.

Rechten en multistore

• Recht Bekijken op het tabblad: dashboard, voorbeeld, koppelingen en logboek, alleen-lezen.
• Bewerken: omzetten, synchroniseren, tags hernoemen, ongedaan maken, instellingen.
• Verwijderen: tags wissen en samenvoegen.

Elke actie controleert aan de serverkant de rechten van het profiel van de medewerker. In PrestaShop zijn tags en kenmerken gemeenschappelijk voor alle winkels: een omzetting geldt voor de hele catalogus, nieuwe kenmerken worden aan alle winkels gekoppeld en de zoekindex wordt voor elke winkel bijgewerkt.

Problemen oplossen

• De taglijst is leeg: uw producten hebben nog geen tags. Tags worden toegevoegd op de productpagina (tabblad Opties of SEO, afhankelijk van de versie) of via een CSV-import.
• Een tag ontbreekt in de lijst: misschien is hij al omgezet. Kies “Alle” in het statusfilter.
• Het nieuwe kenmerk verschijnt niet in de filters: voeg het met Aan filters toevoegen toe aan een filtersjabloon en controleer of de module Gefacetteerd zoeken is ingeschakeld.
• De zoekfunctie van de winkel vindt de waarden niet: schakel Zoekindex na elke bewerking bijwerken in, of klik op Index bijwerken in het dashboard.
• Later getagde producten krijgen de waarde niet: controleer of de omzetting de koppeling heeft bewaard en of Een product synchroniseren bij het opslaan aan staat, of start Alles synchroniseren.
• Ongedaan maken wordt geweigerd: een latere bewerking heeft dezelfde producten gewijzigd. Maak eerst de latere bewerkingen ongedaan, te beginnen met de meest recente.
• De cron-URL geeft een 403-fout: het token is onjuist of opnieuw gegenereerd. Kopieer de URL opnieuw uit het tabblad Instellingen.