English Version

Zurück zur Übersicht

Extended Voucher Rules: Fehlerbehebung

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Fehlerbehebung

Symptom: Der Kunde sieht eine rote Fehlermeldung, obwohl der Code gültig ist.

Prüfen: Welche Meldung erscheint? "nur für Erstbesteller", "außerhalb des gültigen Zeitfensters" und "kann nicht mit einem anderen bereits eingesetzten Gutschein kombiniert werden" stammen vom Modul, siehe Storefront. Andere Meldungen kommen von den Standardregeln der Serie (Gültigkeitszeitraum, Benutzergruppe, Mindestbestellwert, Kontingent).

Lösung: Im Tab Erweiterte Regeln, Zeitfenster und Kombinationen der Serie die aktiven Regeln prüfen und anpassen.

Symptom: Der Gutschein wird nicht angerechnet, es erscheint keine Hinweisbox.

Prüfen: Ist der Gutschein an eine Zahlart, eine Versandart oder einen Mindestbestellwert pro Zahl-/Versandart gebunden? Dann ist er vorgemerkt und wird erst mit passender Auswahl angerechnet. Nutzt der Shop ein anderes Theme als Apex? Dann liefert das Modul keine Hinweisbox mit.

Lösung: Die passende Zahl- oder Versandart wählen. Für andere Themes die Checkout-Zusammenfassung um die Hinweisbox erweitern, siehe Technik.

Symptom: Ein vorgemerkter Gutschein wird trotz passender Zahlart nicht aktiviert.

Prüfen: Ist die gewählte Zahlart in "Erlaubte Zahlarten" enthalten? Ist für die Zahlart ein Mindestbestellwert hinterlegt, den der Warenkorbwert noch nicht erreicht? Gilt dasselbe für die Versandart? Greift eine weitere Regel (Zeitfenster, Erstbesteller, Kombination)? Die Regeln werden der Reihe nach geprüft, siehe Technik.

Lösung: Die betreffende Regel anpassen. Der Gutschein wird bei der nächsten Neuberechnung des Warenkorbs erneut geprüft.

Symptom: Das Zeitfenster gilt zur falschen Zeit oder nie.

Prüfen: Ist mindestens ein Wochentag angehakt? Ein Fenster ohne Wochentag trifft nie zu. Liegt das Ende vor dem Beginn? Ein solches Fenster trifft ebenfalls nie zu. Der Wochentag wird mit der Zeitzone von PHP ermittelt, die Uhrzeit mit der Zeit des Datenbankservers. Weichen beide Zeitzonen voneinander ab, verschiebt sich das Fenster.

Lösung: Fenster korrigieren beziehungsweise für Zeiträume über Mitternacht zwei Fenster anlegen. PHP- und Datenbank-Zeitzone angleichen. Bei Eingabe als HH:MM (zum Beispiel Ende 23:59) endet das Fenster auf die Sekunde 00, die Zeit von 23:59:01 bis 23:59:59 ist nicht abgedeckt.

Symptom: "Nur für Erstbesteller" greift nicht.

Prüfen: Die Prüfung läuft nur, wenn zum Zeitpunkt der Gutschein-Prüfung ein Benutzer ermittelt werden kann. Ohne Benutzer, zum Beispiel bei einem Besucher im Warenkorb, der weder angemeldet ist noch Daten eingegeben hat, wird die Regel nicht angewendet. Gezählt werden alle nicht stornierten Bestellungen dieses Benutzers im aktuellen Shop.

Lösung: Die Regel wird erst im Checkout wirksam, sobald der Kunde angemeldet ist oder als Gast Daten angegeben hat. Frühere Bestellungen eines anderen Benutzerkontos werden nicht berücksichtigt.

Symptom: Die Kombinationssperre greift nicht.

Prüfen: Ist die Kombination im Tab Kombinationen eingetragen? Steht in OXID "Valid with different Series" auf "No", sind bereits alle Kombinationen gesperrt. Dann ist die Sperrliste nicht der Grund. Steht die Option auf "Yes", prüft das Modul die Sperrliste bei jedem Einlösen und bei jeder Neuberechnung in beide Richtungen.

Lösung: Eintrag im Tab Kombinationen prüfen und gegebenenfalls neu anlegen.

Symptom: Die vier Tabs fehlen an der Gutscheinserie.

Prüfen: Ist das Modul mmd_voucherrules aktiv? Wurde der Cache geleert? Ist die Gutscheinserie ausgewählt?

Lösung:

vendor/bin/oe-console oe:module:activate mmd_voucherrules
vendor/bin/oe-console oe:cache:clear

Bekannte Einschränkungen

• Zeitfenster lassen sich nicht bearbeiten, nur löschen und neu anlegen, und sie kennen keine Zeitspannen über Mitternacht.
• Die Erstbesteller-Prüfung wird ohne ermittelten Benutzer übersprungen.
• Die Hinweisbox wird nur für das Theme Apex mitgeliefert.
• Die Höchstzahl "Max. kombinierbar" zählt unterschiedliche Serien der anderen eingelösten Gutscheine und zeigt dieselbe Meldung wie eine gesperrte Kombination.
• Tritt bei der Prüfung der erweiterten Regeln ein unerwarteter Fehler auf (zum Beispiel ein Datenbankfehler), schreibt das Modul einen Eintrag mit dem Präfix mmd_voucherrules: in das OXID-Log und lässt den Gutschein nach den Standardregeln durch.

FAQ

Werden bestehende Gutscheine durch das Modul beeinflusst? Nein. Serien ohne konfigurierte Regeln verhalten sich wie im OXID-Standard.

Was passiert, wenn eine neue Zahlart hinzukommt? Serien ohne Zahlart-Beschränkung gelten für alle Zahlarten, auch für neue. Serien mit Auswahl gelten nur für die ausgewählten Zahlarten.

Funktioniert das Modul im Multishop? Alle Regeln werden pro Shop gespeichert und gelesen (Spalte OXSHOPID).

Können mehrere Zeitfenster pro Serie angelegt werden? Ja. Der Gutschein ist gültig, wenn mindestens ein aktives Fenster zutrifft.

Was passiert, wenn der Kunde zuerst den gesperrten Gutschein einlöst? Die Sperre gilt in beide Richtungen, die Reihenfolge ist egal.

Gehen Daten bei der Deaktivierung verloren? Nein. Die Tabellen und Einträge bleiben erhalten.