Import produktów WooCommerce nie działa? Oto, co robić!

Problem z niedziałającym importem produktów WooCommerce jest prawie zawsze problemem z plikiem CSV, a nie z Twoim sklepem. Kodowanie, niezmapowane kolumny, uszkodzone powiązanie nadrzędne w wierszach wariantów lub limit serwera odpowiadają za zdecydowaną większość błędów, a każdy z nich ma specyficzne rozwiązanie, które można sprawdzić w ciągu kilku minut.

Frustrujące jest to, jak cicho się psuje. WooCommerce często zgłasza pomyślny import, podczas gdy połowa wierszy nie została przetworzona, więc zgadujesz, który etap zawiódł.

Ten przewodnik omawia przyczyny w kolejności, w jakiej warto je sprawdzać, od samego pliku, przez konflikty wtyczek, po limity serwera, z dokładnym rozwiązaniem dla każdego z nich. Zacznijmy więc!

Spis treści

Problemy z formatem CSV: Najczęstsza przyczyna

Znaczna część przypadków „import nie działa” wynika z problemów z plikiem, a nie ze sklepem. Trzy szczegóły powodują większość cichych błędów, a wszystkie trzy są widoczne, jeśli otworzysz plik CSV w edytorze zwykłego tekstu, a nie w aplikacji arkusza kalkulacyjnego.

• Kodowanie UTF-8: pliki zapisane z Excela domyślnie używają Windows-1252 lub MacRoman, a każdy znak diakrytyczny, symbol waluty lub inteligentny cudzysłów zostaje uszkodzony. Zapisz ponownie jako „CSV UTF-8 (rozdzielany przecinkami)” lub użyj Arkuszy Google, które domyślnie eksportują UTF-8.
• Niecytowane pola wielowartościowe: komórka zawierająca wiele kategorii lub adresów URL obrazów musi być ujęta w cudzysłów. Bez nich przecinek jest odczytywany jako podział kolumny, a wiersz rozpada się.
• Wiersze wariantów bez rodzica: każdy wariant wymaga kolumny „Rodzic” zawierającej SKU produktu nadrzędnego. Brakujące lub nieprawidłowe wartości oznaczają, że warianty są importowane jako osierocone produkty proste.

Uruchom tę listę kontrolną dla pliku, zanim założysz, że problem leży po stronie WooCommerce:

1. Otwórz go w edytorze zwykłego tekstu i poszukaj nieczytelnych znaków. „café” wyświetlane jako „café” potwierdza problem z kodowaniem.
2. Sprawdź, czy komórki wielowartościowe są ujęte w cudzysłów.
3. W przypadku produktów wariantowych upewnij się, że kilka wierszy wariantów odwołuje się do prawidłowego SKU rodzica, bez dodatkowych spacji.
4. Najpierw zaimportuj od 5 do 10 wierszy. Jeśli te zostaną poprawnie zaimportowane, zwiększ liczbę do całego pliku.

Pełne zestawienie kolumn, akceptowanych wartości i zasad formatowania znajdziesz w naszym przewodniku po imporcie CSV WooCommerce.

Dlaczego import produktów WooCommerce nie działa?

Nie działający import produktów WooCommerce wynika z czterech przyczyn: formatowania pliku, niezmapowanych kolumn, wtyczki zakłócającej tworzenie produktów lub serwera skracającego proces. Praca nad nimi w tej kolejności najszybciej znajduje przyczynę, ponieważ pierwsze dwie są znacznie częstsze niż ostatnie dwie.

• Nieprawidłowe kodowanie lub niecytowane wartości zawierające przecinki
• Kolumny pozostawione jako „Nie importuj” podczas mapowania
• Wiersze wariantów, które nie odwołują się do swojego rodzica
• Przekroczenie limitu czasu lub wyczerpanie pamięci przy dużych plikach
• Konflikty z wtyczkami buforującymi, zabezpieczającymi lub SEO
• Adresy URL obrazów, do których serwer nie ma dostępu

Zacznij od pliku. Sprawdź formatowanie i potwierdź mapowanie, a następnie przejdź do sprawdzania wtyczek i serwera, jeśli problem nadal występuje.

Jakiego formatu pliku wymaga import produktów WooCommerce?

WooCommerce importuje pliki CSV w kodowaniu UTF-8 i nic innego. Inne formaty, takie jak XLSX, TSV lub JSON, muszą zostać najpierw przekonwertowane do formatu CSV, co każda aplikacja arkusza kalkulacyjnego robi za pomocą funkcji Zapisz jako lub Pobierz.

Warto wiedzieć: potrzeba znacznie mniej kolumn niż twierdzi większość poradników. Tylko Nazwa jest naprawdę wymagana, plus Typ dla wszystkiego, co nie jest prostym produktem. SKU jest generowane automatycznie, gdy brakuje, więc pusta kolumna SKU nie zatrzyma importu, chociaż pozostawia Cię bez klucza do przyszłych aktualizacji.

• Czy każdy wiersz ma nazwę?
• Czy typy produktów są napisane poprawnie (prosty, zmienny, wariacja)?
• Czy w kolumnach SKU lub Rodzic są jakieś dodatkowe spacje lub ukryte znaki?
• Czy w danych znajdują się całkowicie puste wiersze?

Dlaczego kolumny znikają na ekranie mapowania

Jeśli produkty zostały zaimportowane, ale ich dane są puste, kolumna prawie na pewno została ustawiona na „Nie importuj”. WooCommerce wyświetla ekran mapowania kolumn po przesłaniu, a wszystko, czego nie rozpozna, jest domyślnie pomijane, zamiast być zgadywane.

Oznacza to również, że nagłówki nie musiały pasować do nazw WooCommerce. Kolumna o nazwie „Kod pozycji” lub „SKU produktu” doskonale pasuje z listy rozwijanej, więc zmiana nazw kolumn dostawcy jest stratą wysiłku. Przeczytaj ekran mapowania, zamiast klikać dalej, i ustaw każdą kolumnę, którą faktycznie chcesz.

Nierozpoznane kolumny można również wysłać do niestandardowego pola, mapując je do klucza meta:, co pozwala na przeniesienie kodów dostawców i cen hurtowych.

Jakie konflikty wtyczek wpływają na import produktów WooCommerce?

Wtyczki, które integrują się z tworzeniem produktów, mogą spowolnić import do ślimaczego tempa lub całkowicie odrzucić wiersze. Narzędzia do buforowania, bezpieczeństwa i SEO są typowymi podejrzanymi, ponieważ każdy z nich wykonuje dodatkową pracę za każdym razem, gdy produkt jest zapisywany.

• Wtyczki buforujące (WP Rocket, W3 Total Cache)
• Wtyczki bezpieczeństwa i zapory sieciowej (Wordfence)
• Narzędzia SEO integrujące się z metadanymi produktu
• Inne narzędzia do importu i eksportu

Testuj na stronie stagingowej z dezaktywowanymi nieistotnymi wtyczkami i aktywnym domyślnym motywem, takim jak Twenty Twenty-Four. Jeśli import przebiegnie pomyślnie, reaktywuj jedną wtyczkę na raz, aż problem powróci.

Jak sprawdzić limity zasobów serwera dla importu produktów?

Duże katalogi mogą przekroczyć czas wykonania PHP lub pamięć, zanim import się zakończy, a gdy tak się stanie, proces zatrzymuje się bez użytecznego błędu. Podręcznik PHP podaje domyślny max_execution_time wynoszący 30 sekund przez serwer WWW, który kilka tysięcy wierszy przejdzie bez problemu.

• max_execution_time, podniesiony do 300 sekund lub więcej dla dużych plików
• memory_limit, z 512 MB jako rozsądnym punktem wyjścia
• upload_max_filesize i post_max_size, które ograniczają to, co można przesłać przez przeglądarkę

Mieszkają one w Twojej konfiguracji PHP, a hosting współdzielony często ogranicza to, co możesz zmienić. Niezawodnym obejściem są mniejsze partie po 500 do 1000 wierszy, które całkowicie omijają limity.

Jakie komunikaty o błędach pojawiają się po nieudanym imporcie?

WooCommerce zgłasza błędy na poziomie wiersza, zamiast je wyjaśniać. Podsumowanie importu informuje, ile wierszy zostało zaimportowanych, zaktualizowanych, pominiętych i błędnych, a liczba błędnych jest tą, na którą warto zwrócić uwagę, ponieważ „udany” import może nadal pominąć połowę Twojego pliku.

Zatrzymany pasek postępu bez żadnego podsumowania zazwyczaj oznacza przekroczenie limitu czasu, a nie problem z danymi. Jeśli nic nie pojawia się na ekranie, sprawdź dziennik błędów serwera i upewnij się, że WordPress i WooCommerce są aktualne.

Jak zapobiec duplikatom lub brakującym produktom?

Duplikaty prawie zawsze oznaczają, że pole wyboru Aktualizuj istniejące produkty pozostało nieoznaczone. Gdy jest zaznaczone, WooCommerce dopasowuje każdy wiersz do Twojego katalogu według identyfikatora produktu lub SKU i aktualizuje dopasowanie zamiast tworzyć drugą kopię. Wiersze bez dopasowania są pomijane zamiast dodawane.

Odwrotny objaw, czyli produkty cicho pominięte, gdy oczekiwałeś aktualizacji, oznacza, że pole było zaznaczone, ale nic nie pasowało. Sprawdź kolumnę SKU pod kątem dodatkowych spacji i niespójnej wielkości liter, oba są powszechne w plikach dostawców i oba wystarczą, aby przerwać dopasowanie.

• Używaj unikalnych SKU dla produktów i wariantów
• Pomiń kolumnę ID, chyba że celowo aktualizujesz według ID
• Uwzględnij tylko kolumny, które zamierzasz zmienić podczas uruchomienia aktualizacji
• Wykonaj kopię zapasową przed każdą aktualizacją, ponieważ ma ona natychmiastowe zastosowanie do Twojego katalogu na żywo

Co zrobić, gdy import nadal się nie uruchamia

Jeśli plik jest czysty, a Twój import produktów WooCommerce nadal nie działa, problemem jest prawie zawsze rozmiar. Trzy podejścia pozwalają go obejść bez dotykania planu hostingowego.

• Użyj ścieżki pliku serwera. Prześlij plik CSV przez FTP, a następnie otwórz Opcje zaawansowane na ekranie importu i wprowadź ścieżkę. Limit przesyłania przez przeglądarkę przestaje obowiązywać całkowicie.
• Podziel plik. Partie po 500 do 1000 wierszy kończą się dobrze w ramach każdego limitu czasu, a błąd kosztuje Cię tylko jedną partię.
• Uruchom z linii poleceń. WP-CLI omija limity czasu przeglądarki i serwera WWW, co jest odpowiednie dla bardzo dużych migracji jednorazowych.

Najpierw przetestuj cały proces na stronie staging, gdy katalog jest duży. Import, który częściowo się zakończył w sklepie na żywo, wymaga znacznie więcej pracy przy naprawie niż ten, który bezpiecznie zakończył się gdzie indziej.

Jak wyeksportować produkty do celów diagnostycznych?

Eksportowanie istniejących produktów daje Ci plik, który WooCommerce już akceptuje, co zamienia zgadywanie w porównanie. Umieść swój eksport obok pliku importu, a niedopasowanie zazwyczaj staje się oczywiste: inaczej nazwana kolumna, wartość w złym formacie, brakujące odniesienie do elementu nadrzędnego.

Store Exporter Deluxe obsługuje eksport w formatach CSV, TSV, XLS, XLSX, XML lub JSON:

• Eksportuj produkty, warianty, tagi i stany magazynowe
• Wykryj brakujące terminy taksonomii lub pola niestandardowe
• Utwórz działający szablon, na podstawie którego zbudujesz plik importu
• Archiwizuj migawkę przed każdą większą zmianą

Jakie są najlepsze praktyki, aby uniknąć błędów importu?

Kilka nawyków zapobiega większości powtarzających się problemów. Wymagają one niewielkiego nakładu czasu na początku i pozwalają uniknąć przeróbek wynikających z odkrycia złego importu dwa tygodnie później.

• Wykonaj kopię zapasową sklepu przed każdym dużym importem
• Zawsze najpierw przetestuj na małym pliku przykładowym
• Zapisz jako CSV UTF-8, a nie zwykły CSV
• Aktualizuj WordPress i WooCommerce
• Używaj strony staging do operacji masowych
• Po zakończeniu sprawdź ręcznie kilka produktów, zamiast ufać podsumowaniu

Końcowe przemyślenia

Nie działający import produktów WooCommerce rzadko oznacza zepsuty sklep. Zazwyczaj jest to plik, który nie mówi dokładnie tego, co myślisz, a poprawka jest zazwyczaj o jedno ustawienie lub jedną kolumnę od celu.

Oto szybkie podsumowanie tego, co należy sprawdzić, w kolejności:

• Kodowanie pliku i cudzysłowy, zdecydowanie najczęstsza przyczyna.
• Ekran mapowania kolumn, gdzie dane po cichu znikają.
• Konflikty wtyczek, testowane na stagingu z domyślnym motywem.
• Limity serwera lub po prostu mniejsze partie.
• Pole wyboru Aktualizuj istniejące produkty, które decyduje o duplikatach.

Jeśli rozwiązujesz problem z plikiem, którego nie zbudowałeś, zacznij od pliku, który WooCommerce już akceptuje. Wyeksportuj swój aktualny katalog za pomocą Store Exporter Deluxe i porównaj go z plikiem, który powoduje błędy.

Często zadawane pytania

Co oznaczają „wymagania dotyczące formatu CSV” dla importu WooCommerce?

Oznacza to plik rozdzielany przecinkami, zapisany w UTF-8 z wierszem nagłówka. Wymagana jest tylko kolumna Nazwa, a nagłówki nie muszą odpowiadać nazewnictwu pól WooCommerce, ponieważ ekran mapowania kolumn pozwala przypisać każde z nich. Pełna specyfikacja znajduje się w naszym przewodniku po imporcie CSV.

Dlaczego mój import CSV WooCommerce kończy się sukcesem, ale produkty się nie pojawiają?

Prawie wszystkie te problemy wynikają z trzech przyczyn. Produkty zostały zaimportowane jako wersje robocze, więc sprawdź filtr statusu na liście produktów. Kolumna Opublikowano miała wartość 0 lub -1, co czyni je prywatnymi lub wersjami roboczymi. Lub zaimportowano nadrzędny produkt wariantu, podczas gdy jego warianty się nie powiodły, co objawia się jako produkt bez opcji zakupu.

Dlaczego mój import produktów WooCommerce nie działa?

Najczęstsze przyczyny to plik zapisany w złym kodowaniu, kolumny pozostawione na „Nie importuj” podczas mapowania, wiersze wariantów bez wartości nadrzędnej (Parent) i przekroczenia limitu czasu serwera przy dużych plikach. Sprawdź je w tej kolejności, ponieważ dwie pierwsze odpowiadają za większość błędów i obie są widoczne przed uruchomieniem importu.

Jak naprawić błędy „404 URL obrazu” podczas importu CSV?

Importer pobiera każdy adres URL obrazu podczas importu, więc każdy adres URL musi zwracać prawdziwy obraz bez przekierowania lub ściany logowania. Przetestuj je za pomocą curl -I lub wklej jeden do okna incognito. Obrazy za uwierzytelnieniem lub ochroną przed hot-linkingiem zawsze zawiodą, więc najpierw prześlij je do swojej Biblioteki Mediów i odwołuj się do ich ostatecznych adresów URL.

Dlaczego moje warianty zostały zaimportowane jako oddzielne produkty?

Brakuje kolumny Nadrzędny (Parent), jest błędnie napisana lub nie pasuje dokładnie do SKU produktu nadrzędnego. Każdy wiersz wariantu musi mieć typ ustawiony na variation i wartość Nadrzędny (Parent) zawierającą SKU produktu nadrzędnego lub id: wraz z jego identyfikatorem produktu. Zazwyczaj winowajcą są spacje na końcu, ponieważ są niewidoczne w arkuszu kalkulacyjnym, ale przerywają dopasowanie.

Dlaczego mój import zatrzymuje się w połowie?

To jest przekroczenie czasu, a nie problem z danymi. PHP zatrzymuje każdy skrypt działający dłużej niż max_execution_time, który domyślnie wynosi 30 sekund na większości serwerów. Podziel plik na partie od 500 do 1000 wierszy lub umieść go na serwerze i użyj opcji ścieżki pliku w opcjach zaawansowanych.

Czy mogę cofnąć import produktów WooCommerce?

Nie, WooCommerce nie ma opcji cofnięcia importu, dlatego kopia zapasowa przed każdym dużym uruchomieniem jest ważna. Aby poprawić zły import, popraw plik źródłowy i uruchom go ponownie z zaznaczoną opcją Aktualizuj istniejące produkty, aby wiersze zostały poprawione na miejscu, zamiast duplikowane.