Hoàn toàn làm chủ việc nhập sản phẩm WooCommerce: Hướng dẫn tối thượng từ tệp CSV đến sản phẩm tùy chỉnh

Tại sao lại cần những công cụ chuyên dụng để nhập dữ liệu sản phẩm vào hệ thống WooCommerce?

Khi quy mô của các cửa hàng trực tuyến ngày càng tăng, việc thêm sản phẩm một cách thủ công, từng sản phẩm một trở nên không còn khả thi. Dù là việc di chuyển dữ liệu từ cửa hàng hiện có, cập nhật giá hàng tồn kho hàng loạt, hay lấy danh sách sản phẩm từ nhà cung cấp, các công cụ nhập dữ liệu hiệu quả đều rất quan trọng. WooCommerce cung cấp những công cụ nhập dữ liệu cơ bản để xử lý các trường hợp đơn giản, nhưng khi đối mặt với các loại sản phẩm phức tạp, các trường tùy chỉnh hoặc lượng dữ liệu lớn, các nhà phát triển cần sử dụng những phương pháp có hệ thống và mạnh mẽ hơn.

Việc sử dụng đúng công cụ và phương pháp để nhập dữ liệu sản phẩm không chỉ giúp tiết kiệm nhiều thời gian mà còn giảm thiểu tối đa nguy cơ sai sót do con người, đồng thời đảm bảo tính nhất quán của dữ liệu. Dù là sản phẩm đơn giản, sản phẩm có thể thay đổi, hay các loại sản phẩm nâng cao như sản phẩm theo gói đăng ký (subscription) hay bán kèm (bundle), một quy trình nhập dữ liệu được thiết kế tốt chính là nền tảng cho việc tự động hóa hoạt động kinh doanh trực tuyến. Bài viết này sẽ tìm hiểu chi tiết toàn bộ quy trình, từ việc chuẩn bị các tệp CSV tiêu chuẩn cho đến việc xử lý các sản phẩm tùy chỉnh thông qua lập trình.

Hãy chuẩn bị một tệp CSV chuẩn để thực hiện việc nhập dữ liệu theo lô (batch import).

WooCommerce có tính năng nhập sản phẩm thông qua các tệp CSV, đây là phương thức thực hiện các thao tác hàng loạt phổ biến và trực tiếp nhất. Trọng tâm của việc này là chuẩn bị một tệp CSV theo định dạng yêu cầu của WooCommerce.

Đọc thêm Phát triển website thương mại điện tử WooCommerce: Xây dựng cửa hàng trực tuyến của bạn từ con số 0。

Hiểu rõ các cột dữ liệu của sản phẩm chính

Một tệp CSV được nhập vào một cách cơ bản phải chứa một số cột quan trọng. Trong đó,ID和TypeCột (column) là yếu tố quan trọng nhất.IDDùng để tìm kiếm sản phẩm hiện có nhằm thực hiện việc cập nhật; nếu để trống, sản phẩm mới sẽ được tạo ra.TypeĐiều này định nghĩa các loại sản phẩm, ví dụ như…simple(Sản phẩm đơn giản)variable(Sản phẩm có thể thay đổi)grouped(Sản phẩm được phân nhóm), v.v. Các cột cơ bản khác bao gồm…SKU(Đơn vị lưu trữ hàng hóa)Name(Tên sản phẩm),Published(Tình trạng phát hành: 1 là đã được phát hành)Description(Mô tả)Regular price(Giá thông thường) vàStock(Số lượng hàng tồn kho).

UltaHost – Nhà cung cấp dịch vụ máy chủ WordPress chuyên nghiệp

Bảo đảm hoàn tiền trong 30 ngày, băng thông và cơ sở dữ liệu không giới hạn, bảo vệ DDoS miễn phí, mua 3 năm ưu đãi 50%

Truy cập trang

Đối với các sản phẩm có thể được biến đổi, quá trình nhập dữ liệu được chia thành hai bước: trước tiên là nhập dữ liệu của sản phẩm chính (sản phẩm cha), sau đó là nhập dữ liệu của các biến thể con của nó.TypeĐược liệt kê làvariable, biến thể conTypeĐược liệt kê làvariationvà thông quaParentCột này chỉ định mã sản phẩm (SKU) của sản phẩm cha để thiết lập mối liên kết.

Xử lý phân loại, thẻ mô tả và hình ảnh

Việc nhập dữ liệu về phân loại và thẻ (categories/tagging) cần tuân theo một định dạng cụ thể. Đối với phân loại sản phẩm, bạn có thể…CategoriesTrong cột, hãy sử dụng định dạng “Thể loại cha > Thể loại con”; các thể loại khác nhau được phân cách bằng dấu phẩy (“;”). Ví dụ: “Quần áo > Áo sơ mi; Sản phẩm mới mùa hè”. Các thẻ (tags) thì được đặt ở…TagsCác mục trong hàng được phân cách bằng dấu phẩy (,) trong tiếng Anh.

Việc nhập ảnh sản phẩm khá linh hoạt; bạn có thể thực hiện điều này thông qua các phương thức khác nhau.ImagesCột này dùng để chỉ định URL của hình ảnh; nhiều URL có thể được phân cách bằng dấu phẩy (,). URL đầu tiên sẽ được sử dụng làm hình ảnh chính. Khi nhập dữ liệu vào WooCommerce, hệ thống sẽ cố gắng tải các hình ảnh này xuống và lưu chúng vào thư viện media. Một phương pháp khác là tải hình ảnh lên máy chủ thông qua FTP trước, sau đó trích dẫn đường dẫn tương đối của chúng trong tệp CSV.

Ví dụ về tệp CSV cho một sản phẩm tiêu chuẩn và đơn giản như sau:

Đọc thêm Hướng dẫn WooCommerce: Hướng dẫn đầy đủ để xây dựng một trang web thương mại điện tử chuyên nghiệp từ đầu。

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

Sử dụng WP CLI để thực hiện tự động hóa quá trình nhập dữ liệu ở cấp độ nâng cao

Đối với các nhà phát triển và người dùng nâng cao, WordPress cung cấp nhiều công cụ dòng lệnh (command-line tools) hữu ích.WP-CLICung cấp phương thức nhập dữ liệu mạnh mẽ và có thể được tự động hóa bằng script (lệnh). Phương thức này rất phù hợp để tích hợp vào quy trình triển khai hoặc xử lý các tập dữ liệu có quy mô cực lớn.

Một phương pháp cơ bản để thực hiện điều đó là…wp-cliLệnh để nhập dữ liệu từ tệp CSV như sau:

wp import products.csv --authors=skip

Nhưng phương pháp phổ biến hơn là sử dụng các script tùy chỉnh. Chúng ta có thể viết một script PHP để tận dụng những tính năng cần thiết.WP-CLI的wp eval-fileLệnh được sử dụng để thực thi các tác vụ. Trọng tâm của script là việc sử dụng các lệnh này một cách hiệu quả.wc_get_product_objectHàm tạo ra đối tượng sản phẩm và thiết lập các thuộc tính cho nó.

Hosting.com - lưu trữ chia sẻ

Hiệu năng cao, được trang bị CPU AMD EPYC, lưu trữ SSD NVMe và LiteSpeed, hỗ trợ chuyên gia nội bộ 24 giờ/ngày, các biện pháp bảo mật tiên tiến bao gồm SSL, chống brute force, phần mềm độc hại và bảo vệ DDoS, tiết kiệm tới 73%.

Truy cập trang

Dưới đây là một ví dụ về script PHP sử dụng phương pháp lập trình để tạo ra một sản phẩm đơn giản:

<?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);
}
?>

Hãy lưu đoạn mã trên thành tệp có phần mở rộng `.js`. Ví dụ, bạn có thể đặt tên tệp là `myScript.js`.import_products.phpSau đó, bạn có thể thực hiện các thao tác bằng cách sử dụng các lệnh tương ứng.wp eval-file import_products.phpThực hiện.

Sử dụng WP CLI để xử lý các mối liên kết phức tạp

WP-CLIĐiểm mạnh của nó nằm ở khả năng xử lý các logic phức tạp. Ví dụ, khi nhập các sản phẩm có thể thay đổi cùng với các thuộc tính của chúng, bạn có thể tạo ra các thuộc tính toàn cục trước, sau đó gán chúng cho sản phẩm và tạo ra các biến thể. Bằng cách viết các script, bạn có thể kiểm soát chính xác quá trình xử lý lỗi và ghi nhật ký cho từng bước, từ đó thực hiện quy trình nhập dữ liệu một cách hoàn toàn tự động. Đối với các trường hợp cần đồng bộ dữ liệu với các API bên ngoài (như hệ thống ERP hoặc hệ thống của nhà cung cấp), việc kết hợp công cụ này với các API đó sẽ giúp quá trình hoạt động trở nên hiệu quả hWP-CLISử dụng các tác vụ lập lịch (Cron Jobs) là giải pháp lý tưởng nhất.

Xử lý lập trình cho các sản phẩm tùy chỉnh và dữ liệu siêu dữ liệu (metadata)

Khi các cột trong định dạng CSV tiêu chuẩn không thể đáp ứng được nhu cầu, chẳng hạn như cần nhập các trường tùy chỉnh, các loại sản phẩm được tạo bởi các tiện ích bổ sung của bên thứ ba (như sản phẩm đặt trước), hoặc dữ liệu siêu dữ liệu phức tạp, thì bạn buộc phải sử dụng phương pháp lập trình.

Tạo và cập nhật sản phẩm với các trường tùy chỉnh

Tất cả dữ liệu tiêu chuẩn của sản phẩm WooCommerce (như giá cả, hàng tồn kho) cũng như dữ liệu tùy chỉnh (được thêm vào thông qua ACF hoặc các phương thức khác) đều được lưu trữ dưới dạng siêu dữ liệu (Post Meta). Yếu tố then chốt trong việc nhập dữ liệu bằng phương pháp lập trình là sử dụng chúng một cách chính xác.set_Các phương pháp trong loạt này bao gồm…update_post_metaHàm.

Giả sử chúng ta có một thứ được gọi là…custom_batch_numberĐối với các trường tùy chỉnh, đoạn mã dưới đây minh họa cách thiết lập chúng khi tạo sản phẩm:

Máy chủ chia sẻ của InterServer

Lưu trữ chia sẻ với mức phí $2,50 USD mỗi tháng, giảm giá $0,1 USD trong tháng đầu tiên, mã giảm giá tryinterserver, với 461 ứng dụng đám mây và cài đặt chỉ bằng một cú nhấp chuột.

Truy cập trang

// 假设 $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'); // 下划线开头表示隐藏的元数据

Cần lưu ý rằng một số plugin của bên thứ ba có thể định nghĩa các lớp (classes) riêng để phân loại sản phẩm của họ. Khi tạo các sản phẩm thuộc loại này, bạn nên sử dụng những lớp tương ứng.new WC_Product_Booking()Và gọi phương thức cụ thể được cung cấp bởi plugin đó.

Sử dụng các hook của WooCommerce để mở rộng chức năng nhập dữ liệu (import data).

Để có thể chèn thêm logic tùy chỉnh vào quá trình nhập dữ liệu, WooCommerce cung cấp rất nhiều hook (khớp nối). Hai hook hành động quan trọng là…woocommerce_new_product和woocommerce_update_productChúng được kích hoạt lần lượt sau khi sản phẩm được tạo ra và sau khi sản phẩm được cập nhật.

Ví dụ, sau khi nhập thông tin sản phẩm, chúng ta có thể tự động gán cho chúng một trạng thái kiểm tra nội bộ:

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);
    }
}

Ngoài ra, còn có các hook (các thành phần được sử dụng để kết nối các phần khác nhau của chương trình) dành cho bộ lọc (filters).woocommerce_product_import_pre_insert_product_objectNó cũng vô cùng hữu ích; nó cho phép chúng ta thay đổi dữ liệu của các đối tượng sản phẩm trước khi chúng được lưu vào cơ sở dữ liệu. Điều này rất hữu ích trong việc định dạng giá cả một cách thống nhất, chuyển đổi đơn vị đo lường, hoặc kiểm tra tính hợp lệ của dữ liệu.

Tóm lại

Việc nhập dữ liệu sản phẩm vào hệ thống WooCommerce là một kỹ năng có nhiều cấp độ độ khó, từ đơn giản đến phức tạp. Việc thành thạo cách nhập dữ liệu bằng định dạng CSV tiêu chuẩn là điều kiện cơ bản, vì định dạng này phù hợp với hầu hết các trường hợp cập nhật hàng loạt và di chuyển dữ liệu. Tuy nhiên, khi đối mặt với những nhiệm vụ lặp đi lặp lại hoặc cần tích hợp với quy trình phát triểnWP-CLIViệc tự động hóa các thao tác thông qua dòng lệnh đã chứng minh được sức mạnh của nó. Đối với các cửa hàng được tùy chỉnh một cách sâu rộng, những cửa hàng này có thể chứa các trường dữ liệu được thiết lập riêng, dữ liệu từ các plugin của bên thứ ba, hoặc các logic kinh doanh phức tạp, việc kết hợp các phương pháp lập trình với các hook của WooCommerce mang lại sự linh hoạt và khả năng kiểm soát tối ưu. Các chiến lược nhập dữ liệu hiệu quả thường kết hợp sử dụng nhiều công cụ khác nhau: sử dụng file CSV để xử lý các công việc hàng loạt thông thường, và các script để đáp ứng những yêu cầu phức tạp hoặc được tùy chỉnh. Yếu tố then chốt là phải hiểu rõ cấu trúc dữ liệu của WooCommerce và luôn sao lưu toàn bộ dữ liệu hiện có trước khi thực hiện bất kỳ thao tác nào.

FAQ 常见问题

Làm thế nào để xử lý các ký tự đặc biệt và vấn đề về mã hóa trong tệp CSV?

Hãy đảm bảo rằng tệp CSV được lưu với mã hóa UTF-8; đây là mã hóa duy nhất được trình nhập chính thức của WooCommerce hỗ trợ hoàn toàn. Nếu dữ liệu chứa các ký tự đặc biệt như dấu phẩy, dấu ngoặc kép hoặc dấu xuống dòng, toàn bộ giá trị của trường phải được bao bọc bằng dấu ngoặc kép tiếng Anh.

Ví dụ, khi nội dung mô tả chứa dấu phẩy, nó cần được viết như sau:“这是一件优质，舒适的产品”Đề nghị kiểm tra trong trình soạn thảo văn bản và đảm bảo rằng tất cả các dấu ngoặc đơn trong các trường đều xuất hiện theo cặp; đây là bước quan trọng để tránh lỗi khi nhập dữ liệu.

Khi nhập sản phẩm biến thể, thuộc tính không hiển thị hoặc tạo biến thể thất bại phải làm sao

Đây thường là do định dạng tệp CSV hoặc vấn đề về thứ tự nhập dữ liệu. Trước hết, hãy đảm bảo rằng bạn đã thiết lập đúng các thuộc tính toàn cục (global attributes). Khi nhập dữ liệu của sản phẩm cha (parent product),…Type: variableKhi đó, cần phải…Attribute 1 name和Attribute 1 value(s)Định nghĩa các thuộc tính trong các cột tương ứng, ví dụ như…颜色和红色,蓝色。

Thứ hai, việc nhập các biến thể (…)Type: variationKhi thực hiện điều đó, bạn phải thông qua quy trình hoặc phương thức được quy định.ParentHãy trích dẫn chính xác mã sản phẩm (SKU) của sản phẩm cha trong danh sách các sản phẩm con.Attribute: 颜色Trong những cột như vậy, bạn cần chỉ định giá trị cụ thể của thuộc tính cho biến thể đó (ví dụ:红色Cuối cùng, sau khi quá trình nhập dữ liệu được hoàn tất, bạn cần truy cập vào tab “Biến thể” (Variants) của sản phẩm, sau đó nhấp vào nút “Tạo biến thể” (Create Variants) hoặc “Lưu thay đổi” (Save Changes). Hệ thống sẽ tự động tạo ra tất cả các tổ hợp biến thể có thể có dựa trên các thuộc tính đã được chỉ định.

Làm thế nào để thiết lập đúng cách hình ảnh sản phẩm thông qua lập trình?

Việc thiết lập hình ảnh sản phẩm trong quá trình lập trình phức tạp hơn một chút so với việc chỉ định đường dẫn URL trong tệp CSV. Các bước chính bao gồm: trước tiên, bạn cần tải tệp hình ảnh lên thư viện media của WordPress, sau đó lấy mã ID của tệp hình ảnh đó, và cuối cùng gán mã ID này cho sản phẩm cần hiển thị hình ảnh.

Có thể sử dụngmedia_sideload_imageHàm này tải hình ảnh từ URL và tạo ra một tệp đính kèm (attachment). Đoạn mã ví dụ như sau:

$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));
}

Làm thế nào để xử lý tình trạng trang web bị gián đoạn (timeout) hoặc hết bộ nhớ khi nhập khẩu một lượng lớn sản phẩm?

Điều này là do các giới hạn về thời gian thực thi và dung lượng bộ nhớ trên máy chủ gây ra. Đối với các thao tác nhập dữ liệu quy mô lớn, tuyệt đối không nên thực hiện thông qua giao diện quản trị của WordPress, mà cần sử dụng các công cụ hoặc phương pháp phù hợp khác.WP-CLIĐây là một công cụ dòng lệnh, vì nó không bị ảnh hưởng bởi các thiết lập thời gian hết hạn (timeout) của PHP.

Ở cấp độ script, có thể áp dụng chiến lược xử lý theo từng lô. Ví dụ, mỗi lần đọc và xử lý 100 bản ghi từ tệp CSV, sau khi hoàn tất việc xử lý đó thì tiếp tục với lô tiếp theo.sleep(1)Hãy dừng lại một chút, sau đó hãy phối hợp cùng nhau.wp_cache_flush()Dọn dẹp bộ đệm (cache) để giải phóng bộ nhớ. Ngoài ra, trước khi chạy script nhập dữ liệu (import script), bạn có thể…wp-config.phpTạm thời tăng giới hạn bộ nhớ:define('WP_MEMORY_LIMIT', '512M');Đối với việc nhập dữ liệu cho số lượng sản phẩm lên đến hàng chục nghìn hoặc thậm chí hàng trăm nghìn sản phẩm, khuyến nghị nên thực hiện trực tiếp trên cơ sở dữ liệu hoặc sử dụng các công cụ di chuyển dữ liệu chuyên nghiệp hơn.