Doskonałe opanowanie importu produktów do WooCommerce: najlepszy przewodnik od plików CSV do niestandardowych produktów.

Czemu potrzebny jest profesjonalny narzędzie do importu produktów w systemie WooCommerce?

Wraz z rozszerzaniem się skali sklepów online staje się coraz bardziej nierealne dodawanie produktów manualnie, po jednym. Bez względu na to, czy chodzi o migrację danych z istniejącego sklepu, masową aktualizację cen towarów czy pobieranie list produktów od dostawców, ważna jest efektywna funkcja importu danych. WooCommerce sam w sobie oferuje podstawowe narzędzia do importu, które wystarczą do obsługi prostych scenariów, ale przy obszarach złożonych, takich jak różne typy produktów, ustawione przez użytkownika pola oraz duże ilości danych, programiści muszą korzystać z bardziej zorganizowanych i potężniejszych metod.

Używanie właściwych narzędzi i metod przy importowaniu produktów nie tylko pozwala zaoszczędzić dużo czasu, ale także znacząco zmniejsza ryzyko błędów ludzkiej natury oraz gwarantuje spójność danych. Bez względu na to, czy mówimy o standardowych, prostych produktach, produktach zmiennych, czy o zaawansowanych typach produktów, takich jak abonamenty czy pakety, dobrze zorganizowany proces importu stanowi klucz do automatyzacji działania e-sprzedaży. W tym artykule dokładnie opisany jest cały proces – od przygotowania standardowych plików CSV po obsługę produktów dostosowanych za pomocą programowania.

Przygotuj standardny plik w formacie CSV do masowego importu.

WooCommerce posiada w sobie funkcję importu produktów za pomocą plików CSV, co jest najpopularniejszym i najprostszym sposobem na realizację operacji masowych. Kluczowym elementem jest przygotowanie pliku CSV w formacie odpowiadającym wymaganiom WooCommerce.

Polecamy lekturę. Rozwoj stron e-handlowych na platformie WooCommerce: Stworzenie swojego sklepu online od zera。

Zrozumienie kluczowych kolumn danych produktu

Podstawowy plik CSV do importu musi zawierać kilka kluczowych kolumn.ID和TypeKolumny są najważniejsze.IDWykorzystuje się do porównania z istniejącymi produktami w celu ich aktualizacji; jeśli pole zostanie pozostawione puste, zostanie utworzony nowy produkt.TypeWtedy są określone typy produktów, np.simple(Proste produkty),variableProduktów zmiennych (%s).grouped(Grupy produktów) itd. Inne podstawowe kolumny obejmują:SKU( Jednostka magazynowania )Name(Nazwa produktu)PublishedStan publikacji: 1 oznacza, że materiał został udostępniony do oglądania.Description(Opis)Regular price(w cenie standardowej) a takżeStock(Ilość na stoku).

UltaHost – hostingu dla stron WordPress

Gwarancja zwrotu pieniędzy w ciągu 30 dni, nieograniczony przepustowość sieci i dostęp do bazy danych, bezpłatna ochrona przed atakami typu DDoS. Promocja: 50% przy zakupie na 3 lata.

strona dostępu

W przypadku produktów zmiennych proces importu składa się z dwóch kroków: najpierw importuje się produkt rodzicielski, a potem jego odmiany.TypeUwzględniono jako…variablepodwariantTypeUwzględniono jako…variationI poprzez…ParentKolumna określa SKU produktu rodzicowego, aby ustanowić powiązanie.

Obsługa kategorii, tagów oraz zdjęć

Imporcie kategorii i tagów musi używać się określonego formatu. Jeśli chodzi o kategorii produktów, można to zrobić w następujący sposób:CategoriesW kolumnach używa się formatu “rodzina kategorii > podkategoria”; kilka kategorii są oddzielone kropkami. Na przykład: “Odzież > Koszule; Nowe produkty letnie”. Tagi są umieszczone…TagsW kolumnach elementy są rozdzielone angielskimi komarami.

Importowanie zdjęć produktów jest względnie elastyczne. Można to zrobić na różne sposoby…ImagesW polu należy podać URLy zdjęć; kilka URL-ów należy oddzielić kropkami. Pierwszy URL zostanie użyty jako zdjęcie główne. Podczas importu w WooCommerce próbuje się te zdjęcia pobrać i zapisać do biblioteki mediów. Można też wcześniej załadować zdjęcia na serwer za pomocą protokołu FTP do określonego katalogu, a potem w pliku CSV używać względnych adresów do tych zdjęć.

Poniżej znajduje się przykład pliku CSV zawierającego informacje o standardowym, prostym produkcie:

Polecamy lekturę. Przewodnik po WooCommerce: pełny guide do budowy profesjonalnego e-sklepu od zera。

ID,Type,SKU,Name,Published,Description,Regular price,Stock,Categories,Images
,simple,T-SHIRT-SM,纯棉简约T恤,1,这是一件舒适的纯棉T恤。,29.99,100,服饰 > 上衣,https://example.com/tshirt.jpg

Używanie WP CLI do realizacji zaawansowanej automatyzacji procesów importu

Dla programistów i doświadczonych użytkowników: narzędzia linii poleceń WordPressWP-CLIZaproponowano bardziej wydajny i skryptowalny sposób importu danych. Jest on szczególnie przydatny do integracji z procesami wdrożenia lub do obsługi bardzo dużych zbiorów danych.

„Bazowy sposób przekroczenia…”wp-cliPolecenie do importu pliku w formacie CSV to:

wp import products.csv --authors=skip

Ale bardziej powszechnym sposobem jest używanie własnych skryptów. Możemy napisać skrypt w języku PHP, który wykorzysta odpowiednie funkcje do realizacji potrzeb.WP-CLI的wp eval-fileKomendy są używane do wykonywania zadań. Serce skriptu stanowi właśnie wykorzystanie tych komend.wc_get_product_objectFunkcja tworzy obiekt produktu i ustawia dla niego odpowiednie atrybuty.

hosting.com Hosting współdzielony

Wysoka wydajność dzięki procesorom AMD EPYC, pamięci masowej NVMe SSD i LiteSpeed, wewnętrzne wsparcie ekspertów 24/7, zaawansowane środki bezpieczeństwa, w tym SSL, brute force, ochrona przed złośliwym oprogramowaniem i DDoS, oszczędność do 73%

strona dostępu

Poniżej znajduje się przykład skryptu PHP, który umożliwia stworzenie prostego produktu za pomocą programowania:

<?php
// 读取CSV数据
$csvFile = 'products.csv';
if (($handle = fopen($csvFile, 'r')) !== FALSE) {
    $header = fgetcsv($handle); // 读取标题行
    while (($data = fgetcsv($handle)) !== FALSE) {
        $productData = array_combine($header, $data);

// 创建产品对象
        $product = new WC_Product_Simple();
        $product->set_name($productData['Name']);
        $product->set_sku($productData['SKU']);
        $product->set_regular_price($productData['Regular price']);
        $product->set_description($productData['Description']);
        $product->set_stock_quantity($productData['Stock']);
        $product->set_status($productData['Published'] == 1 ? 'publish' : 'draft');

// 处理分类
        $categoryNames = explode(';', $productData['Categories']);
        $categoryIds = [];
        foreach ($categoryNames as $catName) {
            $term = term_exists(trim($catName), 'product_cat');
            if (!$term) {
                $term = wp_insert_term(trim($catName), 'product_cat');
            }
            if (!is_wp_error($term)) {
                $categoryIds[] = (int)$term['term_id'];
            }
        }
        $product->set_category_ids($categoryIds);

$product->save();
        echo "产品已创建/更新: " . $productData['Name'] . " (ID: " . $product->get_id() . ")n";
    }
    fclose($handle);
}
?>

Zapisz powyższy skrypt w formacieimport_products.phpPóźniej można to zrobić za pomocą poleczenia.wp eval-file import_products.phpWykonaj.

Wykorzystanie WP CLI do obsługi złożonych zależności

WP-CLISilna strona tego rozwiązania polega na możliwości obsługi złożonej logiki. Na przykład, przy importowaniu produktów zmiennych oraz ich atryb można najpierw utworzyć globalne atryby, a potem przypisać je produktom i generować różne wersje tych produktów. Poprzez pisanie skryptów można precyzyjnie kontrolować obsługę błędów oraz nagrywanie logów w każdym etapie procesu, co umożliwia w pełni automatyzowaną realizację procesu importu. W przypadkach, gdy konieczna jest synchronizacja z zewnętrznymi API (np. systemami ERP lub systemami dostawców), można to połączyć z tym rozwiązaniem.WP-CLIRozwiązaniem najbardziej idealnym jest wykorzystanie zadań planowanych (Cron Job).

Programowanie umożliwia obsługę kustomizowanych produktów oraz metadanych.

Gdy standardowe kolumny pliku CSV nie wystarczają do zrealizowania potrzeb, np. w przypadku konieczności importu dodatkowych, dostosowanych poli, typów produktów utworzonych za pomocą third-party pluginów (np. produktów rezerwowanych) lub złożonych metadanych, konieczna jest obrada danych za pomocą programowania.

Tworzenie i aktualizacja produktów z polami dostosowanymi (custom fields)

Wszelkie standardowe dane produktów w WooCommerce (np. ceny, ilość na magazynie) oraz dane dostosowane (dodane za pomocą modułu ACF lub innych metod) są w końcu przechowywane w postaci metadanych (Post Meta). Kluczowym elementem procesu importu programowym jest prawidłowe ich używanie.set_Metody serii iupdate_post_metaFunkcja.

Przyjmiemy, że mamy coś nazwanego…custom_batch_numberUdostępniony jest polu dostosowane, a następny kod pokazuje, jak go ustawić podczas tworzenia produktu:

Hosting współdzielony InterServer

Hosting współdzielony $2.50 USD miesięcznie, pierwszy miesiąc $0.1 USD kod promocyjny tryinterserver, 461 skryptów aplikacji w chmurze, instalacja jednym kliknięciem.

strona dostępu

// 假设 $product 是一个 WC_Product 对象
$product->set_name('高级定制产品');
$product->set_regular_price(99.99);
$product->save(); // 必须先保存产品以获得ID

// 更新自定义字段（产品元数据）
$product_id = $product->get_id();
update_post_meta($product_id, 'custom_batch_number', 'BATCH-2026-001');
update_post_meta($product_id, '_custom_field', 'value'); // 下划线开头表示隐藏的元数据

Warto zaznaczyć, że niektóre dodatki (plug-iny) dostępne od stron trzecich mogą definiować własne klasy typów produktów. Podczas tworzenia takich produktów należy używać właśnie tych klasy.new WC_Product_Booking()I wywołuje określony metod dostępny w pluginie.

Rozszerz funkcję importu za pomocą hooków w WooCommerce

Aby w procesie importu włączyć własną logikę, WooCommerce oferuje wiele „hooków” (zdarzeń programowych). Dwa kluczowe hooky to:woocommerce_new_product和woocommerce_update_productWywoływają się odpowiednio po stworzeniu produktu oraz po jego aktualizacji.

Na przykład po imporcie produktu można automatycznie przypisać mu status wewnętrznej weryfikacji.

add_action('woocommerce_new_product', 'my_post_import_actions', 10, 2);
add_action('woocommerce_update_product', 'my_post_import_actions', 10, 2);

function my_post_import_actions($product_id, $product) {
    // 自动为所有新导入的产品添加“待审核”标记
    update_post_meta($product_id, '_internal_review_status', 'pending');

// 或者根据特定条件进行处理
    if (strpos($product->get_sku(), 'PREMIUM') !== false) {
        wp_set_object_terms($product_id, 'premium', 'product_tag', true);
    }
}

Ponadto, elementy hooka filtrów (filter hook elements)woocommerce_product_import_pre_insert_product_objectMoże być również bardzo przydatne, ponieważ umożliwia nam modyfikację danych produktów przed ich wprowadzeniem do bazy danych. To przydatne w przypadku potrzeby jednolitego formatowania cen, konwertowania jednostek miary lub sprawdzania zgodności danych z wymaganiami.

Podsumowanie.

Import produktów w systemie WooCommerce to umiejętność, która może być od łatwej do zaawansowanej i wymagająca różnych poziomów doświadczenia. Podstawa stanowi znajomość standardowego formatu plików CSV, który jest przydatny przy większości operacji masowych aktualizacji i migracji danych. Jeśli natomiast mamy do czynienia z powtarzającymi się zadанияmi lub koniecznością integracji z procesami rozwoju aplikacji, potrzebny jest dalszy rozwój tych umiejętności.WP-CLIAutomatyzacja w linii komend pokazuje swoją siłę. W przypadku sklepów wyjątkowo dostosowanych, gdzie są używane pola dostosowane, dane z pluginów third-party lub złożona logika biznesowa, połączenie programowania z hookami w WooCommerce daje maksymalną elastyczność i kontrolę. Skuteczne strategie importu często wykorzystują połączenie tych narzędzi: CSV do obsługi rutynowych operacji masowych, a skrypty do zadań złożonych i specjalnych wymagań. Kluczowym elementem jest głębokie zrozumienie struktury danych w WooCommerce, a także regularne tworzenie kopii wszystkich dostępnych danych przed każdą operacją.

FAQ – najczęściej zadawane pytania.

Jak poradzić sobie z specjalnymi znakami i problemami związanymi z kodowaniem w plikach CSV?

Upewnij się, że plik CSV jest zapisany w kodowaniu UTF-8 – to jedyny format, który jest w pełni obsługiwany przez oficjalny importer do WooCommerce. Jeśli w danych znajdują się specjalne znaki, takie jak komendy, ułamki lub znaki nawroty linii, całe wartości pola muszą być umieszczone w nawodnikiach angielskich.

Na przykład, jeśli w opisie znajdują się komendy, należy je zapisać w taki sposób, by były oddzielone kropkami.“这是一件优质，舒适的产品”Zaleca się sprawdzić w edytorze tekstu, czy wszystkie pola mają parne nawodniki – to kluczowy krok, aby uniknąć błędów podczas importu.

Co robić, jeśli przy importowaniu produktów z możliwością zmiany atrybutów te atrybuty nie są wyświetlone lub tworzenie wariantów produktów się nie udaje?

Zwykle problem dotyczy formatu pliku CSV lub kolejności importu. Najpierw upewnij się, że ustawiłeś globalne właściwości poprawnie. Podczas importu produktów rodzicielskich…Type: variableGdy to jest konieczne, należy…Attribute 1 name和Attribute 1 value(s)Atryby są definiowane w równych kolumnach, na przykład:颜色和红色,蓝色。

Następnie: importowanie wariantów (…)Type: variationGdy to jest konieczne, należy to zrobić poprzez…ParentKolumny muszą zawierać dokładne referencje do SKU produktów rodzicielskich.Attribute: 颜色W takiej kolumnie określa się konkretną wartość atrybutu tej variacji (np.红色Na koniec, po zakończeniu importu, należy wejść na kartę “Variants” (Warianty) produktu i kliknąć na “Create Variant” (Utworzyć wariant) lub “Save Changes” (Zapisać zmiany), aby system wygenerował wszystkie możliwe kombinacje wariantów na podstawie ustawionych atrybutów.

Jak poprawnie ustawić zdjęcia produktów za pomocą programowania?

Ustawianie zdjęć produktów w programie jest nieco bardziej złożone niż podanie adresów URL w pliku CSV. Kluczowe kroki to: najpierw pobranie pliku zображenia i jego upload do biblioteki mediów w WordPress, uzyskanie ID tego pliku, a następnie przypisanie tego ID produktowi.

Można to użyć.media_sideload_imageFunkcja pobiera zdjęcie z URL i tworzy załącznik. Przykład kodu jest następujący:

$image_url = 'https://example.com/product.jpg';
$attach_id = media_sideload_image($image_url, $product_id, '产品图片描述', 'id');
if (!is_wp_error($attach_id)) {
    // 设置为主图
    set_post_thumbnail($product_id, $attach_id);
    // 如需加入产品图库
    // $gallery_ids = array($attach_id);
    // update_post_meta($product_id, '_product_image_gallery', implode(',', $gallery_ids));
}

Jak postępować, jeśli witryna internetowa przestaje odpowiadać („timeout”) lub dochodzi do wyczerpania pamięci podczas importu dużej liczby produktów?

To wynika z ograniczeń czasu wykonywania operacji na serwerze oraz limitów pamięci. Podczas importu dużych ilości danych konieczne jest unikanie korzystania z interfejsu administracyjnego WordPress i zamiast tego używać innych narzędzi lub metod.WP-CLIProgram narzędziowy dla linii komendowej, ponieważ nie jest podległy ustawieniom czasu wykonywania w PHP.

Na poziomie skryptów można zastosować strategię obsługi danych w partiach. Na przykład można za każdym razie odczytać i przetworzyć 100 rekordów z pliku CSV, a po zakończeniu tego procesu…sleep(1)Zrób krótką przerwę i połącz to z odpowiednią akcją/działaniem.wp_cache_flush()Wymazuj cache, aby zwolnić pamięć. Ponadto, przed uruchomieniem skriptu importu, można…wp-config.phpDodano tymczasowe ograniczenie ilości pamięci:define('WP_MEMORY_LIMIT', '512M');W przypadku importu produktów w liczbie od kilku dziesiętych tysięcy do nawet kilku setek tysięcy, zaleca się bezpośrednio manipulować bazą danych lub skorzystać z bardziej profesjonalnych narzędzi do migracji danych.