A bővítmény a konfigurátort köti össze egy WooCommerce bolttal. Korai hozzáférésben van: nincs a WordPress bővítménykönyvtárban, nincs listázott ára, és a tesztkörnyezetünkben még nem futott végpontok közötti teszt élő WordPress és WooCommerce ellen, ezért először egy staging boltban próbálja ki.

Mit csinál

• Egy Order cut to size gombot ad (a felirat szabadon módosítható) a kiválasztott termékoldalakhoz.
• Megnyitja a konfigurátort felugró ablakban, oldalpanelen vagy az oldalon, a termék lapjával már kiválasztva.
• Az eredményt egy sorként teszi a WooCommerce kosárba, az ellenőrzött árajánlatból árazva.
• A CutOptim rendelésazonosítót és az árajánlat-hasht a rendelési soron tartja, a rendelésen pedig rövid, olvasható „Cut to size” összefoglalót mutat.
• Fogadja a CutOptim aláírt webhookjait, és megjegyzést fűz a WooCommerce rendeléshez.

Telepítés és beállítás

Követelmények: WordPress 6.0 vagy újabb, PHP 7.4 vagy újabb, és WooCommerce.

1. Telepítse és aktiválja a WooCommerce-t, majd a bővítményt.
2. Nyissa meg a WooCommerce > CutOptim Configurator oldalt, és adja meg a tenant azonosítót, a nyilvános kulcsot és a titkos kulcsot. A titkos kulcs helyette megadható a wp-config.php-ban CUTOPTIM_API_SECRET néven. A kulcsok a konzolból jönnek; a nyilvános kulcs csak azokon a webcímeken működik, amelyeket ott felsorolt hozzá.
3. Válassza ki, hogyan nyíljon meg a konfigurátor, a gomb feliratát, és azokat a termékkategóriákat, amelyek megkapják a gombot (ha egyik sincs kijelölve, minden hozzárendelt termék).
4. Rendelje hozzá a termékeket a lapokhoz (lásd alább).
5. A rendelési megjegyzésekhez adja meg a webhook titkát a bővítményben, és adja hozzá a beállítások oldal által mutatott webhookcímet a konfigurációjához (lásd a rendeléseket). Több titok is megadható, soronként egy, hogy a titok forgatható legyen.

Termék hozzárendelése laphoz

A gomb csak olyan terméken jelenik meg, amely a CutOptim katalógusának egy lapját képviseli. A bővítmény ebben a sorrendben oldja fel a lapot:

1. a termék saját CutOptim board és CutOptim thickness (mm) mezői a termékadatokban;
2. egy SKU to board szabály a beállításokban, soronként egy, például MDF-18 = MDF raw | 18 vagy PLY-* = Birch plywood; a pontos SKU erősebb az előtagnál, a #-tel kezdődő sor pedig megjegyzés;
3. a cutoptim_material és cutoptim_thickness termékattribútumok.

A jelölést tartalmazó lapnevet vagy a 0–200 mm tartományon kívüli vastagságot a rendszer elveti, nem javítja. Hozzárendelt lappal a konfigurátor a darabjegyzéken nyílik meg.

Hogyan kerül az ár a kosárba

A böngészőben lévő konfigurátor jelenti a rendelést, de a böngészőből érkező számban soha nem bíznak. A bővítmény egyetlen útja a kosárba egy REST-útvonal az Ön saját szerverén. Ez az útvonal:

1. elküldi az aláírt árajánlatot a CutOptimnak ellenőrzésre a titkos kulccsal, és elutasítja, ha nem érvényes;
2. megnézi, hogy az árajánlat egyezik-e a vevő által látott sorokkal;
3. összeveti a pénznemet a bolt pénznemével, és eltérés esetén elutasítja;
4. egy kosársort ad hozzá az ellenőrzött összegekből árazva, bruttó vagy nettó módon, ahogyan a bolt adóbeállítása előírja.

Ha bármi meghiúsul, semmi sem kerül a kosárba, és a rendszer megkéri a vevőt, hogy próbálja újra. A pénztárnál a CutOptim rendelésazonosító és az árajánlat-hash átmásolódik a rendelési sorra. A webhook-visszaigazolás csak akkor számít, ha a terv-hash egyezik a soron tárolttal.

Az ellenőrzések és a mögöttük álló API-hívások a konfigurátor API-referenciájában vannak.

Korlátok

• Korai hozzáférés. Nincs a WordPress könyvtárban; először stagingben próbálja ki.
• Pénznem. A bolt pénznemének és a CutOptim-konfiguráció pénznemének azonosnak kell lennie.
• Nyelv. A bővítmény saját szövegei (beállítások és üzenetek) angolok; maga a konfigurátor-widget tíz nyelven érhető el.
• Fizetés. A fizetés, a készlet, az adó és a szállítás a WooCommerce feladata.
• Rendelési megjegyzések. A bővítmény elfogadja a rendelési állapoteseményeket; a szolgáltatás csak akkor küld állapotesemény, ha a konzolban módosítja egy rendelés állapotát.