Mengenaktionen & Aktions-Badges: Dokumentation

Installation

Das Modul wird wie jedes andere PrestaShop-Modul installiert, über das Backoffice oder per FTP.

1. Unter Module und dann Modul-Manager auf Modul hochladen klicken und die Datei dfquantitydeal.zip ablegen.
2. Per FTP das Archiv in den Ordner /modules/ Ihres Shops entpacken und anschließend DataFirefly – Mengenrabatte und Aktions-Badges im Modul-Manager installieren.
3. Den Cache unter Erweiterte Einstellungen und dann Leistung leeren.

Die Installation legt acht Tabellen mit dem Präfix ps_df_quantity_deal an, hängt das Modul in neun Hooks ein, erstellt den Hook displayDfQdBadge und ergänzt den Reiter Mengenrabatte im Menü Katalog.

Sprachen des Moduls

Französisch ist die Ausgangssprache des Moduls. Die Übersetzungen werden im Ordner translations/ für Englisch, Italienisch, Spanisch, Deutsch, Niederländisch, Polnisch und Portugiesisch mitgeliefert.

• Das Back-Office wird in der Sprache des angemeldeten Mitarbeiters angezeigt.
• Die Texte, die der Kunde sieht (Sätze im Angebotsblock, Hinweise im Warenkorb, Schaltflächen), folgen der Sprache des Shops.
• Der Menüreiter erhält in jeder installierten Sprache seinen übersetzten Namen.
• Solange die Bezeichnung des Warenkorbrabatts ihren Standardwert behält, wird sie in der Sprache des Kunden übersetzt angezeigt. Wenn Sie sie in den allgemeinen Einstellungen anpassen, wird Ihr Text in allen Sprachen verwendet.

Um eine Formulierung anzupassen, gehen Sie zu International und dann Übersetzungen, Typ Übersetzungen installierter Module, Modul dfquantitydeal.

Allgemeine Einstellungen

Die Schaltfläche Konfigurieren auf der Modulseite öffnet die Einstellungen, die für alle Angebote gelten.

• Modul aktivieren: schaltet Badge-Anzeige und Rabattberechnung ab, ohne zu deinstallieren.
• Badges in Produktlisten: zeigt das Badge auf den Vorschaubildern in Kategorieseiten, Suchergebnissen und Produktblöcken.
• Badge auf der Produktseite: separater Schalter, falls Sie das Badge nur in Listen anzeigen möchten.
• Angebotstabelle auf der Produktseite: zeigt den Block, der die für das Produkt geltenden Angebote auflistet.
• Aufschlüsselung der Angebote im Warenkorb: zeigt den Betrag, den jedes Angebot beisteuert.
• Position der Angebotsaufschlüsselung: „Akkordeon unter der Zeile Rabatt(e)“ (voreingestellt), „Über der Zeile Versand“, „Unter der Warenkorbsumme (inkl. MwSt.)“ oder „Unter der Produktliste (Standardposition)“.
• Badge und durchgestrichener Preis in den Warenkorbzeilen: zeigt in jeder betroffenen Zeile das Angebots-Badge, streicht den ursprünglichen Preis durch und zeigt darunter den reduzierten Preis.
• Automatischen Gutschein ausblenden: entfernt die vom Modul erzeugte Gutscheinzeile aus der Übersicht, da sie bereits in der Zeile Rabatt(e) enthalten ist. So kann der Kunde keinen Rabatt löschen, der bei jeder Warenkorbänderung neu berechnet wird.
• Zum Vervollständigen des Pakets im Warenkorb anregen: zeigt einen Hinweis an, wenn nur noch wenige Artikel bis zum Auslösen eines Angebots fehlen.
• Rabatte inkl. MwSt. berechnen: aktiviert trägt die Warenkorbregel einen Betrag inklusive Steuern. Deaktiviert ist der Betrag netto, und PrestaShop wendet die Mehrwertsteuer nach Ihren Regeln an.
• Bezeichnung des Warenkorbrabatts: Text in der Rabattzeile von Warenkorb und Bestellung.
• Schriftgröße des Badges (px): standardmäßig 13.
• Anzeigemethode der Badges: automatisch (Einfügen per Frontend-Skript), manuell (nur über den Hook displayDfQdBadge) oder beides.
• Position der Angebote auf der Produktseite: siehe den eigenen Abschnitt weiter unten.
• Eigener CSS-Selektor und Position relativ zum Selektor: nur mit der Position „Eigener CSS-Selektor“ verwendet.

Diagnose

Die Konfigurationsseite zeigt über den Einstellungen einen Bereich Diagnose. Er gibt an, ob das Modul aktiviert ist, ob jeder benötigte Hook in der Datenbank existiert und ob das Modul darin eingehängt ist, wie viele Angebote heute aktiv sind und wie viele dem aktuellen Shop zugeordnet sind.

Der Link Badge-Endpunkt testen öffnet den Frontend-Controller, der die Badges liefert. Eine JSON-Antwort bestätigt, dass er antwortet. Ein 404-Fehler bedeutet, dass Sie den Cache leeren und die sprechenden URLs neu erzeugen müssen.

Ein Angebot anlegen

Öffnen Sie Katalog und dann Mengenrabatte, und klicken Sie auf Neues Angebot. Das Formular ist in drei Reiter gegliedert.

Reiter Angebot

• Name des Angebots: übersetztes Feld, genutzt in der Backoffice-Liste und im Angebotsblock der Produktseite.
• Angebotsart: die sechs unten beschriebenen Mechaniken. Das Formular blendet die Felder aus, die für die gewählte Art nicht gelten.
• Gekaufte Menge (X) und Gratismenge (Y): für die Art X kaufen + Y gratis, und X allein für den Paketpreis.
• Position des rabattierten Artikels (N): 2 für „der 2. Artikel -25 %“, 3 für „der 3. Artikel -50 %“.
• Rabattwert: Prozentsatz, Rabattbetrag oder Festpreis je nach Angebotsart. Die Feldbezeichnung passt sich automatisch an.
• Rabattstufen: nur für den Staffelrabatt. Eine Tabelle, in der jede Zeile eine Mindestmenge mit einem Prozentsatz verknüpft. Der Button Stufe hinzufügen legt eine Zeile an, der Papierkorb löscht sie. Jede Stufe muss einen höheren Rabatt bieten als die vorherige.
• Bereits reduzierte Produkte: nur für den Staffelrabatt. Kumulieren wendet die Stufe auf den bereits reduzierten Preis an, Nicht kumulieren behält den besseren der beiden Rabatte. Siehe den eigenen Abschnitt weiter unten.
• Wiederholbares Angebot: aktiviert gilt das Angebot so oft, wie die Menge es zulässt (12 Artikel lösen ein Angebot 4+2 zweimal aus). Deaktiviert gilt es nur einmal pro Warenkorb. Beim Staffelrabatt ist das Feld ausgeblendet, da er immer die gesamte Menge betrifft.
• Mengenbündelung: pro Produkt, pro Variante oder Mix and Match.
• Priorität: niedrigere Werte werden zuerst angewendet.
• Angebot aktivieren: entspricht dem Aktivierungsschalter in der Liste.

Reiter Bedingungen

• Geltungsbereich: gesamter Katalog, ausgewählte Produkte, ausgewählte Kategorien oder ausgewählte Marken. Das passende Auswahlfeld erscheint je nach Wahl.
• Betroffene Produkte: mindestens zwei Zeichen eingeben, um die Suche zu starten. Sie durchsucht Name, Artikelnummer und ID. Ein Klick auf ein Ergebnis fügt es der Liste hinzu.
• Betroffene Kategorien: Kategoriebaum mit Kontrollkästchen. Ein Produkt in einer der markierten Kategorien löst das Angebot aus.
• Betroffene Marken: Liste der Hersteller des Shops.
• Kundengruppen: alles abgewählt lassen, damit das Angebot für alle Gruppen einschließlich Besucher gilt.
• Bereits reduzierte Produkte ausschließen: Produkte mit einem Sonderpreis fallen aus der Berechnung.
• Kunden mit Sonderpreis ausschließen: Ein Kunde, dessen Kundenkonto oder Standard-Kundengruppe einen Sonderpreis für das Produkt hat, erhält weder den Rabatt noch das Badge. Siehe den eigenen Abschnitt weiter unten.
• Startdatum und Enddatum: leer lassen für ein dauerhaftes Angebot. Ein Datum ohne Uhrzeit wird für den Start mit 00:00:00 und für das Ende mit 23:59:59 ergänzt.
• Shops: nur sichtbar, wenn der Multishop-Modus aktiv ist.

Reiter Badge und Anzeige

• Badge-Text: übersetztes Feld. Leer lassen für eine automatische Erzeugung aus den Werten des Angebots.
• Hintergrundfarbe und Textfarbe: Farbwähler, standardmäßig Rot und Weiß.
• Form: quadratisch, abgerundete Ecken, Pille, diagonales Band, runder Sticker.
• Position auf dem Vorschaubild: oben links, oben rechts, unten links, unten rechts oder „Inline (unter dem Preis)“.
• In Produktlisten anzeigen, Auf der Produktseite anzeigen, In der Angebotstabelle anzeigen: drei Schalter je Angebot, zusätzlich zu den globalen Einstellungen.
• Angebotsbeschreibung: übersetzter Rich Text, angezeigt im Angebotsblock der Produktseite.

Die sechs Angebotsarten

X kaufen + Y gratis

Das klassische Format 2+1, 3+1 oder 4+2. Die Engine teilt die in Frage kommenden Einheiten des Warenkorbs in Pakete aus X plus Y. Für jedes vollständige Paket sind die Y günstigsten Einheiten gratis.

Beispiel: Angebot 4+2, sechs Artikel zu 4,49 € im Warenkorb. Ein vollständiges Paket, zwei Gratiseinheiten, 8,98 € Rabatt. Bei nur fünf Artikeln ist kein Paket vollständig und der Rabatt beträgt null.

Der N-te zu -X %

Die Engine teilt die Einheiten in Pakete zu N. In jedem Paket erhält die Einheit auf Position N den prozentualen Rabatt. Da die Einheiten absteigend nach Preis sortiert sind, ist der rabattierte Artikel der günstigste des Pakets.

Beispiel: Angebot „der 2. Artikel -25 %“, vier Artikel zu 20 €. Zwei Pakete zu zwei, zwei Artikel mit je 5 € Rabatt, insgesamt 10 € Rabatt.

Der N-te mit festem Rabattbetrag

Gleiche Aufteilung, der Rabatt ist jedoch ein fester Betrag. Er ist auf den Artikelpreis begrenzt: 30 € Rabatt auf einen Artikel zu 8 € ergeben 8 € Rabatt, nicht 30 €.

Der N-te zum Festpreis

Der Artikel auf Position N wird auf den von Ihnen festgelegten Preis gesenkt. Der Rabatt entspricht der Differenz. Bei „der 2. Artikel für 1 €“ auf zwei Artikel zu 12 € beträgt der Rabatt 11 €.

Paketpreis

Für jedes Paket aus X Einheiten wird die Summe auf den von Ihnen beworbenen Preis gesenkt. Bei einem Angebot 3 für 10 € mit sechs Artikeln zu 5 € bildet die Engine zwei Pakete und gewährt insgesamt 10 € Rabatt.

Staffelrabatt

Sie legen Mengenschwellen fest, jede mit ihrem eigenen Prozentsatz. Die höchste erreichte Stufe gilt für jeden Artikel des Angebots, nicht nur für den letzten.

Beispiel: Stufen -5 % ab 2 Artikeln und -10 % ab 3. Ein Artikel: kein Rabatt. Zwei Artikel zu 10 € und 20 €: 1,50 € Rabatt (5 % von 30 €). Vier Artikel für 50 €: 5 € Rabatt, also -10 % auf alle vier.

Um eine Stufe mit verschiedenen Produkten zu erreichen, zum Beispiel über eine ganze Kategorie, wählen Sie die Mengenbündelung Mix and Match. Bei der Bündelung Pro Produkt muss jede Referenz die Stufe für sich erreichen. Der Staffelrabatt ist nicht wiederholbar: Er betrifft immer die gesamte Menge.

Welcher Artikel gratis ist

Die Engine sortiert die in Frage kommenden Einheiten absteigend nach Preis und wendet den Vorteil auf die günstigsten jedes Pakets an. Das ist die Regel des Einzelhandels und die, die der Kunde erwartet.

Bei einem 3+1-Paket aus Artikeln zu 20 €, 15 €, 10 € und 5 € ist der Gratisartikel der zu 5 €. Der Kunde zahlt 45 € statt 50 €.

Diese Regel betrifft nicht den Staffelrabatt, der für jeden Artikel des Angebots gilt.

Mengenbündelung

• Pro Produkt: alle Varianten derselben Referenz zählen zusammen. Sechs Flaschen desselben Duschgels lösen ein Angebot 4+2 aus, auch wenn es drei verschiedene Duftrichtungen sind.
• Pro Variante: jede Variante zählt für sich. Für dasselbe Angebot braucht es sechs Einheiten derselben Duftrichtung.
• Mix and Match: alle Einheiten der dem Angebot zugeordneten Produkte fließen in dieselbe Zählung. Nützlich für ein 4+2 über eine ganze Serie.

Priorität und Kombination von Angeboten

Die Angebote werden in der Reihenfolge ihrer Priorität geprüft, vom niedrigsten zum höchsten Wert. Jedes Angebot verbraucht die Einheiten, die es nutzt, und das nächste arbeitet mit dem Rest. Dieselbe Einheit wird nie zweimal rabattiert.

Beispiel: sieben Artikel im Warenkorb und ein Angebot 4+2 mit Priorität 10. Das Paket verbraucht sechs Einheiten, die siebte bleibt für ein Angebot mit Priorität 20 auf dasselbe Produkt verfügbar.

Bereits reduzierte Produkte und ausgehandelte Preise

Standardmäßig gilt ein Angebot auf dem im Warenkorb angezeigten Preis, also nach Sonderpreisen und Katalogpreisregeln. Drei Einstellungen passen dieses Verhalten an.

Bereits reduzierte Produkte ausschließen

Jedes Produkt, dessen Warenkorbzeile eine Reduzierung trägt, fällt aus der Berechnung des Angebots. Es zählt auch nicht zum Erreichen der erforderlichen Menge.

Kunden mit Sonderpreis ausschließen

Gedacht für B2B-Shops und ausgehandelte Tarife. Das Modul prüft Produkt für Produkt, ob ein aktiver Sonderpreis existiert, der dem angemeldeten Kunden oder seiner Standard-Kundengruppe vorbehalten ist. Ist das der Fall, fällt dieses Produkt für diesen Kunden aus dem Angebot: kein Rabatt im Warenkorb, kein Badge auf dem Vorschaubild oder der Produktseite.

• Nur die Standard-Kundengruppe zählt, wie in der Preisberechnung von PrestaShop. Ein Kunde, der zusätzlich einer zweiten Gruppe mit Sonderpreis angehört, ohne dass sie seine Standardgruppe ist, zahlt den normalen Preis und behält das Angebot.
• Sonderpreise, die für alle Kunden und alle Gruppen gelten, lösen den Ausschluss nicht aus.
• Der Sonderpreis wird berücksichtigt, wenn er am heutigen Datum aktiv ist, für den Shop, die Währung und das Land des Kunden. Die Mindestmenge des Sonderpreises spielt keine Rolle.
• Ein Sonderpreis, der nur für eine Variante gilt, schließt im Warenkorb nur diese Variante aus. Das Badge bleibt sichtbar, solange der Preis nicht das ganze Produkt abdeckt.

Kumulierung der Stufen

Beim Staffelrabatt bietet die Einstellung Bereits reduzierte Produkte im Reiter Angebot zwei Modi.

• Kumulieren (Standard): Der Prozentsatz der Stufe gilt auf den bereits reduzierten Preis. Ein Produkt zu 20 €, das ein Sonderpreis auf 18 € senkt, kostet mit einer Stufe von -10 % am Ende 16,20 €.
• Nicht kumulieren: Die Stufe wird auf den Preis vor der Reduzierung berechnet, und der Kunde zahlt den niedrigeren der beiden Preise. Ein Produkt mit bereits -20 % bleibt bei einer Stufe von -10 % bei -20 %. Ein Produkt mit -5 % sinkt auf -10 %.

In beiden Modi zählen bereits reduzierte Artikel zum Erreichen der Stufe.

Das Badge

Variablen im Text

Das Feld Badge-Text akzeptiert fünf Variablen, die bei der Anzeige durch die Werte des Angebots ersetzt werden.

• {x}: gekaufte Menge
• {y}: Gratismenge
• {n}: Position des rabattierten Artikels
• {value}: Rabattwert, ohne überflüssige Nullen
• {price}: Rabattwert als Preis formatiert, in der Währung des Kunden

Sie können den Text auch fest ausschreiben: „4+2 gratis“, „3+1 gratis“, „der 2. Artikel -25 %“. Das Feld ist übersetzt, jede Sprache hat also ihre eigene Formulierung.

Bleibt das Feld leer, erzeugt das Modul eine kurze Bezeichnung aus Art und Werten: 4+2 für ein Angebot X kaufen + Y gratis, -25% x2 für einen N-ten mit Prozentsatz, Bis zu -10 % für einen Staffelrabatt oder -10 % ab 3, wenn es nur eine Stufe gibt.

Beim Staffelrabatt entspricht {x} der Menge der ersten Stufe und {value} dem Prozentsatz der höchsten Stufe.

Automatische Anzeige

Standardmäßig erkennt ein Frontend-Skript die Produktvorschaubilder der Seite, fragt deren Badges in einem einzigen Ajax-Aufruf beim Modul ab und setzt sie je nach Position des Angebots auf das Bild oder unter den Preis. Dieser Ablauf hängt von keinem Vorschaubild-Hook ab und funktioniert damit auch in individuellen Themes, die displayProductPriceBlock nicht mehr aufrufen. Die Platzierung wird nach Ajax-Aktualisierungen aus Facettensuche, Seitennavigation und Quick View wiederholt.

Eigener Hook displayDfQdBadge

Um das Badge an einer bestimmten Stelle Ihres Themes oder eines anderen Moduls zu platzieren, rufen Sie den eigenen Hook im Template auf:

{hook h='displayDfQdBadge' id_product=$product.id_product}

Zwei optionale Parameter stehen zur Verfügung.

• mode: auto (Standard) folgt der in jedem Angebot eingestellten Position, inline erzwingt die Anzeige im Seitenfluss, overlay erzwingt die Überlagerung des Bildes. Der Container erhält automatisch position: relative.
• context: list oder product, um die Einstellungen „Produktlisten“ oder „Produktseite“ des Angebots anzuwenden. Fehlt der Parameter, wird er automatisch erkannt.

{hook h='displayDfQdBadge' id_product=$product.id_product mode='inline'}

Der Hook erscheint unter Design und dann Positionen mit dem Namen „DataFirefly – Badge offre quantitative“.

Der Angebotsblock auf der Produktseite

Für jedes geltende Angebot zeigt der Block das Badge, den Namen des Angebots, einen Satz, der dem Kunden sagt, was zu tun ist, und die Beschreibung, falls Sie eine eingegeben haben. Beispielsätze: „Legen Sie 6 Artikel in den Warenkorb, die letzten 2 sind gratis.“, „Legen Sie 3 Artikel in den Warenkorb, das Paket kostet Sie 10,00 €.“ Die Überschrift „Aktuelle Angebote“ erscheint nur, wenn eines der Angebote ein Enddatum hat.

Die Einstellung Position der Angebote auf der Produktseite bietet elf Positionen:

• über oder unter dem Produkttitel;
• unter der Artikelnummer, unter der Kurzbeschreibung;
• über oder unter dem Preis;
• über den Varianten;
• über dem Warenkorb-Button oder unter diesem Button (Standardposition, voreingestellt);
• in einem eigenen Tab auf der Produktseite;
• über einen eigenen CSS-Selektor.

Der Block wird vom nativen Hook displayProductAdditionalInfo ausgegeben und dann im Browser verschoben, ohne Ihr Theme zu ändern. Der eigene Tab läuft über displayProductExtraContent. Beim eigenen CSS-Selektor geben Sie zum Beispiel .product-information h1 ein und wählen, ob der Block direkt vor dem Element, direkt nach dem Element, am Anfang oder am Ende des Elements steht. Findet der Selektor nichts, bleibt der Block an der Standardposition.

Der Warenkorb

Berechnung des Rabatts

Bei jeder Änderung des Warenkorbs berechnet die Engine die Rabattsumme neu und synchronisiert eine private Warenkorbregel. Ihr interner Code beginnt mit DFQD, gefolgt von der Warenkorb-ID. Der Kunde sieht nur eine Rabattzeile und gibt keinen Code ein.

Die Regel wird nur aktualisiert, wenn sich der Betrag geändert hat, sodass sie nicht bei jedem Seitenaufruf neu erstellt wird. Fällt die Summe auf null, wird die Regel vom Warenkorb gelöst und anschließend gelöscht.

Beim Bestellabschluss wird die Regel deaktiviert und ihr Enddatum in die Vergangenheit gesetzt, damit sie nicht erneut genutzt werden kann. Sie bleibt der Bestellung zugeordnet und ist damit in Ihren Buchhaltungsexporten sichtbar und für eine Gutschrift nutzbar.

Aufschlüsselung je Angebot

Der Betrag, den jedes Angebot beisteuert, erscheint an der in den Einstellungen gewählten Position. Im Akkordeon-Modus wird die native Zeile Rabatt(e) anklickbar und klappt die Aufschlüsselung auf. Der geöffnete oder geschlossene Zustand bleibt bei Ajax-Aktualisierungen des Warenkorbs erhalten.

Produktzeilen

Mit der Option Badge und durchgestrichener Preis in den Warenkorbzeilen zeigt jede betroffene Zeile das Angebots-Badge unter dem Stückpreis, die ursprüngliche Summe durchgestrichen und darunter den reduzierten Preis. Bei Angeboten X kaufen + Y gratis nennt ein Hinweis die Zahl der Gratiseinheiten und den gesparten Betrag.

Anregung zum Vervollständigen des Pakets

Fehlen nur noch wenige Artikel bis zum Auslösen eines Angebots, weist ein Hinweisfeld „Aktuelles Angebot“ mit einem Satz wie „Noch 1 Artikel und Sie erhalten 2 gratis.“ darauf hin. Beim Staffelrabatt nennt das Hinweisfeld die nächste Stufe: „Noch 1 Artikel und alle Artikel des Angebots erhalten -10 %.“ Der Button Hinzufügen legt die fehlenden Einheiten direkt in den Warenkorb.

Zeile des automatischen Gutscheins

Die erzeugte Warenkorbregel erscheint normalerweise in der Liste der Gutscheine, obwohl ihr Betrag bereits in der Zeile Rabatt(e) enthalten ist. Die Option Automatischen Gutschein ausblenden, standardmäßig aktiviert, entfernt diese Zeile aus der Übersicht. Das Modul erkennt sie an ihrer Bezeichnung, die in den allgemeinen Einstellungen festgelegt wird.

Anzeige an Ihr Theme anpassen

Drei Templates lassen sich überschreiben. Kopieren Sie sie von /modules/dfquantitydeal/views/templates/hook/ nach /themes/ihr-theme/modules/dfquantitydeal/views/templates/hook/.

• badge.tpl: das vom Hook displayDfQdBadge ausgegebene Badge
• offers.tpl: der Angebotsblock der Produktseite
• cart.tpl: die Aufschlüsselung der Angebote und die Hinweise im Warenkorb

Das CSS ist unter dem Präfix dfqd gekapselt. Für punktuelle Anpassungen sprechen Sie die Klassen aus dem Stylesheet Ihres Themes an, statt views/css/front.css zu ändern, die beim Update überschrieben würde.

Multishop und Mehrsprachigkeit

Jedes Angebot wird den Shops zugeordnet, die Sie im Reiter Bedingungen markieren. Ein in einem Shop angelegtes Angebot erscheint in den anderen erst, wenn es dort zugeordnet ist.

Die Felder Name, Badge-Text und Beschreibung werden in die installierten Sprachen übersetzt. Badge und angezeigte Sätze folgen der Sprache des Kunden.

Update von einer früheren Version

Installieren Sie das neue ZIP über das alte im Modul-Manager. Die Update-Skripte ergänzen die seit Ihrer Version hinzugekommenen Einstellungen und Hooks, ohne Ihre Angebote anzutasten.

Das Update auf 1.1.8 stellt die Übersetzungen wieder her (Englisch, Italienisch, Spanisch, Deutsch, Niederländisch, Polnisch und Portugiesisch) und behebt das Speichern von Angeboten unter PrestaShop 9 sowie die Anzeige der Badges in den Produktlisten. Außerdem ergänzt es die Datenbank von Shops, die von 1.1.6 kommen: Die Spalten für den Ausschluss von Kunden mit spezifischem Preis und für den Staffelrabatt werden hinzugefügt, falls sie fehlen. Der Menüreiter erhält in jeder Sprache wieder seinen übersetzten Namen.

Das Update auf 1.1.7 fügt der Tabelle ps_df_quantity_deal drei Spalten für den Ausschluss von Kunden mit Sonderpreis und den Staffelrabatt hinzu. Bestehende Angebote behalten ihr Verhalten: Die beiden neuen Optionen sind standardmäßig deaktiviert.

Das Update auf 1.1.5 benennt den Menüreiter in jeder installierten Sprache um und gibt dem Hook displayDfQdBadge einen englischen Titel. Steht die Bezeichnung des Warenkorbrabatts noch auf dem früheren Standardwert „Offres quantitatives“, wird sie durch die Übersetzung in der Standardsprache des Shops ersetzt. Eine von Ihnen angepasste Bezeichnung bleibt erhalten.

Fehlerbehebung

Das Badge erscheint nicht

1. Öffnen Sie die Konfiguration des Moduls und lesen Sie den Bereich Diagnose: Modul aktiviert, Hooks eingehängt, heute aktive Angebote.
2. Prüfen Sie, ob das Angebot aktiv ist und das heutige Datum im Gültigkeitszeitraum liegt.
3. Prüfen Sie den Geltungsbereich: Ein Produkt muss dem Angebot ausdrücklich zugeordnet sein oder zu einer markierten Kategorie oder Marke gehören.
4. Kontrollieren Sie die Anzeigeschalter, in den allgemeinen Einstellungen und im Reiter Badge und Anzeige des Angebots.
5. Steht die Anzeigemethode auf Manuell, prüfen Sie, ob Ihr Template den Hook displayDfQdBadge tatsächlich aufruft.
6. Ist die Kundengruppe eingeschränkt, testen Sie mit einem Konto aus der richtigen Gruppe.
7. Leeren Sie den Smarty-Cache und den Cache Ihres Servers.

Die Badges erscheinen doppelt

Ihr Theme ruft den Hook displayDfQdBadge auf, und das Frontend-Skript fügt die Badges ebenfalls ein. Stellen Sie die Anzeigemethode der Badges auf Manuell.

Der Rabatt greift im Warenkorb nicht

Die Menge muss die Schwelle des Angebots im gewählten Bündelungsmodus erreichen. Im Modus Pro Variante lösen sechs Einheiten, verteilt auf drei Varianten, kein Angebot 4+2 aus. Prüfen Sie außerdem, ob das Produkt durch die Option für bereits reduzierte Produkte ausgeschlossen ist oder der Kunde durch die Option für Sonderpreise. Für einen Staffelrabatt über mehrere Produkte muss die Bündelung auf Mix and Match stehen.

Zwei Angebote kommen sich in die Quere

Dieses Verhalten ist so vorgesehen: Eine vom ersten Angebot verbrauchte Einheit fällt aus der Berechnung des zweiten. Soll ein Angebot vor dem anderen greifen, senken Sie seine Priorität.

Badge oder Angebotsblock erscheinen an der falschen Stelle

Für das Badge stellen Sie die Position des Angebots auf Inline (unter dem Preis) oder rufen den Hook displayDfQdBadge an der gewünschten Stelle Ihres Vorschaubild-Templates auf. Für den Angebotsblock wählen Sie eine andere Position oder nutzen den eigenen CSS-Selektor.

Der Testlink der Badges liefert einen 404-Fehler

Leeren Sie den Cache unter Erweiterte Einstellungen und dann Leistung, und speichern Sie anschließend die Einstellungen unter Traffic & SEO erneut, um die sprechenden URLs neu zu erzeugen.

Deinstallation

Die Deinstallation entfernt die acht Tabellen des Moduls, seine Konfigurationsschlüssel und den Reiter im Menü Katalog. Warenkorbregeln, die bereits zu vergangenen Bestellungen gehören, bleiben erhalten, damit Ihre Buchhaltungshistorie unverändert bleibt.