PS PrestaShop Beginner

DF Samples: productstalen bestellen (PrestaShop 8 & 9)

Stalen bestellen per product of per combinatie, limieten per klant, conversietracking en de automatische opvolgmail installeren en instellen.

Bijgewerkt Moduleversie 1.1.0

Overzicht

DF Samples voegt aan uw productpagina’s een knop toe om een staal te bestellen. Het staal kan gratis zijn of een paar euro kosten, voor het product of voor de combinatie die de klant koos. De module maakt voor elk ingeschreven product een verborgen staalproduct aan, zet de hoeveelheid vast op 1, past limieten per klant toe op de inhoud van de winkelwagen, meet de conversie van staal naar aankoop en stuurt een opvolgmail met een optionele kortingscode.

De module werkt met PrestaShop 8.0 tot 9.x, multistore en meertalig, zonder core override. Deze documentatie beschrijft versie 1.1.0.

De interface van de module is beschikbaar in het Frans, Engels, Spaans, Duits en Italiaans. In een Nederlandstalige back-office verschijnt de module in het Engels. Daarom staan de namen van instellingen en knoppen hieronder in het Engels.

Installatie

  1. Ga in de back-office naar Modules > Modulebeheer.
  2. Klik op Upload een module en sleep het bestand dfsamples.zip erin.
  3. Open Catalogus > Samples (DF): op deze pagina vindt u de productlijst, het dashboard en de instellingen.

Bij de installatie maakt de module het volgende aan:

  • drie tabellen: dfsamples_product, dfsamples_order en dfsamples_cart;
  • een uitgeschakelde categorie Samples onder Home, toegankelijk voor alle klantengroepen, waarin de staalproducten komen;
  • de standaardinstellingen en een beveiligingstoken voor de cronjob;
  • het tabblad Catalogus > Samples (DF);
  • een kopie van het Engelse e-mailsjabloon voor elke geïnstalleerde taal die er geen heeft.

De module registreert zich op 12 hooks, waaronder displayProductActions, displayProductAdditionalInfo, displayDfSamplesButton, actionCartSave, actionCartUpdateQuantityBefore, actionValidateOrder en actionOrderStatusPostUpdate.

Updaten vanaf versie 1.0.0

Upload de nieuwe ZIP over de oude heen via Modulebeheer. Het updatescript:

  • voegt de tabel dfsamples_cart en de nieuwe kolommen toe;
  • registreert de nieuwe hooks;
  • maakt de stalencategorie aan en verplaatst uw bestaande staalproducten daarheen;
  • hernoemt ze naar het nieuwe formaat en voegt ontbrekende afbeeldingen toe (onder PrestaShop 9 kopieerde versie 1.0.0 de afbeelding niet);
  • behoudt uw ingeschreven producten, statistieken en opvolggeschiedenis.

Mislukt een stap, dan synchroniseert de knop Resync sample products bovenaan de modulepagina alle staalproducten opnieuw.

Een product toevoegen aan het stalenprogramma

  1. Open Catalogus > Samples (DF) en klik op Add a product.
  2. Zoek het product op naam of referentie en selecteer het. Al ingeschreven producten en staalproducten worden niet getoond.
  3. Vul Sample price (tax incl.) in, de staalprijs incl. btw. Vul 0,00 in voor een gratis staal.
  4. Stel Max per customer in, het maximum voor dit product per klant over de glijdende periode (0 = onbeperkt).
  5. Schakel Sample per option in als het product combinaties heeft en de klant er een moet kiezen (zie verder).
  6. Sla op.

Wat de module doet bij het opslaan

De module maakt een verborgen staalproduct aan, of werkt het bestaande bij:

  • naam in het formaat “Sample: Productnaam” (Échantillon, Muestra, Muster, Campione in de vertaalde talen);
  • referentie in het formaat SMPL gevolgd door het ID van het bronproduct;
  • prijs excl. btw berekend uit de ingevoerde prijs en de belastingregel van het bronproduct;
  • hoofdafbeelding van het bronproduct gekopieerd naar alle afbeeldingsformaten;
  • standaardcategorie: de stalencategorie;
  • zichtbaarheid “nergens”: het product verschijnt niet in lijsten of zoekresultaten;
  • bestellen toegestaan zonder voorraad, zodat een aanvraag nooit geblokkeerd wordt;
  • gewicht uit de globale instelling, gebruikt door de vervoerders.

Wijzigt u later de prijs, de combinatie-optie, het globale gewicht of de actieve status, dan wordt het staalproduct opnieuw gesynchroniseerd. Werd het handmatig uit de catalogus verwijderd, dan wordt het bij de volgende keer opslaan opnieuw aangemaakt.

Staal per combinatie

Met Sample per option ingeschakeld kiest de klant zijn combinatie op de productpagina zoals bij een gewone aankoop en klikt daarna op de knop om een staal van die combinatie te bestellen.

  • De combinatie wordt op de staalregel opgeslagen, bijvoorbeeld “Formaat: A4, Papier: Gestreken 300 g”. Ze verschijnt in een personalisatieveld in de winkelwagen, de bestelling, de factuur en de opvolgmail.
  • Elke combinatie krijgt een eigen regel. Dezelfde combinatie kan niet twee keer worden toegevoegd.
  • Het maximum per klant van het product wordt per combinatie geteld.
  • De staalprijs is dezelfde voor alle combinaties van het product.

Het staalproduct blijft een eenvoudig product, zonder combinaties en zonder eigen voorraad. De combinatie is een personalisatietekst die de module toevoegt, zodat uw combinaties niet gedupliceerd worden.

Instellingen

De instellingen staan onder de productlijst op de pagina Catalogus > Samples (DF).

General settings (algemene instellingen)

  • Button position: onder de winkelwagenknop (displayProductActions), in het blok aanvullende informatie (displayProductAdditionalInfo), of alleen op een eigen plek (displayDfSamplesButton, zie de volgende sectie).
  • Default sample price (tax incl.): voorgestelde waarde bij het toevoegen van een staal.
  • Sample weight: in kilogram, voor alle staalproducten, gebruikt voor de verzendkosten.
  • Require customer account: standaard ingeschakeld. Limieten per klant zijn alleen betrouwbaar af te dwingen bij geïdentificeerde klanten.
  • Customer group discounts on samples: toepassen (standaardgedrag van PrestaShop) of niet toepassen. Zie “Prijzen en groepskortingen”.
  • Samples category: standaardcategorie van alle staalproducten. Laat ze uitgeschakeld. Kiest u een andere categorie, dan worden de bestaande stalen daarheen verplaatst.
  • Redirect sample pages: standaard ingeschakeld. Een bezoeker op de pagina van een staalproduct wordt met een 301 doorgestuurd naar het bronproduct.
  • Conversion counted on: alleen de aankoop van het gesampelde product, of elke latere aankoop.

Limits (limieten)

  • Max samples per cart: 0 = onbeperkt.
  • Max samples per customer per window: alle staalproducten samen, 0 = onbeperkt.
  • Rolling window: glijdende periode in dagen, standaard 30. Met 0 gelden de klantlimieten voor alle eerdere bestellingen, zonder tijdslimiet.

Automatic follow-up (automatische opvolging)

  • Enable follow-up emails: schakelt de opvolgmails in.
  • Delay after sample order: in dagen, standaard 14.
  • Only customers subscribed to the newsletter: inschakelen als uw rechtsgrond voor commerciële e-mails toestemming is.
  • Include a discount voucher: voor elke opvolging wordt een persoonlijke code voor eenmalig gebruik aangemaakt.
  • Voucher amount: in procent, standaard 10.
  • Voucher validity: in dagen, standaard 30.

De cron-URL staat in deze sectie en in het dashboard.

De knop tonen met Creative Elements of een eigen thema

Als de productpagina met een page builder is gebouwd, worden de standaardhooks niet altijd weergegeven, of niet op de gewenste plek. De module biedt een eigen hook, displayDfSamplesButton.

  1. Kies bij de instelling Button position de optie Custom placement only (displayDfSamplesButton). De knop wordt dan niet meer aan de standaardhooks toegevoegd, zodat hij niet twee keer verschijnt.
  2. Met Creative Elements: voeg in het sjabloon van de productpagina de widget Module toe op de gewenste plek en kies de module DF Samples en de hook displayDfSamplesButton.
  3. In een eigen thema: voeg {hook h='displayDfSamplesButton'} toe aan het template van de productpagina, bijvoorbeeld templates/catalog/product.tpl.

Waar hij ook staat, de knop volgt de geselecteerde combinatie en wordt bijgewerkt wanneer de klant die wijzigt.

Prijzen en groepskortingen

De staalprijs staat los van het bronproduct: staffelprijzen, specifieke prijzen en de minimale hoeveelheid van het bronproduct gelden niet. Alleen een catalogusprijsregel die op alle producten zonder onderscheid van toepassing is, zou ook voor stalen gelden.

Een korting voor een klantengroep (Klanten > Groepen, bijvoorbeeld -15 % voor wederverkopers) geldt standaard voor alle producten, stalen inbegrepen. Met Do not apply: samples keep their price sluit de module de staalproducten uit van de korting van elke groep: uw wederverkopers betalen de vastgestelde staalprijs en de korting blijft gelden voor de rest van de catalogus. Groepen die later worden aangemaakt, worden automatisch meegenomen.

De knop toont de prijs die de ingelogde klant betaalt, inclusief groepskorting en btw.

Limieten en controle van de winkelwagen

De regels worden gecontroleerd telkens de winkelwagen wordt opgeslagen, niet alleen bij een klik op de knop. Toevoegen via de knoppen + en – op de winkelwagenpagina, via een directe URL, via “Opnieuw bestellen” of door het samenvoegen van winkelwagens bij het inloggen doorloopt dezelfde controles:

  1. regels van uitgeschakelde stalen worden verwijderd;
  2. dubbele regels worden verwijderd (hetzelfde staal, of dezelfde combinatie in combinatiemodus);
  3. de hoeveelheid van elke regel wordt teruggezet naar 1;
  4. het maximum per winkelwagen wordt toegepast;
  5. het maximum per product en het globale maximum per klant worden toegepast over de glijdende periode.

Moet er een regel weg, dan wordt de meest recente verwijderd. De klant ziet een melding op de winkelwagen- of bestelpagina. Geannuleerde, terugbetaalde of mislukte bestellingen tellen niet mee voor de limieten. Winkelwagens die een medewerker in de back-office aanmaakt, vallen niet onder de limieten.

De cronjob instellen

De opvolgmails worden verstuurd via een cronjob. Plan de URL uit de instellingen elk uur in. Voorbeeld voor crontab:

0 * * * * wget -q -O /dev/null "https://uw-winkel.nl/module/dfsamples/cron?token=UW_TOKEN"

Elke uitvoering verwerkt tot 50 bestellingen en geeft een JSON-samenvatting terug: processed, sent, skipped, waiting en retry.

Regels van de cronjob

  • Eén e-mail per bestelling, ook als die meerdere stalen bevat. De mail somt de geteste producten op en bevat hoogstens één kortingscode.
  • Alleen niet-geconverteerde stalen zonder eerdere opvolging komen in aanmerking, zodra de termijn verstreken is.
  • De staalbestelling moet de status betaald, verzonden of geleverd hebben. Een bestelling die nog op betaling wacht, wordt later opnieuw bekeken en overgeslagen als ze 60 dagen na de vervaldatum van de opvolging nog steeds niet betaald is.
  • Geannuleerde, terugbetaalde of mislukte bestellingen worden genegeerd.
  • Een staal waarvan het product in dezelfde bestelling werd gekocht, krijgt geen opvolging.
  • Met de nieuwsbriefoptie ingeschakeld krijgen niet-ingeschreven klanten geen opvolging.
  • Mislukt het verzenden, dan probeert de module het opnieuw bij volgende uitvoeringen, hoogstens drie keer en met minstens zes uur ertussen. De code die voor een niet-verzonden e-mail werd aangemaakt, wordt verwijderd.
  • Twee gelijktijdige uitvoeringen kunnen niet dezelfde e-mail versturen: elke bestelling wordt vóór de verwerking gereserveerd.

Conversietracking

Bij de validatie van een bestelling met een staal registreert de module de klant, zijn e-mailadres, het bronproduct, de combinatie, de taal en de winkel.

Plaatst deze klant later een bestelling, dan worden de overeenkomende stalen als geconverteerd gemarkeerd:

  • in de modus product (standaard): als de bestelling het product bevat waarvan hij het staal kreeg;
  • in de modus elke aankoop: zodra de bestelling een echt product bevat.

Een conversie telt pas wanneer de aankoop een gevalideerde status bereikt (bijvoorbeeld betaling aanvaard). Een bestelling die per overschrijving wordt betaald, telt dus bij ontvangst van de betaling. Een aankoop in dezelfde bestelling als het staal is geen conversie.

Dashboard

Het paneel boven de productlijst toont:

  • Samples ordered: aantal geregistreerde staalregels;
  • Conversions: aantal stalen gevolgd door een aankoop, en de conversiegraad;
  • Revenue from conversions: totaal incl. btw van de conversiebestellingen, omgerekend naar de standaardvaluta;
  • Pending follow-ups: openstaande opvolgingen.

De productlijst toont per product ook het aantal bestelde stalen, het aantal conversies en of de combinatiemodus aan staat.

Opvolgmails

De sjablonen staan in de map mails van de module, in het Frans, Engels, Spaans, Duits en Italiaans, als HTML- en tekstversie (dfsamples_followup). Voor het Nederlands wordt het Engelse sjabloon bij de installatie gekopieerd naar mails/nl/: vertaal beide bestanden in die map en laat de variabelen tussen accolades staan.

Beschikbare variabelen:

  • {firstname} en {lastname};
  • {product_name}: het of de geteste producten, gescheiden door komma’s;
  • {product_link}: link naar de pagina van het eerste product;
  • {voucher_block}: opgemaakte kortingscode voor de HTML-versie, leeg als de code is uitgeschakeld;
  • {voucher_text}: dezelfde inhoud voor de tekstversie;
  • {shop_name}.

Kortingscodes

Met de optie ingeschakeld maakt elke opvolging een winkelwagenregel van PrestaShop aan:

  • code in het formaat SMPL gevolgd door acht willekeurige tekens;
  • voorbehouden aan de ontvanger, eenmalig bruikbaar;
  • procentuele korting, instelbare geldigheid.

De codes staan in Catalogus > Kortingen > Winkelwagenregels.

Catalogus, sitemap en productfeeds

Staalproducten hebben de zichtbaarheid “nergens” en staan in de uitgeschakelde stalencategorie. Ze verschijnen niet in lijsten, zoekresultaten of uitgelichte blokken, en hun pagina verwijst door naar het bronproduct. De meeste sitemap- en feedmodules slaan deze producten over. Neemt de uwe ze toch op, sluit dan in de instellingen de stalencategorie of de referenties die met SMPL beginnen uit.

Compatibiliteit met het bestelproces

De module grijpt niet in op het bestelproces: een staal is een gewone productregel. Ze werkt met de standaard checkout en met one-page checkouts die de standaardstappen van PrestaShop gebruiken. De melding over een verwijderd staal verschijnt op de winkelwagen- en bestelpagina.

Verwijderen

Bij het verwijderen van de module worden de tabellen, instellingen en het tabblad gewist. Staalproducten worden uitgeschakeld, niet verwijderd, en de stalencategorie blijft bestaan, zodat uw bestelgeschiedenis consistent blijft. Een nieuwe installatie gebruikt deze categorie opnieuw. U kunt deze producten en de categorie handmatig verwijderen als u ze niet meer nodig hebt.

Problemen oplossen

De knop verschijnt niet op de productpagina

Controleer of het product ingeschreven en actief is in Catalogus > Samples (DF). Wijzig daarna de positie van de knop: sommige thema’s geven displayProductActions niet weer. Met een page builder gebruikt u de hook displayDfSamplesButton.

Er verschijnt een melding in plaats van de knop

Een melding over de bereikte stalenlimiet voor het product betekent dat de klant zijn maximum binnen de glijdende periode heeft bereikt. Een melding over het maximum aantal stalen per bestelling betekent dat het maximum per winkelwagen bereikt is. Pas de limieten aan indien nodig.

Staalproducten hebben geen afbeelding

Dat gold voor stalen die versie 1.0.0 onder PrestaShop 9 aanmaakte. Klik op Resync sample products: ontbrekende afbeeldingen worden toegevoegd.

De getoonde prijs is niet de verwachte

De prijs wordt incl. btw ingevoerd en omgerekend met de belastingregel van het bronproduct. Voor een klant uit een groep met korting controleert u de instelling “Customer group discounts on samples”. Een globale catalogusprijsregel geldt ook voor stalen.

De opvolgmails worden niet verstuurd

Open de cron-URL in een browser en lees de JSON-samenvatting. enabled: false betekent dat de opvolging is uitgeschakeld. waiting telt staalbestellingen die nog niet betaald zijn. Controleer ook de termijn, de nieuwsbriefoptie en de e-mailconfiguratie van de winkel (Geavanceerde instellingen > E-mail).

Een staal verdwijnt uit de winkelwagen

Dat is de winkelwagencontrole: dubbele regel, maximum per winkelwagen of klantlimiet bereikt. De klant ziet een melding op de winkelwagenpagina.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support