Plug-in propojuje konfigurátor s obchodem WooCommerce. Je v předběžném přístupu (early access): není v adresáři pluginů WordPressu, nemá uvedenou cenu a v našem testovacím prostředí zatím nebyl spuštěn end-to-end proti živému WordPressu a WooCommerce, proto ho nejdřív vyzkoušejte v testovacím obchodě.

Co dělá

• Přidává tlačítko Order cut to size (jeho popisek můžete změnit) na stránky produktů, které vyberete.
• Otevírá konfigurátor ve vyskakovacím okně, v bočním panelu nebo na stránce, s již vybranou deskou produktu.
• Vkládá výsledek do košíku WooCommerce jako jeden řádek, oceněný z ověřené nabídky.
• Uchovává id objednávky CutOptim a hash nabídky na řádku objednávky a zobrazuje u objednávky krátké čitelné shrnutí „Cut to size“.
• Přijímá podepsané webhooky CutOptim a přidává poznámku k objednávce WooCommerce.

Instalace a nastavení

Požadavky: WordPress 6.0 nebo novější, PHP 7.4 nebo novější a WooCommerce.

1. Nainstalujte a aktivujte WooCommerce a poté plug-in.
2. Otevřete WooCommerce > CutOptim Configurator a zadejte id tenanta, veřejný klíč a tajný klíč. Tajný klíč lze místo toho definovat v wp-config.php jako CUTOPTIM_API_SECRET. Klíče získáte z konzole; veřejný klíč funguje jen na webových adresách, které jste pro něj tam uvedli.
3. Zvolte, jak se konfigurátor otevírá, popisek tlačítka a kategorie produktů, které tlačítko dostanou (žádná vybraná kategorie znamená každý namapovaný produkt).
4. Namapujte produkty na desky (níže).
5. Pro poznámky k objednávkám zadejte v plug-inu tajemství webhooku a přidejte adresu webhooku, kterou zobrazí stránka nastavení, do své konfigurace (viz objednávky). Povoleno je i několik tajemství, jedno na řádek, aby bylo možné tajemství obměnit.

Namapování produktu na desku

Tlačítko se zobrazí jen u produktu, který představuje desku ve vašem katalogu CutOptim. Plug-in desku zjišťuje v tomto pořadí:

1. vlastní pole produktu CutOptim board a CutOptim thickness (mm) v datech produktu;
2. pravidlo SKU to board v nastavení, jedno na řádek, například MDF-18 = MDF raw | 18 nebo PLY-* = Birch plywood; přesné SKU má přednost před předponou a řádek začínající # je komentář;
3. atributy produktu cutoptim_material a cutoptim_thickness.

Název desky se značkami nebo tloušťka mimo rozsah 0 až 200 mm se zahodí, neopravuje se. S namapovanou deskou se konfigurátor otevře u seznamu řezů.

Jak se cena dostane do košíku

Konfigurátor v prohlížeči objednávku oznámí, ale číslu z prohlížeče se nikdy nevěří. Jedinou cestou plug-inu do košíku je trasa REST na vašem vlastním serveru. Tato trasa:

1. pošle podepsanou nabídku CutOptim k ověření vaším tajným klíčem a odmítne ji, pokud není platná;
2. zkontroluje, že nabídka odpovídá řádkům, které zákazník viděl;
3. zkontroluje měnu proti měně obchodu a nesoulad odmítne;
4. přidá jeden řádek košíku oceněný z ověřených součtů, s daní nebo bez daně podle nastavení daní vašeho obchodu.

Pokud cokoli selže, nic se nepřidá a zákazník je vyzván, aby to zkusil znovu. V pokladně se id objednávky CutOptim a hash nabídky zkopírují na řádek objednávky. Potvrzení webhookem se počítá jen tehdy, když jeho hash plánu odpovídá hashi uloženému na řádku.

Kontroly a volání API, která za nimi stojí, jsou v referenční dokumentaci API konfigurátoru.

Limity

• Předběžný přístup. Není v adresáři WordPressu; nejdřív ho vyzkoušejte v testovacím obchodě.
• Měna. Měna obchodu a měna konfigurace CutOptim musí být stejné.
• Jazyk. Vlastní texty plug-inu (nastavení a zprávy) jsou v angličtině; samotný widget konfigurátoru je v deseti jazycích.
• Platba. Platba, sklad, daně a doprava jsou věcí WooCommerce.
• Poznámky k objednávkám. Plug-in přijímá události stavu objednávky; událost stavu služba odešle, jen když v konzoli změníte stav objednávky.