Konfigurator je jedna skripta i jedan HTML element. Za ugradnju ne instalirate ništa na svoj poslužitelj. Sve u nastavku možete isprobati u sandboxu prije puštanja u rad.
Kod
Kategorija Embedding code u konzoli piše isječak za vas u obliku koji odaberete: običan HTML (četiri varijante), WordPress, WooCommerce SKU gumb ili samostalna poveznica s QR kodom. Oblik mu je:
<script type="module" src="https://cfg.cutoptim.com/embed/assets/latest/cutoptim-configurator.js"></script>
<cutoptim-configurator mode="inline" key="YOUR_PUBLISHABLE_KEY"
api="https://cfg.cutoptim.com" lang="en"></cutoptim-configurator>Ključ, adresa usluge i jezik dolaze iz vaše konzole. Skočni prozor ili bočni panel otvara se gumbom:
<button data-cutoptim-open="#cut" data-material="MDF-18">Cut this board to size</button>
<cutoptim-configurator id="cut" mode="modal" key="YOUR_PUBLISHABLE_KEY"
api="https://cfg.cutoptim.com" lang="en"></cutoptim-configurator>Načini rada i atributi
| Attribute | Značenje |
|---|---|
mode |
inline (zadano), modal (skočni prozor) ili drawer (bočni panel) |
key |
vaš javni ključ |
lang |
jezik za kupce |
material |
ploča iz vašeg kataloga, po id-ju ili točnom nazivu; tijek tada počinje na popisu rezanja |
thickness |
sužava material u milimetrima; sam za sebe ne odabire ništa |
template |
predložak namještaja od kojeg se kreće |
start |
catalog, cutlist ili template |
project |
spremljeni projekt koji se učitava |
customer-token |
vaša vlastita neprozirna oznaka prijavljenog kupca, do 128 znakova |
width, height |
veličina okvira domaćina, kao obične CSS duljine |
Skočni prozor ili bočni panel ne učitavaju ništa dok se prvi put ne otvore, pa mreža proizvoda s mnogo gumba ostaje lagana. Više konfiguratora na jednoj stranici radi neovisno. Atribut s neispravnom vrijednošću odbacuje se, nikada se ne primjenjuje napola.
Iz skripte element nudi open(), close(), setMaterial(), loadProject() i setCustomerToken(). Na sebi podiže događaje: cutoptim:ready, step, quote, order, project, error, open i close.
Samostalna stranica, QR i iframe
Isti konfigurator može raditi kao zasebna stranica: povežite na nju, ispišite QR kod za pult trgovine ili kiosk ili je pošaljite kupcu. Stranica koja ne može učitati skriptu može prikazati tu stranicu u iframeu; uokviriti je mogu samo domene koje navedete, a poruke između okvira i vaše stranice prihvaćaju se samo s tih domena.
Dopuštene domene
Javni ključ radi samo s domena navedenih za njega. Domene svoje trgovine, uključujući sve testne (staging) domene, navodite pri stvaranju ključa u kategoriji Keys & embedding; zahtjev s bilo kojeg drugog podrijetla se odbija.
Brendiranje
Boje, polumjer zaobljenja kutova, tipografija, svijetli ili tamni prikaz i svi tekstovi vidljivi kupcima na deset jezika postavljaju se u konzoli i primjenjuju se bez uređivanja vaše stranice. Stranica može i oblikovati dijelove widgeta putem CSS ::part selektora.
Fiksirana verzija s integritetom
Prema zadanim postavkama isječak učitava pomičnu latest verziju. Ondje gdje usluga zadržava izdanja, konzola umjesto toga može ponuditi fiksirani isječak: određeno numerirano izdanje s hash vrijednošću integrity, pa preglednik odbija datoteku koja je promijenjena. Stroža varijanta fiksira i dijelove koji se učitavaju naknadno. Izdanja su potpisana, objavljeno izdanje nikada se ne mijenja, a ranije izdanje ostaje dostupno kako biste ga mogli fiksirati koliko god vam treba. Za strogu Content Security Policy konzola prikazuje direktive koje treba dopustiti. Fiksirani isječci zahtijevaju da usluga čuva izdanja; do tada konzola nudi samo pomični isječak.
Spremljeni projekti
Kupac može spremiti popis rezanja i vratiti mu se. Prvo spremanje stvara privatni token koji preglednik čuva, pa je prema zadanim postavkama projekt dostupan samo u tom pregledniku. Ne postoji sinkronizacija između uređaja temeljena na prijavi, a kupac ne može izbrisati spremljeni projekt; nenaručeni projekti brišu se nakon vašeg razdoblja zadržavanja.
Povratak u vašu košaricu
Kad kupac naruči, konfigurator na vašoj stranici podiže događaj narudžbe. Na samostalnoj stranici može i vratiti kupca u vašu trgovinu nakon uspješne narudžbe: postavljate povratnu adresu (samo https, na vašoj domeni), a kupac vidi kratku potvrdu s gumbom Back to the shop. Cijena se nikada ne smije preuzeti iz preglednika ni iz povratne adrese: vaš poslužitelj prvo provjerava ponudu. Kako, piše na stranici o narudžbama; gotov dodatak za WooCommerce nalazi se na vlastitoj stranici, a referentni kod za bilo koju drugu trgovinu na stranici o vlastitim platformama.