DOCS

Mapowanie atrybutów produktów WooCommerce

Mapowanie atrybutów produktów dla WooCommerce Checkout

Mapuj atrybuty produktów, takie jak kolor, rozmiar i inne dostosowania dla swojego sklepu WooCommerce.

Przegląd 

Mapuj atrybuty produktów WooCommerce (takie jak kolor, rozmiar i inne dostosowania) w rozszerzeniu Zonos, aby zapewnić, że zamówienia są importowane z Zonos do Twojego sklepu WooCommerce z poprawnymi atrybutami.

Krok 1: Znajdź swoje atrybuty produktów

  1. Przejdź do zakładki Produkty w swoim panelu administracyjnym WordPressa.

  2. Z lewego menu nawigacyjnego kliknij Atrybuty, aby wyświetlić lub zarządzać swoimi globalnymi atrybutami produktów. Atrybuty można również ustawić podczas dodawania nowego produktu.

Jeśli korzystasz z aplikacji zewnętrznej do atrybutów niestandardowych, takich jak Product Add-Ons for WooCommerce, postępuj zgodnie z instrukcjami w dokumentacji aplikacji, aby zlokalizować atrybuty.

Krok 2: Zidentyfikuj ścieżkę atrybutu z Zonos

Aby mapować atrybuty w rozszerzeniu Zonos, najpierw musisz zrozumieć, jak są one przekazywane do Zonos. Aby zlokalizować te dane:

  1. Utwórz testowe zamówienie dla produktu z atrybutem, który chcesz zmapować.
  2. Przejdź przez Zonos Checkout i wybierz poziom usługi. To wygeneruje wycenę landed cost. (Nie musisz kończyć zamówienia.)
  3. W Dashboard przejdź do Wyceny.
  4. Znajdź wycenę dla swojego testowego zamówienia i kliknij w Szczegóły wyceny.
  5. W sekcji Szczegóły API po prawej stronie rozwiń rozwijane menu na poziomie głównym, a następnie rozwiń:
    • items
    • metadata

Ten blok metadanych pokazuje, jak atrybuty produktów są przekazywane z WooCommerce do Zonos w żądaniu API.

Krok 3: Mapuj atrybut w rozszerzeniu Zonos

Gdy zlokalizujesz atrybut w metadanych JSON, wróć do ustawień Mapowania Zonos w swoim rozszerzeniu WooCommerce.

  1. W polu Pole atrybutu wybierz Atrybut niestandardowy.
  2. W polu Alias wpisz opisowy etykietę (np. Kolor, Rozmiar lub Niestandardowe grawerowanie).
  3. W polu Ścieżka elementu koszyka wpisz ścieżkę do wartości atrybutu, na podstawie struktury, którą zaobserwowałeś w metadanych.

Przykład mapowania atrybutów niestandardowych

Przejdźmy przez to, jak możesz zmapować produkt, który ma atrybut niestandardowy dla grawerowania, koloru i rozmiaru.

Jeśli korzystasz z wtyczki Product Add-ons od WooCommerce, atrybuty są czasami przekazywane w tablicy pod kluczem addons. Blok JSON poniżej pokazuje atrybuty, które zostały przekazane do Zonos.

Przykładowy blok JSON:

{
  "addons": [
    {
      "name": "Custom Engraving",
      "value": "Built to last",
      "price": 0,
      "field_name": "1226-1748963436",
      "field_type": "custom_text",
      "id": 1748963436,
      "price_type": "flat_fee"
    }
  ],
  "variation": {
    "attribute_pa_color": "blue",
    "attribute_size": "Large"
  }
}

W Ustawieniach mapowania w sekcji Atrybuty, każdy z tych atrybutów powinien być zmapowany w następujący sposób:

Atrybut niestandardowyAliasŚcieżka elementu koszyka
GrawerowanieNiestandardowe grawerowanieaddons.0.value
KolorKolorattribute_pa_color
RozmiarRozmiarattribute_size

Uwaga: Format ścieżki addons.0.value działa w ten sposób:

  • addons informuje system, aby szukał w tablicy addons
  • .0 wskazuje na pierwszy obiekt w tej tablicy
  • .value zwraca wartość z pola value tego obiektu
  • attribute_pa_color i attribute_size to obiekty, które nie są w tablicy i mogą być mapowane bezpośrednio.

Przetestuj mapowanie atrybutów produktu

Gdy już zmapujesz atrybut, złóż pełne testowe zamówienie w Zonos Checkout. Po przetworzeniu zamówienia sprawdź szczegóły zamówienia w WooCommerce, aby upewnić się, że atrybuty produktów zostały poprawnie zaimportowane.

Czy ta strona była pomocna?