Shopware

Instrukcja instalacji i konfiguracji konektora Shopware 6.5 <> Ergonode (plugin)

Ostatnia ręczna aktualizacja: 2024-09-04

Wtyczka Shopware jest teraz w pełni Open Source i jest utrzymywana przez stronę trzecią.

Proszę przejść do GitHub aby pobrać najnowszą wersję, zapoznać się ze zmianami lub zgłosić ticket z problemem, jeśli taki wystąpi.

Niniejszy podręcznik może z czasem stać się nieaktualny.

Proszę przeczytać OŚWIADCZENIE ZRZECZENIA przed użyciem tej wtyczki.

Konektor Shopware do Ergonode działa wyłącznie z Ergonode Cloud i Shopware 6.5. Korzysta z API GraphQL, aby nawiązać połączenie między tymi platformami.

Licencja wtyczki daje użytkownikom możliwość samodzielnej modyfikacji kodu, co pozwala na dodawanie funkcji lub naprawę błędów. Chociaż zgłoszenia tych modyfikacji do Ergonode są mile widziane, ich włączenie do oficjalnego repozytorium wtyczki zależy od decyzji Ergonode i nie jest gwarantowane.

NIE używaj podwójnego znaku podłogi __ nigdzie w Ergonode, może to spowodować nieprawidłowe działanie wtyczki, ponieważ __ jest używane do oznaczania elementów wewnętrznie w kodzie wtyczki.

Konfiguracja (w zakresie URL endpointu API, mapowania pól, kategorii, harmonogramu i pól niestandardowych) wykonuje się raz i jest współdzielona przez wszystkie kanały sprzedaży. Możliwe jest jednak synchronizowanie innego segmentu produktów z każdym kanałem sprzedaży. Osiąga się to, wybierając konkretny kanał sprzedaży w konfiguracji wtyczki, a następnie edytując klucz API dla tego kanału. W takim przypadku dany kanał będzie synchronizowany z segmentem produktów Ergonode przypisanym do podanego klucza API.

„Segment” w Ergonode to zestaw produktów wybierany za pomocą reguły, któremu można przypisać własny klucz API. W tym kontekście można wykorzystać funkcję Segmenty, aby przypisać różne zestawy produktów do różnych kanałów sprzedaży.

Ta wtyczka została zaprojektowana do pracy z jednym konsumentem. Nie można zagwarantować prawidłowego działania wtyczki przy współpracy z wieloma konsumentami.

Założenia ogólne

Działająca instalacja Ergonode
Przynajmniej 1 wygenerowany klucz API Ergonode
Działający consumer Shopware (Admin Worker lub CLI - messenger:consume)
Wszystkie zadania synchronizacji są uruchamiane w kolejce

Język Shopware:

Domyślny język Shopware (wybrany podczas instalacji Shopware) MUSI być oznaczony jako aktywny w Ergonode.

Dodatkowe punkty:

Przynajmniej Atrybut Ergonode mapowany z nazwą w Shopware MUSI być wypełniony, aby w Shopware pojawiła się domyślna nazwa produktu.
Zaleca się, aby przynajmniej tłumaczenia w domyślnym języku Shopware były wypełnione we wszystkich produktach/kategoriach/atrybutach itp. w Ergonode.
Gdy brak jest tłumaczenia, fallback wtyczki to kod. Na przykład przy domyślnym języku Shopware pl-PL należy wypełnić przynajmniej jedno pole dla każdego produktu/kategorii/atrybutu w tłumaczeniu polskim.

Ważne:

Każdy język musi być aktywowany w wtyczce „Language pack”.

Jeśli SKU produktu w Ergonode PIM jest takie samo jak numer produktu istniejącego już w Shopware, informacje o produkcie w Shopware zostaną nadpisane; w przeciwnym razie zostanie utworzony nowy produkt.

Krok 1: Jak uzyskać konektor Shopware > Ergonode

Konektor jest dostępny na żądanie. Aby uzyskać bezpieczny link do Google Drive, skontaktuj się z pomocą techniczną Ergonode.

Krok 2: Wygeneruj klucze API w panelu administracyjnym Ergonode

Pamiętaj, że twój klucz API jest danymi wrażliwymi. Przechowuj go w bezpiecznym miejscu i nie udostępniaj osobom, którym nie ufasz. Jeśli będziesz musiał cofnąć dostęp do klucza API, możesz to zrobić na tej samej stronie Klucze API, gdzie go utworzyłeś.

Podczas tworzenia klucza API możesz wybrać segment (opcjonalnie), dzięki czemu Shopware Connector pobierze tylko produkty odpowiadające produktom z wybranego segmentu. Jeśli pole pozostawisz puste, pobrane zostaną wszystkie produkty w systemie Ergonode. Wartość pola „Allow to write” nie ma znaczenia, ponieważ moduł nic nie zapisuje w Ergonode. Zaleca się pozostawienie tej opcji odznaczonej.

Podczas synchronizacji produktów grupujących lub produktów z wariantami pamiętaj, że WSZYSTKIE produkty MUSZĄ znajdować się w tym samym segmencie.

Informacje, jak utworzyć klucz API, można znaleźć tutaj.

Krok 3: Instalacja

Szczegółowy przewodnik instalacji rozszerzenia jest dostępny w oficjalnej dokumentacji Shopware w sekcji: Shopware 6 - Moje rozszerzenia.

Po pomyślnym dodaniu wtyczki do sklepu Shopware rozpocznij proces instalacji. Można to zrobić, przechodząc do „Shopware Admin > Extensions > My Extensions”. Znajdź na liście „Shopware Ergonode Integration” i wybierz „Install”.

Aktywuj wtyczkę, wybierając przycisk radiowy po lewej stronie.

Po wykonaniu tych kroków konfiguracja powinna wyglądać jak poniższa ilustracja.

Aktualizacja ze starszej wersji

Pobierz nową wersję wtyczki

Pobierz nową wersję wtyczki z udostępnionego linku Google Drive.

Prześlij wtyczkę do Shopware

Przejdź do Administration > Extensions > My Extensions.

Kliknij na Upload extension przycisk i potwierdź zamiar.

Wybierz plik ZIP z nową wtyczką i potwierdź przesłanie.

Zaktualizuj wtyczkę

Na liście wtyczek zobaczysz teraz opcję Update.

Kliknij ją i poczekaj, aż aktualizacja zostanie zakończona.

Nowa wersja wtyczki została zainstalowana, a numer wersji został zaktualizowany.

Krok 4: Konfiguracja

Najpierw należy skonfigurować połączenie z Ergonode. Można to zrobić, uzyskując dostęp do konfiguracji wtyczki poprzez pasek administracyjny. Postępuj według ścieżki: „Extensions > My Extensions > Shopware Ergonode Integration > … (3 kropki po prawej) > Configuration”.

Ustawienia API

Endpoint Ergonode GraphQL API:

Pole wymaga pełnego adresu URL endpointu GraphQL.
URL powinien być podany wyłącznie dla wszystkich kanałów sprzedaży. Przypisanie różnych URL-i dla innych kanałów sprzedaży nie przyniesie efektu. Wartość ta jest propagowana do innych kanałów sprzedaży i nie może być zmieniana lub usuwana dla poszczególnych kanałów.
URL powinien mieć format „https://name.ergonode.cloud/api/graphql/”, gdzie początkowy segment odpowiada adresowi środowiska Ergonode, z którego korzystasz.
W przeciwieństwie do podstawowego URL-a, klucze API mogą być ustawiane indywidualnie dla każdego kanału sprzedaży. Jednak obowiązkowe jest wypełnienie ich dla wszystkich kanałów sprzedaży. Można je modyfikować dla każdego kanału, co pozwala na konfigurację Segmentów w Ergonode, aby przypisać tylko Produkty filtrowane warunkami Segmentu do danego kanału sprzedaży. Jeśli ustawiony jest tylko podstawowy klucz API, wszystkie kanały sprzedaży zostaną domyślnie przypisane do produktów.

Zwróć uwagę, że dla prawidłowego działania wszystkie segmenty kanałów sprzedaży muszą obejmować produkty, które będą używane do wypełnienia poszczególnych kanałów sprzedaży.

Na przykład wszystkie klucze kanałów są skonfigurowane do pracy z „main_segment”, który zawiera produkty o SKU: SKU1, SKU2 i SKU3. Następnie użytkownik powinien wygenerować nowy klucz API dla kanału „Headless”, który będzie zawierał wyłącznie SKU2 i SKU3.

Jeśli segment powiązany z kluczem API używanym dla wszystkich kanałów sprzedaży nie zawiera produktów z innych kanałów, tworzenie produktów dla tych dodatkowych kanałów nie zostanie wykonane.

Uwaga: po zapisaniu zmian zostaniesz przekierowany z powrotem do „All Sales Channels”. Jest to normalne zachowanie Shopware.

Weryfikacja poświadczeń:

Kliknij „Verify”, aby uwierzytelnić powyższe poświadczenia.
Zaleca się zweryfikowanie poświadczeń przed zapisaniem konfiguracji.
W przypadku nieprawidłowych poświadczeń odpowiednie informacje można znaleźć w katalogu logów Shopware, zazwyczaj w lokalizacji ‘/var/log’.

Mapowanie pól

Opcjonalnie można skonfigurować mapowanie pól niestandardowych Shopware oraz atrybutów cross-selling.

Uwaga: Należy najpierw ustawić Ustawienia API i zapisać konfigurację przed przejściem do konfiguracji mapowania pól.

Atrybuty Ergonode jako pola niestandardowe Shopware:

Menu rozwijane wymienia wszystkie Atrybuty Ergonode.
Wybrane atrybuty będą wykorzystywane do:
- Generowania Shopware Product Custom Fields z odpowiednimi typami podczas synchronizacji atrybutów.
- Synchronizowania wartości podczas synchronizacji produktów.

Atrybuty Ergonode jako Cross-Selling:

Menu rozwijane wymienia wszystkie Atrybuty Ergonode typu „relation” (znane również jako „Product relations”).
Wybrane atrybuty będą wykorzystywane do tworzenia kolekcji Cross-Selling podczas synchronizacji produktów (zobacz „Product Cross Selling” po szczegóły).

Wymuś zapisywanie SKU produktu wielkimi literami:

Gdy ta opcja jest włączona, produkty będą zapisywane w Shopware wielkimi literami, na przykład w Ergonode: Product-12a zostanie zapisany jako PRODUCT-12A

Synchronizacja kategorii

Aby ułatwić synchronizację kategorii Ergonode z Shopware, administrator musi zdefiniować kod drzewa kategorii w konfiguracji wtyczki.

Uwaga: Twoje drzewa kategorii można znaleźć w Ergonode w kolumnie „Category tree code” na siatce Category trees.

Drzewa kategorii do synchronizacji można wybrać z menu wielokrotnego wyboru, co umożliwia synchronizację wielu drzew kategorii.

Każda kategoria jest synchronizowana z Ergonode do Shopware na zasadzie jeden do jednego, co oznacza, że:

Kategoria utworzona w Ergonode jest replikowana w Shopware.
Tłumaczenie kategorii w określonym języku jest przenoszone do Shopware.
Usunięcie kategorii w Ergonode powoduje jej usunięcie w Shopware.
Pozycja kategorii w drzewie kategorii w Shopware odzwierciedla jej pozycję na odpowiadającym drzewie kategorii w Ergonode.

Zwróć uwagę, że może wystąpić sytuacja, w której kategoria w Ergonode ma wypełniony tylko „category code” i brak jakiegokolwiek tłumaczenia. W takim przypadku „category code” zostanie przeniesiony do Shopware jako tłumaczenie w domyślnym języku systemu.

Istnieje możliwość mapowania kategorii obecnych w obu systemach przed synchronizacją. Dalsze informacje znajdują się w sekcji dokumentacji „Category mappings”.

Harmonogram

Aby umożliwić automatyczną synchronizację, konieczne jest skonfigurowanie harmonogramu.

Opis pól:

Włącz harmonogram: Ten przełącznik pozwala włączyć lub wyłączyć automatyczną synchronizację.
Data i godzina rozpoczęcia: To pole pozwala wybrać czas rozpoczęcia, od którego harmonogram rozpocznie synchronizację.
Strefa czasowa harmonogramu: To pole pozwala ustawić strefę czasową dla wybranej daty i godziny.
Godzina powtarzania: To pole, w zakresie 0-24, określa częstotliwość synchronizacji w godzinach.
Minuta powtarzania: To pole, w zakresie 0-59, określa częstotliwość synchronizacji w minutach.

Przykłady:

Jeśli Godzina powtarzania = 0 i Minuta powtarzania = 10, synchronizacja będzie wykonywana co 10 minut.
Jeśli Godzina powtarzania = 1 i Minuta powtarzania = 0, synchronizacja będzie wykonywana co godzinę.
Jeśli Godzina powtarzania = 2 i Minuta powtarzania = 30, synchronizacja będzie wykonywana co 2,5 godziny.

Uwaga: Ostrożnie dobieraj bardzo krótkie interwały (np. 1 minuta). W zależności od możliwości serwera, częstotliwości zmian produktów w instancji Ergonode oraz liczby atrybutów do synchronizacji, częste synchronizacje mogą spowodować problemy z wydajnością, choć nie jest to gwarantowane.

Pamiętaj o zapisaniu zmian przed opuszczeniem strony podstawowej konfiguracji.

Krok 5: Mapowanie

Pola typu select (boolean)

Możliwe jest mapowanie pól boolean w Shopware (np. active) z atrybutami select w Ergonode. Aby to działało, opcje select w Ergonode muszą spełniać następujące warunki:

Zaleca się ustawienie zakresu (scope) atrybutów select w Ergonode na globalny; atrybuty boolean i pola niestandardowe Shopware nie są tłumaczalne w Shopware. Jeśli atrybut jest lokalny, podczas synchronizacji użyta zostanie tylko wartość w domyślnym języku.

Dozwolone wartości kodów opcji to:

Wartość, która zostanie zapisana w SW

Kody opcji ustawione w Ergonode

true

YES

yes

false

Jeśli kod opcji nie pasuje do żadnej z powyższych wartości, wartość zostanie uznana za false podczas synchronizacji

Atrybut czasu dostawy

Czas dostawy w Shopware jest atrybutem typu SELECT. Opcje dla tego atrybutu są konfigurowane w ustawieniach sklepu. Wartość tego atrybutu dla każdego produktu może być synchronizowana z Ergonode, jeśli spełnione są pewne warunki:

Opcje czasu dostawy są utworzone w Shopware:

Atrybut typu SELECT nazwany (kod) delivery_time jest utworzony w Ergonode.
Opcje dla atrybutu delivery_time są utworzone w Ergonode.

Uwaga! Te opcje muszą być identyczne z opcjami utworzonymi w Shopware! Nowe opcje utworzone w Shopware NIE będą tworzone podczas synchronizacji w Ergonode, więc musisz je utworzyć ręcznie.

Czas dostawy w Shopware jest mapowany z delivery_time w Ergonode w ustawieniach wtyczki.

Stawki podatkowe

Domyślnie Shopware pozwala przypisać 3 typowe stawki podatkowe (Panel administracyjny SW -> Menu po lewej -> Settings -> Shop -> Tax): Standard, Reduced, Super-reduced. Te stawki mogą mieć przypisane różne wartości liczbowe (zobacz zrzut ekranu poniżej):

Jeśli wartość stawki podatkowej synchronizowana z Ergonode ma inną wartość liczbową niż te 3 stawki, zostanie wygenerowana nowa stawka podatkowa w Shopware i przypisana do produktu. Zostanie ona nazwana „Ergonode Autogenerate ([tutaj wartość liczbową]%)”.

Mapowanie atrybutów

Po utworzeniu typów atrybutów w obu systemach ich typów nie można zmienić. Jeśli chcesz zmienić typ, konieczne będzie utworzenie zupełnie nowych atrybutów.

Po pomyślnym ukończeniu konfiguracji wtyczki możesz zakończyć proces konfiguracji, ustawiając „Attribute Mappings”.

Konfigurację tego mapowania można wykonać, przechodząc do „Settings -> Ergonode Integration -> Attribute Mappings”.

Aby umożliwić synchronizację wartości atrybutów produktów Ergonode z Shopware, należy przypisać je do atrybutów Shopware, korzystając ze strony „Attribute Mappings”.

Pola wyboru na górze zawierają wszystkie atrybuty, które można mapować między systemami. Wybierz atrybut Shopware i odpowiadający mu atrybut Ergonode, a następnie kliknij „Add Mapping”.

Możesz wpisywać, aby wyszukać atrybut.

Najnowsze mapowania są wyświetlane na początku listy.

Zauważ, że typy atrybutów muszą być zgodne. Kompatybilność typów atrybutów jest kluczowa dla poprawnego mapowania. Typy atrybutów, które można mapować razem, są wyświetlane w nawiasach obok nazwy atrybutu.

Oznacza to, że wybierając atrybuty do mapowania, powinieneś upewnić się, że typy atrybutów Shopware i odpowiadający im atrybut Ergonode są zgodne, jak wskazano. Ten krok jest konieczny, aby zapewnić poprawne działanie procesu mapowania i synchronizacji atrybutów. Nieprawidłowe mapowanie typów atrybutów może prowadzić do błędów lub nieoczekiwanego zachowania.

Zwróć uwagę, że nie jest możliwe mapowanie wielu atrybutów Ergonode do jednego atrybutu Shopware. Natomiast mapowanie jednego atrybutu Ergonode do wielu atrybutów Shopware jest dozwolone.

Aby edytować mapowanie, po prostu usuń je i dodaj żądane mapowanie.

Aktualnie dozwolone mapowania dla każdego typu atrybutu:

Ponieważ Ergonode nie posiada atrybutu typu bool, należy zastosować obejście, aby je mapować. Informacje, jak to zrobić, znajdują się później w tym artykule.

Atrybut Shopware

Typ(y) atrybutu w Ergonode

Active

select (bool)

Name

text / textarea / select

Price (net)

numeric / price

Price (gross)

numeric / price

Tax rate

numeric

Stock

numeric

Media

gallery

GTIN / EAN

text / textarea / select

Manufacturer product number

text / textarea / select

Manufacturer

select

Weight

numeric / unit

Height

numeric / unit

Width

numeric / unit

Length

numeric / unit

Custom search terms

multiselect

Description

text / textarea

Meta title

text / textarea / select

Meta description

text / textarea / select

SEO keywords

text / textarea / select

Purchase steps

numeric

Maks. ilość zamówienia

numeric

Min. ilość zamówienia

numeric

Jednostka opakowania

text / textarea / select

Jednostka opakowania (liczba mnoga)

text / textarea / select

Jednostka sprzedaży

numeric

Jednostka podstawowa

numeric

Na wyprzedaży

select (bool)

Darmowa wysyłka

select (bool)

Czas uzupełnienia zapasów

numeric

Wyróżnij produkt

select (bool)

Czas dostawy

select

Jednostka miary

select

Uwaga: Informujemy, że w obecnej wersji wtyczki, przy mapowaniu właściwości na atrybuty Ergonode typu select, wartości opcji select są wyświetlane jako ich kody systemowe, jeśli tłumaczenia nie są dostępne. Dlatego należy zachować szczególną ostrożność przy konfigurowaniu tego typu mapowania.

Ostrzeżenie 2: Właściwości Shopware w mapperze są wyświetlane jako ich przetłumaczone nazwy, aby dopasować nazewnictwo pól w panelu administracyjnym.

Mapowania pól niestandardowych Shopware

Analogicznie do właściwości, możliwe jest mapowanie pól niestandardowych Shopware do atrybutów Ergonode.

Ta funkcja różni się od pola „Ergonode attributes as custom fields” w konfiguracji wtyczki. Wtyczka umożliwia wybór atrybutów Ergonode, które zostaną zaimportowane do Shopware jako nowe pola niestandardowe (w ramach nowo utworzonego zestawu „Ergonode Custom Fields”). Funkcja opisana w tej sekcji umożliwia faktyczne mapowanie istniejących pól niestandardowych do konkretnych atrybutów Ergonode.

Konfigurację tego mapowania można wykonać, przechodząc do „Settings -> Ergonode Integration -> Custom Fields Mappings”.

Proces konfiguracji jest analogiczny do mapowania atrybutów. Najpierw wybierz pole niestandardowe z menu rozwijanego „Shopware Custom Field”, a następnie odpowiedni atrybut Ergonode w polu „Ergonode Attribute”. Kliknij „Add Mapping”, a mapowanie pojawi się na liście poniżej.

Wymagania dotyczące atrybutów mają również zastosowanie do pól niestandardowych Shopware podczas mapowania ich z atrybutem select Ergonode.

Aby uzyskać dodatkowe szczegóły, proszę odnieść się do sekcji „Krok 5: Mapowanie -> Pola typu select (Boolean)”,"

t255

Mapowania kategorii

Konfigurację tego mapowania można wykonać, przechodząc do „Użytkownicy mają możliwość dopasowania istniejących kategorii w Shopware do kategorii pochodzących z Ergonode.”.

Ekran mapowania kategorii Shopware Ergonode Integration

Aby ustanowić dopasowanie kategorii między systemami, wybierz kategorię z menu rozwijanego „Shopware Category”, a następnie kategorię z menu „Ergonode Category”. Podczas synchronizacji kategoria w Shopware odziedziczy niektóre dane z Ergonode (np. tłumaczenia, lokalizację w drzewie), zachowując jednocześnie swoje istniejące dane.

Oznacza to, że jeśli kategoria ma przypisany układ lub wypełnione pola niestandardowe, te atrybuty zostaną zachowane i nie zostaną usunięte ani nadpisane.

Jeśli chcesz przerwać mapowanie kategorii i przywrócić je do osobnych encji, po prostu usuń mapowanie. Spowoduje to ponowne wprowadzenie każdej kategorii z Ergonode wcześniej mapowanej z kategorią Shopware jako nowej, niezależnej encji. Przyszłe zmiany tej kategorii nie wpłyną na wcześniej mapowaną kategorię Shopware.

Zaleca się uruchomienie zadania „Synchronize all” po zakończeniu konfiguracji.

Mapowania atrybutów kategorii

Aby umożliwić wykorzystanie mapowań atrybutów Ergonode do wypełniania atrybutów kategorii, konieczne jest najpierw włączyć synchronizację kategorii.

Atrybuty kategorii są dodawane do istniejących kategorii w Shopware.

Jeśli utworzysz mapowanie i nie wypełnisz wartości w Ergonode - synchronizacja atrybutów kategorii spowoduje wyzerowanie wszystkich mapowanych wartości! Zanim atrybuty kategorii będą mogły być użyte w Shopware, muszą być.

utworzone i wypełnione w Ergonode

Konfigurację tego mapowania można wykonać, przechodząc do „Pamiętaj, że nie musisz mapować wszystkich atrybutów. Dodaj tylko te atrybuty, których będziesz używać. Możesz dodać pola w Ergonode i zmapować je później w Shopware, gdy dane będą gotowe do użycia.”.

Ekran mapowania atrybutów kategorii Shopware Ergonode Integration

Mapowanie tutaj działa dokładnie tak, jak mapowanie w Category mappings.

Instrukcja dotycząca mapowania kategorii według regionu:

Strona ustawień kategorii Shopware - karta Ogólne

Name

Pola na bieżącym widoku: ● Name ● Active ● Tags ● Category Type

Active

Mapowane w synchronizacji kategorii.

Pole boolean to przełącznik, który pozwala kontrolować, czy kategoria jest widoczna na froncie. Kiedy kategoria jest nieaktywna, nie jest wyświetlana w menu nawigacji ani na stronach produktów i nie jest dostępna dla klientów.

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

select

Typ atrybutu

Kod atrybutu

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

category_attributes

1 | 0

global

Nie dodawaj tłumaczeń do opcji tego atrybutu!

Po utworzeniu nie zapomnij dodać tego atrybutu jako atrybut kategorii, w przeciwnym razie nie pojawi się w mapperze.

Tagi

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

multiselect

Typ atrybutu

Tagi pozwalają przechowywać słowa kluczowe dla produktów, kategorii, mediów, klientów, zamówień, metod wysyłki, odbiorców newslettera, stron docelowych lub reguł. Te słowa kluczowe mogą być używane np. w regułach z Rule Builder. Dzięki temu przeglądowi możesz bezpośrednio przeglądać i zarządzać wszystkimi utworzonymi tagami.

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

category_attributes

category_tags

global

Nie dodawaj tłumaczeń do opcji tego atrybutu!

kody, które będą nazwami tagów

Typ kategorii

Shopware pozwala ustawić 3 wartości: Page / List, Structuring element / Entry point, Link Kategoria Strona/Lista:

Ten typ kategorii służy jako samodzielna strona docelowa dla określonej grupy produktów, promocji lub kampanii marketingowej. Jest podobny do istniejącej kategorii Landing Page, ale daje większą kontrolę nad zawartością i układem strony.Kategoria Element strukturyzujący/Punkt wejścia

: Ten typ kategorii jest używany głównie do strukturyzowania katalogu produktów i zapewnienia przejrzystej nawigacji dla klientów. Jest podobny do istniejącej kategorii Nawigacja, ale oferuje więcej opcji dostosowania wyglądu i zachowania kategorii.Kategoria Link

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

select

Typ atrybutu

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

category_attributes

: Ten typ kategorii służy jako bezpośrednie odnośnik do określonego produktu, strony lub zewnętrznego URL. Jest podobny do istniejącego bytu Link w Shopware, ale jest teraz zintegrowany z systemem zarządzania kategoriami.

global

Nie dodawaj tłumaczeń do opcji tego atrybutu!

pages | folder| link

Ogólne - Ustawienia menu

Strona ustawień kategorii Shopware - karta Ogólne - ustawienia menu

Pola na bieżącym widoku: ● Hide in navigation ● Display image ● Description

Ukryj w nawigacji

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

select

Typ atrybutu

Pozwala ukryć kategorię i jej węzły w nawigacji.

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

category_attributes

1 | 0

global

Nie dodawaj tłumaczeń do opcji tego atrybutu!

category_hide_in_navigation

Wyświetl obraz

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

Obraz używany w niektórych szablonach, które umożliwiają wyświetlanie obrazów dla kategorii.

Typ atrybutu

image

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

Nie dodawaj tłumaczeń do opcji tego atrybutu!

Description

category_media

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

Niektóre szablony pozwalają na wyświetlanie opisów kategorii.

Typ atrybutu

textarea

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

category_description

Nie dodawaj tłumaczeń do opcji tego atrybutu!

Nie dodawaj tłumaczeń do tej wartości atrybutu!

Ogólne - Dostosowywalny link

Strona ustawień kategorii Shopware - karta Ogólne - ustawienia dostosowywalnego linku

Pola na bieżącym widoku (dla typu Link = External): ● Link type ● Link destination (External link) ● Open in a new tab

Pola na bieżącym widoku (dla typu Link = Internal): ● Link type (Internal) ● Entity (Internal Link types) ● Internal link (Category, Product, Landing Page) ● Open in a new tab

Typ linku

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

select

Typ atrybutu

Pozwala zdecydować, jaki typ linku będzie używany.

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

category_attributes

category_link_type

global

Nie dodawaj tłumaczeń do opcji tego atrybutu!

external | category | landing_page | product

Link zewnętrzny

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

URL do zasobów spoza Shopware.

Typ atrybutu

text

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

Nie dodawaj tłumaczeń do opcji tego atrybutu!

category_external_link

Link zewnętrzny

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

URL do zasobów spoza Shopware.

Typ atrybutu

Dane linku wewnętrznego

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

Nie dodawaj tłumaczeń do opcji tego atrybutu!

category_internal_link

Otwórz w nowej karcie

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

select

Typ atrybutu

Pozwala otworzyć link w nowej karcie zamiast w bieżącym oknie

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

category_attributes

1 | 0

global

Nie dodawaj tłumaczeń do opcji tego atrybutu!

category_link_new_tab

Strona ustawień kategorii Shopware - karta SEO

Meta title

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

URL do zasobów spoza Shopware.

Typ atrybutu

Pola na bieżącym widoku: ● Meta title ● Meta Description ● Keywords

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

Nie dodawaj tłumaczeń do opcji tego atrybutu!

category_seo_meta_title

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

Niektóre szablony pozwalają na wyświetlanie opisów kategorii.

Typ atrybutu

Pola na bieżącym widoku: ● Meta title ● Meta Description ● Keywords

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

Nie dodawaj tłumaczeń do opcji tego atrybutu!

Meta Description

Jeśli chcesz użyć tego pola w mapowaniu, dodaj nowy atrybut w Ergonode z następującymi parametrami:

URL do zasobów spoza Shopware.

Typ atrybutu

Keywords

Opcje atrybutu

Zakres atrybutu

category_active

Grupa atrybutów

Nie dodawaj tłumaczeń do opcji tego atrybutu!

Krok 6: Synchronizacja

Konfigurację tego mapowania można wykonać, przechodząc do „Settings -> Ergonode Integration -> Synchronization”.

Synchronize Latest Changes: Ta operacja uruchamia wszystkie zadania synchronizacji, przetwarzając najnowsze modyfikacje produktów oraz kompletne dane innych encji, takich jak atrybuty i kategorie. Po każdym uruchomieniu kursory Ergonode są zachowywane, aby kolejne uruchomienie rozpoczęło się od bieżącego stanu, co oznacza, że przetwarzane będą jedynie zmiany dokonane od tego momentu.
Synchronize All: Ta operacja synchronizuje WSZYSTKIE encje z Ergonode. Rozpoczyna się od wyczyszczenia zapisanych kursorów Ergonode, aby pobrać wszystkie encje, a nie tylko najnowsze zmiany, a następnie uruchamia wszystkie zadania synchronizacji. Postęp procesu synchronizacji można obserwować na karcie „Import history”.

Zadania zaplanowane

Proces synchronizacji podzielony jest na kilka zaplanowanych zadań. Interwał tych zadań można zmienić w konfiguracji wtyczki. Aby to zrobić, przejdź do Configuration -> Plugin config -> Scheduler po więcej szczegółów.

Zadania w prawidłowej kolejności to:

LanguageSync
AttributeSync
CategorySync
ProductSync
ProductVisibilitySync
DeletedProductSync
DeletedAttributeSync

Szczegóły synchronizacji

Kategorie

Zauważ, że każda kategoria usunięta w Ergonode zostanie także usunięta w Shopware podczas CategorySync.

Grupy właściwości

Wszystkie Atrybuty Ergonode typu „select” lub „multi-select” są przesyłane do Shopware jako właściwości (zwane Shopware Property Groups), a ich opcje są przesyłane jako opcje właściwości (Shopware Property Group Options).

Pola niestandardowe

Wszystkie Atrybuty Ergonode oznaczone jako Pola Niestandardowe w konfiguracji wtyczki są przesyłane do Shopware jako Product Custom Fields. Ponadto istniejące pola niestandardowe można zmapować z atrybutami Ergonode w ten sam sposób, w jaki konfiguruje się zwykłe właściwości. Aby uzyskać więcej informacji, zobacz sekcję Attribute Mappings. Wszelkie niezmapowane pola niestandardowe są przesyłane z Ergonode i tworzone jako nowe wpisy w Shopware. Zobacz tabelę Matching Types poniżej po więcej szczegółów.

Date

Nie wysyłaj jeśli niezmapowane

File

Nie wysyłaj jeśli niezmapowane

Gallery

Nie wysyłaj jeśli niezmapowane

Image

Nie wysyłaj jeśli niezmapowane

Multi select

Wysyłaj jako właściwość

Numeric

Nie wysyłaj jeśli niezmapowane

Price

Nie wysyłaj jeśli niezmapowane

Product relations

Nie wysyłaj jeśli niezmapowane

Select

Wysyłaj jako właściwość

Text

Nie wysyłaj jeśli niezmapowane

Textarea

Nie wysyłaj jeśli niezmapowane

Unit

Nie wysyłaj jeśli niezmapowane

Ograniczenia Shopware: Atrybuty typu „gallery” lub „file” mają pewne ograniczenie. W Ergonode pola te mogą zawierać wiele encji, podczas gdy odpowiadające im typy pól niestandardowych w Shopware obsługują tylko jedną encję na pole. W rezultacie podczas przesyłania tych pól do Shopware ich wartości są ograniczane do pierwszej encji. Przykład: jeśli masz listę plików w atrybucie typu file w Ergonode, tylko pierwszy z nich zostanie przeniesiony do Shopware

Media produktu

Aby umożliwić synchronizację mediów produktu (takich jak obrazy produktów) z Ergonode do Shopware, administrator musi zmapować pole mediów Shopware z atrybutem Ergonode typu „gallery”.

Product Cross Selling

Synchronizacja relacji produktów zadziała tylko wtedy, gdy produkt, który chcesz powiązać, znajduje się w segmencie importowanym dla tego kanału sprzedaży lub jest już obecny w tym kanale sprzedaży w Shopware.

Wszystkie Atrybuty Relacji Produktów Ergonode oznaczone jako Cross Selling w konfiguracji wtyczki będą używane do tworzenia Cross-Selling podczas synchronizacji produktów. System zidentyfikuje wartości z atrybutów Ergonode i wygeneruje oddzielną kolekcję Cross-Selling dla każdego zidentyfikowanego atrybutu. Nazwy atrybutów utworzone w Ergonode zostaną użyte jako nazwy kolekcji Cross-Selling i będą wyświetlane na sklepie Shopware.

Ograniczenia Shopware: Shopware pozwala na tworzenie Cross-Selling tylko dla produktu głównego. Tworzenie Cross-Selling dla wariantów zostanie zignorowane.

Dodatkowo Cross-Selling nie jest tłumaczalny w Shopware. Oznacza to, że nawet jeśli zakres atrybutu relacji produktu w Ergonode jest ustawiony jako lokalny, wartości będą pobierane z domyślnego locale Shopware podczas synchronizacji produktów. Dlatego zaleca się ustawienie wszystkich Atrybutów Relacji Produktów w Ergonode jako globalnych.

Krok 7: Historia importów

Wyświetla tabelę ze wszystkimi importami, zarówno wywołanymi ręcznie, jak i przez zadania zaplanowane.

Dłużej trwające importy będą wyświetlane wielokrotnie. Dzieje się tak, ponieważ pojedyncza synchronizacja ma ograniczoną liczbę encji, które może przetworzyć.

WAŻNE: Aby uzyskać pełną widoczność wszystkich szczegółów importu, ważne jest, aby pliki logów Shopware, w szczególności te znajdujące się w var/log/ergonode_integration, były przechowywane na głównym serwerze Shopware. Na przykład, jeśli konsumenci działają na różnych maszynach, logi mogą nie być widoczne w panelu administracyjnym, chyba że są przechowywane na tym samym serwerze Shopware.

Konfigurację tego mapowania można wykonać, przechodząc do „Settings -> Ergonode Integration -> Import history”.

Funkcja filtrów w zakładce Import History oferuje przyjazny interfejs do zawężania wyszukiwania konkretnych rekordów importu. Składa się z trzech głównych elementów:

Pokaż tylko błędy: Ta opcja pozwala filtrować historię importu, aby wyświetlać tylko te rekordy, w których wystąpiły błędy. Po zaznaczeniu tego pola system ukryje wszystkie pomyślne rekordy importu i pokaże jedynie te zawierające błędy. Może to być szczególnie przydatne podczas rozwiązywania problemów lub audytu procesu importu.
Od: Jest to selektor daty, który pozwala określić datę początkową dla wyszukiwania. Wybierając datę w tym polu, system pokaże tylko rekordy importu od tej daty wzwyż. Przydaje się to do zawężenia wyszukiwania do konkretnego okresu.
Do: Podobnie jak pole „Od”, jest to selektor daty, który pozwala określić datę końcową dla wyszukiwania. Wybierając datę w tym polu, system pokaże tylko rekordy importu do tej daty.

Każdą synchronizację można oznaczyć jako ROZPOCZĘTĄ lub ZAKOŃCZONĄ i ma ona widok szczegółowy. Uzyskaj do niego dostęp, klikając trzy kropki i wybierając „Szczegóły”.

PreviousMagento 2 (nowy plugin)NextPrestaShop

Last updated 15 days ago

Was this helpful?