Ręczna edycja katalogu w WooCommerce brzmi niewinnie, dopóki nie trzeba zmienić cen, opisów albo SKU w kilkudziesięciu czy kilkuset produktach. Klikanie każdego rekordu osobno szybko zamienia się w sport ekstremalny, a pomyłka w jednym polu potrafi później narobić bałaganu w sklepie. Właśnie tutaj przydaje się CSV WooCommerce.
WooCommerce ma wbudowane narzędzia do importu, eksportu i masowej aktualizacji produktów. Możesz dodać nowe dane, poprawić istniejące produkty albo przygotować katalog do przeniesienia do innego sklepu. Sam plik nie jest jednak magiczną różdżką. Trzeba dopilnować kolumn, kodowania UTF-8, identyfikatorów, zdjęć, wariantów i testu na małej próbce. Poniżej przechodzimy przez cały proces bez zaklinania rzeczywistości.
CSV w WooCommerce — po co w ogóle się z nim męczyć?
CSV to zwykły plik tabelaryczny, w którym dane produktów są zapisane w wierszach i kolumnach. W WooCommerce może służyć do importowania nowych produktów, eksportowania katalogu oraz aktualizowania produktów, które już są w sklepie. To szczególnie wygodne wtedy, gdy zmiana dotyczy wielu rekordów naraz.
Zamiast otwierać każdy produkt, poprawiać cenę, zapisywać i przechodzić do następnego, przygotowujesz dane w jednym pliku. Potem importer próbuje dopasować je do właściwych pól. Oczywiście „próbuje” nie oznacza „zrobi wszystko za ciebie”. Źle przygotowany plik potrafi wprowadzić więcej zamieszania niż pożytku.
Kiedy CSV naprawdę oszczędza czas
Import produktów WooCommerce ma sens między innymi w takich sytuacjach:
- dodajesz większą liczbę nowych produktów naraz;
- chcesz masowo zmienić ceny regularne albo promocyjne;
- aktualizujesz opisy, SKU, kategorie, tagi, stany magazynowe lub statusy publikacji;
- eksportujesz katalog przed dalszą edycją albo migracją;
- przenosisz standardowe dane produktów między sklepami.
Ważne zastrzeżenie: wbudowany importer dotyczy przede wszystkim standardowych danych WooCommerce. Pola dodane przez konkretne wtyczki mogą wymagać osobnego sprawdzenia, dodatkowego narzędzia albo innego procesu. Nie zakładaj więc, że każdy element sklepu wskoczy do nowego miejsca tylko dlatego, że znalazł się w arkuszu.
Jak przygotować plik CSV do WooCommerce?
Najbezpieczniej nie zaczynać od pustej tabeli i zgadywania, jak nazwać każdą kolumnę. Dobrym punktem wyjścia jest eksport istniejących produktów albo plik zgodny ze schematem WooCommerce. Dzięki temu zachowasz nazwy pól, które importer potrafi rozpoznać.
Plik powinien być zapisany w kodowaniu UTF-8. To ważne zwłaszcza przy polskich znakach. Po zapisaniu sprawdź plik jeszcze raz, bo program arkuszowy może zmienić kodowanie, formatowanie albo sposób zapisu wartości. Na ekranie wszystko może wyglądać dobrze, a po imporcie nagle pojawiają się krzaczki. Mało eleganckie i średnio pomocne.
Nie istnieje jeden idealny zestaw kolumn dla każdego sklepu. Inaczej wygląda katalog prostych produktów, inaczej produktów wariantowych, a jeszcze inaczej sklep korzystający z dodatkowych rozszerzeń. Schemat WooCommerce obejmuje między innymi SKU, nazwę, opis, cenę regularną, cenę promocyjną, kategorie, tagi, stany magazynowe, obrazy, status publikacji i dane wariantów.
Kolumny, kodowanie i mapowanie
Przed importem zwróć uwagę przede wszystkim na:
- SKU — identyfikator produktu, szczególnie ważny przy aktualizacjach;
- Name — nazwę produktu;
- Description — opis;
- Regular price i Sale price — ceny;
- kategorie, tagi, stany magazynowe, obrazy i status publikacji;
- dane wariantów, jeśli katalog ich używa.
Podczas importu WooCommerce pokazuje etap mapowania kolumn. Przejrzyj go, zamiast przeklikiwać dalej na autopilocie. Kolumny nierozpoznane nie są domyślnie importowane, więc dodatkowa informacja w pliku nie oznacza automatycznie, że trafi do produktu.
Uważaj też na kategorie zawierające przecinki. W takim przypadku dane muszą być prawidłowo zapisane i „escapowane”, inaczej jedna kategoria może zostać odczytana jako kilka osobnych wartości. Obrazy z kolei muszą być dostępne w bibliotece mediów albo pod bezpośrednim adresem URL. Link ukryty za skryptem przekierowującym nie wystarczy.
Masowa aktualizacja produktów krok po kroku
Jeśli chcesz zmienić ceny, SKU albo opisy, zacznij od eksportu produktów, których dotyczy operacja. Zachowaj kopię tego pliku przed edycją. To nie jest przesadna ostrożność, tylko prosty sposób na porównanie danych przed i po imporcie.
W pliku aktualizacyjnym powinny znaleźć się identyfikatory produktów oraz pola, które faktycznie mają się zmienić. Nie ma potrzeby przerabiać całego katalogu, jeśli chcesz zaktualizować tylko ceny kilku grup produktów. Mniejszy zakres oznacza mniej miejsc, w których może wydarzyć się coś nieprzewidzianego.
WooCommerce może dopasować istniejące produkty po ID albo SKU. To właśnie dlatego stabilny identyfikator jest tak ważny. Jeśli identyfikator nie pasuje do produktu w sklepie, rekord może zostać pominięty albo nie zostanie przypisany do właściwego produktu.
Co umieścić w pliku aktualizacyjnym
Przygotuj co najmniej:
- ID albo SKU produktu;
- kolumnę z ceną regularną, jeśli zmieniasz cenę podstawową;
- kolumnę z ceną promocyjną, jeśli aktualizujesz promocję;
- kolumnę z opisem, jeśli zmieniasz treść;
- kolumnę SKU, jeśli identyfikatory mają zostać poprawione.
W importerze wybierz opcję aktualizacji istniejących produktów, czyli Update existing products. Następnie sprawdź mapowanie kolumn i dopasowanie po ID albo SKU. Nie klikaj dalej tylko dlatego, że przycisk jest pod ręką. Po imporcie porównaj ceny, opisy i SKU z wcześniejszym eksportem. Przed całą operacją wykonaj kopię zapasową sklepu.
Przenoszenie katalogu do innego sklepu
CSV może być użyty do migracji produktów WooCommerce. Schemat jest prosty: eksportujesz katalog ze starego sklepu, porządkujesz plik, a następnie importujesz go w sklepie docelowym. Ten sam mechanizm może służyć do importu, eksportu, aktualizacji i scalania danych produktów między sklepami.
Najważniejsze słowo brzmi tutaj: „zgodność”. Przed migracją sprawdź kategorie, atrybuty, SKU, warianty i obrazy. Sklep docelowy musi umieć odczytać dane w sposób zgodny z tym, jak zostały przygotowane. Sam eksport tekstu nie gwarantuje, że zdjęcia, warianty i dodatkowe pola pojawią się bez dalszej pracy.
Co może wymagać dodatkowego sprawdzenia
Standardowe dane prostych produktów można obsłużyć wbudowanym importerem, ale większej uwagi wymagają:
- warianty oraz relacja produktu wariantowego z produktem nadrzędnym;
- zgodność SKU i atrybutów;
- obrazy dostępne w bibliotece mediów albo pod bezpośrednimi adresami URL;
- pola dodawane przez wtyczki;
- dane zależne od konfiguracji konkretnego sklepu.
Jeśli katalog jest ważny dla sprzedaży, testuj migrację na stagingu albo kopii testowej. Dopiero gdy ceny, opisy, zdjęcia, warianty i stany magazynowe wyglądają poprawnie, przechodź do właściwego sklepu.
Duży katalog i warianty — tu najłatwiej o bałagan
Duży import zależy od pamięci serwera, limitów wysyłania plików i czasu potrzebnego na przetworzenie danych. Nie ma jednej uniwersalnej liczby produktów, którą można bezpiecznie wrzucić w każdej konfiguracji. To zależy od konkretnego hostingu i sklepu.
Dlatego duży katalog podziel na mniejsze partie. Najpierw zaimportuj małą próbkę, sprawdź efekt, a dopiero później zwiększaj zakres. Taki proces jest mniej widowiskowy niż wrzucenie wszystkiego naraz, ale za to łatwiej znaleźć moment, w którym coś poszło nie tak.
Warianty bez zgadywania
Produkty wariantowe wymagają zgodności kilku elementów. Sprawdź, czy SKU są poprawne, pole Parent wskazuje właściwy produkt nadrzędny, a jego atrybuty pasują do danych wariantów. Jeśli jeden z tych elementów się nie zgadza, importer może nie zbudować katalogu tak, jak oczekujesz.
Przed importem wykonaj kopię zapasową i przeprowadź test na stagingu albo kopii testowej. W trakcie działania importera nie odświeżaj strony i nie opuszczaj ekranu importu, ponieważ może to przerwać operację.
Najczęstsze błędy przy imporcie CSV
Najwięcej problemów wynika nie z samego WooCommerce, ale z drobiazgów w pliku. Najczęstsze punkty kontrolne to:
- brak kodowania UTF-8;
- złe albo nierozpoznane nagłówki kolumn;
- pominięcie mapowania na właściwym polu;
- brak poprawnego ID lub SKU przy aktualizacji;
- nieprawidłowe wartości cen, kategorii, statusów albo wariantów;
- obrazy pod niedostępnymi lub niebezpośrednimi adresami;
- plik zbyt duży dla limitów serwera;
- pola dodatkowych wtyczek, których standardowy importer nie obsługuje.
Nie zakładaj, że brak komunikatu o błędzie oznacza pełny sukces. Po imporcie sprawdź faktyczny wygląd produktów, log importu oraz dane, które miały zostać zmienione.
Co sprawdzić, gdy część produktów zniknęła z importu
Najpierw sprawdź, czy wybrano aktualizację istniejących produktów. Potem porównaj ID albo SKU w pliku z danymi w sklepie. Kolejny krok to kontrola mapowania kolumn i rozmiaru pliku. Jeśli import był duży, podziel go na mniejsze partie i sprawdź każdą osobno.
W przypadku danych dodawanych przez wtyczki zajrzyj do dokumentacji używanego rozszerzenia. Standardowy CSV nie musi przenosić niestandardowych pól tylko dlatego, że zostały dopisane do arkusza.
Checklista przed kliknięciem „Uruchom importer”
Przed startem przejdź przez krótką listę kontrolną. Dzięki temu nie będziesz później zastanawiać się, czy cena zniknęła przez plik, mapowanie, czy może przez zwykłe przeoczenie.
- Wykonaj kopię zapasową sklepu.
- Przygotuj małą próbkę produktów.
- Przetestuj import na stagingu albo kopii testowej.
- Sprawdź kodowanie UTF-8 i nagłówki kolumn.
- Zweryfikuj mapowanie pól.
- Przy aktualizacji sprawdź ID albo SKU oraz opcję aktualizacji istniejących produktów.
- Po imporcie skontroluj ceny, opisy, obrazy, warianty, stany magazynowe i statusy publikacji.
- Przy większym katalogu podziel plik na mniejsze partie.
- Nie odświeżaj strony podczas trwania importu.
Samodzielnie czy z pomocą
Prosty import standardowych danych można zaplanować na podstawie eksportu i małej próbki. Im większy katalog, więcej wariantów i więcej pól zależnych od wtyczek, tym ważniejsze staje się dokładne sprawdzenie konfiguracji sklepu. Nie chodzi o to, żeby bać się CSV. Chodzi o to, żeby nie traktować go jak przycisku „napraw wszystko”.
Jeśli dane są uporządkowane, identyfikatory pasują, a test przeszedł poprawnie, masowa aktualizacja może mocno ograniczyć ręczne klikanie. Jeśli natomiast katalog jest niejednorodny, lepiej najpierw uporządkować plik i ustalić, które dane są standardowe, a które pochodzą z dodatkowych rozszerzeń.
CSV WooCommerce potrafi oszczędzić mnóstwo pracy przy dodawaniu, aktualizacji i przenoszeniu produktów, ale bez przygotowania łatwo o pominięte rekordy, złe ceny albo brakujące zdjęcia. Najbezpieczniejszy schemat jest prosty: kopia zapasowa, mała próbka, poprawne UTF-8, sprawdzone ID lub SKU, mapowanie kolumn i kontrola efektu. Przy większym katalogu dochodzi podział na partie oraz osobna weryfikacja wariantów i pól z wtyczek. Masz stronę, sklep albo materiały graficzne, które proszą się o ogarnięcie? Napisz do INB Marketing i zobaczymy, co da się z tym sensownie zrobić.
