Wtyczka łączy konfigurator ze sklepem WooCommerce. Jest we wczesnym dostępie: nie ma jej w katalogu wtyczek WordPress, nie ma podanej ceny i nie została jeszcze uruchomiona od początku do końca na działającym WordPress i WooCommerce w naszym środowisku testowym, więc wypróbuj ją najpierw w sklepie testowym (staging).

Co robi

• Dodaje przycisk Order cut to size (jego etykietę możesz zmienić) na wybranych stronach produktów.
• Otwiera konfigurator w oknie modalnym, panelu bocznym lub na stronie, z już wybraną płytą produktu.
• Wkłada wynik do koszyka WooCommerce jako jedną pozycję, wycenioną ze zweryfikowanej wyceny.
• Zachowuje identyfikator zamówienia CutOptim i hash wyceny na pozycji zamówienia oraz pokazuje na zamówieniu krótkie, czytelne podsumowanie „Cut to size”.
• Odbiera podpisane webhooki CutOptim i dodaje notatkę do zamówienia WooCommerce.

Instalacja i konfiguracja

Wymagania: WordPress 6.0 lub nowszy, PHP 7.4 lub nowszy oraz WooCommerce.

1. Zainstaluj i aktywuj WooCommerce, a potem wtyczkę.
2. Otwórz WooCommerce > CutOptim Configurator i wpisz identyfikator tenanta, klucz publiczny i klucz tajny. Klucz tajny można zamiast tego zdefiniować w wp-config.php jako CUTOPTIM_API_SECRET. Klucze pochodzą z konsoli; klucz publiczny działa tylko na adresach internetowych, które tam dla niego wymieniono.
3. Wybierz, jak otwiera się konfigurator, etykietę przycisku oraz kategorie produktów, które dostają przycisk (brak zaznaczenia oznacza każdy zmapowany produkt).
4. Zmapuj produkty na płyty (poniżej).
5. Aby dostawać notatki do zamówień, wpisz we wtyczce sekret webhooka i dodaj adres webhooka pokazany na stronie ustawień do swojej konfiguracji (zobacz zamówienia). Dozwolonych jest kilka sekretów, po jednym w wierszu, aby można było rotować sekret.

Mapowanie produktu na płytę

Przycisk pojawia się tylko przy produkcie, który odpowiada płycie z Twojego katalogu CutOptim. Wtyczka ustala płytę w tej kolejności:

1. własne pola produktu CutOptim board i CutOptim thickness (mm) w danych produktu;
2. reguła SKU to board w ustawieniach, po jednej w wierszu, na przykład MDF-18 = MDF raw | 18 lub PLY-* = Birch plywood; dokładny SKU ma pierwszeństwo przed prefiksem, a wiersz zaczynający się od # jest komentarzem;
3. atrybuty produktu cutoptim_material i cutoptim_thickness.

Nazwa płyty ze znacznikami lub grubość poza zakresem od 0 do 200 mm jest odrzucana, nie naprawiana. Po zmapowaniu płyty konfigurator otwiera się na liście cięcia.

Jak cena trafia do koszyka

Konfigurator w przeglądarce zgłasza zamówienie, ale liczbie z przeglądarki nigdy się nie ufa. Jedyną drogą wtyczki do koszyka jest trasa REST na Twoim własnym serwerze. Ta trasa:

1. wysyła podpisaną wycenę do CutOptim w celu weryfikacji za pomocą Twojego klucza tajnego i odmawia, jeśli nie jest prawidłowa;
2. sprawdza, czy wycena zgadza się z pozycjami, które widział klient;
3. sprawdza walutę względem waluty sklepu i odrzuca niezgodność;
4. dodaje jedną pozycję koszyka wycenioną ze zweryfikowanych sum, brutto lub netto, zależnie od ustawienia podatków w Twoim sklepie.

Jeśli cokolwiek zawiedzie, nic nie jest dodawane, a klient jest proszony o ponowną próbę. Przy finalizacji zamówienia identyfikator zamówienia CutOptim i hash wyceny są kopiowane do pozycji zamówienia. Potwierdzenie webhookiem się liczy tylko wtedy, gdy jego hash planu zgadza się z tym zapisanym na pozycji.

Sprawdzenia i stojące za nimi wywołania API opisano w referencji API konfiguratora.

Ograniczenia

• Wczesny dostęp. Nie ma jej w katalogu WordPress; najpierw wypróbuj ją w sklepie testowym (staging).
• Waluta. Waluta sklepu i waluta konfiguracji CutOptim muszą być takie same.
• Język. Własne teksty wtyczki (ustawienia i komunikaty) są po angielsku; sam widżet konfiguratora jest w dziesięciu językach.
• Płatność. Płatność, stany magazynowe, podatek i wysyłka to zadanie WooCommerce.
• Notatki do zamówień. Wtyczka przyjmuje zdarzenia statusu zamówienia; zdarzenie statusu jest wysyłane przez usługę tylko wtedy, gdy zmienisz status zamówienia w konsoli.