Alles, was Sie wissen sollten bevor Sie installieren.
Ein detaillierter Blick darauf, wie dffreegift — Geschenk ab Warenkorbschwelle für PrestaShop 8 & 9 funktioniert, warum wir es so gebaut haben und der Gedanke hinter den Funktionen oben.
Der am besten messbare Hebel auf den Durchschnittswarenkorb
In einem E-Commerce-Shop treiben zwei Variablen den Umsatz: die Anzahl der Bestellungen und der durchschnittliche Warenkorbwert. Die Kosten für die Akquisition einer neuen Bestellung sind sehr hoch geworden (Werbung, SEO, Retargeting). Den Warenkorb eines Besuchers, der ohnehin kurz vor dem Kauf steht, anzuheben, kostet hingegen fast nichts — es ist Upsell auf bereits bezahltem Traffic. Das Schwellengeschenk ist eine der wirksamsten Mechaniken dafür: Der Besucher fügt freiwillig ein paar Euro hinzu, um das Angebot nicht zu verpassen. Vorausgesetzt, die Mechanik ist sichtbar, beziffert und unmittelbar. Genau das tut dffreegift.
Der Fortschrittsblock: psychologische Mechanik auf den Cent genau
Auf der Warenkorbseite zeigt das Modul dauerhaft ein eigenes Banner mit dem Bild des angebotenen Geschenks, dessen Namen und einer Nachricht, die die verbleibende Distanz auf den Cent beziffert: «Fügen Sie 12,40 € hinzu, um Ihr Geschenk zu erhalten». Ein farbiger Fortschrittsbalken wechselt fortschreitend von grau-orange zu grün, je näher die Schwelle rückt. Beim Überschreiten färbt sich das Banner grün mit der Nachricht «Geschenk zu Ihrem Warenkorb hinzugefügt!», und eine Pulse-Animation bestätigt den Erfolg visuell. Diese Echtzeit-Dramaturgie verwandelt eine einfache bedingte Aktion in einen Verhaltenshebel: Der Besucher sieht den Zähler steigen, kalkuliert mental den nötigen Aufwand und kippt um.
Unter der Haube: Der native PrestaShop-Mechanismus, sauber umgesetzt
Die meisten Geschenkmodule am Markt manipulieren Produktpreise direkt über den Hook actionProductPriceCalculation, erstellen Warenkorbzeilen mit erzwungenem Nullpreis oder injizieren temporäre SpecificPrice-Einträge. Dieser Ansatz bricht später die Kompatibilität mit anderen Aktionsmodulen, erzeugt Inkonsistenzen in Buchhaltungsexporten und erschwert die Fehlersuche. dffreegift macht das Gegenteil: Bei der Installation wird eine Standard-CartRule erstellt (sichtbar unter Katalog → Rabatte → Warenkorbregeln) mit einem DFFREEGIFT_xxxxxxxx-Code und einem auf null initialisierten gift_product. Bei jedem Speichern des Warenkorbs synchronisiert das Modul gift_product und gift_product_attribute mit Ihrer Konfiguration und hängt dann die Regel über die nativen Methoden Cart::addCartRule und Cart::removeCartRule an den Warenkorb an bzw. ab. PrestaShop übernimmt anschließend alles: Einfügen der Geschenkzeile (gift = 1, Preis = 0), Warenkorbanzeige, Summen, Bestellkonvertierung, historischer Snapshot. Kein direkter Preisaufruf, keine invasive Injektion — daher die native Kompatibilität mit Ihren anderen Aktionsmechanismen.
Drei Synchronisations-Trigger plus Selbstheilung
Die Hauptlogik läuft auf dem Hook actionCartSave, den PrestaShop bei jedem Warenkorb-Save aufruft — also bei jedem Hinzufügen, Ändern oder Entfernen eines Produkts, aber auch beim Kundenlogin (Warenkorb-Merge) und bei einigen Backoffice-Aktionen. Ein statischer Anti-Rekursions-Flag verhindert, dass die Änderung des Warenkorbs durch das Modul den Hook in einer Schleife erneut auslöst. Parallel überwacht der Hook actionObjectCartRuleDeleteBefore die manuelle Löschung unserer CartRule im Backoffice: Löscht ein Admin die Regel versehentlich, wird die Konfiguration zurückgesetzt und die nächste Synchronisation legt eine saubere Regel neu an. Schließlich synchronisiert das Modul bei jedem Speichern der Konfiguration über den Konfigurations-Bildschirm gift_product und gift_product_attribute auf die bestehende Regel — Sie müssen die Regel im Bereich Rabatte nie manuell anfassen.
Konfiguration: Schwelle, Steuern, Versand, Lager, Gruppen
Der Bildschirm Module → DataFirefly Free Gift → Konfigurieren bündelt alles. Ein Master-Schalter zum Aktivieren oder Deaktivieren des Ganzen. Die ID des Geschenkartikels (manuell eingegeben, der Produktname wird nach dem Speichern als Hinweis angezeigt). Ein Dropdown für die Varianten des Produkts (automatisch gefüllt, nachdem Sie die Produkt-ID erstmals gespeichert haben, das Modul liest dann die verfügbaren Varianten ein). Der Schwellenbetrag, mit zwei zugehörigen Schaltern: Bruttoberechnung (sonst Netto) und Versandkosten einschließen (sonst nur Produkte). Ein Schalter Lagerbestand des Geschenks prüfen, der das Auto-Hinzufügen aussetzt, wenn der Artikel nicht verfügbar ist (respektiert die in PrestaShop global konfigurierte Out-of-Stock-Strategie). Ein Checkbox-Raster, um das Angebot auf bestimmte Kundengruppen zu beschränken — ist nichts angekreuzt, sind alle Kunden berechtigt, nicht identifizierte Besucher inklusive. Zwei unabhängige Anzeigeschalter für die Fortschrittsmeldung und den Fortschrittsbalken.
Typische Anwendungsfälle
Kosmetikshop mit komfortabler Marge: ab 40 € brutto eine Parfümprobe verschenken, um Warenkörbe von 28-35 € auf 40 € zu pushen. Mode und Accessoires: Marken-Täschchen als Geschenk ab 80 € brutto, ohne Versand gerechnet, um Erstkäufer zu binden. B2B-Ausrüstung: Schlüsselanhänger oder USB-Stick ab 200 € netto, beschränkt auf die Gruppe Geschäftskunden. Lebensmittel-Marketplace: kostenloses Verkostungsprodukt ab 50 € brutto inklusive Versand, um die Kosten für den kostenlosen Versand zu absorbieren und ihn in die Rentabilität zu bringen. In all diesen Fällen ist die Mechanik identisch: eine klare Schwelle, ein begehrenswertes Geschenk, eine sichtbare Progression, ein automatisches Hinzufügen. dffreegift erledigt das alles ohne manuelle Eingriffe.
Kompatibilität PrestaShop 8 und 9 — getestet, nicht versprochen
Das Modul verwendet ausschließlich versionsübergreifend stabile APIs: Module, Hook, Configuration, CartRule, Cart, HelperForm, Smarty. Keine Verwendung der Symfony-Produktreiter in PrestaShop 9 (die bei vielen Drittanbieter-Modulen Inkompatibilitäten erzeugten), keine Injektion in den One-Page-Checkout, keine Abhängigkeit von in PS 9 deprecateten Klassen. Der Admin-Bildschirm verwendet HelperForm — eine stabile Komponente, identisch in PS 8 und PS 9. Im Frontend ist der Hook displayShoppingCart in beiden Versionen vorhanden und funktional, und der Helper getCurrentLocale (verwendet für die Preisformatierung) ist seit PrestaShop 1.7.6 verfügbar. Installieren Sie das Modul heute auf PS 8, migrieren Sie auf PS 9, wann Sie wollen: keine Aktion Ihrerseits am Modul nötig.
Multi-Shop, mehrsprachig, lesbarer Code
Das Modul funktioniert mit dem Multi-Shop-Setup von PrestaShop im Standard-Shop-Kontext. Frontend-Botschaften sind über den Standard-PrestaShop-Mechanismus übersetzbar (Modules.Dffreegift.Shop für das Frontend, Modules.Dffreegift.Admin für das Backoffice), mit vorpositionierten Versionen für FR, EN, ES und DE. Der Quellcode wird offen geliefert (PHP nicht verschlüsselt, konform mit Standard-PrestaShop-Konventionen), mit französischen und englischen Kommentaren am Anfang jeder wichtigen Methode. Die Hauptlogik passt in eine dffreegift.php-Datei mit weniger als 700 Zeilen — lesbar und prüfbar in weniger als einer Stunde. Sie können den Code ändern, über Ihre eigenen Hooks erweitern oder für einen spezifischen Geschäftsfall forken.
Es gibt noch keine Rezensionen.