Przejdź do treści

Dokumentacja pluginu HFT71

Dokumentacja operacyjna wdrożeń i utrzymania wtyczki HFT71 Integration dla WooCommerce (v1.4.1).

Wtyczka korzysta z głównego menu HFT71 w wp-admin (nie pod WooCommerce):

Podmenu Opis
Ustawienia Dane API, interwały synchronizacji, mapowanie statusów, flagi funkcji
Logi Log requestów/response API (tabela hft71_api_log)
Modele Konfiguracja modeli produktów (SKU, rozmiary, ceny)
Kolory Wspólna paleta kolorów używana przez modele

Dokumentacja

Dokument Opis
Checklista wydania Checklista przed wdrożeniem produkcyjnym
Runbook incydentowy Obsługa incydentów (awaria API, webhook, drift stocku)
Checklista operacyjna Codzienne i tygodniowe czynności utrzymaniowe
Przykłady API Przykłady request/response dla kluczowych flow
Schematy JSON Schematy payloadów i konfiguracji

Konfiguracja modeli produktów (v1.3.0)

Scentralizowane dane modeli są przechowywane w tabelach (hft71_models, hft71_colors, hft71_model_colors, hft71_model_skus).

  • Dane modeli, kolorów i SKU są utrzymywane centralnie w tabelach pluginu.
  • CRUD w panelu: HFT71 > Modele i HFT71 > Kolory.
  • Publiczne helpery odczytu: hft71_get_models(), hft71_get_model(), hft71_get_model_sku_map() i powiązane (każdy z filtrem).
  • Znormalizowany kształt konfiguracji: schemas/model-config.schema.json.
  • Akcja hft71_model_price_changed przy zmianie ceny bazowej lub dopłaty za druk dwustronny.

SKU i paleta kolorów (v1.3.1+)

  • SKU wariantów są wyliczane automatycznie przy zapisie modelu (wzór {kod_modelu}-{kod_koloru}-{kod_rozmiaru}). W edycji modelu macierz SKU jest tylko do odczytu.
  • Tabela hft71_colors przechowuje kod BYB/HFT (5 cyfr, kolumna code), nazwę i hex (#RRGGBB).
  • Mapowanie nazwa ↔ kod budowane jest z kolumny code, SKU w hft71_model_skus oraz hft71_stock_cache.
  • HFT71 > Kolory: edycja nazwy, kodu BYB i hex. Przy duplikacie (nazwa, hex lub kod) wymagane jest potwierdzenie.

Paleta Build Your Brand (BYB) — kody i hex (v1.3.4)

Przy aktualizacji danych paleta ładuje 66 kolorów BYB z pliku includes/data/hft71-byb-colors.php:

Źródło Rola
buildyourbrand.de Pięciocyfrowe kody w numerze artykułu (BY011-03467-0042 → kod 03467)
BYB Katalog 2025 (PDF) Nazwy kolorów i wartości hex (wykresy kolorów w katalogu)

Przykładowe wpisy (format kod,Nazwa,HEX):

00007,Black,#000000
00220,White,#FFFFFF
00155,Navy,#022447
00431,Heather Grey,#868686
03467,Bark,#9A6055
00606,Burgundy,#3A0201

Pełna lista i przykłady PHP/API: Przykłady API — sekcja BYB.

Specyfikacja produktu L-Shop (v1.3.5)

Dla modeli BY004, BY011, BY021, BY026, BY036, BY102, BY149 zapisywane są z L-Shop Team: Skład, Gramatura, etykiety pielęgnacji po polsku (np. „Pranie w pralce 30°C, program delikatny”), certyfikaty (np. „Oeko-Tex 100”) oraz URL karty produktu. Dane źródłowe: includes/data/hft71-byb-models-product.php; kolumny w hft71_models: sklad, gramatura, care, certificates, lshop_url.

Uwaga: strona L-Shop (np. Heavy Hoody) może blokować boty przy automatycznym pobieraniu specyfikacji produktu.

Macierz kolorów w edycji modelu (v1.3.2+)

  • Wyświetlane są tylko kolory z katalogu buildyourbrand.de dla danego modelu (katalog: includes/data/hft71-byb-model-colors.php, tabela hft71_model_byb_colors).
  • Wybrane kolory (checkbox) zapisywane są w hft71_model_colors; można zaznaczyć wyłącznie kolory obecne w magazynie HFT (hft71_stock_cache).
  • Wiersze bez stanu magazynowego są wyszarzone, niezaznaczone i nieaktywne (read-only).
  • Nagłówek Stan magazynowy HFT nad kolumnami rozmiarów (XS–XXL); w komórkach wartość stocku z hft71_stock_cache lub —.
  • Kolumny: . (checkbox) → Hex → Kolor → stany magazynowe per rozmiar.

Rozmiary modelu (v1.4.1)

  • W HFT71 > Modele > Edytuj rozmiary wybiera się listą checkboxów (XS, S, M, L, XL, XXL), nie polem tekstowym.
  • Zapis trafia do kolumny sizes (JSON) w ustalonej kolejności.

Migracja schematu care (v1.4.1)

  • Kolumna care_icons w hft71_models została przemianowana na care (wersja schematu DB 1.6).
  • Pole w hft71_get_model() / schemacie JSON: care (tablica etykiet pielęgnacji).

Synchronizacja shipping (v1.1.0)

  • Jednokierunkowa synchronizacja z HFT71 do WooCommerce dla shipping.carrier, shipping.tracking i shipping.trackingRet.
  • Uruchamiana przez polling CRON, wybrane zdarzenia zamówień i ręczną akcję w metaboxie zamówienia.
  • Kontrolowana flagą hft71_shipping_sync_enabled.
  • Weryfikacja: meta _hft71_shipping_*, logi sync_shipping / sync_shipping_skipped, sekcja w metaboxie zamówienia.