A konfigurátor egy script és egy HTML-elem. A beágyazáshoz nem kell semmit telepítenie a szerverére. Minden alább leírtat begyakorolhat sandboxban, mielőtt élesbe indul.
A kód
A konzol Embedding code kategóriája az Ön által választott formában megírja Önnek a kódrészletet: sima HTML (négy változat), WordPress, WooCommerce SKU-gomb, vagy önálló hivatkozás QR-kóddal. Az alakja:
<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>A kulcs, a szolgáltatás címe és a nyelv a konzolból jön. A felugró ablakot vagy az oldalpanelt egy gomb nyitja meg:
<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>Módok és attribútumok
| Attribútum | Jelentés |
|---|---|
mode |
inline (alapértelmezett), modal (felugró ablak) vagy drawer (oldalpanel) |
key |
az Ön nyilvános kulcsa |
lang |
a vevőoldali nyelv |
material |
a katalógusa egy lapja azonosítóval vagy pontos névvel; a folyamat ekkor a darabjegyzéken indul |
thickness |
milliméterben szűkíti a material-t; önmagában nem választ ki semmit |
template |
egy bútorsablon, amelyből indul |
start |
catalog, cutlist vagy template |
project |
egy betöltendő mentett projekt |
customer-token |
az Ön saját, átlátszatlan hivatkozása a bejelentkezett vevőre, legfeljebb 128 karakter |
width, height |
a befogadó doboz mérete, egyszerű CSS-hosszúságként |
A felugró ablak vagy az oldalpanel az első megnyitásig nem tölt be semmit, így a sok gombot tartalmazó termékrács könnyű marad. Egy oldalon több konfigurátor is egymástól függetlenül működik. Az érvénytelen értékű attribútumot a rendszer elveti, soha nem alkalmazza félig.
Scriptből az elem a open(), close(), setMaterial(), loadProject() és setCustomerToken() hívásokat kínálja. Eseményeket önmagán vált ki: cutoptim:ready, step, quote, order, project, error, open és close.
Önálló oldal, QR és iframe
Ugyanaz a konfigurátor futhat önálló oldalként is: hivatkozhat rá, kinyomtathatja a QR-kódot egy bolti pulthoz vagy kioszkhoz, vagy elküldheti egy vevőnek. Az az oldal, amely nem tud scriptet betölteni, ezt az oldalt egy iframe-ben jelenítheti meg; csak az Ön által felsorolt domainek keretezhetik, és az iframe és az Ön oldala közötti üzeneteket is csak ezekről a domainekről fogadja el a rendszer.
Engedélyezett domainek
A nyilvános kulcs csak a hozzá felsorolt domainekről működik. A bolt domainjeit, az esetleges staging domaint is beleértve, a kulcs létrehozásakor sorolja fel a Keys & embedding kategóriában; bármely más eredetről érkező kérést elutasít a rendszer.
Arculat
A színeket, a sarokkerekítést, a betűtípust, a világos vagy sötét megjelenést és az összes vevő számára látható szöveget tíz nyelven a konzolban állítja be, és az oldal szerkesztése nélkül érvényesül. Az oldal CSS ::part szelektorokkal a widget egyes részeit is formázhatja.
Rögzített verzió, integritás-ellenőrzéssel
Alapértelmezés szerint a kódrészlet a mozgó latest buildet tölti be. Ahol a szolgáltatás megőrzi a kiadásokat, a konzol ehelyett rögzített kódrészletet is kínálhat: egy meghatározott, számozott kiadást integrity hasheléssel, így a böngésző elutasítja a megváltoztatott fájlt. Egy szigorúbb változat a lazán betöltött részeket is rögzíti. A kiadások alá vannak írva, a közzétett kiadás soha nem változik, és egy korábbi kiadás elérhető marad, így addig rögzítheti, ameddig szüksége van rá. Szigorú Content Security Policy-hoz a konzol megmutatja az engedélyezendő direktívákat. A rögzített kódrészletekhez az kell, hogy a szolgáltatás őrizze a kiadásokat; addig a konzol csak a mozgó kódrészletet kínálja.
Mentett projektek
A vevő elmentheti a darabjegyzéket, és visszatérhet hozzá. Az első mentés egy privát tokent hoz létre, amelyet a böngésző őriz, így alapértelmezés szerint a projekt csak azon a böngészőn érhető el. Nincs bejelentkezésalapú szinkronizálás az eszközök között, és a vevő nem törölheti a mentett projektet; a le nem adott projekteket a rendszer a megőrzési idő után törli.
Visszatérés a kosárba
Amikor a vevő rendel, a konfigurátor kiváltja a rendelési eseményt az Ön oldalán. Az önálló oldalon sikeres rendelés után vissza is küldheti a vevőt az Ön boltjába: megad egy visszatérési címet (csak https, a saját domainjén), és a vevő rövid visszaigazolást lát egy Back to the shop gombbal. Az árat soha nem szabad a böngészőből vagy a visszatérési címből venni: a szervere először ellenőrzi az árajánlatot. Hogyan, azt a rendelések oldal írja le; a WooCommerce kész bővítménye a saját oldalán, bármely más bolt referenciakódja pedig az egyedi platform oldalon található.