„Ab“-Preis-Modul (dffromprice) — Dokumentation

Das Modul dffromprice („Ab“) zeigt den niedrigsten Mengenpreis direkt in Ihren Produktlisten an, sobald ein Produkt einen Mengenrabatt hat. Diese Dokumentation behandelt Installation, vollständige Konfiguration und Fehlerbehebung.

Überblick

Wenn ein Produkt Mengenrabatte hat (zum Beispiel „3 kaufen = 20 % sparen“), ist diese Information nur auf der Produktseite ganz unten sichtbar. Das Modul bringt ein „Ab X“-Label auf das Produkt-Vorschaubild, in Kategorien, Suche, Cross-Selling- und Empfehlungsblöcke. Der angezeigte Preis wird mit dem nativen Mechanismus von PrestaShop berechnet, unter Berücksichtigung von Kundengruppe, Währung, Land und Steuerberechnungsmethode.

Installation

Über das Back-Office

1. Gehen Sie zu Module > Modul-Manager.
2. Klicken Sie auf Modul hochladen und wählen Sie die ZIP-Datei des Moduls aus.
3. Nach Abschluss des Uploads installiert sich das Modul automatisch und registriert seine Hooks.

Per FTP

1. Entpacken Sie das Archiv und legen Sie den Ordner dffromprice in das Verzeichnis /modules Ihres Shops.
2. Suchen Sie in Module > Modul-Manager nach „Ab“ und klicken Sie auf Installieren.

Einstellungen

Die Konfiguration finden Sie unter Module > Modul-Manager > dffromprice > Konfigurieren. Sie ist in zwei Bereiche gegliedert.

Anzeige

• Modul aktivieren: Hauptschalter.
• In Produktlisten anzeigen: Kategorien, Suche, Cross-Selling, hervorgehobene Produkte.
• Auf der Produktseite anzeigen: fügt den „Ab“-Preis nach dem Hauptpreis der Produktseite hinzu.
• Label: Text vor dem Preis, pro Sprache übersetzbar („Ab“, „From“…).
• Mindestmenge anzeigen: gibt die für den besten Preis erforderliche Menge an.
• Mengen-Label: Text zur Menge, mit der Variable %qty% (z. B. „ab %qty% Stück“).
• Ersparnisprozentsatz anzeigen: „-21%“-Badge basierend auf der Differenz zwischen Grundpreis und bestem Mengenpreis.
• Steuer-Label (Brutto/Netto): Nie, Gemäß Shop-Einstellungen, oder Immer.
• Anzeigemodus: Normalen Preis ersetzen oder Zusätzlich zum normalen Preis anzeigen.
• Auszublendende(r) CSS-Selektor(en): im Ersetzungsmodus ausgeblendete CSS-Selektoren, wenn der „Ab“-Preis angezeigt wird.

Erscheinungsbild und Einschränkungen

• Textfarbe: Farbwähler, standardmäßig #f1a019.
• Mindestersparnis zur Anzeige (%): blendet den „Ab“-Preis aus, wenn die Ersparnis unter diesem Prozentsatz liegt. 0 = immer anzeigen.
• Ausgeschlossene Produkt-IDs: durch Kommas getrennte Liste von IDs.
• Ausgeschlossene Kategorie-IDs: durch Kommas getrennte Liste von IDs (basierend auf der Standardkategorie des Produkts).
• Benutzerdefiniertes CSS: auf jeder Front-Office-Seite hinzugefügt, um den Block .df-fromprice und seine Kinder anzusprechen.

Funktionsweise und Preisberechnung

Das Modul stützt sich auf SpecificPrice::getQuantityDiscounts() mit denselben Parametern wie die native „Mengenrabatt“-Tabelle (Shop, Währung, Land, Kundengruppe, Kunde). Für jede Mengenstufe größer als 1 wird der tatsächliche Stückpreis über Product::getPriceStatic() berechnet. Der „Ab“-Preis wird nur angezeigt, wenn dieser Preis strikt niedriger als der Grundpreis ist. Ein statischer Cache pro Produkt und Kombination garantiert eine einzige Berechnungsabfrage pro Vorschaubild innerhalb einer Seite.

Theme-Kompatibilität

Das Modul klinkt sich in den Hook displayProductPriceBlock ein, der in jeder Standard-PrestaShop-Produktliste vorhanden ist. Im Ersetzungsmodus wird der normale Preis durch den konfigurierbaren CSS-Selektor ausgeblendet. Der Standardwert deckt Classic-basierte Themes und das Falcon-Theme ab:

.df-fromprice + .wrapper-price-taxe, .df-fromprice + .price

Für ein anderes Theme untersuchen Sie den Preis-Container im Vorschaubild und passen Sie den Selektor entsprechend an.

Fehlerbehebung

Der „Ab“-Preis erscheint nicht

• Prüfen Sie, ob das Produkt tatsächlich einen Mengenrabatt hat (Mengenstufe größer als 1) und ob der Stufenpreis niedriger als der Grundpreis ist.
• Prüfen Sie, ob die Anzeige in Produktlisten aktiviert ist.
• Überprüfen Sie die Mindestersparnis-Schwelle: Ist sie zu hoch, kann die Anzeige blockiert sein.
• Stellen Sie sicher, dass das Produkt oder seine Kategorie nicht in den Ausschlüssen steht.

Der normale Preis bleibt im Ersetzungsmodus sichtbar

Der Ausblende-CSS-Selektor passt nicht zum Preis-Container Ihres Themes. Passen Sie das Feld „Auszublendende(r) CSS-Selektor(en)“ an und leeren Sie dann den Cache.