Konfigurátor je jeden skript a jeden element HTML. Pro vložení nemusíte na svém serveru nic instalovat. Vše níže si můžete vyzkoušet v sandboxu před spuštěním ostrého provozu.
Kód
Kategorie Embedding code v konzoli napíše úryvek za vás ve zvolené podobě: prosté HTML (čtyři varianty), WordPress, tlačítko WooCommerce SKU nebo samostatný odkaz s QR kódem. Jeho tvar 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>Klíč, adresa služby a jazyk pocházejí z vaší konzole. Vyskakovací okno nebo boční panel se otevírá tlačítkem:
<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>Režimy a atributy
| Atribut | Význam |
|---|---|
mode |
inline (výchozí), modal (vyskakovací okno) nebo drawer (boční panel) |
key |
váš veřejný klíč |
lang |
jazyk pro zákazníka |
material |
deska z vašeho katalogu podle id nebo přesného názvu; postup pak začíná u seznamu řezů |
thickness |
zužuje material v milimetrech; samostatně nevybere nic |
template |
nábytková šablona, od které se začíná |
start |
catalog, cutlist nebo template |
project |
uložený projekt k načtení |
customer-token |
vaše vlastní neprůhledná reference na přihlášeného zákazníka, nejvýše 128 znaků |
width, height |
velikost hostitelského boxu, jako obyčejné délky CSS |
Vyskakovací okno nebo boční panel nenačte nic, dokud se poprvé neotevře, takže mřížka produktů s mnoha tlačítky zůstává lehká. Několik konfigurátorů na jedné stránce funguje nezávisle. Atribut s neplatnou hodnotou je zahozen, nikdy není použit napůl.
Ze skriptu nabízí element metody open(), close(), setMaterial(), loadProject() a setCustomerToken(). Na sobě vyvolává události: cutoptim:ready, step, quote, order, project, error, open a close.
Samostatná stránka, QR a iframe
Stejný konfigurátor může běžet jako samostatná stránka: odkažte na ni, vytiskněte QR kód pro pult obchodu nebo kiosek, nebo ji pošlete zákazníkovi. Stránka, která nemůže načíst skript, může tuto stránku zobrazit v iframe; zarámovat ji mohou jen domény, které uvedete, a zprávy mezi rámcem a vaší stránkou se přijímají jen z těchto domén.
Povolené domény
Veřejný klíč funguje jen z domén uvedených pro něj. Domény svého obchodu, včetně případné testovací domény, uvedete při vytváření klíče v kategorii Keys & embedding; požadavek z jakéhokoli jiného původu je odmítnut.
Vzhled
Barvy, zaoblení rohů, písmo, světlý nebo tmavý vzhled a všechny texty viditelné zákazníkovi v deseti jazycích se nastavují v konzoli a použijí se bez úprav vaší stránky. Stránka může také upravovat styl částí widgetu pomocí selektorů CSS ::part.
Připnutá verze s kontrolou integrity
Ve výchozím nastavení úryvek načítá pohyblivé sestavení latest. Kde služba vydání uchovává, může konzole místo toho nabídnout připnutý úryvek: konkrétní číslované vydání s hashem integrity, takže prohlížeč odmítne soubor, který byl změněn. Přísnější varianta připíná i části načítané za běhu. Vydání jsou podepsána, publikované vydání se nikdy nemění a dřívější vydání zůstává dostupné, takže je můžete připnout, jak dlouho potřebujete. Pro přísnou politiku Content Security Policy konzole ukazuje direktivy, které je třeba povolit. Připnuté úryvky vyžadují, aby služba vydání uchovávala; do té doby konzole nabízí jen pohyblivý úryvek.
Uložené projekty
Zákazník si může uložit seznam řezů a vrátit se k němu. První uložení vytvoří soukromý token, který si prohlížeč ponechá, takže projekt je ve výchozím nastavení dostupný jen v tomto prohlížeči. Neexistuje synchronizace mezi zařízeními založená na přihlášení a zákazník uložený projekt nemůže smazat; neobjednané projekty se vymažou po uplynutí vaší doby uchování.
Návrat do vašeho košíku
Když zákazník objedná, konfigurátor vyvolá na vaší stránce událost order. Na samostatné stránce může po úspěšné objednávce zákazníka poslat zpět do vašeho obchodu: nastavíte návratovou adresu (jen https, na vaší vlastní doméně) a zákazník uvidí krátké potvrzení s tlačítkem Back to the shop. Cena se nikdy nesmí brát z prohlížeče ani z návratové adresy: váš server nejprve ověří nabídku. Jak, je popsáno na stránce o objednávkách; hotový plug-in pro WooCommerce je na své vlastní stránce a referenční kód pro jakýkoli jiný obchod je na stránce o vlastní platformě.