DF Samples — Produktmuster bestellen (PrestaShop 8 & 9)

Überblick

DF Samples fügt Ihren Produktseiten eine Schaltfläche „Muster bestellen“ hinzu. Das Muster kann kostenlos sein oder wenige Euro kosten. Das Modul erzeugt automatisch für jedes im Programm eingetragene Produkt ein verstecktes Musterprodukt, setzt Limits pro Kunde durch, verfolgt die Conversion vom Muster zum Kauf und erinnert Ihre Kunden automatisch per E-Mail, mit optionalem Rabattgutschein.

Das Modul ist kompatibel mit PrestaShop 8.0 bis 9.x, mandantenfähig und mehrsprachig, und verwendet keinen Core-Override.

Installation

1. Gehen Sie im Backoffice zu Module > Modul-Manager.
2. Klicken Sie auf Modul hochladen und legen Sie die Datei dfsamples.zip ab.
3. Bei der Installation erstellt das Modul seine zwei Tabellen, seine Standardeinstellungen, ein Sicherheitstoken für den Cron-Job und einen Admin-Tab unter Katalog > Muster (DF).

Das Modul registriert sich auf den Hooks displayProductActions, displayProductAdditionalInfo, actionFrontControllerSetMedia, actionValidateOrder und actionObjectProductDeleteAfter.

Ein Produkt zum Musterprogramm hinzufügen

1. Öffnen Sie Katalog > Muster (DF).
2. Klicken Sie auf Hinzufügen.
3. Suchen Sie ein Produkt nach Name oder Referenz im Autovervollständigungsfeld und wählen Sie es aus der Liste. Bereits im Programm eingetragene Produkte und die Musterprodukte selbst werden automatisch aus den Ergebnissen ausgeschlossen.
4. Geben Sie den Musterpreis inklusive Steuern ein. Geben Sie 0,00 für ein kostenloses Muster ein.
5. Legen Sie das Maximum pro Kunde für dieses Produkt fest (0 = unbegrenzt).
6. Speichern Sie.

Was das Modul beim Speichern tut

Das Modul erstellt automatisch ein verstecktes Musterprodukt:

• Name mit übersetztem Präfix in Ihren Sprachen: Échantillon, Sample, Muestra, Muster, Campione.
• Eigene Referenz im Format SMPL, gefolgt von der Kennung des Quellprodukts.
• Nettopreis, berechnet aus dem eingegebenen Bruttopreis und dem Steuersatz des Quellprodukts.
• Titelbild des Quellprodukts kopiert und in allen Bildformaten skaliert.
• Sichtbarkeit auf „nirgendwo“ gesetzt: Das Produkt erscheint weder in der Navigation noch in der Suche.
• Unbegrenzter Bestand (Nachbestellung erlaubt), damit eine Anfrage nie blockiert wird.
• Mustergewicht aus der globalen Einstellung, von den Versanddienstleistern verwendet.

Wenn Sie später den Preis, das globale Gewicht oder den Aktivstatus ändern, wird das Musterprodukt neu synchronisiert. Wurde das Musterprodukt manuell aus dem Katalog gelöscht, wird es beim nächsten Speichern neu erstellt.

Einstellungen

Die Einstellungen befinden sich unten auf der Seite Katalog > Muster (DF), unterhalb der Produktliste.

Allgemeine Einstellungen

• Position der Schaltfläche — unter dem Warenkorb-Button (displayProductActions) oder im Zusatzinformationsblock (displayProductAdditionalInfo). Ändern Sie diese Einstellung, wenn Ihr Theme den ersten Hook nicht rendert.
• Standard-Musterpreis inklusive Steuern — beim Anlegen eines neuen Musters vorausgefüllter Wert.
• Mustergewicht — in Kilogramm, auf alle erzeugten Musterprodukte angewendet. Wird für die Versandkostenberechnung verwendet.
• Kundenkonto erforderlich — empfohlen und standardmäßig aktiviert. Limits pro Kunde lassen sich nur bei identifizierten Kunden zuverlässig durchsetzen.
• Conversion gezählt bei — nur beim Kauf des bemusterten Produkts oder bei jedem späteren Kauf.

Limits

• Maximale Anzahl Muster pro Warenkorb — 0 für unbegrenzt.
• Maximale Anzahl Muster pro Kunde und Zeitfenster — alle Musterprodukte zusammen. 0 für unbegrenzt.
• Gleitendes Zeitfenster — in Tagen, standardmäßig 30. Die Zähler pro Kunde beziehen sich auf diesen gleitenden Zeitraum.

Dasselbe Muster kann unabhängig von der Konfiguration nie zweimal in denselben Warenkorb gelegt werden.

Automatisches Follow-up

• Follow-up-E-Mails aktivieren.
• Frist nach der Musterbestellung — in Tagen, standardmäßig 14.
• Rabattgutschein beilegen — für jedes Follow-up wird ein personalisierter Einmal-Gutschein erzeugt.
• Gutscheinhöhe — in Prozent, standardmäßig 10.
• Gültigkeit des Gutscheins — in Tagen, standardmäßig 30.

Die per Token gesicherte Cron-URL wird in diesem Abschnitt sowie im Statistik-Panel angezeigt.

Cron-Job einrichten

Die Follow-ups werden von einem Cron-Job versendet. Planen Sie die in den Einstellungen angezeigte URL stündlich ein. Beispiel-Crontab:

0 * * * * wget -q -O /dev/null "https://ihr-shop.de/module/dfsamples/cron?token=IHR_TOKEN"

Jeder Lauf verarbeitet bis zu fünfzig ausstehende Follow-ups und gibt eine JSON-Zusammenfassung zurück: Anzahl der verarbeiteten, versendeten, übersprungenen und wartenden Einträge.

Regeln des Cron-Jobs

• Nur Muster, die noch nicht konvertiert sind und für die noch kein Follow-up versendet wurde, werden berücksichtigt.
• Die Musterbestellung muss den Status bezahlt, versandt oder geliefert erreicht haben.
• Stornierte Bestellungen und Zahlungsfehler werden endgültig übersprungen.
• Bestellungen, die auf Zahlung warten, werden auf den nächsten Lauf verschoben.

Conversion-Tracking

Bei jeder Bestellbestätigung erfasst das Modul die Musterzeilen: Kunde, E-Mail, Quellprodukt, Sprache und Shop.

Wenn derselbe Kunde später eine Bestellung aufgibt, markiert das Modul die entsprechenden Muster als konvertiert:

• Im Modus Produkt (Standard): nur wenn die Bestellung das Produkt enthält, dessen Muster empfangen wurde.
• Im Modus jeder Kauf: sobald die Bestellung ein beliebiges echtes Produkt enthält.

Die aktuelle Bestellung wird aus der Berechnung ausgeschlossen: Muster und Produkt im selben Warenkorb zu bestellen zählt nicht als Conversion.

Dashboard

Das über der Produktliste angezeigte Panel zeigt:

• Bestellte Muster — Gesamtzahl der erfassten Musterzeilen.
• Conversions — Anzahl der Muster, denen ein Kauf folgte, sowie die zugehörige Conversion-Rate.
• Umsatz aus Conversions — Summe der Bruttobeträge der Conversion-Bestellungen.
• Ausstehende Follow-ups — Anzahl der Muster, die für ein noch nicht versendetes Follow-up infrage kommen.

Die Produktliste zeigt außerdem je Produkt die Anzahl der bestellten Muster und der Conversions.

Follow-up-E-Mails

Die Vorlagen liegen im mails-Ordner des Moduls, in fünf Sprachen: fr, en, es, de, it. Jede Sprache verfügt über eine HTML- und eine Textversion der Vorlage dfsamples_followup.

Verfügbare Variablen: firstname, lastname, product_name, product_link, voucher_block und shop_name. Der Block voucher_block enthält den formatierten Rabattgutschein oder eine leere Zeichenkette, wenn der Gutschein deaktiviert ist.

Sie können diese Vorlagen frei anpassen. Behalten Sie die Variablen in geschweiften Klammern bei, damit die Ersetzung funktioniert.

Rabattgutscheine

Ist die Option aktiviert, erzeugt jedes Follow-up eine PrestaShop-Warenkorbregel:

• Code im Format SMPL, gefolgt von acht zufälligen Zeichen.
• Auf den Empfänger beschränkt.
• Nur einmal verwendbar.
• Prozentualer Rabatt auf den Bruttobetrag.
• Konfigurierbare Gültigkeitsdauer.

Die erzeugten Gutscheine sind unter Rabatte > Warenkorbregeln sichtbar.

Deinstallation

Bei der Deinstallation entfernt das Modul seine zwei Tabellen, seine Einstellungen und seinen Admin-Tab. Die erzeugten Musterprodukte werden deaktiviert, nicht gelöscht, damit die Historie Ihrer bisherigen Bestellungen konsistent bleibt. Sie können sie bei Bedarf manuell aus dem Katalog löschen.

Fehlerbehebung

Die Schaltfläche erscheint nicht auf der Produktseite

Prüfen Sie, ob das Produkt im Programm eingetragen und unter Katalog > Muster (DF) aktiv ist. Ist das Produkt tatsächlich aktiv, ändern Sie die Einstellung „Position der Schaltfläche“: Manche Themes rendern den Hook displayProductActions nicht.

Die Follow-ups werden nicht versendet

Prüfen Sie, ob der Cron-Job eingeplant ist und die URL das richtige Token enthält. Rufen Sie die URL manuell im Browser auf: Das Modul gibt eine JSON-Zusammenfassung zurück. Prüfen Sie außerdem, ob die Follow-up-Option aktiviert ist und die konfigurierte Frist seit den Musterbestellungen tatsächlich verstrichen ist.

Der Musterpreis entspricht nicht der Erwartung

Der Preis wird brutto eingegeben und anhand der Mehrwertsteuer des Quellprodukts in netto umgerechnet. Hat das Quellprodukt keine Steuerregel, entspricht der Nettopreis dem eingegebenen Preis.

Ein Kunde überschreitet seine Limits

Limits pro Kunde gelten nur für identifizierte Kunden. Aktivieren Sie die Einstellung „Kundenkonto erforderlich“, damit sie greifen.