Preskoči na glavni sadržaj
Na ovoj stranici▾

Dodatak povezuje konfigurator s WooCommerce trgovinom. U ranom je pristupu: nije u WordPressovu direktoriju dodataka, nema navedenu cijenu i još nije od početka do kraja izvršen na stvarnom WordPressu i WooCommerceu u našem testnom okruženju, pa ga prvo isprobajte na testnoj (staging) trgovini.

Što radi

  • Dodaje gumb Order cut to size (natpis možete promijeniti) na stranice proizvoda koje odaberete.
  • Otvara konfigurator kao skočni prozor, bočni panel ili na stranici, s već odabranom pločom proizvoda.
  • Stavlja rezultat u WooCommerce košaricu kao jednu stavku, s cijenom iz provjerene ponude.
  • Čuva CutOptim id narudžbe i hash ponude na stavci narudžbe te prikazuje kratak čitljiv sažetak „Cut to size” na narudžbi.
  • Prima CutOptimove potpisane webhookove i dodaje bilješku na WooCommerce narudžbu.

Instalacija i postavljanje

Zahtjevi: WordPress 6.0 ili noviji, PHP 7.4 ili noviji i WooCommerce.

  1. Instalirajte i aktivirajte WooCommerce, zatim dodatak.
  2. Otvorite WooCommerce > CutOptim Configurator i unesite id tenanta, javni ključ i tajni ključ. Tajni ključ umjesto toga može biti definiran u wp-config.php kao CUTOPTIM_API_SECRET. Ključevi dolaze iz konzole; javni ključ radi samo na web-adresama koje ste za njega ondje naveli.
  3. Odaberite kako se konfigurator otvara, natpis gumba i kategorije proizvoda koje dobivaju gumb (ako nijedna nije odabrana, svaki mapirani proizvod).
  4. Mapirajte proizvode na ploče (u nastavku).
  5. Za bilješke narudžbi unesite webhook tajnu u dodatak i dodajte adresu webhooka koju prikazuje stranica postavki u svoju konfiguraciju (pogledajte narudžbe). Dopuštene su i više tajni, po jedna u retku, kako bi se tajna mogla rotirati.

Mapiranje proizvoda na ploču

Gumb se pojavljuje samo na proizvodu koji predstavlja ploču u vašem CutOptim katalogu. Dodatak utvrđuje ploču ovim redom:

  1. vlastita polja proizvoda CutOptim board i CutOptim thickness (mm) u podacima proizvoda;
  2. pravilo SKU to board u postavkama, jedno po retku, na primjer MDF-18 = MDF raw | 18 ili PLY-* = Birch plywood; točan SKU pobjeđuje prefiks, a redak koji počinje znakom # je komentar;
  3. atributi proizvoda cutoptim_material i cutoptim_thickness.

Naziv ploče s oznakama ili debljina izvan raspona od 0 do 200 mm odbacuje se, a ne popravlja. Kad je ploča mapirana, konfigurator se otvara na popisu rezanja.

Kako cijena dospijeva u košaricu

Konfigurator u pregledniku prijavljuje narudžbu, ali broju iz preglednika nikada se ne vjeruje. Jedini put dodatka u košaricu je REST ruta na vašem vlastitom poslužitelju. Ta ruta:

  1. šalje potpisanu ponudu CutOptimu na provjeru vašim tajnim ključem i odbija je ako nije valjana;
  2. provjerava da ponuda odgovara stavkama koje je kupac vidio;
  3. provjerava valutu u odnosu na valutu trgovine i odbija nepodudaranje;
  4. dodaje jednu stavku u košaricu s cijenom iz provjerenih ukupnih iznosa, bruto ili neto prema poreznoj postavci vaše trgovine.

Ako išta ne uspije, ništa se ne dodaje, a kupac se traži da pokuša ponovno. Pri naplati se CutOptim id narudžbe i hash ponude kopiraju na stavku narudžbe. Potvrda webhookom vrijedi samo ako se njezin hash plana podudara s onim pohranjenim na stavci.

Provjere i API pozivi iza njih nalaze se u API referenci konfiguratora.

Ograničenja

  • Rani pristup. Nije u WordPress direktoriju; prvo isprobajte na testnoj (staging) trgovini.
  • Valuta. Valuta trgovine i valuta CutOptim konfiguracije moraju biti iste.
  • Jezik. Vlastiti tekstovi dodatka (postavke i poruke) su na engleskom; sam widget konfiguratora dostupan je na deset jezika.
  • Plaćanje. Plaćanje, zalihe, porez i dostava posao su WooCommercea.
  • Bilješke narudžbi. Dodatak prihvaća događaje statusa narudžbe; događaj statusa usluga šalje samo kad u konzoli promijenite status narudžbe.

FAQ

Što radi WooCommerce dodatak?
Dodaje gumb Order cut to size na proizvode koje odaberete. Kupac unosi dijelove, vidi plan rezanja i cijenu prema vašim pravilima, a rezultat ide u WooCommerce košaricu kao jedna stavka. Košarica, naplata, zalihe, porez, dostava i plaćanje ostaju u WooCommerceu; CutOptim ne naplaćuje plaćanje.
Može li kupac promijeniti cijenu u konzoli preglednika?
Ne. Dodatak ima točno jedan put u košaricu, rutu na vašem vlastitom poslužitelju. Ta ruta traži od CutOptima da vašim tajnim ključem provjeri potpisanu ponudu, provjerava da ponuda odgovara stavkama koje je kupac vidio i tek tada dodaje jednu stavku u košaricu s cijenom iz provjerenih ukupnih iznosa. Cijena poslana iz preglednika nikada se ne koristi.
Je li dostupan u WordPressovu direktoriju dodataka?
Još ne. U ranom je pristupu. Još se ne distribuira javno; ako ga želite isprobati, zatražite ga putem stranice za kontakt. End-to-end test dodatka na WordPressu i WooCommerceu još nije izvršen, pa ga tretirajte kao verziju koju prvo treba isprobati na testnoj (staging) trgovini.
Kako dodatku kažem koji je proizvod koja ploča?
Na tri načina, provjeravana ovim redom: vlastita polja CutOptim board i thickness u podacima proizvoda, SKU pravilo u postavkama dodatka, poput MDF-18 = MDF raw | 18, ili pravilo prefiksa, poput PLY-* = Birch plywood, te atributi proizvoda cutoptim_material i cutoptim_thickness. Proizvod za koji nije utvrđena nijedna ploča ne dobiva gumb.
Zašto moja stavka nije dodana u košaricu?
Cijena se nije mogla potvrditi. Uobičajeni uzroci: valuta trgovine razlikuje se od valute u vašoj CutOptim konfiguraciji (nema pretvorbe), tajni ključ ili id tenanta nije ispravan ili je ponuda istekla. Kupac vidi poruku i može pokušati ponovno.
Podržava li druge platforme za trgovine, poput Shopifyja?
Ne. WooCommerce jedini je dodatak za platformu. Za svaku drugu trgovinu vaš razvojni programer koristi dokumentirane korake provjere i webhooka s referentnim kodom, opisane na stranici o vlastitim platformama.

Zadnje ažuriranje: 19. listopada 2026.