Plug-in-ul conectează Configuratorul la un magazin WooCommerce. Este în acces timpuriu: nu se află în directorul de plug-in-uri WordPress, nu are un preț listat și nu a fost încă rulat end-to-end împotriva unui WordPress și WooCommerce live în configurația noastră de test, deci încearcă-l mai întâi pe un magazin de staging.

Ce face

• Adaugă un buton Order cut to size (eticheta o poți schimba tu) pe paginile de produs pe care le alegi.
• Deschide Configuratorul într-un pop-up, într-un panou lateral sau în pagină, cu placa produsului deja selectată.
• Pune rezultatul în coșul WooCommerce ca o singură linie, cu prețul din oferta verificată.
• Păstrează id-ul comenzii CutOptim și hash-ul ofertei pe linia comenzii și afișează pe comandă un scurt rezumat lizibil „Cut to size”.
• Primește webhook-urile semnate ale CutOptim și adaugă o notă la comanda WooCommerce.

Instalare și configurare

Cerințe: WordPress 6.0 sau mai nou, PHP 7.4 sau mai nou și WooCommerce.

1. Instalează și activează WooCommerce, apoi plug-in-ul.
2. Deschide WooCommerce > CutOptim Configurator și introdu id-ul de tenant, cheia publicabilă și cheia secretă. Cheia secretă poate fi definită în schimb în wp-config.php ca CUTOPTIM_API_SECRET. Cheile provin din consolă; cheia publicabilă funcționează doar pe adresele web pe care le-ai listat pentru ea acolo.
3. Alege cum se deschide Configuratorul, eticheta butonului și categoriile de produse care primesc butonul (nicio categorie selectată înseamnă fiecare produs asociat).
4. Asociază produsele cu plăcile (mai jos).
5. Pentru notele de comandă, introdu secretul webhook în plug-in și adaugă în configurația ta adresa de webhook pe care o arată pagina de setări (vezi comenzile). Sunt permise mai multe secrete, câte unul pe linie, pentru ca un secret să poată fi rotit.

Asocierea unui produs cu o placă

Butonul apare doar pe un produs care reprezintă o placă din catalogul tău CutOptim. Plug-in-ul rezolvă placa în această ordine:

1. câmpurile proprii ale produsului CutOptim board și CutOptim thickness (mm), din datele produsului;
2. o regulă SKU to board în setări, câte una pe linie, de exemplu MDF-18 = MDF raw | 18 sau PLY-* = Birch plywood; un SKU exact are prioritate față de un prefix, iar o linie care începe cu # este un comentariu;
3. atributele de produs cutoptim_material și cutoptim_thickness.

Un nume de placă cu marcaje sau o grosime în afara intervalului 0 până la 200 mm este eliminat, nu reparat. Cu o placă asociată, Configuratorul se deschide la lista de tăieri.

Cum ajunge prețul în coș

Configuratorul din browser raportează comanda, dar un număr din browser nu este niciodată de încredere. Singura cale a plug-in-ului spre coș este o rută REST pe propriul tău server. Acea rută:

1. trimite oferta semnată la CutOptim pentru verificare, cu cheia ta secretă, și refuză dacă nu este validă;
2. verifică dacă oferta corespunde liniilor pe care le-a văzut clientul;
3. verifică moneda față de moneda magazinului și refuză o nepotrivire;
4. adaugă o singură linie de coș, cu prețul din totalurile verificate, brut sau net, după cum spune setarea de taxe a magazinului tău.

Dacă ceva eșuează, nu se adaugă nimic și clientul este rugat să încerce din nou. La finalizarea comenzii, id-ul comenzii CutOptim și hash-ul ofertei sunt copiate pe linia comenzii. O confirmare prin webhook contează doar dacă hash-ul ei de plan corespunde celui stocat pe linie.

Verificările și apelurile API din spatele lor sunt în referința API a Configuratorului.

Limite

• Acces timpuriu. Nu este în directorul WordPress; încearcă-l mai întâi în staging.
• Moneda. Moneda magazinului și moneda configurației CutOptim trebuie să fie aceeași.
• Limba. Textele proprii ale plug-in-ului (setări și mesaje) sunt în engleză; widgetul Configurator în sine este în zece limbi.
• Plata. Plata, stocul, taxele și livrarea sunt treaba WooCommerce.
• Note de comandă. Plug-in-ul acceptă evenimente de stare a comenzii; un eveniment de stare este trimis de serviciu doar când schimbi starea unei comenzi în consolă.