Sammelbestellung & kollektive Staffelpreise — Vollständige Anleitung

Überblick und Voraussetzungen

Sammelbestellung führt einen kollektiven Staffelpreis ein: Je mehr Käufer ein Produkt hat, desto niedriger wird der Stückpreis für alle. Sie definieren Staffeln (eine Käuferschwelle schaltet einen Preis frei), und das Modul wendet den Preis der erreichten Staffel automatisch über die nativen spezifischen Preise von PrestaShop an. Der aktuelle Preis erscheint daher überall ohne jede Theme-Änderung: Produktseite, Listen, Warenkorb und E-Mails.

• Kompatibel mit PrestaShop 8.0 bis 9.x, Classic-Theme und abgeleitete Themes.
• PHP 7.4 bis 8.3.
• Multishop und mehrsprachig (FR/EN/ES/DE/IT).
• Keine CRON-Aufgabe erforderlich: Die Neuberechnung wird durch Bestellereignisse gesteuert.
• PrestaShop-konforme Architektur (ModuleAdminController, ObjectModel), ohne Composer-Abhängigkeit.

Installation

Installieren Sie das Modul wie jedes PrestaShop-Modul:

1. Laden Sie das Archiv dfgroupbuy-1.0.2.zip aus Ihrem Kundenkonto herunter.
2. Gehen Sie im Back-Office zu Module > Modul-Manager.
3. Klicken Sie auf Modul hochladen und legen Sie das Archiv ab.
4. Klicken Sie nach der Installation auf Konfigurieren.

Bei der Installation erstellt das Modul seine Tabellen (Kampagnen, Staffeln, Teilnehmer), registriert seine Hooks und fügt den Reiter Sammelbestellung unter Katalog hinzu. Sie können sofort Ihre erste Kampagne erstellen.

Allgemeine Moduleinstellungen

Die Konfigurationsseite bündelt die globalen Einstellungen, die für alle Kampagnen gelten:

• Hauptfarbe und Akzentfarbe: werden auf das Produktseiten-Widget angewendet (Fortschrittsbalken, Badges, aktueller Preis).
• E-Mail bei rückwirkender Erstattung senden: benachrichtigt den Käufer, wenn ihm ein Gutschein gewährt wird.
• Gültigkeitsdauer der Gutscheine: Anzahl der Tage, die die rückwirkenden Gutscheine gültig bleiben (standardmäßig 30).
• Aktualisierungsintervall: wie oft sich das Widget live aktualisiert, in Sekunden (standardmäßig 30).

Eine Sammelbestellungs-Kampagne erstellen

Klicken Sie im Reiter Katalog > Sammelbestellung auf Kampagne hinzufügen. Eine Kampagne verknüpft ein Produkt mit einem Staffelraster, über ein Datumsfenster.

• Referenz: interne Kennung der Kampagne (freier Text).
• Produkt: suchen und wählen Sie das betreffende Produkt. Sie können eine bestimmte Variante ansprechen oder „alle Varianten“ belassen.
• Name und Beschreibung: übersetzbare Texte, im Widget angezeigt.
• Zählmodus: siehe den eigenen Abschnitt weiter unten.
• Nur gültige Bestellungen: zählt nur bestätigte Bestellungen (empfohlen).
• Referenzpreis: der Ausgangspreis (durchgestrichen) vor jeder Staffel.
• Start- / Enddatum: das Aktivitätsfenster der Kampagne.
• Rückwirkende Erstattung: siehe den eigenen Abschnitt.
• Aktiv: aktiviert oder pausiert die Kampagne.

Die Staffeln definieren

Jede Staffel verknüpft eine Schwelle (Anzahl Käufer, Einheiten oder Kunden je nach Modus) mit einem Stückpreis netto. Fügen Sie so viele Staffeln hinzu wie nötig, zum Beispiel:

10 Käufer  → 18,00 € netto
50 Käufer  → 15,00 € netto
100 Käufer → 12,00 € netto

Bei jedem Speichern berechnet das Modul die aktuelle Staffel neu und aktualisiert den spezifischen Preis. Die Preise müssen mit steigender Schwelle sinken.

Die Zählmodi

Der Zählmodus bestimmt, was den kollektiven Zähler vorantreibt:

• Bestellungen: Anzahl verschiedener Bestellungen, die das Produkt enthalten.
• Verkaufte Einheiten: Gesamtmenge der verkauften Einheiten des Produkts.
• Verschiedene Kunden: Anzahl verschiedener Kunden, die das Produkt gekauft haben.

Die Option Nur gültige Bestellungen beschränkt die Zählung auf Bestellungen, die von PrestaShop als gültig betrachtet werden (Zahlung akzeptiert usw.), was das Zählen stornierter oder ausstehender Bestellungen vermeidet.

Der kollektive Preis in Echtzeit

Sobald eine Bestellung validiert wird oder ihren Status ändert, zählt das Modul die Kampagne neu, ermittelt die erreichte Staffel und aktualisiert den spezifischen Preis, der für alle Käufer gilt. Der neue Preis erscheint sofort überall, ohne Eingriff. Kein CRON ist erforderlich: Alles wird durch Bestellereignisse gesteuert.

Mengen-Staffelpreis (Großeinkauf)

Im Modus Verkaufte Einheiten überschreitet ein Kunde, der eine große Menge auf einmal bestellt, allein eine Staffel: Er erhält dann sofort den Preis dieser Staffel für seine eigene Bestellung, ohne auf den kollektiven Zähler zu warten. Zum Beispiel zahlt ein Kunde mit einer Staffel bei 10 Einheiten, der 10 in den Warenkorb legt, sofort den Preis der Staffel 10.

Diese Logik bleibt „bester Preis für alle“: Ist der aktuelle kollektive Preis bereits niedriger als der Preis der Mengenstaffel, gilt der kollektive Preis. Alles läuft über die nativen spezifischen Preise (nach Mengenstaffeln), sodass der richtige Preis schon im Warenkorb erscheint.

Rückwirkende Erstattung

Ist die Option aktiviert, gilt das Prinzip „alle zum besten Preis“: Sobald eine niedrigere Staffel freigeschaltet wird, erhalten frühere Käufer automatisch einen Rabattgutschein in Höhe der Differenz zwischen dem von ihnen gezahlten Preis und dem neuen Preis, multipliziert mit der gekauften Menge. Eine Benachrichtigungs-E-Mail wird gesendet, wenn die Sendeoption aktiv ist.

• Der Gutschein ist ein personalisierter Rabattcode (CartRule), gültig für die konfigurierte Anzahl Tage.
• Nur Käufer, die mehr als den neuen Preis gezahlt haben, erhalten einen Gutschein.
• Der effektive Preis jedes Teilnehmers wird aktualisiert, um jede Doppelerstattung bei späteren Senkungen zu vermeiden.

Das Produktseiten-Widget

Auf der Produktseite zeigt das Modul ein Widget, das die kollektive Dynamik in Szene setzt:

• Ein Badge und der durchgestrichene Referenzpreis neben dem aktuellen Preis.
• Der kollektive Zähler und ein Fortschrittsbalken zur nächsten Staffel.
• Die vollständige Staffelleiter, mit hervorgehobener aktueller Staffel.
• Ein Countdown bis zum Kampagnenende.
• Ein Hinweis zur rückwirkenden Erstattung, wenn die Option aktiv ist.

Alles aktualisiert sich live per AJAX, im in den Einstellungen festgelegten Intervall, ohne die Seite neu zu laden.

FAQ und Fehlerbehebung

Das Widget erscheint nicht auf dem Produkt

Prüfen Sie, dass eine aktive Kampagne dieses Produkt anspricht, dass das heutige Datum zwischen dem Start- und Enddatum liegt und dass die Kampagne zum aktuellen Shop gehört. Wenn Sie eine bestimmte Variante ansprechen, erscheint das Widget nur für diese Variante.

Der Preis sinkt nicht, obwohl die Schwelle erreicht ist

Die Neuberechnung wird durch die Bestellvalidierung und Statusänderungen ausgelöst. Wenn Sie nur gültige Bestellungen zählen, stellen Sie sicher, dass die betreffenden Bestellungen in einem gültigen Status sind. Ein einfaches Bearbeiten und Speichern der Kampagne erzwingt ebenfalls eine Neuberechnung.

Ein Großbesteller erhält nicht den Preis seiner Menge

Der Mengen-Staffelpreis funktioniert nur im Modus Verkaufte Einheiten und für Schwellen größer oder gleich 2. Im Modus Bestellungen oder Kunden überschreitet die Menge einer Bestellung keine Staffel von allein.

Funktioniert es mit Varianten?

Ja. Eine Kampagne kann eine bestimmte Variante oder alle Varianten eines Produkts ansprechen. Eine Kampagne, die eine bestimmte Variante anspricht, hat Vorrang vor einer „alle Varianten“-Kampagne.

Was passiert bei der Deinstallation?

Die Deinstallation entfernt die vom Modul erstellten spezifischen Preise, löscht seine Hooks und seinen Reiter und bereinigt seine Tabellen. Bereits ausgestellte Rabattgutscheine bleiben auf Kundenseite gültig.