點解需要專業嘅WooCommerce產品導入工具
隨住網上商店規模擴大，逐個手動加產品變得越來越唔實際。無論係搬遷現有店舖數據、批量更新庫存同價錢，定係從供應商度攞產品清單，高效嘅數據導入功能都係關鍵。WooCommerce本身提供嘅基本導入工具夠應付簡單情況，但處理複雜產品類型、自訂欄位同大量數據嗰陣，開發者需要掌握更系統化同更強大嘅方法。
用啱嘅工具同方法嚟導入產品，唔單止可以慳返大量時間，仲能夠盡量避免人為錯誤，確保數據一致性。由標準嘅簡單產品、可變產品，到訂閱制同綑綁銷售呢啲高級產品類型，一個結構良好嘅導入流程係電商營運自動化嘅基礎。本文會深入探討從準備標準CSV檔案到透過編程方式處理自訂產品嘅完整流程。
準備標準CSV檔案進行批量導入
WooCommerce內置咗透過CSV檔案嚟導入產品嘅功能，呢個係最常用亦都最直接嘅批量操作方式。佢嘅核心在於準備一個符合WooCommerce預期格式嘅CSV檔案。
推薦閱讀 WooCommerce電商網站開發：從零開始建立你嘅網上商店。
理解核心產品數據欄
一個基礎嘅導入CSV檔案必須包含一啲關鍵欄位。其中，ID同埋Type欄最為重要。ID用嚟配對現有產品以進行更新，如果留空就會創建新產品。Type就定義咗產品類型，例如simple（簡單產品）、variable（可變產品）、grouped（分組產品）等等。其他基本欄位包括SKU（存貨單位）、Name（產品名稱）、Published（發佈狀態，1為發佈）、Description（描述）、Regular price（常規價錢）同埋Stock（存貨數量）。
對於可變產品，導入過程分兩步：首先導入母產品，然後導入其子變體。母產品Type列為variable，子變體Type列為variation，並透過Parent列指定父產品嘅SKU嚟建立關聯。
處理分類、標籤同圖片
分類同標籤嘅導入需要透過特定格式。對於產品分類，可以喺Categories列用「父分類 > 子分類」嘅格式，多個分類用英文分號隔開。例如：「服飾 > 恤衫; 夏季新品」。標籤就喺Tags列入面用英式逗號分隔。
產品圖片嘅導入比較靈活。可以透過Images列指定圖片嘅URL，多個URL用英式逗號分隔，第一個URL會當做主圖。WooCommerce喺導入嗰陣會嘗試將呢啲圖片下載同保存到媒體庫。另一種方法係將圖片預先透過FTP上傳到伺服器嘅特定目錄，然後喺CSV入面引用相對路徑。
一個標準簡單產品嘅CSV文件示例如下：
推薦閱讀 WooCommerce教學：由零開始建立專業網店嘅完整指南。
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使用WP CLI實現高級導入自動化
對於開發者同高級用戶，WordPress命令行工具WP-CLI提供咗更強大、可編寫腳本嘅導入方式。佢特別適合整合到部署流程或者處理極大規模嘅數據集。
一個基本嘅通過wp-cli導入CSV嘅指令如下：
wp import products.csv --authors=skip但更常見嘅做法係用自訂腳本。我哋可以寫一個PHP腳本，利用WP-CLI的wp eval-file指令嚟執行。腳本嘅核心係用wc_get_product_object函數創建產品物件，並為佢設定屬性。
下面係一個用編程方式創建簡單產品嘅PHP腳本示例：
<?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);
}
?>將上面嘅腳本保存做import_products.php之後，可以透過命令wp eval-file import_products.php執行。
利用WP CLI處理複雜關聯
WP-CLI嘅強大之處在於處理複雜邏輯。例如，喺導入可變產品同埋佢哋嘅屬性時，可以首先創建全局屬性，然後將屬性賦予產品並生成變體。通過編寫腳本，可以精確控制每個步驟嘅錯誤處理同埋日誌記錄，實現完全自動化嘅導入流水線。對於需要同外部API（例如ERP或者供應商系統）同步嘅場景，結合WP-CLI同埋計劃任務（Cron Job）係最理想嘅解決方案。
編程處理自訂產品同埋元數據
當標準CSV欄位無法滿足需求時，例如需要導入關聯自訂欄位、第三方插件創建嘅產品類型（例如預訂產品）或者複雜嘅元數據時，就必須採用編程方式。
建立同更新自訂欄位產品
WooCommerce產品嘅所有標準數據（例如價錢、存貨）同自訂數據（透過ACF或者其他方式加入）最終都會作為元數據（Post Meta）儲存。程式導入嘅核心係正確使用set_系列方法同update_post_meta函數。
假設我哋有一個名為custom_batch_number嘅自訂欄位，以下程式碼展示咗點樣喺建立產品時設定佢：
// 假设 $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'); // 下划线开头表示隐藏的元数据需要留意嘅係，某啲第三方插件會定義自己嘅產品類型類。喺建立呢類產品時，應該用相應嘅類，例如new WC_Product_Booking()，同埋調用插件提供嘅特定方法。
使用WooCommerce鉤子擴展導入功能
為咗喺導入過程入面加入自訂邏輯，WooCommerce提供咗大量嘅鉤子（Hook）。兩個關鍵嘅動作鉤子係woocommerce_new_product同埋woocommerce_update_product。佢哋分別喺產品建立同更新之後觸發。
例如，我哋可以喺導入產品之後，自動同佢分配一個內部審核狀態：
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);
}
}另外，過濾器鉤子woocommerce_product_import_pre_insert_product_object亦極為有用，佢容許我哋喺產品物件插入數據庫之前修改其數據，適用於統一格式化價格、轉換計量單位或者驗證數據合規性。
摘要
WooCommerce產品導入係一項由簡單到複雜、層次豐富嘅技能。掌握標準CSV導入係基礎，佢適用於大多數批量更新同遷移場景。當面對重複性任務或者需要同開發工作流程整合嗰陣，WP-CLI嘅命令行自動化就展示咗佢嘅威力。而對於高度定制化嘅商店，涉及自訂欄位、第三方插件數據或者複雜業務邏輯嗰陣，編程方式結合WooCommerce鉤子就提供咗終極嘅靈活性同控制力。成功嘅導入策略往往混合使用呢啲工具：用CSV處理日常批量作業，用腳本應對複雜同定制嘅需求。關鍵在於深入理解WooCommerce嘅數據結構，並喺操作前始終對現有數據進行完整備份。
常見問題
點樣處理CSV檔案入面嘅特殊字符同編碼問題
確保CSV檔案用UTF-8編碼儲存，呢個係WooCommerce官方導入器唯一完全支援嘅編碼。如果數據入面包埋逗號、引號或者換行符呢啲特殊字符，就一定要用英文雙引號成個欄位值包住佢。
例如，描述入面有逗號嗰陣，應該寫成“这是一件优质，舒适的产品”。建議喺文字編輯器度檢查吓，確保所有欄位嘅引號係成對出現嘅，呢個係避免導入出錯嘅關鍵步驟。
導入可變產品嗰陣，屬性唔顯示或者變體建立失敗點算好
呢個通常係CSV格式或者導入順序問題。首先，確保你已經正確設定咗全域屬性。喺導入父產品（Type: variable）嗰陣，需要喺Attribute 1 name同埋Attribute 1 value(s)等列度定義屬性，例如颜色同埋红色,蓝色。
其次，導入變體（Type: variation）嗰陣，必須通過Parent欄準確引用父產品嘅SKU，並喺Attribute: 颜色噉樣嘅欄度指定該變體嘅具體屬性值（例如红色）。最後，導入完成之後，需要進入產品嘅「變體」選項卡，撳「創建變體」或者「保存變更」，系統先會根據屬性生成所有可能嘅變體組合。
點樣用程式方法正確設定產品圖片
用程式設定產品圖片，比起喺CSV檔案入面指定URL會複雜少少。核心步驟係先將圖片檔案上傳到WordPress媒體庫，攞到佢嘅附件ID，然後將呢個ID分配俾產品。
可以用media_sideload_image個函數會從URL下載圖片並建立附件。示例代碼如下：
$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));
}匯入大量產品嗰陣網站超時或者記憶體耗盡點樣處理
呢個係伺服器執行時間限制同記憶體限制造成嘅。對於大規模匯入，千祈唔好通過WordPress後台界面操作，而應該用WP-CLI命令行工具，因為佢唔受PHP超時設定影響。
喺腳本層面，可以採取分批處理策略。例如，每次讀取同處理100條CSV記錄，處理完之後用sleep(1)稍作停頓，並配合wp_cache_flush()清理快取，以釋放記憶體。另外，喺執行匯入腳本之前，可以喺wp-config.php度臨時增加記憶體限制：define('WP_MEMORY_LIMIT', '512M');。對於數萬甚至數十萬級嘅產品匯入，建議直接操作數據庫或者搵更專業嘅數據遷移工具。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。