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 – Mengenaktionen & 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, registriert sieben Hooks und ergänzt den Reiter Mengenaktionen im Menü Katalog.

Allgemeine Einstellungen

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

• Modul aktivieren: schaltet Badge-Anzeige und Rabattberechnung ab, ohne zu deinstallieren.
• Badges in Listen: 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 behalten möchten.
• Aktionstabelle auf der Produktseite: listet die für das Produkt geltenden Aktionen unter dem Warenkorb-Button auf.
• Aktionsdetails im Warenkorb: ergänzt unter der Warenkorbübersicht den Betrag jeder einzelnen Aktion.
• Rabatte brutto berechnen: aktiv trägt die Warenkorbregel einen Betrag inklusive Steuern. Inaktiv ist der Betrag netto und PrestaShop wendet die Mehrwertsteuer nach Ihren Regeln an.
• Bezeichnung des Warenkorbrabatts: Text in der Rabattzeile von Warenkorb und Bestellung. Standard ist „Mengenaktionen“.
• Schriftgröße des Badges: in Pixel, Standard 13.

Eine Aktion anlegen

Öffnen Sie Katalog und dann Mengenaktionen, und klicken Sie auf Neue Aktion. Das Formular ist in drei Reiter gegliedert.

Reiter Aktion

• Name der Aktion: übersetztes Feld, genutzt in der Backoffice-Liste und in der Aktionstabelle der Produktseite.
• Aktionstyp: die fünf unten beschriebenen Mechaniken. Das Formular blendet die Felder aus, die für den gewählten Typ nicht gelten.
• Gekaufte Menge (X) und Gratismenge (Y): für den Typ X kaufen Y gratis, und X allein für den Paketpreis.
• Rang des rabattierten Artikels (N): 2 für „der 2. zu -25 %“, 3 für „der 3. zu -50 %“.
• Rabattwert: Prozentsatz, Rabattbetrag oder festgelegter Preis je nach Typ. Die Feldbezeichnung passt sich selbst an.
• Wiederholbare Aktion: aktiv gilt die Aktion so oft, wie die Menge es zulässt. Inaktiv gilt sie einmal pro Warenkorb.
• Gruppierung der Mengen: pro Produkt, pro Variante oder Mix and Match.
• Priorität: niedrigere Werte laufen zuerst.
• Aktion aktivieren: entspricht dem Schalter in der Listenansicht.

Reiter Bedingungen

• Geltungsbereich: gesamter Katalog, ausgewählte Produkte, ausgewählte Kategorien oder ausgewählte Hersteller. Das passende Auswahlfeld erscheint je nach Wahl.
• Betroffene Produkte: mindestens zwei Zeichen eingeben, um die Suche zu starten. Sie durchsucht Name, Referenz 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 die Aktion aus.
• Betroffene Hersteller: Liste der Hersteller des Shops.
• Kundengruppen: nichts markieren, um die Aktion für alle Gruppen einschließlich Besucher gelten zu lassen.
• Bereits reduzierte Produkte ausschließen: Produkte mit einem Sonderpreis fallen aus der Berechnung.
• Startdatum und Enddatum: leer lassen für eine dauerhafte Aktion. 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 & Anzeige

• Badge-Text: übersetztes Feld. Leer lassen für eine automatische Erzeugung aus den Aktionswerten.
• Hintergrundfarbe und Textfarbe: Farbwähler, standardmäßig Rot und Weiß.
• Form: Quadrat, abgerundete Ecken, Pille, schräges Band, runder Punkt.
• Position auf dem Produktbild: oben links, oben rechts, unten links, unten rechts, oder inline unter dem Preis.
• In Listen anzeigen, auf der Produktseite, in der Aktionstabelle: drei Schalter je Aktion, zusätzlich zu den globalen Einstellungen.
• Beschreibung der Aktion: übersetzter Rich Text, angezeigt unter dem Erklärsatz in der Aktionstabelle.

Die fünf Aktionstypen

X kaufen, Y gratis

Das klassische Format 2+1, 3+1 oder 4+2. Die Engine teilt die in Frage kommenden Warenkorbeinheiten in Sets aus X plus Y. Für jedes vollständige Set sind die Y günstigsten Einheiten kostenlos.

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

Der N-te zu -X %

Die Engine teilt die Einheiten in Sets von N. In jedem Set erhält die Einheit auf Rang N den Prozentsatz. Da die Einheiten absteigend nach Preis sortiert sind, ist der rabattierte Artikel der günstigste des Sets.

Beispiel: Aktion „der 2. zu -25 %“, vier Artikel zu 20. Zwei Sets 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, nicht 30.

Der N-te zum festgelegten Preis

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

Paketpreis

Für jedes Set aus X Einheiten wird die Summe auf den beworbenen Preis gesenkt. Bei einer Aktion 3 für 10 mit sechs Artikeln zu 5 bildet die Engine zwei Sets und gewährt insgesamt 10 Rabatt.

Welcher Artikel gratis ist

Die Engine sortiert die in Frage kommenden Einheiten absteigend nach Preis und wendet den Vorteil auf die günstigsten jedes Sets an. Das ist die Regel des Einzelhandels und die Erwartung des Kunden.

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

Gruppierung der Mengen

• Pro Produkt: alle Varianten derselben Referenz zählen zusammen. Sechs Flaschen desselben Duschgels lösen eine 4+2-Aktion aus, auch bei drei Duftrichtungen.
• Pro Variante: jede Variante zählt für sich. Es braucht sechs Einheiten derselben Duftrichtung für dieselbe Aktion.
• Mix and Match: alle Einheiten der zur Aktion gehörenden Produkte fließen in dieselbe Zählung. Nützlich für ein 4+2 über eine ganze Serie.

Priorität und Kombination

Die Aktionen werden in der Reihenfolge ihrer Priorität geprüft, vom niedrigsten zum höchsten Wert. Jede Aktion verbraucht die von ihr genutzten Einheiten, die nächste arbeitet mit dem Rest. Dieselbe Einheit wird nie zweimal rabattiert.

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

Das Badge

Variablen im Text

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

• {x}: gekaufte Menge
• {y}: Gratismenge
• {n}: Rang 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 ausschreiben: „4+2 gratis“, „3+1 gratis“, „der 2. zu -25 %“. Das Feld ist übersetzt, jede Sprache bekommt also ihre eigene Formulierung.

Bleibt das Feld leer, erzeugt das Modul eine kurze Bezeichnung aus Typ und Werten: 4+2 für eine Aktion X kaufen Y gratis, -25% x2 für einen prozentualen N-ten.

Position und Einbindung ins Produktbild

Das Badge wird im Preisblock gerendert, über den Hook displayProductPriceBlock. Ein Frontend-Skript verschiebt es anschließend in den Container des Produktbilds, damit es über dem Bild liegt. Die Platzierung wird nach Ajax-Aktualisierungen aus Facettensuche, Seitennavigation und Quick View wiederholt.

Der Modus Inline (unter dem Preis) deaktiviert diese Verschiebung und belässt das Badge im Fluss, unter dem Preis. Wählen Sie diesen Modus, wenn Ihr Theme eine untypische Vorschaubild-Struktur verwendet.

Berechnung des Rabatts im Warenkorb

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 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.

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 Badge selbst
• offers.tpl: die Aktionstabelle der Produktseite
• cart.tpl: die Übersicht unter dem Warenkorb

Das CSS ist unter dem Präfix dfqd gekapselt. Für kleine 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

Jede Aktion wird den Shops zugeordnet, die Sie im Reiter Bedingungen markieren. Eine in einem Shop angelegte Aktion erscheint in den anderen erst, wenn sie dort zugeordnet ist.

Die Felder Name, Badge-Text und Beschreibung werden in die installierten Sprachen übersetzt. Das angezeigte Badge folgt der Sprache des Kunden.

Fehlerbehebung

Das Badge erscheint nicht

1. Prüfen Sie, ob Modul und Aktion aktiv sind und ob das heutige Datum im Gültigkeitszeitraum liegt.
2. Prüfen Sie den Geltungsbereich: ein Produkt muss der Aktion ausdrücklich zugeordnet sein oder zu einer markierten Kategorie beziehungsweise einem markierten Hersteller gehören.
3. Kontrollieren Sie die Anzeigeschalter, in den globalen Einstellungen und im Reiter Badge der Aktion.
4. Ist die Kundengruppe eingeschränkt, testen Sie mit einem Konto aus der richtigen Gruppe.
5. Leeren Sie den Smarty-Cache und den Cache Ihres Servers.

Der Rabatt greift im Warenkorb nicht

Die Menge muss die Schwelle der Aktion im gewählten Gruppierungsmodus erreichen. Im Modus Pro Variante lösen sechs Einheiten verteilt auf drei Varianten keine 4+2-Aktion aus. Prüfen Sie außerdem, ob das Produkt durch die Option für bereits reduzierte Produkte ausgeschlossen ist.

Zwei Aktionen behindern sich

Dieses Verhalten ist so vorgesehen: eine von der ersten Aktion verbrauchte Einheit fällt aus der Berechnung der zweiten. Soll eine Aktion vor der anderen greifen, senken Sie ihre Priorität.

Das Badge sitzt an der falschen Stelle

Manche individuellen Themes verwenden nicht die Standardstruktur der Vorschaubilder. Stellen Sie die Position auf Inline (unter dem Preis), oder überschreiben Sie badge.tpl, um das Badge frei zu platzieren.

Deinstallation

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