Mindestbestellmenge und Verpackungseinheiten: Dokumentation DataFirefly Minimums

Installation

Installieren Sie das Modul über Module > Module Manager > Modul hochladen mit der ZIP-Datei, oder legen Sie den Ordner dfminimums in das Verzeichnis /modules/ Ihres Shops und klicken Sie auf Installieren.

Bei der Installation legt das Modul zwei Tabellen an (Mengenregeln und Mindestbestellwerte), registriert seine Hooks und fügt im Menü Katalog zwei Reiter hinzu: Mindestmengen und Vielfache und Mindestbestellwert.

Moduleinstellungen

Die Konfigurationsseite des Moduls enthält sechs Einstellungen.

Kaufregeln aktivieren

Hauptschalter. Ist er aus, wird im Shop keine Regel angezeigt oder angewendet. Die Regeln bleiben gespeichert.

Mengen automatisch anpassen

Legt ein Kunde eine Menge in den Warenkorb, die gegen eine Regel verstößt, ersetzt das Modul sie durch die nächste erlaubte Menge: beim Hinzufügen nach oben, beim Entfernen nach unten. 7 Stück eines Produkts im 6er-Verkauf ergeben 12, eine Reduzierung von 12 auf 11 ergibt 6. Personalisierte Zeilen werden nie geändert. Ist die Option aus, bleibt die Menge unverändert und der Warenkorb ist gesperrt, bis der Kunde korrigiert.

Bedingungen auf der Produktseite anzeigen

Zeigt unter dem Warenkorb-Button eine Box mit Minimum, Vielfachem und Maximum für den angemeldeten Kunden. Die Box erscheint auch in der Schnellansicht.

Hinweis in Produktlisten anzeigen

Fügt unter dem Preis der Produktkacheln einen kurzen Hinweis ein, zum Beispiel „Verkauf zu 6“ oder „Min. 12“.

Bedingungen unter jeder Warenkorbzeile anzeigen

Nennt die Bedingung jeder Zeile und zeigt den Fehler in Rot, wenn die Menge nicht erlaubt ist.

Kunde in mehreren Gruppen

Legt fest, welcher Mindestbestellwert gilt, wenn ein Kunde mehreren Gruppen mit jeweils eigenem Minimum angehört: der seiner Standardgruppe, der höchste oder der niedrigste.

Eine Mengenregel anlegen

Öffnen Sie Katalog > Mindestmengen und Vielfache und klicken Sie auf Regel hinzufügen.

Gilt für

• Ein Produkt: Suchen Sie das Produkt nach Name, Artikelnummer, EAN oder ID und wählen Sie bei Bedarf eine Variante. Eine Regel für eine Variante hat Vorrang vor einer Regel für das ganze Produkt.
• Eine Kategorie: Wählen Sie die Kategorie und ob Unterkategorien einbezogen werden. Betroffen sind alle Produkte, die der Kategorie zugeordnet sind, unabhängig von ihrer Standardkategorie.
• Alle Produkte: Die Regel gilt für den ganzen Katalog.

Kundengruppe

Lassen Sie „Alle Kundengruppen“ oder wählen Sie eine Gruppe. Eine Gruppenregel gilt für jeden Kunden, der dieser Gruppe angehört, auch wenn es nicht seine Standardgruppe ist.

Minimum, Vielfaches und Maximum

• Mindestmenge: 0 oder 1 bedeutet kein Minimum. Ist ein Vielfaches gesetzt und das Minimum keines davon, wird es aufgerundet: Minimum 10 zu 6 ergibt 12.
• Verkauf in Vielfachen von: 1 lässt die Menge frei, 6 akzeptiert nur 6, 12, 18 usw.
• Höchstmenge: 0 bedeutet kein Maximum. Das Maximum muss ein Vielfaches des gewählten Vielfachen und mindestens so groß wie das Minimum sein.

Eine Regel muss mindestens ein Minimum über 1, ein Vielfaches über 1 oder ein Maximum festlegen.

Welche Regel gilt

Für jedes Produkt im Warenkorb gilt genau eine Produktregel. Das Modul wählt sie in dieser Reihenfolge:

1. die höchste Priorität;
2. bei gleicher Priorität die spezifischste Regel: Variante, dann Produkt, dann Kategorie (die tiefste zuerst), dann alle Produkte;
3. bei gleicher Spezifität eine Kundengruppenregel vor einer Regel für alle Gruppen.

Beispiel: eine Regel „Weine, Verkauf zu 6“ für alle Kunden und eine Regel „Weine, Verkauf zu 12“ für die Gruppe Gewerbe. Ein Gewerbekunde bestellt zu 12, ein Privatkunde zu 6.

Das Modul-Panel im Reiter Module des Produktblatts listet die Regeln, die das Produkt direkt betreffen, sowie die Kategorie- und Katalogregeln, die ebenfalls gelten können.

Frei kombinierbar pro Kategorie

Bei einer Kategorieregel bietet das Feld Zählweise zwei Werte.

• Jedes Produkt einzeln: Die Regel gilt für jedes Produkt der Kategorie wie eine Produktregel.
• Alle Produkte der Kategorie zusammen (frei kombinierbar): Minimum, Vielfaches und Maximum gelten für die Summe der Mengen aller Produkte der Kategorie im Warenkorb.

Beispiel: Minimum 12 und Vielfaches 6, frei kombinierbar, in der Kategorie Weine. Der Kunde kann 4 Rotweine, 4 Weißweine und 4 Roséweine nehmen. Bei insgesamt 13 Flaschen ist der Warenkorb gesperrt.

Frei kombinierbare Regeln werden zusätzlich zur eigenen Regel jedes Produkts geprüft. Ein Wein im Einzelverkauf bleibt einzeln erhältlich, solange die Summe der Kategorie die frei kombinierbare Regel erfüllt.

Mindestbestellwerte pro Gruppe

Öffnen Sie Katalog > Mindestbestellwert und klicken Sie auf Mindestbestellwert hinzufügen.

• Kundengruppe: ein Minimum pro Gruppe. Der Eintrag „Alle Kunden (Standard)“ gilt für Kunden, deren Gruppen kein eigenes Minimum haben.
• Mindestbetrag: in der Standardwährung des Shops, bei Warenkörben in anderer Währung automatisch umgerechnet. Versandkosten sind nie enthalten.
• Betrag inkl. MwSt.: Nein vergleicht mit der Produktsumme ohne MwSt., wie im B2B üblich.
• Gutscheine abziehen: Ja nimmt die Summe nach Warenkorbregeln und Gutscheinen.

Was der Kunde sieht

Verstößt der Warenkorb gegen eine Regel, befüllt das Modul den Schlüssel minimalPurchaseRequired des Warenkorbs, den PrestaShop für seinen eigenen Mindestbestellwert nutzt. Der Bestellbutton wird deaktiviert und der native Warenkorb-Hinweis zeigt „Ihr Warenkorb erfüllt die Kaufbedingungen noch nicht.“, gefolgt von den Einzelheiten jedes Problems: nicht erlaubte Menge mit den möglichen Mengen, Summe einer frei kombinierbaren Kategorie, fehlender Betrag bis zum Mindestbestellwert.

Beim Öffnen der Bestellseite wird erneut geprüft: Wer sie direkt aufruft, wird in den Warenkorb zurückgeleitet.

Im Frontend folgen die Mengenfelder der Regel. Im Classic-Theme springen die TouchSpin-Buttons um das Vielfache. In Hummingbird springen die Buttons +/- direkt zur nächsten oder vorherigen erlaubten Menge.

CSV-Import und -Export

Der Import befindet sich oben in der Regelliste. Die Datei akzeptiert das Trennzeichen ; oder , und braucht eine Kopfzeile mit mindestens der Spalte scope. Erkannte Spalten:

• name: interner Name, wird erzeugt, wenn leer;
• scope: product, category oder all;
• product_id oder product_reference;
• combination_reference: Variantenreferenz;
• category_id und include_subcategories (0 oder 1);
• apply_mode: per_product oder cumulative (frei kombinierbar);
• group_id: 0 für alle Gruppen;
• min_qty, multiple, max_qty, priority, active.

Das Kästchen „Zuerst alle bestehenden Regeln dieses Shops löschen“ ersetzt den gesamten Regelsatz. Fehlerhafte Zeilen werden mit ihrer Nummer aufgelistet und blockieren die übrigen nicht. Der Button CSV exportieren erzeugt dasselbe Format, praktisch, um Regeln von einem Shop in einen anderen zu übernehmen. Eine Beispieldatei lässt sich im Importblock herunterladen.

Empfehlungen

• Beginnen Sie mit einer breiten Regel (Kategorie oder Katalog) und ergänzen Sie dann Ausnahmen pro Produkt: Die spezifischste Regel gewinnt, ohne dass Sie die Priorität ändern müssen.
• Nutzen Sie die Priorität nur, wenn eine weniger spezifische Regel gewinnen soll, etwa eine Kategorieregel, die für alle ihre Produkte gelten muss.
• Testen Sie mit einem Kundenkonto jeder betroffenen Gruppe: Gruppenregeln sind für nicht angemeldete Besucher nicht sichtbar.
• Leeren Sie nach einer Änderung den Cache, wenn Ihr Shop ein Full-Page-Cache-Modul nutzt.

Fehlerbehebung

Der Kunde kann eine Menge nicht unterschreiten, obwohl keine Regel das verlangt

Prüfen Sie die native Mindestmenge im Produktblatt (Reiter Lager oder Mengen, je nach Version) und setzen Sie sie auf 1 zurück.

Der Warenkorb ist mit der nativen Meldung zum Mindestbestellwert gesperrt

Das ist der native Mindestbestellwert aus Shop-Parameter > Bestellungen. Setzen Sie ihn auf 0, wenn nur die Gruppen-Mindestwerte zählen sollen.

Die Buttons +/- springen um 1

Das Theme verwendet nicht die Standard-Selektoren von Classic oder Hummingbird. Die Regel wird serverseitig trotzdem durchgesetzt: Der Warenkorb wird korrigiert oder gesperrt. Nennen Sie uns den Theme-Namen für eine Anpassung.

Ein One-Page-Checkout-Modul lässt die Bestellung durch

Das Drittanbieter-Modul ignoriert minimalPurchaseRequired. Testen Sie es auf einem Staging-Shop und nennen Sie uns seinen Namen.

Kompatibilität

• PrestaShop 8.0 bis 9.x, dieselbe ZIP-Datei für beide Versionszweige.
• Themes Classic und Hummingbird.
• Multistore: Regeln und Mindestwerte werden pro Shop gespeichert.
• Architektur ModuleAdminController, ohne Composer-Abhängigkeit, PHP 7.2 und höher.
• Oberfläche auf Englisch, Französisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.