DF Quantity Tiers — Dokumentation

Überblick und Voraussetzungen

DF Quantity Tiers verwandelt die nativen Mengenrabatte von PrestaShop in einen klaren, anklickbaren Verkaufsblock. Das Modul führt keine neue Preislogik ein: Es liest die bereits in Ihrem Katalog konfigurierten mengenbasierten Spezialpreise und stellt sie als Karten oder Tabelle dar, mit einem In-den-Warenkorb-Button für jede Staffel.

• Kompatibel mit PrestaShop 8.0 bis 9.x, dem Classic-Theme und davon abgeleiteten Themes.
• PHP 7.4 bis 8.3.
• Multistore und mehrsprachig (FR/EN/ES/DE/IT).
• Keine Datei-Overrides: nur native Hooks.

Installation

Installieren Sie das Modul wie jedes PrestaShop-Modul:

1. Laden Sie das Archiv dfquantitytiers-1.1.0.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 registriert das Modul seine Hooks, legt seine Statistiktabelle an und füllt einen in alle fünf Sprachen übersetzten Blocktitel vor. Ihre bestehenden Mengenrabatte erscheinen sofort auf den betreffenden Produktseiten.

Aktualisierung von 1.0.0

Die Aktualisierung auf 1.1.0 erfolgt normal über den Modul-Manager. Das integrierte Upgrade-Skript legt die Statistiktabelle an, registriert den neuen Hook der Warenkorbseite und wendet die Standardwerte der neuen Optionen an (Steuermodus, JSON-LD, Warenkorb-Upsell, Statistiken, Verpackungsbezeichnungen). Es ist keine manuelle Aktion erforderlich und Ihre bestehende Konfiguration bleibt erhalten.

Allgemeine Konfiguration

Die Konfigurationsseite bündelt alle Anzeigeeinstellungen:

• Blocktitel: über den Staffeln angezeigter Text, pro Sprache übersetzbar.
• Layout: „Karten“ (empfohlen, eine Karte pro Staffel) oder „Kompakte Tabelle“ (eine Zeile pro Staffel).
• Position auf der Produktseite: unter dem Kaufblock (Hook displayProductAdditionalInfo, Standard) oder direkt unter dem Preis (Hook displayProductPriceBlock).
• Akzentfarbe: angewendet auf die „Bestes Angebot“-Staffel, Badges und Buttons.
• Anzeige der Ersparnis: als Prozentsatz, als Betrag oder beides.
• Gesamtpreis der Staffel anzeigen: fügt den Gesamtpreis für die Staffelmenge hinzu.
• Staffel „pro Stück“ anzeigen: zeigt den Basispreis als erste Vergleichsstaffel an.

Steuermodus (B2B)

Der Steuermodus legt fest, ob die Staffelpreise netto oder brutto angezeigt werden:

• Automatisch: folgt der Anzeigeeinstellung der aktuellen Kundengruppe (Standardverhalten von PrestaShop).
• Netto erzwingen: zeigt die Preise immer netto an, mit dem Hinweis „netto“ neben jedem Stückpreis. Ideal für einen B2B-Shop.
• Brutto erzwingen: zeigt die Preise immer brutto an, mit dem Hinweis „brutto“.

Der gewählte Modus gilt sowohl für die Karten auf der Produktseite als auch für den Upsell-Block im Warenkorb.

Verpackungsbezeichnungen

Sie können jeder Menge eine geschäftliche Bezeichnung zuordnen, zum Beispiel „Karton“ oder „Palette“. Geben Sie im Feld Verpackungsbezeichnungen eine Zuordnung pro Zeile im Format Menge=Bezeichnung ein:

12=Karton à 12
48=Halbe Palette
96=Palette

Die Bezeichnung wird unter der Menge der entsprechenden Staffel angezeigt. Dieses Feld ist übersetzbar: Füllen Sie es für jede Sprache über die Sprachauswahl im Formular aus.

Upsell zur nächsten Staffel

Zwei Anreizmechanismen stehen zur Verfügung und können unabhängig voneinander aktiviert werden.

Auf der Produktseite

Ein Fortschrittsbalken zeigt eine Meldung wie „Noch 3 Einheit(en) hinzufügen, um 15 % zu sparen“ an, die je nach eingegebener Menge in Echtzeit neu berechnet wird. Erreicht der Kunde die vorteilhafteste Staffel, wechselt die Meldung zu „Sie erhalten den besten Rabatt!“.

Auf der Warenkorbseite

Für jedes Warenkorbprodukt, bei dem eine höhere Staffel noch erreichbar ist, zeigt das Modul unter dem Warenkorb einen Block mit „Noch N Einheiten hinzufügen, um X / Stück zu erreichen“ sowie einen Ein-Klick-Button an. Der Button nutzt den nativen Warenkorb-Aktualisierungsmechanismus von PrestaShop und lädt die Seite anschließend neu. Ist keine höhere Staffel erreichbar, wird kein Block angezeigt.

Strukturierte Daten (JSON-LD)

Wenn die Option aktiviert ist, fügt das Modul auf der Produktseite ein JSON-LD-Markup vom Typ AggregateOffer hinzu, mit einem Angebot pro Staffel und der zugehörigen zulässigen Menge. So können Suchmaschinen Ihre mengenbasierten Preisspannen verstehen.

Klickstatistiken pro Staffel

Wenn die Option aktiviert ist, wird jeder Klick auf einen Staffel-Button anonym erfasst: Produkt, Variante, Menge und Rabatt der angeklickten Staffel. Es werden keine personenbezogenen Daten und keine Cookies verwendet, wodurch die Funktion DSGVO-konform ist.

Die Konfigurationsseite zeigt ein 30-Tage-Dashboard: Gesamtzahl der Klicks und die meistgeklickten Kombinationen aus Produkt / Staffel / Rabatt. Diese Daten helfen Ihnen, Ihre Rabatte zu kalibrieren, indem sie zeigen, welche Staffeln tatsächlich Warenkorb-Hinzufügungen auslösen.

FAQ und Fehlerbehebung

Der Block erscheint bei einem Produkt nicht

Prüfen Sie, ob das Produkt Spezialpreise mit einer Startmenge größer als 1 hat und ob diese Preise für die aktuelle Kundengruppe, Währung und das aktuelle Land gelten. Die Basisstaffel allein löst die Anzeige nicht aus, wenn keine Rabattstaffel existiert.

Der Hinzufügen-Button funktioniert mit meinem Theme nicht

Das Modul stützt sich auf den standardmäßigen In-den-Warenkorb-Button des Classic-Themes. Stellen Sie bei einem stark angepassten Theme sicher, dass das Mengenfeld und der Hinzufügen-Button dem Standard-Markup von PrestaShop folgen.

Funktioniert es mit Varianten?

Ja. Die Staffeln werden für jede Variante neu berechnet und der Block aktualisiert sich automatisch beim Variantenwechsel, ohne Seitenneuladen.

Was passiert bei der Deinstallation?

Die Deinstallation entfernt die Hooks, Konfigurationsvariablen und die Statistiktabelle sauber. Es bleiben keine Restdaten in der Datenbank zurück.