Eine Richtlinie ist eine benannte Service-Kampagne - Ihre Feiertags-Extras, Ihre VIP-Vorteile, Ihr Elektronik-Garantie-Stack. Jede Richtlinie enthält einen Bedingungsbaum (wer qualifiziert ist) und eine oder mehrere Service-Regeln (was Sie anbieten und zu welchem Preis). Erstellen Sie unbegrenzte Richtlinien, sortieren Sie per Drag-and-Drop nach Priorität, aktivieren oder pausieren Sie einzeln ohne Code.

Jede Regel definiert: Service-Code, mehrsprachiges Warenkorb-Label und Beschreibung (conorderservices_rule_lang), Werttyp (fest, prozentual, gestaffelt), Wertbasis (Produkte, Warenkorb, Versand, Gewicht), Min/Max-Gebührenobergrenzen, Steuerregelgruppe, Icon oder hochgeladenes Bild, UI-Typ (Checkbox oder Radio), optionale Radio-Gruppe und Label, Vorauswahl-Flag, Priorität, Zeitplan-Daten (gültig ab / gültig bis) und optionale Regel-Bedingungen.

Bei erstem Treffer stoppen beendet die Auswertung nach der ersten qualifizierenden Richtlinie - nützlich, wenn Kampagnen sich nicht überschneiden dürfen. Merge-Strategie pro Richtlinie steuert, wie mehrere Regeln innerhalb einer Richtlinie kombiniert werden: alle Leistungen stapeln, erster Treffer gewinnt, Prioritätskaskade, nur höchste Gebühr oder eindeutige Service-Codes. Eine globale Standard-Merge-Strategie in den Einstellungen gilt für neue Richtlinien.

Die Richtlinienlistenansicht zeigt Status, Merge-Strategie, Regelanzahl und Schnellaktionen. Duplizieren, JSON exportieren, aus Datei importieren oder aktiv umschalten - alles aus dem Richtlinien-Panel, jede Änderung ins Audit-Protokoll geschrieben.

Der Bedingungs-Editor ist ein verschachtelter UND/ODER-Baum-Editor - dasselbe Muster wie in professionellen Regel-Engines, als drag-freundliche Gruppen in Ihrem Back Office. Gruppe hinzufügen, Feld wählen, Operator wählen, Wert setzen. Gruppen verschachteln für Logik wie: (VIP-Gruppe ODER 5+ vergangene Bestellungen) UND (Warenkorbwert ≥ 100 €) UND (Kategorie Sommerschlussverkauf hat 3+ Artikel).

35 Bedingungsfelder decken den vollen Warenkorbkontext ab: Warenkorbwert, Produktzwischensumme, Versandkosten, Produktanzahl, eindeutige SKU-Anzahl, Gewicht, bestehende Warenkorbregeln-Anzahl, Kundenbestellanzahl, Lifetime-Ausgaben, Wochentag, Stunde, Datum, Postleitzahl, Währung, Land, Rechnungsland, Zone, Kundengruppe, Versanddienstleister, Zahlungsmodul, eingeloggt/Gast-Status, Produkte, Kategorien, Hersteller, Lieferanten, virtuell/physisch-Flags, Personalisierung und bestehende Rabatterkennung.

Zusammengesetzte Felder kombinieren Entität + Schwellenwert in einer Bedingung - z. B. Produkt #123 Menge ≥ 3, Kategorie #45 Zeilensumme ≥ 50 €. Operatoren umfassen gleich, ungleich, größer/kleiner als, zwischen, in Liste, nicht in Liste, enthält, beginnt mit, Regex, leer und nicht leer.

Referenz der Bedingungstypen

Jede Zeile entspricht genau dem, was Sie im Bedingungs-Editor-Dropdown wählen. Numerische Felder unterstützen =, ≠, <, ≤, ≥, > und zwischen. Boolesche Felder nutzen Ja/Nein. Suchfelder unterstützen in und not in mit Mehrfachauswahl. Textfelder ergänzen enthält, beginnt mit und regex. Kombinieren Sie beliebige Felder in verschachtelten UND/ODER-Gruppen - die Engine prüft sie bei jeder Warenkorbaktualisierung neu.

Produkt-, Kategorie-, Hersteller- und Gruppenauswahl nutzen integrierte Autocomplete-Suche. Ein Live-Vorschau-Satz erklärt, was der Baum trifft. Power-User können Raw-JSON umschalten für Copy-Paste zwischen Umgebungen. Bedingungen werden bei jeder Warenkorb-Synchronisation neu ausgewertet - In den Warenkorb, Mengenänderung, Login, Adressänderung - die Engine reagiert sofort.

Operator-Referenz

14 Operatoren sind im Editor verfügbar. Der Feldtyp bestimmt, welche Operatoren erscheinen - boolesche Felder nutzen nur = und ≠; numerische Felder erhalten den vollen Vergleichssatz.

Jede Service-Regel wählt einen Betragstyp: fest, prozentual oder gestaffelt. Fest nutzt einen einzelnen Dezimalwert. Prozentual nutzt einen Satz plus eine Wertbasis - Produktgesamtbetrag, Warenkorbgesamtbetrag, Versandkosten oder Warenkorbgewicht. Gestaffelt öffnet eine Stufen-Tabelle als JSON (tiers_json) mit Von/Bis-Bändern und Gebühr pro Band.

Min-Gebühr und Max-Gebühr begrenzen Prozentberechnungen, damit Versicherung nie unter 2 € fällt oder 50 € überschreitet. Pro-Regel-Steuerregelgruppe stellt sicher, dass die Service-Zeile die korrekte MwSt. erbt. Zeitplan-Felder (date_from / date_to) begrenzen saisonale Angebote, ohne die ganze Richtlinie zu deaktivieren.

Hinter der UI löst ConorderservicesEngine berechtigte Regeln auf, berechnet jede Gebühr aus dem Live-Warenkorbkontext, wendet Merge-Strategie an und schreibt den kombinierten Gesamtbetrag in einen dynamischen SpecificPrice auf dem gemeinsamen Service-Produkt. Regel-Zusammenfassungs-Chips im Admin zeigen aktive Preisgestaltung auf einen Blick ohne Editor.

Der Stufen-Editor in adminPolicyRules.js fügt/entfernt Zeilen visuell. Wechsel von gestaffelt zurück zu fest erhält andere Regel-Einstellungen. Richtlinie aus Staging importieren, Regelkarte öffnen, einen Schwellenwert anpassen, speichern - strukturierte Daten bleiben konsistent.

Berechtigte Leistungen rendern in einem dedizierten Checkout-Panel über displayShoppingCart, displayShoppingCartFooter oder displayCheckoutSummaryTop - Position in den Einstellungen konfigurierbar. Jede Angebotszeile zeigt Checkbox- oder Radio-Steuerung, optionales Icon/Bild, Name, Beschreibung und berechnetes Preis-Badge.

Kunden schalten Leistungen über Front-AJAX-Controller um (checkout.js + Modul-Ajax-Endpunkt). Warenkorb-Summen und Zeilenlabels aktualisieren ohne vollständigen Seitenreload. Panel aktualisiert sich auch bei Warenkorb-Mengenänderung. Auswahl-Ereignisse werden ins Audit protokolliert (service_selected, service_deselected). Impression-Ereignisse werden protokolliert, wenn das Panel angezeigt wird (dedupliziert pro berechtigtem Set).

Ausgewählte Leistungen synchronisieren zu einem versteckten Katalogprodukt (CONORDERSVC-SERVICE) mit dynamischem SpecificPrice pro Warenkorb. Mehrere Auswahlen erscheinen als eine Warenkorbzeile mit kommagetrennten mehrsprachigen Labels und kombiniertem Betrag. Warenkorbstatus persistiert in conorderservices_cart mit berechtigtem Snapshot, ausgewählten Leistungen als JSON und angewendetem Snapshot für idempotenten Sync.

Hooks actionCartSave, Produkt-im-Warenkorb-Lösch-Hooks, actionPresentCartProduct und actionProductPriceCalculation halten die Service-Zeile synchron, wenn sich der Warenkorb ändert. Kompatibel mit PrestaShop 9, 8, 1.7 Themes inkl. Hummingbird-Warenkorb-Thumbnails über actionPresentProduct.

Jede Service-Regel unterstützt eine visuelle Identität beim Checkout: JPG/PNG/GIF/WebP hochladen nach views/img/services/ oder externe HTTPS-URL einfügen. ConorderservicesRuleImage handhabt Upload-Validierung, Speicherung, öffentliche URL-Auflösung und sicheres Löschen bei Bildwechsel oder -entfernung.

Die dedizierte Bild-Editor-UI (adminPolicyRuleImage.js) zeigt Live-Vorschau, Entfernen/Ersetzen-Steuerung und Vorheriges-beibehalten-Fallback beim Speichern. Bei Richtlinien-Duplizierung oder Import werden Bilder sicher geklont oder referenziert, damit Staging-zu-Produktion-Transfers Checkout-Visuals nicht brechen.

Icon-Größe (1-256 px), Icon-Position (links/Mitte/rechts) und Steuerungsausrichtung sind globale Einstellungen - ein Shop kann große links ausgerichtete Geschenkverpackungs-Icons zeigen, ein anderer kompakte rechts ausgerichtete Checkboxen. Ein-/Ausblenden für Name, Beschreibung, Preis und Icon pro Shop vervollständigen die Darstellungsschicht.

Der Simulator-Tab ist ein dreistufiger Workflow gegen echte Daten in Ihrer Datenbank - kein Mock-Warenkorb. Schritt 1: Warenkörbe nach ID, Kundenname oder E-Mail suchen. Schritt 2: Warenkorb aus der Live-Liste wählen (zeigt Kunde, E-Mail, Warenkorbwert, letzte Aktualisierung). Schritt 3: Auswertung starten und vollständige Ergebnisaufschlüsselung lesen.

Ergebnisse zeigen, welche Richtlinien getroffen haben, welche übersprungen wurden (und warum), berechnete Gebühren pro Regel, berechtigt vs. ausgewählt, Radio-Gruppen-Auflösung und Warenkorbzeilen-Vorschau mit kombiniertem Label und Betrag. Optionaler Kundenfilter grenzt die Warenkorbliste auf ein Konto ein - ideal zur Reproduktion eines Support-Tickets.

Jeder Simulationslauf wird im Audit-Protokoll mit Ereignistyp simulation_run, Warenkorb-ID, Akteur (Mitarbeiter) und Ergebnis-Snapshot protokolliert. Merchandising kann eine Kampagne vor Aktivierung prüfen. Support kann erklären, warum ein bestimmter Kundenwarenkorb Geschenkverpackung sah oder nicht - ohne Testbestellung im Live-Shop.

Nutzen Sie den Simulator nach jeder Richtlinienbearbeitung, vor Feiertags-Go-Live und beim Import von Richtlinien aus Staging. Er ist das Sicherheitsnetz, das Enterprise-Service-Management von „ändern und hoffen" trennt.

Der Dashboard-Tab ist Ihre Kontrollzentrale für optionale Leistungen. KPI-Karten über einen wählbaren Zeitraum (30 / 90 / 180 / 365 Tage) zeigen: Panel-Impressionen, Checkout-Auswahlen, Bestellungen mit Leistungen, Kaufquote und Service-Umsatz in Shop-Währung. Zahlen stammen aus dem Audit-Protokoll - echte Ereignisse, keine Schätzungen.

Chart.js-Trenddiagramme visualisieren den Umsatz-Funnel in drei Granularitäten: täglich (konfigurierbares Fenster), wöchentlich und monatlich. Linien verfolgen Impressionen, Auswahlen, bezahlte Bestellungen und Service-Umsatz auf sekundärer Achse. Standard-Diagrammtyp in den Einstellungen wechseln. Ein Kreisdiagramm schlüsselt bezahlten Umsatz nach Service-Code auf, damit Sie sehen, welche Extras tatsächlich konvertieren.

Die Tabelle pro Leistung listet jeden Service-Code mit Impressionen, Auswahlen, Bestellungen, Umsatz und Kaufquote. Auswahlen sind ein Funnel-Schritt - Bestellungen und Umsatz sind die KPI-Wahrheit (vermeidet Eitelkeitsmetriken von Checkbox-Umschaltungen, die nie konvertieren). Aktuelle Audit-Einträge erscheinen im Dashboard für schnelle Fehlersuche.

Für Agenturen und Multistore-Betreiber: Das Dashboard beantwortet die Frage, die Merchandising immer stellt - „Verkaufen unsere Checkout-Extras tatsächlich?" - mit Daten, nicht Bauchgefühl.

Der dedizierte Audit-Protokoll-Tab ist ein vollständiges Ereignisjournal - keine Debug-Datei in Server-Logs. Jede Zeile speichert Zeitstempel, Ereignistyp, Akteur (Mitarbeitername, Kundenname oder SYSTEM), lesbare Zusammenfassung, verknüpfte Bestellreferenz, Service-Code, Gebührenbetrag, Warenkorb-ID und Richtlinien-/Regel-ID.

20+ Ereignistypen werden verfolgt:

• service_impression - Checkout-Panel dem Warenkorb angezeigt
• service_selected / service_deselected - Kunde schaltet eine Leistung um
• service_applied - Leistungen zur Warenkorbzeile synchronisiert
• order_services - Bestellung mit Service-Umsatz aufgegeben (pro Zeile)
• order_validated - Bestellvalidierungs-Hook ausgelöst
• policy_created, policy_updated, policy_deleted, policy_toggled
• policy_duplicated, policy_imported, policy_exported
• rule_created, rule_updated, rule_deleted, rule_toggled
• preset_applied - Bedingungs-Preset in Editor geladen
• settings_updated - Modulkonfiguration geändert
• simulation_run / simulation - Back-Office-Warenkorbauswertung

Klicken Sie Anzeigen auf einer Zeile, um ein Detail-Modal mit vollständigem JSON-Snapshot zu öffnen - angewandte Service-Zeilen, Richtlinien-Diff, Simulationsausgabe oder Einstellungsänderungs-Payload. Service-Anwendungen speichern einen fee_snapshot, damit Sie exakt rekonstruieren können, was der Kunde beim Checkout sah.

Die Liste unterstützt nativen PrestaShop-CSV-Export für Finanz- und Compliance-Prüfungen. Verknüpfte Spalten zeigen Bestellreferenz, Kundenname und Mitarbeitername ohne manuelles Querverweisen. Auf der Bestellseite im Back Office (displayAdminOrder-Hook) zeigt ein Panel, welche optionalen Leistungen zu dieser Bestellung beigetragen haben - Leistungsname, Code, Betrag und Snapshot.

Richtlinien sind portable JSON-Dokumente. Export lädt die vollständige Richtlinie herunter - Bedingungsbaum, alle Regeln, Preiskonfigurationen, Merge-Strategie, Service-Bilder-Metadaten, Positionen - bereit für Versionskontrolle oder Übergabe an einen anderen Shop. Import lädt eine JSON-Datei hoch und erstellt eine neue Richtlinie mit Audit-Protokoll-Eintrag policy_imported.

Duplizieren klont eine Richtlinie mit einem Klick aus dem Listen-Aktionsmenü über ConorderservicesPolicyDuplicator - kopiert jede Regel, benennt mit Suffix um, klont Bilder sicher, protokolliert policy_duplicated. Perfekt, um „Feiertag v2" aus „Feiertag v1" zu erstellen, ohne 10 Regeln manuell neu aufzubauen.

Typischer Agentur-Workflow: auf Staging bauen und simulieren → JSON exportieren → in Produktion importieren → Simulator erneut ausführen → aktivieren. Saisonale Service-Setups wechseln in Minuten zwischen Kundenshops. Jeder Transfer ist im Audit-Protokoll nachvollziehbar.

Der Einstellungen-Tab zentralisiert shopweites Verhalten. Master-Ein/Aus-Schalter. Globale Merge-Strategie als Standard für neue Richtlinien. Standard-Steuerregelgruppe für neue Service-Regeln. Service-Produkt-ID - wählen Sie, welches Katalogprodukt die Warenkorbzeile repräsentiert, oder nutzen Sie das automatisch erstellte versteckte Produkt CONORDERSVC-SERVICE.

Anzeigeposition steuert, wo das Checkout-Panel rendert: integrierter Block in der Warenkorbübersicht, nur Warenkorbseite, nur Checkout-Zusammenfassung, Warenkorb- und Checkout-Theme-Hooks oder unter der Warenkorb-Produktliste. Angebotsdarstellungs-Einstellungen steuern Ein-/Ausblenden von Name, Beschreibung, Preis und Icon; Icon-Größe (1-256 px); Icon-Position (links/Mitte/rechts); Checkbox-/Radio-Steuerungsausrichtung.

Debug-Protokoll schreibt ausführliche Engine-Traces für Support. Analytik-Bereich konfiguriert Standard-Diagrammzeitraum (30/90/180/365 Tage), tägliche/wöchentliche/monatliche Diagrammfenster und Standard-Diagrammtyp. Live-Vorschau in den Einstellungen zeigt, wie Angebotszeilen mit aktuellen Darstellungsoptionen aussehen.

Jedes Speichern der Einstellungen protokolliert settings_updated ins Audit-Protokoll mit Vorher/Nachher-Snapshot. Keine stillen Konfigurationsabweichungen.

Leistungen materialisieren als echte Warenkorbzeile auf dem gemeinsamen versteckten Produkt mit dynamischem Preis und mehrsprachigem Label. Sie erscheinen in Warenkorbübersicht, Checkout, Bestellbestätigung, Rechnungen und Back-Office-Bestellansicht - genau wie eine normale Produktzeile, ohne Theme-Hacks oder gefälschte negative Beträge.

Die Engine hängt an actionCartSave, Produkt hinzufügen/entfernen, Front-Controller-Init, Bestellvalidierung (actionValidateOrder, actionValidateOrderBefore auf PS 8.1+) und Warenkorb-Darstellung - Neuberechnung bei jeder Warenkorbkontext-Änderung. Bestelltabelle-Spalten conorderservices_service_amount und conorderservices_service_snapshot speichern historische Service-Gesamtbeträge im Bestelldatensatz.

Richtlinien sind shop-spezifisch (id_shop) für Multistore-Setups. Jeder Shop in Ihrer Gruppe kann unabhängige Service-Stacks betreiben. PrestaShop 9, 8 und 1.7 teilen eine Codebasis über lib/prestashop9compatibility.php und ConorderservicesCompatibility.

Mehrsprachige Checkout-Labels pro Regel (conorderservices_rule_lang) stellen sicher, dass die Service-Zeile in jeder aktiven Shop-Sprache korrekt gelesen wird. 30 fertige Übersetzungspakete decken Back Office und Front Office über PrestaShop l() ab - von Englisch, Deutsch und Polnisch bis Spanisch, Französisch, Italienisch und Märkte in Europa und Asien.