Dropshipping XML WooCommerce

Najważniejsze funkcje wtyczki

• Mapowanie danych produktów – przypisz pola z pliku do nazwy, opisu, cen, podatków, SKU, EAN, stanów magazynowych, wymiarów, kategorii, atrybutów, tagów i zdjęć produktu.
• Obsługa różnych typów produktów – importuj produkty proste i wariantowe, a w wersji PRO również produkty zewnętrzne i afiliacyjne.
• Aktualizacja wybranych informacji – zdecyduj, które pola mają być synchronizowane podczas kolejnych importów. Możesz na przykład aktualizować wyłącznie ceny i stany magazynowe, pozostawiając własne opisy oraz zdjęcia.
• Automatyczna synchronizacja PRO – ustaw dni i godziny pobierania aktualnych danych z pliku dostawcy. Import możesz także uruchomić ręcznie z poziomu Managera importu.
• Logika warunkowa PRO – importuj lub pomijaj produkty zależnie od danych w pliku, np. ceny, dostępności, kategorii albo obecności numeru SKU.
• Modyfikowanie cen – zwiększaj lub zmniejszaj ceny z pliku o określoną kwotę albo procent. Warunki umożliwiają zastosowanie różnych marż do wybranych grup produktów.
• Obsługa zmian w ofercie dostawcy – gdy produktu zabraknie w kolejnym pliku, wtyczka może pozostawić go bez zmian, ustawić stan magazynowy na zero albo — w wersji PRO — przenieść go do kosza.
• Integracje z danymi dodatkowymi – kod umożliwia import własnych pól meta oraz danych używanych przez ACF, Yoast SEO i GPSR, jeśli odpowiednie wtyczki są aktywne.
• Manager i log importu – zapisane konfiguracje można uruchamiać, edytować, duplikować, wstrzymywać i usuwać. Log pokazuje produkty utworzone, zaktualizowane i pominięte.

Dropshipping XML WooCommerce służy do importowania produktów z plików XML i CSV oraz ich późniejszej synchronizacji z katalogiem WooCommerce. Wtyczka może tworzyć nowe produkty lub aktualizować istniejące na podstawie nazwy, SKU, EAN albo własnego identyfikatora.

Wtyczka sprawdzi się przede wszystkim w sklepach korzystających z oferty hurtowni lub dostawców udostępniających katalog XML albo CSV. Może służyć do pierwszego zasilenia sklepu produktami, regularnej aktualizacji cen i dostępności, migracji katalogu, tworzenia oferty afiliacyjnej oraz aktualizowania istniejących produktów bez dodawania nowych.

Instalacja

Instrukcja instalacji →

Aktywacja subskrypcji

Instrukcja aktywacji →

Aktualizacja

Instrukcja aktualizacji →

Ważne informacje

• Wtyczka wymaga co najmniej 256 MB pamięci dla procesów PHP. Sprawdź, jak zmienić limit pamięci dla WordPressa i skryptów PHP.
• Wtyczka wymaga obsługi biblioteki cURL na serwerze oraz cyklicznego wywoływania pliku wp-cron.php (najlepiej co minutę). Przeczytaj więcej o procesach cron.
• Serwer z PHP 7.4 i co najmniej 256 MB pamięci dla skryptu.
• Serwer z limitem czasu wykonywania skryptów wynoszącym co najmniej 60 s (max_execution_time).
• Serwer z limitem czasu wykonywania skryptu po stronie serwera HTTP (Apache, Nginx) wynoszącym co najmniej 60 s.
• Włączona opcja allow_url_fopen oraz rozszerzenie fileinfo.
• Serwer z dużym transferem oraz dyskiem SSD.
• Serwer z obsługą HTTP/2.
• Parametr max_input_vars o wartości co najmniej 5000, zwłaszcza przy dużej liczbie kategorii.
• Biblioteka libxml co najmniej w wersji 2.10.0.

Ustawienia główne

Rozpocznij korzystanie z wtyczki od jej konfiguracji w zakładce Dropshipping XML → Ustawienia.

Produktów w jednej partii – import produktów z pliku CSV/XML do sklepu WooCommerce odbywa się partiami. Proces jest podzielony na etapy, aby uniknąć problemów z wydajnością. Cały plik jest dzielony na części, importowane po kolei. Domyślna wartość to 30, co oznacza, że jednorazowo podczas jednego etapu przetwarzanych jest 30 pozycji.

Jeśli w twoim sklepie występują problemy z wydajnością, zmniejsz tę wartość. Jeśli twój serwer jest dobrze zoptymalizowany i chciałbyś zwiększyć szybkość importu, możesz podwyższyć wartość w tym polu.

Manager importu

Przejdź do zakładki Dropshipping XML → Manager importu.

W tym miejscu znajdziesz wszystkie pliki, które zostały zaimportowane do Twojego sklepu.

Tutaj możesz także wykonać kopię importu.

Duplikowanie importów – aby utworzyć kopię, wybierz import, którego kopię chcesz wykonać i kliknij Duplikuj.

Opis kolumn:

ID – Adres URL importowanego pliku. Po najechaniu na ID pliku pojawi się możliwość przejścia do ustawień mapowania, synchronizacji, harmonogramu, podglądu pliku z logami ostatniego importu, podglądu pliku oraz jego usunięcia.
PRO Harmonogram cron – terminy automatycznego importu (synchronizacji) pliku.

Akcje:

Importuj teraz – uruchom ręcznie proces synchronizacji pliku. Po ręcznym uruchomieniu zadania zobaczysz log importu, który wyświetli produkty utworzone, zaktualizowane i pominięte podczas importu.
Wstrzymaj synchronizację – link umożliwiający wstrzymanie importu, przydatny zwłaszcza podczas wstępnego mapowania pliku importu. Wstrzymanie importu powoduje, że plik nie będzie automatycznie synchronizowany we wskazanych okresach.
Aktywuj synchronizację – użyj tej opcji, aby aktywować automatyczną synchronizację pliku we wskazanych okresach. Link jest dostępny, gdy automatyczna synchronizacja jest wyłączona.

Status:

Synchronizacja aktywna – plik jest gotowy do importu i będzie automatycznie synchronizowany w okresach wskazanych w ustawieniach Harmonogramu cron.
Synchronizacja wstrzymana – import jest wstrzymany i nie będzie wykonywany automatycznie. W każdej chwili można go wznowić. Przy wstrzymanej synchronizacji nadal możesz uruchomić synchronizację ręcznie.
W trakcie synchronizacji – proces importu jest uruchomiony. W tym momencie odbywa się synchronizacja.

Statystyki: Informacje o liczbie utworzonych, zaktualizowanych i pominiętych produktów w procesie importu. Statystyki pokazują aktualny stan importu. Po ukończeniu importu dane są zerowane.

Utworzone – data i godzina dodania pliku do listy.

Masowe działania

Z listy masowych działań masz możliwość usunięcia wielu plików na raz. Aby to wykonać, zaznacz na liście pliki do usunięcia i wybierz opcję Usuń.

Import

Przejdź do zakładki Dropshipping XML → Import.
Przeprowadzisz tutaj proces importu i synchronizacji (cyklicznego importu produktów) na podstawie pliku hurtowni, z którego będą pobierane informacje o produktach.

Krok 1 Import pliku

Uzupełnij adres URL pliku XML lub CSV, który chcesz zaimportować, i kliknij Import pliku.

Po kliknięciu przycisku wtyczka zwaliduje poprawność adresu URL pliku i pobierze go. Przejdź do kolejnego kroku, klikając przycisk Następny krok.

Krok 2 Podgląd pliku

CSV

Jeśli twój plik jest w formacie CSV, zostanie on zaprezentowany w formie tabelki zawierającej wszystkie informacje o produktach. Twoim zadaniem jest upewnienie się, że wszystkie wartości z pliku są prezentowane prawidłowo. Masz możliwość przeglądania kolejnych pozycji pliku przy pomocy strzałek w prawo i lewo.

Wtyczka automatycznie rozpoznaje separator użyty w pliku CSV. Jeśli podgląd pliku CSV nie jest prezentowany prawidłowo, wprowadź prawidłowy znak separatora do pola Ustaw separator i kliknij przycisk Zastosuj.

XML

Po zaimportowaniu pliku XML masz możliwość wyboru gałęzi produktowej w jego strukturze. Wybierz tę, która zawiera wszystkie informacje o produkcie.

Wtyczka automatycznie wytypuje gałąź, która z największym prawdopodobieństwem zawiera dane produktowe. Przejrzyj poszczególne pozycje, aby upewnić się, że wybór jest poprawny. Możesz przechodzić pomiędzy kolejnymi pozycjami za pomocą strzałek. Możesz też wprowadzić numer pozycji, którą chcesz przejrzeć.

Jak sprawdzić, czy wybrana gałąź jest prawidłowa?

• po wyborze gałęzi na ekranie podglądu powinny być widoczne wszystkie parametry produktu, takie jak nazwa, cena, zdjęcia, atrybuty czy opis,
• liczba wystąpień wybranej gałęzi, wyświetlona na ekranie, powinna odpowiadać liczbie pozycji (produktów) w importowanym pliku,
• jeśli nie masz pewności, przejrzyj również surowy plik w poszukiwaniu powtarzającego się wzorca i porównaj go z wybranym we wtyczce.

Po wyborze odpowiedniej gałęzi do importu przejdź do następnego kroku.

Krok 3 Mapowanie pól

Przed rozpoczęciem mapowania pól możesz nadać nazwę importu. Aby to zrobić, wpisz ją w polu Nazwa importu.

Nazwa pojawi się na liście importów dostępnych w Managerze importu. Jeżeli import nie ma nazwy, w kolumnie pojawi się link do importu.

Na tym ekranie możesz zmapować pola produktu WooCommerce z atrybutami z pliku XML lub nazwami kolumn w pliku CSV. Aby to zrobić, przeciągnij znacznik z podglądu pliku do odpowiedniego pola produktu:

Zmapuj parametry z pliku na pola danych produktu WooCommerce:

Nazwa produktu
W tym miejscu wprowadź wzorzec, według którego będą tworzone i identyfikowane produkty w sklepie WooCommerce. Najlepiej wykorzystaj w tym miejscu tag odpowiadający za tytuł produktu w pliku. W tytule możesz zawrzeć też np. atrybuty. Jeśli chcesz, możesz dodać własny przedrostek lub przyrostek.

Opis produktu
Wypełnij opis produktu. Aby zachować elastyczność, możesz korzystać z dowolnej liczby tagów pochodzących z pliku. Dzięki temu w opisie produktu zostaną zapisane wszystkie parametry, które chcesz tam umieścić. Możesz dodać dowolny tekst, własne dekoracje i adnotacje.

Mapowanie pól produktów
Ekran mapowania przypomina standardowy ekran ustawień produktu WooCommerce:

Typ produktu

Wybierz, czy importowane produkty mają być tworzone jako:

• Produkt prosty
• Produkt z wariantami
• PRO Produkt zewnętrzny/afiliacyjny

Zaznacz checkbox Wirtualny, jeśli chcesz, żeby produkty były tworzone jako wirtualne. W takim przypadku ustawienia wysyłki zostaną ukryte.

Główne

Cena – jeśli chcesz, aby cena w sklepie bazowała na cenie podanej w pliku, z którego importujesz produkty, przeciągnij tag odpowiadający za cenę z metaboksa po prawej stronie do pola z ceną. Możesz też wprowadzić stałą wartość.

PRO Masz możliwość modyfikacji ceny w locie o stałą wartość lub konkretny procent:

• PRO Dodaj wartość procentową – cena produktu w sklepie zostanie zwiększona o wartość procentową, którą podasz w kolejnym polu. Przykład: jeśli chcesz, żeby cena w sklepie WooCommerce była o 20% wyższa względem ceny w pliku, wybierz tę opcję, a w kolejnym polu wprowadź liczbę 20.
• PRO Dodaj stałą wartość – cena produktu w sklepie zostanie zwiększona o stałą wartość, którą podasz w kolejnym polu. Przykład: jeśli chcesz, żeby cena w sklepie WooCommerce była o 10 zł wyższa względem ceny w pliku, wybierz tę opcję, a w kolejnym polu wprowadź liczbę 10.

Cena promocyjna – jeśli chcesz, aby produkt był w promocji, wprowadź promocyjną cenę w tym polu.

Status podatku – opcjonalnie włącz lub wyłącz podatki dla produktu. Pozostaw to pole bez zmian, aby użyć ustawień sklepu. Możesz też opodatkować tylko koszty wysyłki (Tylko wysyłka).

Ustaw jedną klasę podatkową dla wszystkich importowanych produktów – zaimportuj produkty do jednej, wybranej klasy podatkowej w sklepie.

Klasa podatkowa – wybierz z dostępnych w sklepie klas podatkowych, do której produkty mają być przypisane podczas importu. Klasy podatkowe umożliwiają przypisywanie różnych stawek podatkowych do różnych typów produktów.

Mapowanie klasy podatkowej – opcja pozwala na mapowanie stawek podatkowych z pliku z klasami podatkowymi w sklepie. W pliku muszą być zdefiniowane nazwy lub identyfikatory klas podatkowych. Jeśli wartość będzie inna, zostanie ustawiona stawka standardowa.

Pole klasy podatkowej – umieść w tym polu tag pochodzący z pliku, który odpowiada za nazwę lub identyfikator podatku. Jeśli w pliku znajduje się kilka pól z podatkami, a chcesz, aby każde pole zostało zmapowane, umieść tutaj znaczniki oddzielone przecinkami.

Pole mapowania klasy podatkowej – składa się z pola Klas podatkowych WooCommerce (z lewej) i pola Zewnętrzna klasa podatkowa.

Klasy podatkowe WooCommerce – wybierz z listy klasę podatkową WooCommerce. Jeśli na liście brakuje interesującej cię klasy, dodaj ją do listy klas podatkowych WooCommerce.

Zewnętrzna klasa podatkowa – wprowadź w tym polu identyfikator danej klasy podatkowej pochodzący z pliku, z którego dokonujesz importu, odpowiadający klasom podatkowym WooCommerce.

Dodaj kolejne klasy na liście dla wszystkich klas istniejących w pliku. Dodawaj je za pomocą przycisku Dodaj. Istniejące pozycje możesz usuwać za pomocą przycisku Usuń.

Magazyn

SKU – wprowadź tutaj unikalny identyfikator produktu w twoim sklepie. Warto w tym miejscu wprowadzić kod używany w pliku przez producenta lub hurtownię. Dzięki temu będzie można w kolejnym kroku użyć tego pola do identyfikacji produktu. Pole SKU nie jest prezentowane kupującym w sklepie.

EAN – w tym miejscu upuść placeholder, który zawiera numer EAN z importowanego pliku.

Zarządzać stanem magazynowym? – po włączeniu zarządzania stanem magazynowym możesz skonfigurować:

Stan magazynowy – jeśli chcesz, aby stan magazynowy produktu był synchronizowany z plikiem, przeciągnij i upuść w tym miejscu odpowiednią wartość z pliku.

Po kliknięciu na listę wyboru w pozycji Pozwalać na zamówienia oczekujące otrzymasz następujące opcje:

• Nie pozwalaj – wybierz, jeśli nie chcesz umożliwiać zamawiania przy zerowym stanie magazynowym.
• Pozwalaj, ale poinformuj klienta – wybierz, jeśli chcesz dać taką możliwość, ale w sklepie ma wyświetlić się stosowna informacja.
• Pozwalaj – wybierz, jeśli przy zerowym stanie magazynowym sprzedaż od strony widoku produktu w sklepie ma wyglądać tak samo jak przy stanie dodatnim.

Próg niskiego stanu magazynowego – stan magazynowy, przy którym otrzymasz powiadomienie.

Sprzedawaj pojedynczo – wybierz tę opcję, jeśli chcesz, aby kupujący mogli dodać do koszyka tylko jedną sztukę produktu.

Wysyłka

Waga, wymiary – przeciągnij i upuść tagi z pliku, odpowiadające za te informacje o produktach. Są one przydatne dla kupujących, a także pomocne przy obliczaniu kosztu wysyłki.

Klasa wysyłkowa – wybierz klasę wysyłkową produktu. Jest ona przydatna, gdy importujesz produkty o bardzo dużych lub bardzo małych gabarytach. Dzięki klasie wysyłkowej możesz lepiej wyceniać koszt wysyłki.

Atrybuty

W sekcji Atrybuty masz możliwość zdefiniowania atrybutów produktu, które zostaną dodane podczas importu.

Lista atrybutów jest podzielona na dwie części: Nazwa i wartość

Nazwa – podaj nazwę atrybutu. Możesz wprowadzić ją ręcznie lub użyć tagu pochodzącego z podglądu pliku.

Wartość – wprowadź wartość atrybutu, który zostanie dodany do produktów. Aby wartości były dynamicznie pobierane z pliku, umieść w tym polu tag pochodzący z pliku z produktami.
Dodawaj kolejne atrybuty za pomocą przycisku Dodaj +. Zdefiniuj każdy atrybut, który chcesz zapisać przy produkcie w sklepie WooCommerce. Istniejące pozycje możesz usuwać za pomocą przycisku Usuń.

Atrybuty w jednej linii – użyj pola, jeśli w pliku atrybuty są zawarte w jednym polu. Np. kolor:czerwony,niebieski,biały.
Separator atrybutów – uzupełnij znak, którym rozdzielone są od siebie atrybuty.
Separator wartości – uzupełnij znak, którym rozdzielone są od siebie wartości atrybutów.

Modyfikator ceny

Modyfikator cen umożliwia hurtową zmianę (zwiększenie lub zmniejszenie) ceny regularnej i promocyjnej każdego importowanego produktu.

1. Kliknij przycisk Dodaj nową grupę – dodasz nową grupę zawierającą modyfikator cen oraz warunki dla logiki warunkowej.
2. Kliknij na nazwę grupy – rozwiną się ustawienia grupy.
3. Wybierz rodzaj modyfikatora Dodaj stałą wartość albo Dodaj % wartość.
4. Ustaw wartość modyfikatora.
5. Wybierz, czy modyfikator wpłynie na Cenę regularną, czy Cenę promocyjną.
6. Jeżeli ustawisz logikę warunkową, modyfikator będzie wpływał tylko na produkty spełniające ustawione warunki.
   W poniższym przykładzie logika warunkowa sprawdzi, czy nazwa produktu zawiera tekst T-Shirt.
   1. Ustaw pierwszy warunek, kopiując XPath pola, np. {//node/name}.
   2. Wybierz relację między warunkiem a wartością, np. Zawiera.
   3. Wpisz wartość, która będzie sprawdzana, np. T-Shirt.
   4. Kliknij ikonę PLUS i dodaj kolejny warunek (opcjonalnie).
7. Kliknij przycisk Dodaj nową grupę – dodasz nową grupę (opcjonalnie).
8. Kliknij przycisk Usuń grupę – usuniesz grupę (opcjonalnie).

Krótki opis produktu

Wypełnij krótki opis produktu, jeśli używasz go w swoim sklepie. Masz pełną dowolność, tak jak w przypadku opisu głównego.

GPSR

Wtyczka Dropshipping XML Import obsługuje import treści do pól darmowej wtyczki GPSR WooCommerce, którą znajdziesz pod tym linkiem →

Integracja z Yoast SEO

Co robi?
Yoast SEO fields pozwalają zapisać wszystkie metadane SEO (tytuł, opis, adres kanoniczny i grafiki do mediów społecznościowych) bezpośrednio podczas importu. Wtyczka uzupełnia tradycyjne metadane (_yoast_wpseo_*) produktu, dzięki czemu Yoast pokazuje gotowe wartości bez dodatkowej edycji.

Gdzie kliknąć?

1. Zaznacz „Yoast SEO fields” na liście „Synchronizuj pola produktów” w kroku Opcje importu. To odblokuje sekcję Yoast w maperze.
2. Przejdź do mapowania i wybierz zakładkę Yoast (podzieloną na SERP, Analysis, Canonical, Facebook i Twitter).
3. Przeciągnij tagi z podglądu pliku do konkretnych meta-kluczy, np. {//product/yoast_title} → _yoast_wpseo_title, {//product/og_image} → _yoast_wpseo_opengraph-image-url.
4. Zapisz ustawienia importu – wszystkie pola zostaną zapisane w bazie produktu i od razu pojawią się w Yoast SEO.

Przykładowe tagi:
{//item/yoast_title} (SEO title), {//item/yoast_meta_desc} (Meta description), {//item/yoast_canonical} (Canonical URL), {//item/og_image/wp} (Open Graph image).

Na co uważać?

• Yoast musi być aktywny – wtyczka sprawdza stałą WPSEO_VERSION lub aktywność wordpress-seo/wp-seo.php. Bez aktywnego Yoast SEO odpowiednie pola nie pojawią się w maperze.
• Jeśli importujesz obrazki OG/Twitter, sprawdź, czy URL jest pełny (np. zaczyna się od https://), inaczej Yoast nie będzie w stanie wygenerować podglądu.
• Możesz dodać stałe prefiksy, np. „Import {item/title}” w tytule SEO, żeby łatwo rozróżnić produkty.

Najczęstsze pułapki:

• Meta title nie nadpisuje się, bo tag był pusty – dodaj wartość zapasową (np. {//item/name}|{//item/id}).
• Canonical pozostaje pusty, bo ścieżka XPath dotyczy innego węzła – sprawdź strukturę XML w kroku „Podgląd pliku”.

Integracja z Advanced Custom Fields

Co robi?
ACF fields synchronizują pola z grup ACF przypisanych do produktów. Wtyczka importuje tylko proste typy (text, textarea, number, select itd.) i w przypadku pól zagnieżdżonych dodaje nazwę grupy do etykiety, aby zachować kontekst.

Gdzie kliknąć?

1. Zaznacz ACF fields na stronie Opcje importu. Jeśli wtyczka ACF lub ACF PRO jest aktywna, w maperze pojawią się komponenty dla każdej grupy.
2. Wybierz grupę, przeciągnij tag z podglądu do odpowiedniego pola (np. {//item/specs/title} → klucz ACF acf_title).
3. Po zapisaniu wtyczka zapisze wartość w metadanych (np. acf_title oraz _acf_title) i wywoła funkcję update_field(), jeśli jest dostępna.

Przykład tagu:
{//product/parameters/promotions} → ACF field acf_promotions; w grupie „Dane SEO” przeciągnij {//product/seo_summary} → acf_seo_summary.

Na co uważać?

• Importowane są tylko pola zdefiniowane dla post_type=product. Jeśli grupa jest przypisana do innego typu, nie pojawi się na liście.
• Grupy muszą zawierać pola obsługiwanych typów, np. tekst, liczba lub checkbox. Inne typy, np. repeater, są pomijane.
• Pola zagnieżdżone są „spłaszczane” i otrzymują prefiks etykiety grupy, żeby łatwiej je rozróżnić.

Najczęstsze pułapki:

• Brak wartości w pliku dla pola oznacza pominięcie – dodaj logikę zapasową lub oznacz wartości jako obowiązkowe.
• Jeśli używasz ACF PRO i funkcji update_field(), upewnij się, że wtyczka ACF działa w tym samym środowisku co importer.

Mapowanie obrazków

Wtyczka automatycznie pobiera do sklepu obrazki ze wskazanych lokalizacji. Obrazki są pobierane do Biblioteki mediów WordPressa i dodawane do galerii produktu. Pierwszy obrazek jest ustawiany jako Główny obrazek produktu.

Aby poprawnie zmapować wszystkie obrazki powiązane z produktami, wskaż w polu mapowania wszystkie gałęzie znaczników, które do nich prowadzą. Kolejne tagi muszą być rozdzielone ustawionym znakiem oddzielającym (separatorem).

Przykład dodania tagów pochodzących z pliku XML dla Ceneo:

{//o/imgs/main},{//o/imgs/i[1]/@url},{//o/imgs/i[2]/@url}

Separator – ustaw znak oddzielający, którym odseparujesz od siebie kolejne tagi umieszczone w polu.

Przykład dodania tagów dla pliku XML z obrazkami umieszczonymi w katalogach:

https://www.link-do-strony.pl{//xpath to the images in XML structure}

Zrzut ekranu z przykładowym plikiem XML:

Skanuj tagi <img> i importuj obrazki – zaznacz tę opcję, jeśli importowany plik zawiera obrazki w formacie HTML. Wtyczka automatycznie pobierze adresy URL obrazków z tagów HTML. Jeśli wewnątrz tagów podanych w polu znajdują się ścieżki w formacie <img src=”URL”>, wtyczka pobierze ich adresy URL.

Nie dodawaj Obrazka produktu do Galerii produktu – ta opcja wyłączy dodawanie pierwszego obrazu do Galerii produktu. Pierwszy obraz zostanie ustawiony jedynie jako Obrazek produktu, ale nie będzie już ponownie dodawany do galerii.

Nie zastępuj istniejących obrazków. Po prostu dołącz nowe zdjęcia do produktu. – zaznacz checkbox, aby nowe zdjęcia zostały dodane do produktu i nie nadpisały zdjęć dodanych podczas poprzednich importów.

Warianty produktów

Produkty wariantowe mają taką samą nazwę – zaznacz tę opcję, jeśli warianty z pliku będą identyfikowane przez wtyczkę na podstawie nazwy produktu.

Checkbox: zaznacz, jeśli w strukturze pliku produkty wariantowe mają produkt główny.
Taka sytuacja występuje, kiedy w pliku XML znajduje się produkt nadrzędny.

Produkty wariantowe mają taki sam numer SKU – zaznacz tę opcję, jeśli produkty wariantowe korzystają z numeru SKU produktu głównego. Numer SKU produktu zostanie wtedy pobrany do pola SKU w ustawieniach produktu głównego WooCommerce.

Produkty wariantowe i produkt główny mają różne identyfikatory – zaznacz tę opcję, jeśli produkty wariantowe w pliku korzystają z unikalnego identyfikatora.

Produkty wariantowe mają taki sam identyfikator – zaznacz tę opcję, jeśli w pliku XML produkt główny ma identyfikator „rodzica” dla identyfikatorów produktów wariantowych. Następnie wskaż ścieżkę XPath do obu identyfikatorów – produktu rodzica oraz produktu wariantowego.

Checkbox: zaznacz, jeśli w strukturze pliku produkty wariantowe mają produkt główny.

Produkty wariantowe są zagnieżdżone w pliku XML – zaznacz tę opcję, jeśli w pliku XML produkt główny i poszczególne warianty są ułożone w ramach jednego węzła i wyróżniają je atrybuty.

Po wybraniu tej opcji zostanie rozwinięte pole typu input. Umieść w nim znacznik XPath wskazujący ścieżkę do pierwszego wariantu produktu:

Po wskazaniu znacznika zostaną wyświetlone pola, za pomocą których skonfigurujesz tworzenie poszczególnych wariantów produktu:

Import wariantów z jednego pola – wtyczka wspiera teraz import wielu wariantów produktu z jednego pola w pliku. W ustawieniach możesz wskazać pole oraz określić separator używany do rozdzielenia danych wariantów.

Otwórz okno z wariantami – użyj tej opcji, aby w nowym oknie móc przełączać się pomiędzy kolejnymi wariantami zagnieżdżonymi w pliku XML.

Wirtualny – zaznacz checkbox, jeśli chcesz, żeby tworzone warianty miały status produktów Wirtualnych.

Utwórz produkty bez wariantów jako produkty proste – użyj tej opcji, aby w przypadku niewykrycia przez wtyczkę wariantów w ramach węzła (tzn. jeśli występuje tylko jeden wariant) został utworzony produkt prosty, a nie produkt z wariantami.

Pierwszy wariant jako domyślny – wybierz tę opcję, aby pierwszy utworzony wariant miał status domyślnego. Jeśli opcja nie zostanie zaznaczona, żaden z wariantów nie będzie traktowany jako domyślny.

Pobierz wartości z ustawień produktu głównego – zaznacz checkbox, jeśli chcesz wyłączyć konfigurację poszczególnych pól na poziomie wariantu i korzystać z parametrów ustawionych na poziomie konfiguracji produktu nadrzędnego. Zostanie rozwinięte pole typu multiselect, w którym możesz wybrać, które pola konfiguracji wariantów mają zostać wyłączone. Wartości tych pól będą ustawiane zgodnie z konfiguracją produktu nadrzędnego.

URL obrazka – ustaw obrazek wyróżniający dla wariantu, podając ścieżkę do pola zawierającego adres URL obrazka. Obrazek zostanie pobrany do Biblioteki mediów i ustawiony jako obrazek wariantu produktu.

SKU – przeciągnij i upuść znacznik pola, w którym znajduje się identyfikator produktu.

Cena – przeciągnij i upuść znacznik pola, w którym znajduje się cena produktu. Możesz też wprowadzić stałą wartość.

PRO Masz możliwość modyfikacji ceny w locie o stałą wartość lub konkretny procent:

PRO Dodaj wartość procentową – cena produktu w sklepie zostanie zwiększona o wartość procentową, którą podasz w kolejnym polu. Przykład: jeśli chcesz, żeby cena w sklepie WooCommerce była o 20% wyższa względem ceny w pliku, wybierz tę opcję, a w kolejnym polu wprowadź liczbę 20.
PRO Dodaj stałą wartość – cena produktu w sklepie zostanie zwiększona o stałą wartość, którą podasz w kolejnym polu. Przykład: jeśli chcesz, żeby cena w sklepie WooCommerce była o 10 zł wyższa względem ceny w pliku, wybierz tę opcję, a w kolejnym polu wprowadź liczbę 10.

Cena promocyjna – jeśli chcesz, aby produkt był w promocji, wprowadź promocyjną cenę w tym polu.

Waga, wymiary – przeciągnij i upuść tagi z pliku, odpowiadające za te informacje o produktach. Są one przydatne dla kupujących, a także pomocne przy obliczaniu kosztu wysyłki.

Zarządzać stanem magazynowym? – po włączeniu zarządzania stanem magazynowym możesz skonfigurować:

Stan magazynowy – jeśli chcesz, aby stan magazynowy produktów na poziomie wariantów był synchronizowany z plikiem, przeciągnij i upuść w tym miejscu odpowiednią wartość z pliku.

Po kliknięciu na listę wyboru w pozycji Pozwalać na zamówienia oczekujące otrzymasz następujące opcje:

• Nie pozwalaj – wybierz, jeśli nie chcesz umożliwiać zamawiania przy zerowym stanie magazynowym.
• Pozwalaj, ale poinformuj klienta – wybierz, jeśli chcesz dać taką możliwość, ale w sklepie ma wyświetlić się stosowna informacja.
• Pozwalaj – wybierz, jeśli przy zerowym stanie magazynowym sprzedaż od strony widoku produktu w sklepie ma wyglądać tak samo jak przy stanie dodatnim.

Klasa wysyłkowa – wybierz klasę wysyłkową produktu. Jest ona przydatna, gdy importujesz produkty o bardzo dużych lub bardzo małych gabarytach. Dzięki klasie wysyłkowej możesz lepiej wyceniać koszt wysyłki.

Status podatku – opcjonalnie włącz lub wyłącz podatki dla produktu. Pozostaw to pole bez zmian, aby użyć ustawień sklepu. Możesz też opodatkować tylko koszty wysyłki (Tylko wysyłka).

Klasa podatkowa – wybierz z dostępnych w sklepie klas podatkowych, do której produkty mają być przypisane podczas importu. Klasy podatkowe umożliwiają przypisywanie różnych stawek podatkowych do różnych typów produktów.

Mapowanie klasy podatkowej – opcja pozwala na mapowanie stawek podatkowych z pliku z klasami podatkowymi w sklepie. W pliku muszą być zdefiniowane nazwy lub identyfikatory klas podatkowych. Jeśli wartość będzie inna, zostanie ustawiona stawka standardowa.

Pole klasy podatkowej – umieść w tym polu tag pochodzący z pliku, który odpowiada za nazwę lub identyfikator podatku. Jeśli w pliku znajduje się kilka pól z podatkami, a chcesz, aby każde pole zostało zmapowane, umieść tutaj znaczniki oddzielone przecinkami.

Pole mapowania klasy podatkowej – składa się z pola Klas podatkowych WooCommerce (z lewej) i pola Zewnętrzna klasa podatkowa.

Klasy podatkowe WooCommerce – wybierz z listy klasę podatkową WooCommerce. Jeśli na liście brakuje interesującej cię klasy, dodaj ją do listy klas podatkowych WooCommerce.

Opis – wypełnij opis wariantu. Aby zachować elastyczność, możesz korzystać z dowolnej liczby tagów pochodzących z pliku. Dzięki temu w opisie produktu zostaną zapisane wszystkie parametry, które chcesz tam umieścić. Możesz dodać dowolny tekst, własne dekoracje i adnotacje.

Atrybuty

W sekcji Atrybuty masz możliwość zdefiniowania atrybutów produktu, które zostaną dodane podczas importu.

Lista atrybutów jest podzielona na dwie części: Nazwa i wartość

Nazwa – podaj nazwę atrybutu. Możesz wprowadzić ją ręcznie lub użyć tagu pochodzącego z podglądu pliku.

Wartość – wprowadź wartość atrybutu, który zostanie dodany do produktów. Aby wartości były dynamicznie pobierane z pliku, umieść w tym polu tag pochodzący z pliku z produktami.
Dodawaj kolejne atrybuty za pomocą przycisku Dodaj +. Zdefiniuj każdy atrybut, który chcesz zapisać przy produkcie w sklepie WooCommerce. Istniejące pozycje możesz usuwać za pomocą przycisku Usuń.

Produkty zewnętrzne/afiliacyjne

Adres URL produktu – umieść w tym polu tag z pliku z adresem URL produktu zewnętrznego/afiliacyjnego. Jeśli w strukturze pliku XML ścieżki do adresów URL produktów są względne, wprowadź początek adresu URL przed XPath, aby uzupełnić adres:
https://adres-strony.pl/{//XPath do obrazów w strukturze XML}

Tekst przycisku – wprowadź tekst przycisku do produktu zewnętrznego. Możesz tu też umieścić tag.

Mapowanie kategorii

Wtyczka daje możliwość importu kategorii według poniższych opcji:

1. Ustaw jedną kategorię dla wszystkich importowanych produktów – zaimportuj produkty do jednej, wybranej kategorii w sklepie.
2. Mapuj kategorie – opcja pozwala na mapowanie kategorii z pliku z kategoriami w sklepie. W pliku muszą być zdefiniowane nazwy lub identyfikatory kategorii.
   1. Importuj tylko produkty ze zmapowanych kategorii – zaznaczysz tę opcję, jeśli chcesz, aby wtyczka importowała produkty tylko z kategorii z identyfikatorami ustawionymi w maperze poniżej.
   2. PRO Stwórz lub wybierz kategorie automatycznie – zaznacz tę opcję, jeśli chcesz, aby kategorie produktów WooCommerce były automatycznie tworzone podczas synchronizacji. Wtyczka utworzy kategorie i przypisze do nich produkty. W polu kategorii produktów musi znajdować się znacznik zawierający nazwę kategorii.
   3. Pole kategorii produktów – umieść w tym polu tag pochodzący z pliku, który odpowiada za nazwę lub identyfikator kategorii. Jeśli w pliku znajduje się kilka pól z kategoriami, a chcesz, aby każde pole zostało zmapowane, umieść tutaj znaczniki oddzielone przecinkami.
   4. Maper kategorii – znajduje się tutaj lista kategorii. Każda pozycja na liście składa się z dwóch pól: Kategoria WooCommerce i Identyfikator kategorii z pliku.
      1. Kategoria WooCommerce – wybierz z listy kategorię WooCommerce. Jeśli na liście brakuje interesującej cię kategorii, dodaj ją do listy kategorii WooCommerce.
      2. Identyfikator kategorii w pliku – wprowadź w tym polu identyfikator danej kategorii pochodzący z pliku, z którego dokonujesz importu, odpowiadający kategorii WooCommerce.
      3. Dodaj kolejne kategorie na liście dla wszystkich kategorii istniejących w pliku. Dodawaj je za pomocą przycisku Dodaj. Istniejące pozycje możesz usuwać za pomocą przycisku Usuń.
         Jeśli w trakcie procesu importu identyfikator nie zostanie odnaleziony, produkt zostanie dodany do domyślnej kategorii WooCommerce (domyślnie: Bez kategorii).
3. Stwórz kategorie hierarchiczne – zaimportuj kategorie zgodnie z ich hierarchią, np. Kobiety > Odzież > Sukienki.
   1. Pole kategorii produktów – umieść w tym polu tag pochodzący z pliku, który odpowiada za nazwę lub identyfikator kategorii. Jeśli w pliku znajduje się kilka pól z kategoriami, a chcesz, aby każde pole zostało zmapowane, umieść tutaj znaczniki oddzielone przecinkami.
   2. Dodać produkt do wszystkich podkategorii – zaznacz to pole, jeżeli chcesz, aby produkt został dodany do wszystkich kategorii w drzewie kategorii (np. Kobiety > Odzież > Sukienki), a nie tylko do kategorii najniższego poziomu (np. Sukienki).
   3. Separator drzewa kategorii – ustaw znak, który oddziela kategorie w pliku. Na przykład kategorie w drzewie Kobiety > Odzież > Sukienki są oddzielone znakiem >.

Krok 4 Opcje importu

Ten krok pozwoli Ci ustawić opcje importu, na przykład synchronizację pól produktów, logikę warunkową i harmonogram importu.

Łącz produkty na podstawie – wybierz identyfikator produktu. Na jego podstawie wtyczka będzie synchronizować produkty z pliku z istniejącymi produktami w WooCommerce. Produkty będą identyfikowane według tego parametru. Jeśli wtyczka wykryje istniejący produkt o takim parametrze, zostanie on zaktualizowany. Jeśli w sklepie nie zostanie odnaleziony produkt z identycznym identyfikatorem, zostanie utworzony nowy produkt.

Wtyczka daje możliwość wyboru następujących identyfikatorów:

• Nazwa,
• SKU,
• Unikalny identyfikator,
• EAN.

Przy braku produktów w pliku XML/CSV – zdecyduj, co zrobić, gdy produkty nie zostaną znalezione w trakcie kolejnych importów pliku. Możesz wybrać jedną z poniższych opcji:

• nie podejmuj działań – wobec nieobecnych produktów nie zostanie wykonane żadne działanie,
• zmień stan magazynowy produktów na 0 – to pozwoli na pozostawienie produktów w sklepie, ale ustawienie ich stanu magazynowego na 0,
• PRO przenieś produkty do kosza – “brakujące” produkty, wcześniej zaimportowane z tego pliku, zostaną przeniesione do kosza.

PRO Włącz logikę warunkową – zaznacz tę opcję, aby pojawiły się pola logiki warunkowej.

Nie twórz, tylko aktualizuj istniejące produkty – zaznacz checkbox, jeśli chcesz, aby podczas importu nie były tworzone nowe produkty. Podczas synchronizacji zostaną zaktualizowane jedynie produkty, które już istnieją w sklepie.

Utwórz nowe produkty jako szkice – zaznacz checkbox, aby wszystkie utworzone przez wtyczkę produkty miały status Szkic. Produkty ze statusem Szkic nie są widoczne dla kupujących. Ta opcja jest przydatna, jeśli chcesz przetestować proces importu w działającym sklepie. Opcja będzie aktywna tylko wtedy, gdy opcja Nie twórz, tylko aktualizuj istniejące produkty jest wyłączona. Jeśli checkbox pozostanie odznaczony, nowe produkty będą tworzone ze statusem Opublikowany.

Synchronizuj pola produktu – wybierz pola produktu, które mają być aktualizowane podczas kolejnych importów. Domyślnie wtyczka synchronizuje wszystkie pola. Usuń z listy te, które powinny zostać pominięte. Opcja jest przydatna zwłaszcza przy aktualizacji cen i stanów magazynowych.

PRO Harmonogram cron – wybierz dni tygodnia oraz godziny, w których ma następować automatyczna synchronizacja plików. Jeśli nie wybierzesz żadnych opcji, proces nie będzie uruchamiany automatycznie w przyszłości.

Pola logiki warunkowej:

PRO Importuj / Nie importuj – wybierz opcję, aby wybrać lub pominąć pola, które wskażesz w warunkach logicznych.

PRO XPath pola – wskaż ścieżkę, przeciągając ją z drzewka importu.

PRO Wartości pól logiki warunkowej:

• Jest pusta
• Nie jest pusta
• Większa od
• Mniejsza od
• Równa
• Nie jest równa
• Zawiera
• Nie zawiera

Przykłady użycia logiki warunkowej:

Pomiń w imporcie produkty o stanie magazynowym równym 0

PRO
Aby pominąć produkty o stanie magazynowym równym 0, przeciągnij tag, który odpowiada za wartość stanu magazynowego. Następnie wpisz w polu cyfrę 0.

Pomiń w imporcie produkty nieposiadające SKU

PRO
Aby pominąć w imporcie produkty, które nie mają SKU, przeciągnij tag użyty w mapowaniu produktu jako SKU i ustaw wartość pola na Jest pusta.

Importuj produkty o cenie większej niż 15 złotych, ale mniejszej niż 100 złotych

PRO
W ustawieniach warunków logicznych przeciągnij tag odpowiedzialny za cenę. Wybierz wartość pola mniejsza od i wpisz wartość 100. Następnie kliknij ikonę +, aby dodać drugi warunek. Wybierz ten sam tag co w poprzednim warunku, ustaw wartość pola „większa od” i wpisz liczbę 15.

Importuj produkty, których stawka podatkowa jest równa 23%

PRO
Wybierz Importuj produkt jeśli i wybierz tag wskazujący stawkę podatkową. Następnie wybierz wartość pola Równa i wpisz liczbę 23.

Log importu

Jeśli uruchomisz proces importu ręcznie, na ekranie zostanie wyświetlony dziennik zdarzeń, który pozwala monitorować przebieg procesu:

Jeśli pozostawisz otwartą kartę przeglądarki, import będzie przebiegał szybciej, ponieważ kolejne zadania będą wywoływane przez funkcje AJAX. Jeśli zamkniesz kartę przeglądarki, proces będzie kontynuowany w tle przy użyciu zadań wp-cron.

Informacje na ekranie:

Czas, który upłynął – czas od rozpoczęcia procesu importu.

Postęp – wartość procentowa pokazująca, jaka część procesu została już wykonana.

Utworzone – liczba produktów, które zostały utworzone w sklepie WooCommerce podczas importu (w sklepie nie znaleziono produktów na podstawie wybranego identyfikatora, dlatego zostały one utworzone).

Zaktualizowane – liczba produktów, które zostały zidentyfikowane na podstawie wybranego identyfikatora i zaktualizowane na podstawie pliku produktów.

Pominięte – liczba pozycji w pliku, które zostały pominięte (informacje o nich nie zostały zapisane w sklepie). Ten komunikat pojawia się, gdy w trakcie importu wystąpi błąd lub WooCommerce nie pozwala na dodawanie produktów. Informacja o przyczynie powinna być dostępna w okienku poniżej:

Logowanie importu – tutaj zapisywany jest dziennik zdarzeń. Wyjaśnienia komunikatów:

• Starting new import – rozpoczęcie importu z podanym indywidualnym identyfikatorem pliku,
• Pobieranie – rozpoczęcie pobierania pliku XML / CSV ze wskazanego URL-a,
• Pobieranie zostało zakończone – plik został prawidłowo zapisany na serwerze,
• Konwertowanie – rozpoczęcie konwersji pliku XML / CSV do formatu przygotowanego do importu,
• Konwertowanie zakończono – proces konwersji pliku XML / CSV do formatu przygotowanego do importu,
• Poczekaj na zakończenie importu – rozpoczęcie procesu zapisywania informacji o produktach w sklepie,
• Importowanie zakończono – plik został prawidłowo odczytany,
• Poszukiwanie produktu w bazie danych – identyfikowanie produktu na podstawie wybranego identyfikatora,
• Produkt znaleziono i zostanie on zaktualizowany – produkt został odnaleziony w sklepie i jego dane zostaną zaktualizowane,
• Produktu nie znaleziono – produkt nie został odnaleziony w sklepie na podstawie wybranego identyfikatora,
• Tworzenie nowego produktu – rozpoczęcie tworzenia nowego produktu na podstawie pozycji w pliku,
• Produkt nie może zostać utworzony i zostanie pominięty – sprawdź, czy rozmiar bazy danych nie przekracza limitów serwera,
• Kategoria dla produktu nie została zmapowana i produkt został pominięty – jeśli aktywowałeś mapowanie kategorii, upewnij się, że wszystkie kategorie z pliku zostały prawidłowo zmapowane,
• Found attachment in the media library, attachment X – podczas pobierania zdjęć do galerii produktu, zdjęcie o wskazanym ID zostało odnalezione w bibliotece mediów i przypisane do produktu (zdjęcie nie zostało pobrane ponownie),
• Created new attachment X – zdjęcie zostało pobrane do sklepu i zapisane w Bibliotece mediów pod wskazanym ID,
• Błąd przy tworzeniu obrazka: Obrazek nie może zostać pobrany poprawnie – obrazek nie został pobrany. Upewnij się, że adresy URL plików są prawidłowo zmapowane,
• Czyszczenie – trwa usuwanie plików tymczasowych,
• Koniec – proces importu zakończony pomyślnie

Lista importowanych produktów

Przejdź do WooCommerce → Produkty. W kolumnie Dropshipping znajdziesz informacje, w trakcie jakiego importu produkty zostały utworzone. Jeżeli nadałeś nazwę importowi, to w kolumnie znajdziesz właśnie jego nazwę. Jeżeli import nie posiada nazwy, w kolumnie znajdziesz URL pliku, który został użyty do importu.

Opcje zaawansowane

Edycja danych w locie

PRO
Wtyczka posiada wbudowane filtry, które pozwalają na modyfikację danych w locie pomiędzy pobraniem danych z pliku XML/CSV a zapisaniem ich w sklepie WooCommerce. Poniżej znajdują się przykłady wykorzystania filtrów. Poniższy kod usunie w locie znaki nawiasów klamrowych { i }. Ponadto wytnie cały tekst, który nie znajduje się wewnątrz podanych tagów HTML.

Modyfikacja nazwy produktu w locie

PRO

Modyfikacja opisu produktu w locie

PRO

Modyfikacja krótkiego opisu produktu w locie

PRO

Modyfikacja znaków specjalnych w adresach obrazków

PRO

Mapowanie nietypowych stanów magazynowych

PRO

Filtr pozwalający dodać plik wraz ze zdjęciami pomimo ograniczeń związanych z certyfikatem SSL

PRO

Poprawne kodowanie pliku

PRO

Poprawne kodowanie typu MIME pliku

PRO

Poprawne pobieranie zdjęć, gdy w pliku nie ma pełnego adresu obrazków

PRO

Roadmapa

W przyszłości planujemy rozwinąć wtyczkę o następujące funkcjonalności:

1. Import produktów z wariantami – ukończone,
2. Dodanie nowych metod importu plików (FTP) – ukończone (zobacz dodatek),
3. Eksport zamówień – ukończone (zobacz dodatek).

Jeśli masz pomysł na funkcjonalności, które wtyczka mogłaby obsługiwać, napisz nam o nich.

Warto przeczytać

• https://www.wpdesk.pl/blog/hurtownie-dropshipping-w-polsce-jak-zaczac-lista-hurtowni-oraz-trendy/
• https://www.wpdesk.pl/blog/import-zdjec-dropshipping-xml-woocommerce/
• https://www.wpdesk.pl/blog/sklep-internetowy-bez-towaru/
• https://www.wpdesk.pl/blog/co-to-jest-dropshipping/
• https://www.wpdesk.pl/blog/model-dropshipping-sprzedaz-allegro-woocommerce/
• https://www.wpdesk.pl/blog/konfiguracja-pliku-importowego-z-hurtowni-dropshipping/
• https://www.wpdesk.pl/blog/import-csv-produktow-woocommerce-nowa-wersja-wtyczki-dropshipping-xml/
• https://www.wpdesk.pl/blog/dropshipping-woocommerce-xml-csv-hurtownie/
• https://www.wpdesk.pl/onboarding/dropshipping-xml-szybki-start/

FAQ