Käytäntö on nimetty palvelukampanja - lomalisäpalvelusi, VIP-etusi, elektroniikkatakuupinosi. Jokaisessa käytännössä on ehtopuu (kuka kelpuutetaan) ja yksi tai useampi palvelusääntö (mitä tarjoat ja millä hinnalla). Luo rajattomasti käytäntöjä, järjestä vetämällä prioriteetin mukaan, aktivoi tai keskeytä yksitellen koskematta koodiin.

Jokainen sääntö määrittää: palvelukoodin, monikielisen ostoskorinimikkeen ja kuvauksen (conorderservices_rule_lang), arvotyypin (kiinteä, prosentti, porrastettu), arvopohjan (tuotteet, ostoskori, toimitus, paino), min/max-maksukatot, verosääntöryhmän, kuvakkeen tai ladatun kuvan, UI-tyypin (valintaruutu tai radio), valinnaisen radioryhmän ja otsikon, esivalintalipun, prioriteetin, aikataulupäivät (voimassa alkaen / voimassa asti) ja valinnaiset sääntötason ehdot.

Stop on first match lopettaa arvioinnin ensimmäisen kelpuuttavan käytännön jälkeen - hyödyllinen, kun kampanjat eivät saa mennä päällekkäin. Merge strategy käytäntöä kohti hallitsee, miten useat säännöt yhdessä käytännössä yhdistyvät: stack all services, first match wins, priority cascade, vain suurin maksu tai unique service codes. Globaali oletusyhdistämisstrategia Asetuksissa koskee uusia käytäntöjä.

Käytäntöjen listanäkymä näyttää tilan, yhdistämisstrategian, sääntömäärän ja pikatoiminnot. Monista, vie JSON, tuo tiedostosta tai vaihda aktiivinen - kaikki käytäntöpaneelista, jokainen muutos auditointilokiin.

Ehtorakentaja on sisäkkäinen AND/OR-puueditori - sama malli kuin ammattimaisissa sääntömoottoreissa, vetämällä käsiteltävinä ryhminä back officessa. Lisää ryhmä, valitse kenttä, valitse operaattori, aseta arvo. Sisäkkäistä ryhmiä logiikalle kuten: (VIP-ryhmä TAI 5+ aiempaa tilausta) JA (ostoskorin summa ≥ 100 €) JA (kategoriassa Summer Sale on 3+ tuotetta).

35 ehtokenttää kattavat koko ostoskorikontekstin: ostoskorin summa, tuotteiden välisumma, toimituskulu, tuotemäärä, uniikkien SKU:iden määrä, paino, olemassa olevien ostoskorin sääntöjen määrä, asiakkaan tilausmäärä, elinikäinen kulutus, viikonpäivä, tunti, päivämäärä, postinumero, valuutta, maa, laskutusmaa, vyöhyke, asiakasryhmä, kuljetusyhtiö, maksumoduuli, kirjautunut/vieras-tila, tuotteet, kategoriat, valmistajat, toimittajat, virtuaalinen/fyysinen-liput, räätälöinti ja olemassa olevan alennuksen tunnistus.

Yhdistelmäkentät yhdistävät entiteetin ja kynnyksen yhteen ehtoon - esim. tuote #123 määrä ≥ 3, kategoria #45 rivin summa ≥ 50 €. Operaattorit: equals, not equals, greater/less than, between, in list, not in list, contains, starts with, regex, empty ja not empty.

Ehtotyyppien luettelo

Jokainen rivi vastaa täsmälleen ehtorakentajan valintalistaa. Numeeriset kentät tukevat =, ≠, <, ≤, ≥, > ja between. Totuusarvo-kentät käyttävät Yes/No. Hakukentät tukevat in ja not in monivalinnalla. Tekstikentät lisäävät contains, starts with ja regex. Yhdistä mitä tahansa kenttiä sisäkkäisissä AND/OR-ryhmissä - moottori tarkistaa ne jokaisella ostoskorin päivityksellä.

Tuote-, kategoria-, valmistaja- ja ryhmävalitsimet käyttävät sisäänrakennettua automaattista hakua. Live-esikatselulause selittää, mitä puu vastaa. Tehokäyttäjät voivat vaihtaa raakaan JSONiin kopiointia varten. Ehdot arvioidaan uudelleen jokaisella ostoskorin synkronoinnilla - lisäys, määrän muutos, kirjautuminen, osoitteen muutos - moottori reagoi heti.

Operaattorien luettelo

14 operaattoria on saatavilla rakentajassa. Kenttätyyppi määrää, mitkä operaattorit näkyvät - totuusarvo-kentät käyttävät vain = ja ≠; numeeriset kentät saavat täyden vertailujoukon.

Jokainen palvelusääntö valitsee summatyypin: kiinteä, prosentti tai porrastettu. Kiinteä käyttää yhtä desimaaliarvoa. Prosentti käyttää prosenttia ja arvopohjaa - tuotteiden summa, ostoskorin summa, toimituskulu tai ostoskorin paino. Porrastettu avaa porrasvaihetaulukon JSONina (tiers_json) from/to-kaistoilla ja maksulla kaistaa kohti.

Min-maksu ja max-maksu -katot rajoittavat prosenttilaskentaa, jotta vakuutus ei koskaan putoa alle 2 € eikä ylitä 50 €. Sääntökohtainen verosääntöryhmä varmistaa, että palvelurivi perii oikean ALV:n. Aikataulukentät (date_from / date_to) rajoittavat kausitarjouksia poistamatta koko käytäntöä käytöstä.

Käyttöliittymän takana ConorderservicesEngine ratkaisee kelvolliset säännöt, laskee jokaisen maksun live-ostoskorikontekstista, soveltaa yhdistämisstrategian ja kirjoittaa yhdistetyn summan dynaamiseen SpecificPrice -kenttään jaetulla palvelutuotteella. Sääntöyhteenvetomerkit adminissa näyttävät aktiivisen hinnoittelun yhdellä silmäyksellä.

Porrastusrakentaja adminPolicyRules.js -tiedostossa lisää/poistaa rivejä visuaalisesti. Porrastetusta takaisin kiinteään säilyttää muut sääntöasetukset. Tuo käytäntö stagingista, avaa sääntökortti, säädä yhtä kynnystä, tallenna - strukturoitu data pysyy johdonmukaisena.

Kelvolliset palvelut renderöidään erillisessä kassapaneelissa displayShoppingCart, displayShoppingCartFooter tai displayCheckoutSummaryTop - sijainti konfiguroitavissa Asetuksissa. Jokainen tarjousrivi näyttää valintaruudun tai radion, valinnaisen kuvakkeen/kuvan, nimen, kuvauksen ja lasketun hintamerkin.

Asiakas vaihtaa palveluja front AJAX -ohjaimella (checkout.js + moduulin ajax-endpoint). Ostoskorin summat ja rivinimikkeet päivittyvät ilman täyttä sivulatausta. Paneeli päivittyy myös määrän muuttuessa. Valintatapahtumat lokiin (service_selected, service_deselected). Näyttökerrat lokiin, kun paneeli näytetään (dedup per kelvollinen joukko).

Valitut palvelut synkronoidaan yhteen piilotettuun katalogituotteeseen (CONORDERSVC-SERVICE) dynaamisella SpecificPrice ostoskoria kohti. Useat valinnat yhtenä ostoskoririvinä pilkulla erotetuilla monikielisillä nimikkeillä ja yhdistetyllä summalla. Ostoskorin tila conorderservices_cart -taulussa kelvollisella vedoksella, valittujen palveluiden JSONilla ja sovelletulla vedoksella idempotenttiin synkronointiin.

Hookit actionCartSave, ostoskorin poistohookit, actionPresentCartProduct ja actionProductPriceCalculation pitävät palvelurivin synkassa ostoskorin muuttuessa. Yhteensopiva PrestaShop 9, 8, 1.7 -teemojen kanssa, mukaan lukien Hummingbird-kuvakkeet actionPresentProduct -hookilla.

Jokainen palvelusääntö tukee visuaalista identiteettiä kassalla: lataa JPG/PNG/GIF/WebP hakemistoon views/img/services/ tai liitä ulkoinen HTTPS-URL. ConorderservicesRuleImage hoitaa latauksen validoinnin, tallennuksen, julkisen URL-ratkaisun ja turvallisen poiston kuvien vaihdossa tai poistossa.

Erillinen kuvaeditori (adminPolicyRuleImage.js) näyttää live-esikatselun, poista/korvaa-ohjaimet ja säilyttää edellisen varana tallennuksen aikana. Käytännön monistuksessa tai tuonnissa kuvat kloonataan tai viitataan turvallisesti, jotta staging-tuotanto-siirrot eivät riko kassan visuaaleja.

Kuvakkeen koko (1-256 px), sijainti (vasen/keski/oikea) ja ohjainten tasaus ovat globaaleja Asetuksia - yksi kauppa voi näyttää suuria vasemmalle tasattuja lahjapaketointikuvakkeita, toinen kompaktit oikealle tasatut valintaruudut. Näytä/piilota-kytkimet nimelle, kuvaukselle, hinnalle ja kuvakkeelle kauppaa kohti viimeistelevät esityskerroksen.

Simulaattori-välilehti on kolmivaiheinen työnkulku oikeaa tietokantadataa vasten - ei mock-ostoskoria. Vaihe 1: hae ostoskoreja ID:llä, asiakkaan nimellä tai sähköpostilla. Vaihe 2: valitse ostoskori live-listasta (näyttää asiakkaan, sähköpostin, ostoskorin summan, viimeisimmän päivityksen). Vaihe 3: aja arviointi ja lue täydellinen tulosjäsennys.

Tulokset näyttävät, mitkä käytännöt täsmäsivät, mitkä ohitettiin (ja miksi), sääntökohtaiset lasketut maksut, kelvollinen vs valittu -tila, radioryhmän ratkaisu ja ostoskoririvin esikatselun yhdistetyllä nimikkeellä ja summalla. Valinnainen asiakassuodatin rajaa ostoskorilistan yhteen tiliin - ihanteellinen tukipyynnön toistamiseen.

Jokainen simulaatioajo kirjataan auditointilokiin tapahtumatyypillä simulation_run, ostoskorin ID, toimija (työntekijä) ja tulosvedos. Myynti voi varmistaa kampanjan ennen aktivointia. Tuki voi selittää, miksi tietyn asiakkaan ostoskorissa näkyi tai ei näkynyt lahjapaketointia - ilman testitilausta live-kaupassa.

Käytä simulaattoria jokaisen käytäntömuutoksen jälkeen, ennen lomakäynnistystä ja käytäntöjä stagingista tuotaessa. Se on turvaverkko, joka erottaa yritystason palveluhallinnan "muuta ja toivo parasta" -lähestymistavasta.

Paneeli-välilehti on valinnaisten palveluiden ohjaamo. KPI-kortit valittavalla jaksolla (30 / 90 / 180 / 365 päivää) näyttävät: paneelin näyttökerrat, kassavalinnat, tilaukset palveluineen, ostoasteen ja palveluliikevaihdon kaupan valuutassa. Luvut tulevat auditointilokista - oikeita tapahtumia, ei arvioita.

Chart.js-trendikaaviot visualisoivat liikevaihtosuppilon kolmella tarkkuudella: päivittäin (konfiguroitava ikkuna), viikoittain ja kuukausittain. Viivat seuraavat näyttökertoja, valintoja, maksettuja tilauksia ja palveluliikevaihtoa toissijaisella akselilla. Vaihda oletuskaaviotyyppi Asetuksissa. Ympyräkaavio jakaa maksetun liikevaihdon palvelukoodin mukaan, jotta näet, mitkä lisäpalvelut todella konvertoivat.

Palvelukohtainen taulukko listaa jokaisen palvelukoodin näyttökerrat, valinnat, tilaukset, liikevaihdon ja ostoasteen. Valinnat ovat suppilon vaihe - tilaukset ja liikevaihto ovat KPI-totuus (välttää turhia metriikoita valintaruuduista, jotka eivät konvertoi). Viimeisimmät auditointimerkinnät paneelissa nopeaan vianmääritykseen.

Toimistoille ja monikauppaoperaattoreille: paneeli vastaa kysymykseen, jonka myynti aina kysyy - "Myyvätkö kassalisäpalvelumme oikeasti?" - datalla, ei vaistolla.

Erillinen Auditointiloki-välilehti on täydellinen tapahtumapäiväkirja - ei palvelinlokiin haudattu debug-tiedosto. Jokainen rivi tallentaa aikaleiman, tapahtumatyypin, toimijan (työntekijän nimi, asiakkaan nimi tai SYSTEM), ihmisluettavan yhteenvedon, linkitetyn tilausviitteen, palvelukoodin, maksusumman, ostoskorin ID:n ja käytäntö/sääntö-ID:n.

20+ tapahtumatyyppiä seurataan:

• service_impression - kassapaneeli näytetty ostoskorille
• service_selected / service_deselected - asiakas vaihtaa palvelua
• service_applied - palvelut synkronoitu ostoskoririville
• order_services - tilaus tehty palveluliikevaihdolla (riviä kohti)
• order_validated - tilauksen validointihook lauennut
• policy_created, policy_updated, policy_deleted, policy_toggled
• policy_duplicated, policy_imported, policy_exported
• rule_created, rule_updated, rule_deleted, rule_toggled
• preset_applied - ehtoesiasetus ladattu rakentajaan
• settings_updated - moduulin konfiguraatiomuutos
• simulation_run / simulation - back office -ostoskorin arviointi

Napsauta Näytä millä tahansa rivillä avataksesi yksityiskohtamodaalin täydellä JSON-vedoksella - sovelletut palvelurivit, käytäntödiffi, simulaatiotulos tai asetusmuutoksen payload. Palvelusovellukset tallentavat fee_snapshot -kentän, jotta voit rekonstruoida tarkalleen, mitä asiakas näki kassalla.

Lista tukee PrestaShopin natiivia CSV-vientiä talous- ja compliance-tarkastuksiin. Liitetyt sarakkeet näyttävät tilausviitteen, asiakkaan nimen ja työntekijän nimen ilman manuaalista ristiinviittausta. Tilaussivulla back officessa (displayAdminOrder -hook) paneeli näyttää, mitkä valinnaiset palvelut vaikuttivat tilaukseen - palvelun nimi, koodi, summa ja vedos.

Käytännöt ovat siirrettäviä JSON-dokumentteja. Vie lataa täyden käytännön - ehtopuu, kaikki säännöt, hinnoitteluasetukset, yhdistämisstrategia, palvelukuvien metatiedot, sijainnit - versionhallintaan tai toiseen kauppaan. Tuo lataa JSON-tiedoston ja luo uuden käytännön auditointimerkinnällä policy_imported.

Monista kloonaa käytännön yhdellä napsautuksella listan toimintovalikosta ConorderservicesPolicyDuplicator - kopioi jokaisen säännön, nimeää uudelleen suffiksilla, kloonaa kuvat turvallisesti, kirjaa policy_duplicated. Täydellinen "Holiday v2" -käytännön luontiin "Holiday v1":stä ilman 10 säännön uudelleenrakentamista.

Tyypillinen toimistotyönkulku: rakenna ja simuloi stagingissa → vie JSON → tuo tuotantoon → aja simulaattori uudelleen → aktivoi. Kausittaiset palveluasetukset siirtyvät asiakaskauppojen välillä minuuteissa. Jokainen siirto jäljitettävissä auditointilokissa.

Asetukset-välilehti keskittää koko kaupan toiminnan. Pääkytkin päälle/pois. Globaali yhdistämisstrategia oletuksena uusille käytännöille. Oletusverosääntöryhmä uusille palvelusäännöille. Palvelutuotteen ID - valitse, mikä katalogituote edustaa ostoskoririviä tai käytä automaattisesti luotua piilotettua CONORDERSVC-SERVICE -tuotetta.

Näyttösijainti hallitsee, missä kassapaneeli renderöidään: ostoskorin yhteenveto integroituna, vain ostoskorisivu, vain kassayhteenveto, ostoskori- ja kassateemahookit tai ostoskorin tuotelistan alla. Tarjouksen näyttöasetukset hallitsevat nimen, kuvauksen, hinnan ja kuvakkeen näyttö/piiloto; kuvakkeen koko (1-256 px); sijainti (vasen/keski/oikea); valintaruutu/radio-tasaus.

Debug-loki kirjoittaa yksityiskohtaisia moottorijälkiä tukea varten. Analytiikka-osio konfiguroi oletuskaaviojakson (30/90/180/365 päivää), päivä/viikko/kuukausi-ikkunat ja oletuskaaviotyypin. Live-esikatselu Asetuksissa näyttää, miltä tarjousrivit näyttävät nykyisillä näyttöasetuksilla.

Jokainen asetusten tallennus kirjaa settings_updated auditointilokiin ennen/jälkeen-vedoksella. Ei hiljaista konfiguraatioiden ajautumista.

Palvelut materialisoituvat oikeaksi ostoskoririviksi jaetulla piilotetulla tuotteella dynaamisella hinnalla ja monikielisellä nimikkeellä. Ne näkyvät ostoskorin yhteenvedossa, kassalla, tilausvahvistuksessa, laskuissa ja back office -tilausnäkymässä - aivan kuin tavallinen tuoterivi, ilman teemahakkereita tai vääriä negatiivisia summia.

Moottori kytkeytyy actionCartSave -hookiin, tuotteiden lisäykseen/poistoon, front controller init -vaiheeseen, tilauksen validointiin (actionValidateOrder, actionValidateOrderBefore PS 8.1+) ja ostoskorin esitykseen - laskee uudelleen aina ostoskorikontekstin muuttuessa. Tilaustaulun sarakkeet conorderservices_service_amount ja conorderservices_service_snapshot tallentavat historialliset palvelusummat tilaustietueeseen.

Käytännöt ovat kauppakohtaisia (id_shop) monikauppa-asetuksissa. Jokainen kauppa ryhmässä voi ajaa itsenäisiä palvelupinoja. PrestaShop 9, 8 ja 1.7 jakavat yhden koodipohjan lib/prestashop9compatibility.php ja ConorderservicesCompatibility -tiedostojen kautta.

Monikieliset kassanimikkeet sääntöä kohti (conorderservices_rule_lang) varmistavat, että palvelurivi luetaan oikein jokaisella aktiivisella kaupan kielellä. 30 valmista käännöspakettia kattaa back officen ja front officen PrestaShopin l() -funktiolla - englannista, saksasta ja puolasta espanjaan, ranskaan, italiaan ja markkinoille Euroopassa ja Aasiassa.