Een beleid is een benoemde servicecampagne - uw feestdagenextra's, uw VIP-voordelen, uw elektronica-garantiestack. Elk beleid bevat een voorwaardenboom (wie kwalificeert) en een of meer serviceregels (wat u aanbiedt en tegen welke prijs). Maak onbeperkte beleidsregels, sorteer op prioriteit via slepen, activeer of pauzeer individueel zonder code aan te raken.

Elke regel definieert: servicecode, meertalig winkelwagenlabel en beschrijving (conorderservices_rule_lang), waardetype (vast, percentage, gelaagd), waardebasis (producten, winkelwagen, verzending, gewicht), min/max-vergoedingslimieten, belastingregelgroep, icoon of geüploade afbeelding, UI-type (selectievakje of radio), optionele radiogroep en label, vooraf-aangevinkt-vlag, prioriteit, planningsdatums (geldig van / geldig tot) en optionele regelniveau-voorwaarden.

Stop bij eerste match beëindigt evaluatie na het eerste kwalificerende beleid - nuttig wanneer campagnes niet mogen overlappen. Samenvoegstrategie per beleid bepaalt hoe meerdere regels binnen één beleid combineren: alle diensten stapelen, eerste match wint, prioriteitscascade, alleen hoogste vergoeding, of unieke servicecodes. Een globale standaard samenvoegstrategie in Instellingen geldt voor nieuwe beleidsregels.

Beleidslijstweergave toont status, samenvoegstrategie, regeltelling en snelle acties. Dupliceren, JSON exporteren, importeren uit bestand, of actief schakelen - allemaal vanuit het beleidspaneel met elke wijziging geschreven naar het auditlogboek.

De voorwaardenbouwer is een geneste AND/OR-boomeditor - hetzelfde patroon als in professionele rule engines, weergegeven als sleepvriendelijke groepen in uw back office. Voeg een groep toe, kies een veld, kies een operator, stel een waarde in. Nest groepen voor logica zoals: (VIP-groep OF 5+ eerdere bestellingen) EN (winkelwagentotaal ≥ €100) EN (categorie Zomersale heeft 3+ items).

35 voorwaardevelden dekken de volledige winkelwagencontext: winkelwagentotaal, productsubtotaal, verzendkosten, productaantal, uniek SKU-aantal, gewicht, bestaande winkelwagenregels, klantbestellingen, lifetime besteding, weekdag, uur, datum, postcode, valuta, land, factuurland, zone, klantgroep, vervoerder, betaalmodule, ingelogd/gast-status, producten, categorieën, fabrikanten, leveranciers, virtueel/fysiek-vlaggen, personalisatie en bestaande kortingsdetectie.

Samengestelde velden combineren entiteit + drempel in één voorwaarde - bijv. product #123 aantal ≥ 3, categorie #45 regeltotaal ≥ €50. Operatoren omvatten gelijk aan, niet gelijk aan, groter/kleiner dan, tussen, in lijst, niet in lijst, bevat, begint met, regex, leeg en niet leeg.

Referentie voorwaardetypen

Elke rij komt exact overeen met wat u kiest in het dropdownmenu van de voorwaardenbouwer. Numerieke velden ondersteunen =, ≠, <, ≤, ≥, > en tussen. Booleaanse velden gebruiken Ja/Nee. Zoekvelden ondersteunen in en niet in met multiselect. Tekstvelden voegen bevat, begint met en regex toe. Combineer willekeurige velden in geneste AND/OR-groepen - de engine hercontroleert ze bij elke winkelwagenupdate.

Product-, categorie-, fabrikant- en groepskiezers gebruiken ingebouwde autocomplete-zoekfunctie. Een live voorbeeldzin legt uit wat de boom matcht. Ervaren gebruikers kunnen ruwe JSON schakelen voor kopiëren-plakken tussen omgevingen. Voorwaarden worden opnieuw geëvalueerd bij elke winkelwagensync - toevoegen aan winkelwagen, aantal wijzigen, inloggen, adres wijzigen - de engine reageert direct.

Operatorenreferentie

14 operatoren zijn beschikbaar in de bouwer. Veldtype bepaalt welke operatoren verschijnen - booleaanse velden gebruiken alleen = en ≠; numerieke velden krijgen de volledige vergelijkingsset.

Elke serviceregel kiest een bedragtype: vast, percentage of gelaagd. Vast gebruikt één decimale waarde. Percentage gebruikt een tarief plus een waardebasis - producttotaal, winkelwagentotaal, verzendkosten of winkelwagengewicht. Gelaagd opent een trapsgewijze tabel opgeslagen als JSON (tiers_json) met van/tot-bands en vergoeding per band.

Min vergoeding en max vergoeding limieten klemmen percentageberekeningen zodat verzekering nooit onder €2 zakt of €50 overschrijdt. Per-regel belastingregelgroep zorgt dat de serviceregel de juiste btw erft. Planningsvelden (date_from / date_to) beperken seizoensaanbiedingen zonder het hele beleid uit te schakelen.

Achter de UI resolveert ConorderservicesEngine in aanmerking komende regels, berekent elke vergoeding vanuit live winkelwagencontext, past samenvoegstrategie toe en schrijft het gecombineerde totaal naar een dynamische SpecificPrice op het gedeelde serviceproduct. Regelsamenvattingschips in admin tonen actieve prijsstelling in één oogopslag zonder de editor te openen.

De tierbouwer in adminPolicyRules.js voegt/verwijdert rijen visueel. Schakelen van gelaagd terug naar vast behoudt andere regelinstellingen. Importeer een beleid van staging, open de regelkaart, pas één drempel aan, sla op - gestructureerde data blijft consistent.

In aanmerking komende diensten renderen in een dedicated checkoutpaneel via displayShoppingCart, displayShoppingCartFooter of displayCheckoutSummaryTop - positie configureerbaar in Instellingen. Elke aanbiedingsregel toont selectievakje of radiocontrole, optioneel icoon/afbeelding, naam, beschrijving en berekend prijsbadge.

Klant schakelt diensten via front AJAX-controller (checkout.js + module ajax endpoint). Winkelwagentotalen en regelabels werken bij zonder volledige paginareload. Paneel ververst ook wanneer winkelwagenaantal wijzigt. Selectie-events loggen naar audit (service_selected, service_deselected). Impressie-events loggen wanneer het paneel wordt getoond (gededupliceerd per in aanmerking komende set).

Geselecteerde diensten synchroniseren naar één verborgen catalogusproduct (CONORDERSVC-SERVICE) met dynamische SpecificPrice per winkelwagen. Meerdere selecties verschijnen als één winkelwagenregel met komma-gescheiden meertalige labels en gecombineerd bedrag. Winkelwagenstatus blijft bewaard in conorderservices_cart met in aanmerking komende snapshot, geselecteerde diensten JSON en toegepaste snapshot voor idempotente sync.

Hooks actionCartSave, hooks voor productverwijdering uit de winkelwagen, actionPresentCartProduct en actionProductPriceCalculation houden de serviceregel gesynchroniseerd wanneer de winkelwagen wijzigt. Compatibel met PrestaShop 9, 8, 1.7-thema's inclusief Hummingbird winkelwagenminiaturen via actionPresentProduct.

Elke serviceregel ondersteunt een visuele identiteit bij checkout: upload een JPG/PNG/GIF/WebP naar views/img/services/ of plak een externe HTTPS-URL. ConorderservicesRuleImage handelt uploadvalidatie, opslag, publieke URL-resolutie en veilig verwijderen af wanneer afbeeldingen worden vervangen of verwijderd.

De dedicated afbeeldingen-editor UI (adminPolicyRuleImage.js) toont live voorbeeld, verwijder/vervang-controles en fallback naar vorige afbeelding tijdens opslaan. Bij beleidsduplicatie of import worden afbeeldingen veilig gekloond of gerefereerd zodat staging-naar-productie-overdrachten de checkout-weergave niet breken.

Icoongrootte (1-256 px), icoonpositie (links/midden/rechts) en controle-uitlijning zijn globale Instellingen - zodat één winkel grote links-uitgelijnde cadeauverpakking-iconen toont terwijl een andere compacte rechts-uitgelijnde selectievakjes houdt. Toon/verberg-schakelaars voor naam, beschrijving, prijs en icoon per winkel voltooien de presentatielaag.

Het tabblad Simulator is een driestapsworkflow tegen echte data in uw database - geen mock-winkelwagen. Stap 1: zoek winkelwagens op ID, klantnaam of e-mail. Stap 2: kies een winkelwagen uit de live lijst (toont klant, e-mail, winkelwagentotaal, laatste update). Stap 3: voer evaluatie uit en lees de volledige resultaatspecificatie.

Resultaten tonen welke beleidsregels matchten, welke werden overgeslagen (en waarom), berekende vergoedingen per regel, in aanmerking komende vs geselecteerde status, radiogroep-resolutie en winkelwagenregelvoorbeeld met gecombineerd label en bedrag. Optioneel klantfilter vernauwt de winkelwagenlijst tot één account - ideaal voor het reproduceren van een supportticket.

Elke simulatierun wordt gelogd in het auditlogboek met eventtype simulation_run, winkelwagen-ID, actor (medewerker) en resultaatsnapshot. Merchandising kan een campagne verifiëren vóór activering. Support kan uitleggen waarom een specifieke klantwinkelwagen wel of geen cadeauverpakking zag - zonder een testbestelling op de live winkel te plaatsen.

Gebruik de simulator na elke beleidsbewerking, vóór feestdagengolive, en bij importeren van beleidsregels van staging. Het is het vangnet dat servicebeheer op enterprise-niveau scheidt van "wijzigen en hopen".

Het tabblad Dashboard is uw controlekamer voor optionele diensten. KPI-kaarten over een selecteerbare periode (30 / 90 / 180 / 365 dagen) tonen: paneelimpressies, checkoutselecties, bestellingen met diensten, conversiepercentage en serviceomzet in winkelvaluta. Cijfers komen uit het auditlogboek - echte events, geen schattingen.

Chart.js trendgrafieken visualiseren de omzetfunnel over drie granulariteiten: dagelijks (configureerbaar venster), wekelijks en maandelijks. Lijnen volgen impressies, selecties, betaalde bestellingen en serviceomzet op secundaire as. Schakel het standaard grafiektype in Instellingen. Een taartdiagram splitst betaalde omzet op servicecode zodat u ziet welke extra's daadwerkelijk converteren.

De tabel per dienst somt elke servicecode op met impressies, selecties, bestellingen, omzet en conversiepercentage. Selecties zijn een funnelstap - bestellingen en omzet zijn de KPI-waarheid (vermijdt vanity metrics van selectievakjes die nooit converteren). Recente auditvermeldingen verschijnen op het dashboard voor probleemoplossing in één oogopslag.

Voor bureaus en multistore-operators: het dashboard beantwoordt de vraag die merchandising altijd stelt - "Verkopen onze checkout-extra's daadwerkelijk?" - met data, niet onderbuikgevoel.

Het dedicated tabblad Auditlogboek is een volledig eventjournaal - geen debugbestand begraven in serverlogs. Elke rij slaat tijdstempel, eventtype, actor (medewerkersnaam, klantnaam of SYSTEM), leesbare samenvatting, gekoppelde bestelreferentie, servicecode, vergoedingsbedrag, winkelwagen-ID en beleids-/regel-ID op.

20+ eventtypes worden bijgehouden:

• service_impression - checkoutpaneel getoond aan winkelwagen
• service_selected / service_deselected - klant schakelt een dienst
• service_applied - diensten gesynchroniseerd naar winkelwagenregel
• order_services - bestelling geplaatst met serviceomzet (per regel)
• order_validated - ordervalidatie-hook afgevuurd
• policy_created, policy_updated, policy_deleted, policy_toggled
• policy_duplicated, policy_imported, policy_exported
• rule_created, rule_updated, rule_deleted, rule_toggled
• preset_applied - voorwaardepreset geladen in bouwer
• settings_updated - moduleconfiguratiewijziging
• simulation_run / simulation - back-office winkelwagenevaluatie

Klik Bekijken op elke rij om een detailmodal te openen met de volledige JSON-snapshot - toegepaste serviceregels, beleidsdiff, simulatie-output of instellingenwijzigingspayload. Servicetoepassingen slaan een fee_snapshot op zodat u precies kunt reconstrueren wat de klant bij checkout zag.

De lijst ondersteunt PrestaShop native CSV-export voor finance- en compliance-reviews. Gekoppelde kolommen tonen bestelreferentie, klantnaam en medewerkersnaam zonder handmatige kruisverwijzing. Op de bestelpagina in back office (displayAdminOrder hook) toont een paneel welke optionele diensten aan die bestelling hebben bijgedragen - servicenaam, code, bedrag en snapshot.

Beleidsregels zijn draagbare JSON-documenten. Export downloadt het volledige beleid - voorwaardenboom, alle regels, prijsconfiguraties, samenvoegstrategie, serviceafbeeldingen-metadata, posities - klaar voor versiebeheer of overdracht naar een andere winkel. Import uploadt een JSON-bestand en maakt een nieuw beleid met auditlogboekvermelding policy_imported.

Dupliceren kloont een beleid met één klik vanuit het lijstactiemenu via ConorderservicesPolicyDuplicator - kopieert elke regel, hernoemt met suffix, kloont afbeeldingen veilig, logt policy_duplicated. Perfect voor het maken van "Holiday v2" van "Holiday v1" zonder 10 regels handmatig opnieuw op te bouwen.

Typische bureauworkflow: bouw en simuleer op staging → exporteer JSON → importeer op productie → voer simulator opnieuw uit → activeer. Seizoensconfiguraties verplaatsen tussen klantwinkels in minuten. Elke overdracht is traceerbaar in het auditlogboek.

Het tabblad Instellingen centraliseert winkelbreed gedrag. Master aan/uit-schakelaar. Globale samenvoegstrategie standaard voor nieuwe beleidsregels. Standaard belastingregelgroep voor nieuwe serviceregels. Serviceproduct-ID - kies welk catalogusproduct de winkelwagenregel vertegenwoordigt of gebruik het automatisch aangemaakte verborgen product CONORDERSVC-SERVICE.

Weergavepositie bepaalt waar het checkoutpaneel rendert: geïntegreerd blok winkelwagenoverzicht, alleen winkelwagenpagina, alleen checkoutoverzicht, winkelwagen- en checkout-themahooks, of onder winkelwagenproductlijst. Aanbiedingsweergave-instellingen bepalen toon/verberg naam, beschrijving, prijs en icoon; icoonformaat (1-256 px); icoonpositie (links/midden/rechts); selectievakje/radio-uitlijning.

Debuglog schrijft uitgebreide engine-traces voor support. Analytics-sectie configureert standaard grafiekperiode (30/90/180/365 dagen), dagelijkse/wekelijkse/maandelijkse grafiekvensters en standaard grafiektype. Live voorbeeld in Instellingen toont hoe aanbiedingsregels eruitzien met huidige weergaveopties.

Elke instellingenopslag logt settings_updated naar het auditlogboek met voor/na-snapshot. Geen stille configuratiedrift.

Diensten materialiseren als een echte winkelwagenregel op het gedeelde verborgen product met dynamische prijs en meertalig label. Ze verschijnen in winkelwagenoverzicht, checkout, orderbevestiging, facturen en back-office bestelweergave - precies als een normale productregel, zonder themahacks of nep negatieve bedragen.

De engine haakt in op actionCartSave, product toevoegen/verwijderen, front controller init, ordervalidatie (actionValidateOrder, actionValidateOrderBefore op PS 8.1+) en winkelwagenpresentatie - herberekent wanneer de winkelwagencontext wijzigt. Ordertabelkolommen conorderservices_service_amount en conorderservices_service_snapshot slaan historische servicetotalen op het orderrecord op.

Beleidsregels zijn winkel-scoped (id_shop) voor multistore-configuraties. Elke winkel in uw groep kan onafhankelijke servicestacks draaien. PrestaShop 9, 8 en 1.7 delen één codebase via lib/prestashop9compatibility.php en ConorderservicesCompatibility.

Meertalige checkoutlabels per regel (conorderservices_rule_lang) zorgen dat de serviceregel correct leest in elke actieve winkelstaal. 30 kant-en-klare vertaalpakketten dekken back office en front office via PrestaShop l() - van Engels, Duits en Pools tot Spaans, Frans, Italiaans en markten in heel Europa en Azië.