DF Samples: stalen bestellen (PrestaShop 8 en 9)

Overzicht

DF Samples voegt een knop « Een staal bestellen » toe aan uw productfiches. Het staal kan gratis zijn of enkele euro’s kosten. De module maakt automatisch een verborgen staalproduct aan voor elk product dat aan het programma deelneemt, past limieten per klant toe, volgt de conversie van staal naar aankoop op en herinnert uw klanten automatisch per e-mail, met een optionele kortingsbon.

De module is compatibel met PrestaShop 8.0 tot 9.x, werkt in multistore en meertalig, en gebruikt geen enkele override van de kern.

Installatie

1. Ga in de backoffice naar Modules > Modulebeheer.
2. Klik op Een module installeren en plaats het bestand dfsamples.zip.
3. Bij de installatie maakt de module zijn twee tabellen aan, zijn standaardinstellingen, een beveiligingstoken voor de crontaak en een beheertabblad Catalogus > Stalen (DF).

De module registreert zich op de hooks displayProductActions, displayProductAdditionalInfo, actionFrontControllerSetMedia, actionValidateOrder en actionObjectProductDeleteAfter.

Een product aan het staalprogramma toevoegen

1. Open Catalogus > Stalen (DF).
2. Klik op Toevoegen.
3. Zoek een product op naam of referentie in het autocompleteveld en kies het uit de lijst. Producten die al in het programma zitten en de staalproducten zelf worden automatisch uit de resultaten geweerd.
4. Voer de staalprijs inclusief btw in. Vul 0,00 in voor een gratis staal.
5. Bepaal het maximum per klant voor dit product (0 = onbeperkt).
6. Sla op.

Wat de module bij het opslaan doet

De module maakt automatisch een verborgen staalproduct aan:

• Naam met een voorvoegsel, vertaald in uw talen: Échantillon, Sample, Muestra, Muster, Campione.
• Eigen referentie in de vorm SMPL gevolgd door de identificatie van het bronproduct.
• Prijs exclusief btw, berekend uit de ingevoerde prijs inclusief btw en het btw-tarief van het bronproduct.
• De omslagafbeelding van het bronproduct wordt gekopieerd en in alle formaten herschaald.
• Zichtbaarheid op « nergens »: het product verschijnt niet in de navigatie en niet in de zoekresultaten.
• Onbeperkte voorraad (bestellen bij uitverkocht toegestaan) zodat een aanvraag nooit wordt geblokkeerd.
• Staalgewicht uit de globale instelling, gebruikt door de vervoerders.

Wijzigt u daarna de prijs, het globale gewicht of de actieve status, dan wordt het staalproduct opnieuw gesynchroniseerd. Is het staalproduct handmatig uit de catalogus verwijderd, dan wordt het bij het volgende opslaan opnieuw aangemaakt.

Instellingen

De instellingen staan onder aan de pagina Catalogus > Stalen (DF), onder de productlijst.

Algemene instellingen

• Positie van de knop: onder de knop om aan de winkelwagen toe te voegen (displayProductActions) of in het blok met aanvullende informatie (displayProductAdditionalInfo). Wijzig deze instelling als uw thema de eerste hook niet weergeeft.
• Standaard staalprijs inclusief btw: de waarde die bij het aanmaken van een nieuw staal wordt voorgesteld.
• Staalgewicht: in kilogram, toegepast op alle gegenereerde staalproducten. Wordt gebruikt om de verzendkosten te berekenen.
• Klantaccount verplicht: aanbevolen en standaard ingeschakeld. De limieten per klant zijn alleen betrouwbaar toe te passen op geïdentificeerde klanten.
• Conversie geteld op: alleen de aankoop van het product waarvan een staal werd besteld, of eender welke latere aankoop.

Limieten

• Maximaal aantal stalen per winkelwagen: 0 voor onbeperkt.
• Maximaal aantal stalen per klant en per venster: alle staalproducten samen. 0 voor onbeperkt.
• Voortschrijdend venster: in dagen, standaard 30. De tellers per klant slaan op die voortschrijdende periode.

Eenzelfde staal kan nooit twee keer in dezelfde winkelwagen worden gelegd, ongeacht de configuratie.

Automatische herinnering

• Herinneringsmails inschakelen.
• Termijn na de staalbestelling: in dagen, standaard 14.
• Een kortingsbon meesturen: er wordt per herinnering een persoonlijke bon voor eenmalig gebruik aangemaakt.
• Waarde van de bon: in procent, standaard 10.
• Geldigheid van de bon: in dagen, standaard 30.

De met een token beveiligde URL van de crontaak staat in dit onderdeel en ook in het statistiekenpaneel.

De crontaak instellen

De herinneringen worden door een crontaak verstuurd. Plan de URL uit de instellingen elk uur in. Voorbeeld van een crontab:

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

Elke uitvoering verwerkt tot vijftig wachtende herinneringen en geeft een JSON-samenvatting terug: aantal verwerkte, verstuurde, overgeslagen en wachtende records.

Regels die de crontaak toepast

• Alleen stalen die nog niet zijn omgezet en nog geen herinnering kregen, komen in aanmerking.
• De staalbestelling moet de status betaald, verzonden of geleverd hebben bereikt.
• Geannuleerde bestellingen en bestellingen met een betalingsfout worden definitief overgeslagen.
• Bestellingen die op betaling wachten, worden naar de volgende uitvoering doorgeschoven.

Conversieopvolging

Bij de validatie van elke bestelling legt de module de staalregels vast: klant, e-mailadres, bronproduct, taal en winkel.

Plaatst diezelfde klant later een bestelling, dan markeert de module de bijbehorende stalen als omgezet:

• In de modus product (standaard): alleen als de bestelling het product bevat waarvan het staal werd ontvangen.
• In de modus elke aankoop: zodra de bestelling om het even welk echt product bevat.

De lopende bestelling wordt uit de berekening gelaten: een staal en het bijbehorende product in dezelfde winkelwagen bestellen, telt niet als conversie.

Dashboard

Het paneel boven de productlijst toont:

• Bestelde stalen: het totale aantal vastgelegde staalregels.
• Conversies: het aantal stalen dat door een aankoop is gevolgd, en het bijbehorende conversiepercentage.
• Omzet uit conversies: de som van de bedragen inclusief btw van de conversiebestellingen.
• Wachtende herinneringen: het aantal stalen dat voor een nog niet verstuurde herinnering in aanmerking komt.

De productlijst toont per product ook het aantal bestelde stalen en het aantal conversies.

Herinneringsmails

De sjablonen staan in de map mails van de module, in vijf talen: fr, en, es, de en it. Elke taal heeft een HTML- en een tekstversie van het sjabloon dfsamples_followup.

Beschikbare variabelen: firstname, lastname, product_name, product_link, voucher_block en shop_name. Het blok voucher_block bevat de opgemaakte kortingsbon, of een lege tekst als de bon is uitgeschakeld.

U kunt deze sjablonen vrij aanpassen. Behoud de variabelen tussen accolades zodat de vervanging blijft werken.

Kortingsbonnen

Staat de optie aan, dan maakt elke herinnering een winkelwagenregel van PrestaShop aan:

• Code in de vorm SMPL gevolgd door acht willekeurige tekens.
• Beperkt tot de klant die de bon ontvangt.
• Eenmalig te gebruiken.
• Korting in procent, op het bedrag inclusief btw.
• Instelbare geldigheidsduur.

De aangemaakte bonnen zijn zichtbaar in Promoties > Winkelwagenregels.

Verwijderen

Bij het verwijderen wist de module zijn twee tabellen, zijn instellingen en zijn beheertabblad. De aangemaakte staalproducten worden uitgeschakeld en niet verwijderd, zodat de historiek van uw eerdere bestellingen samenhangend blijft. U kunt ze desgewenst handmatig uit de catalogus verwijderen.

Problemen oplossen

De knop verschijnt niet op de productfiche

Controleer of het product wel in het programma zit en actief is in Catalogus > Stalen (DF). Is het product actief, wijzig dan de instelling « Positie van de knop »: sommige thema’s geven de hook displayProductActions niet weer.

De herinneringen vertrekken niet

Controleer of de crontaak is ingepland en of de URL het juiste token bevat. Roep de URL handmatig op in een browser: de module geeft een JSON-samenvatting terug. Controleer ook of de herinneringsoptie aanstaat en of de ingestelde termijn sinds de staalbestellingen wel is verstreken.

De staalprijs is niet wat ik verwachtte

De prijs voert u inclusief btw in en wordt omgerekend naar exclusief btw volgens de btw van het bronproduct. Heeft het bronproduct geen belastingregel, dan is de prijs exclusief btw gelijk aan de ingevoerde prijs.

Een klant overschrijdt zijn limieten

De limieten per klant gelden alleen voor geïdentificeerde klanten. Schakel de instelling « Klantaccount verplicht » in om ze werkzaam te maken.