Import produktów WooCommerce z CSV: błędy, brakujące zdjęcia i kiedy wybrać rozmowę
Import produktów WooCommerce z CSV najczęściej psuje się z czterech powodów: zły format pliku, kolumny niedopasowane do schematu WooCommerce, powtórzone SKU i adresy zdjęć, których serwer nie może pobrać. Zacznij od zapisu pliku w UTF-8 i porównania go z eksportem kilku produktów z twojego sklepu. Zdjęcia sprawdź, otwierając ich adresy w przeglądarce.
Autor: Zespół TellMyShop. Piszemy o PrestaShop na podstawie pracy z zapleczem prawdziwych sklepów i testów na własnym sklepie testowym.
Aktualizacja: · 5 min czytania
Najczęstsze błędy importu i co znaczą
Wbudowany importer znajdziesz w Produkty → Wszystkie produkty, przycisk Import u góry listy. Po imporcie pokazuje podsumowanie: ile produktów utworzył, zaktualizował, pominął i przy których wystąpił błąd. Zasady pliku opisuje dokumentacja importera i eksportera CSV, a pełną listę kolumn schemat importu na GitHubie.
| Co widzisz | Najczęstsza przyczyna | Co zrobić |
|---|---|---|
| Polskie znaki zamienione na krzaki | plik nie jest w UTF-8 | zapisz jako CSV UTF-8 i zaimportuj ponownie |
| Wiersze pominięte, bo produkt już istnieje | SKU albo ID jest już w sklepie | zaznacz aktualizację istniejących produktów albo zmień SKU |
| Puste nazwy, ceny albo opisy | kolumny nie zostały dopasowane w kroku mapowania | w kroku mapowania przypisz kolumny ręcznie |
| Cena 0 albo dziwna kwota | arkusz zmienił format liczb | porównaj zapis cen z przykładowym plikiem i trzymaj się tego formatu |
| Produkty bez kategorii albo z nowymi, dziwnymi kategoriami | literówka w nazwie kategorii albo zły zapis podkategorii | sprawdź nazwy kategorii i zapis hierarchii w schemacie |
| Import przerywa się w połowie | limit czasu albo pamięci na serwerze | dziel plik na mniejsze części, zapytaj hosting o limity |
| Warianty bez ceny albo bez atrybutów | wiersze wariantów nie wskazują produktu nadrzędnego | sprawdź kolumnę rodzica i atrybuty w wierszach wariantów |
Dokumentacja WooCommerce ostrzega też przed arkuszami kalkulacyjnymi, które po cichu zmieniają formatowanie i kodowanie. Zanim zaimportujesz plik po edycji w arkuszu, otwórz go w zwykłym edytorze tekstu i zobacz, czy kolumny i znaki wyglądają tak samo jak w eksporcie.
Dlaczego zdjęcia się nie importują
To najczęstsza skarga po imporcie: produkty są, zdjęć nie ma. WooCommerce przy imporcie pobiera każde zdjęcie z adresu podanego w pliku i dodaje je do biblioteki mediów. Jeśli pobranie się nie uda, produkt powstaje bez zdjęcia. Sprawdzaj po kolei:
- Adres otwiera samo zdjęcie. Wklej go do okna prywatnego przeglądarki. Musisz zobaczyć obraz, a nie stronę z logowaniem, podglądem dysku w chmurze albo pobieraniem pliku.
- Adres jest publiczny. Zdjęcia z panelu hurtowni po zalogowaniu albo z prywatnego folderu nie zostaną pobrane.
- Kolumna zdjęć ma właściwy zapis. Kilka zdjęć jednego produktu wpisuje się w jednej kolumnie, oddzielone tak, jak pokazuje schemat. Pierwsze zdjęcie zostaje zdjęciem głównym.
- Serwer dostawcy nie blokuje pobierania. Niektóre serwery odrzucają masowe pobieranie z innej strony. Na to pomaga tylko pobranie zdjęć i wgranie ich do biblioteki mediów albo prośba do dostawcy.
- Zdjęcia nie są za duże. Bardzo duże pliki potrafią przekroczyć limit czasu albo pamięci serwera. Mniejsza paczka produktów w jednym imporcie często rozwiązuje problem.
- Nazwa pliku zamiast adresu. Jeśli zdjęcia są już w bibliotece mediów, możesz w pliku podać ich nazwy zamiast pełnych adresów. Ważne bywa wtedy, w którym miesiącu wgrano pliki do biblioteki. Typowe przyczyny nieudanego pobierania zebrał poradnik WebToffee o błędach importu zdjęć.
Gdy po imporcie brakuje zdjęć tylko w części produktów, zrób listę tych produktów i porównaj ich adresy zdjęć z tymi, które zadziałały. Różnica zwykle od razu wskazuje przyczynę.
Jak przygotować plik, żeby import zadziałał za pierwszym razem
Najmniej błędów daje plik zbudowany na eksporcie z własnego sklepu:
- Dodaj ręcznie dwa, trzy produkty, w tym jeden z wariantami, i wyeksportuj je do CSV.
- Wklej dane dostawcy w te same kolumny, nie zmieniając nagłówków.
- Zaimportuj najpierw pięć wierszy. Sprawdź w sklepie nazwę, cenę, kategorię, zdjęcia i warianty.
- Dopiero potem importuj resztę, w częściach po kilkaset wierszy, jeśli serwer bywa wolny.
- Nowe produkty możesz importować jako szkice, żeby sprawdzić je przed publikacją.
Przewodnik WP Engine o imporcie produktów z CSV opisuje wbudowany importer jako dobry wybór dla małych i średnich sklepów z prostymi danymi. Przy złożonych plikach dostawców i regularnych aktualizacjach lepsza bywa wtyczka do importu z harmonogramem.
CSV czy rozmowa z Claude: kiedy co
Wtyczka TellMyShop dla WordPress i WooCommerce nie zastępuje importu tysięcy produktów i nie czyta raportu błędów importera. Pomaga w dwóch sytuacjach: gdy nowych produktów jest kilka, kilkanaście, i gdy po imporcie trzeba znaleźć, co nie wyszło.
| Sytuacja | Lepszy wybór | Dlaczego |
|---|---|---|
| Tysiące produktów z pliku hurtowni | import CSV albo wtyczka do importu | jeden plik, jeden proces, powtarzalny co tydzień |
| Codzienna aktualizacja cen i stanów od dostawcy | wtyczka do importu z harmonogramem | działa sama, bez rozmowy |
| Kilka, kilkanaście nowych produktów z maila dostawcy | rozmowa z Claude | bez budowania pliku, z opisem napisanym od razu |
| Sprawdzenie po imporcie: produkty bez zdjęć, opisu, kategorii | rozmowa z Claude | lista braków w jednej odpowiedzi |
| Poprawki po imporcie: opisy, kategorie, zdjęcia | rozmowa z Claude | paczki z podglądem zamiast ponownego importu |
Po imporcie: braki w jednej liście
Darmowa wersja TellMyShop Free czyta produkty i ich pełne dane, więc Claude znajdzie produkty bez zdjęcia głównego, bez opisu, bez kategorii albo z ceną zero. W TellMyShop Pro może te braki poprawić: dodać zdjęcia z publicznych adresów, przypisać kategorie i napisać opisy, zawsze z podglądem. Ceny i stany zapisuje dopiero po włączeniu przełącznika Handel w panelu wtyczki. Przykład rozmowy, liczby są przykładowe:
Wczoraj zaimportowałem 400 produktów od nowego dostawcy. Sprawdź, czego brakuje.
Z 400 nowych produktów 37 nie ma zdjęcia głównego, 12 nie ma kategorii, a 5 ma cenę 0 zł. Wszystkie 37 bez zdjęcia to produkty jednej marki, Szlak. Sprawdź w pliku ich adresy zdjęć i otwórz jeden w oknie prywatnym: jeśli zobaczysz stronę logowania zamiast zdjęcia, pobranie zostało zablokowane.
Rzeczywiście, logowanie. Zdjęcia dostanę od dostawcy. Kategorie przypisz według nazwy, jak w pozostałych produktach.
Podgląd dla 12 produktów:
Kubek termiczny Szlak 450 ml
było: brak kategorii
będzie: Kubki i termosy
Zapiszę po twoim „tak”. Ceny zero wymagają przełącznika Handel.
Nowe produkty z listy Claude tworzy po kilka, do 10 w jednej paczce, jako szkice niewidoczne w sklepie. Jak wygląda dodawanie produktów z maila dostawcy, pokazujemy w tekście o tym, jak dodać produkt w WooCommerce. Każda zmiana trafia do historii zmian i większość zmian cofniesz.
Darmową wersję wypróbujesz ze strony darmowej wersji. Szczegóły wtyczki są na stronie TellMyShop dla WordPress i WooCommerce, ceny w cenniku. Jeśli po imporcie produkty nie pojawiają się w sklepie, przejdź poradnik produkt nie wyświetla się w WooCommerce, a gdy problem dotyczy wariantów, listę kontrolną wariantów produktu.
Pytania i odpowiedzi
Dlaczego po imporcie CSV polskie znaki są zamienione na dziwne symbole?
Plik nie był zapisany w kodowaniu UTF-8. Arkusze kalkulacyjne często zapisują CSV w innym kodowaniu. Zapisz plik ponownie jako CSV UTF-8 i zaimportuj jeszcze raz z opcją aktualizacji istniejących produktów.
Dlaczego zdjęcia nie importują się z pliku CSV?
Najczęściej adres zdjęcia nie otwiera się publicznie, serwer dostawcy blokuje pobieranie albo adresy w kolumnie zdjęć są źle rozdzielone. Otwórz kilka adresów z pliku w oknie prywatnym przeglądarki. Jeśli nie widzisz samego zdjęcia, WooCommerce też go nie pobierze.
Jak zaktualizować ceny istniejących produktów przez CSV, nie tworząc duplikatów?
W pierwszym kroku importu zaznacz opcję aktualizacji istniejących produktów. WooCommerce dopasuje wiersze do produktów po ID albo SKU. Bez tej opcji wiersz z istniejącym SKU zakończy się błędem albo zostanie pominięty.
Czy Claude zastąpi import tysięcy produktów?
Nie. Do tysięcy pozycji z pliku dostawcy lepszy jest import CSV albo wtyczka do importu z harmonogramem. Wtyczka TellMyShop przydaje się przy kilku, kilkunastu nowych produktach z maila albo listy i przy sprawdzaniu, co po imporcie wymaga poprawki.
Gdzie znajdę wzór pliku CSV dla WooCommerce?
WooCommerce udostępnia przykładowy plik CSV, do którego odsyła jego dokumentacja importera. Najprostszy wzór to też eksport kilku twoich produktów z panelu, bo taki plik ma już poprawne nazwy kolumn.
WordPress jest znakiem towarowym WordPress Foundation. WooCommerce jest znakiem towarowym Automattic Inc. Claude jest znakiem towarowym Anthropic. TellMyShop nie jest powiązany z żadnym z tych podmiotów.