對於成熟嘅 WooCommerce 網店嚟講，預設嘅商品屬性同庫存管理系統通常難以滿足精細化營運嘅需求。你可能需要對唔同規格嘅同一商品（例如 T 恤嘅顏色同尺碼組合）進行獨立嘅庫存追蹤，或者為商品添加獨特嘅銷售屬性並據此篩選。本文會深入探討點樣透過自訂欄位同掛鉤，擴展 WooCommerce 嘅數據管理能力，實現真正切合業務邏輯嘅高級數據管理。
理解 WooCommerce 嘅核心數據架構
要實現有效嘅自訂，首先必須釐清 WooCommerce 處理商品數據嘅基礎模型。咁樣有助我哋確定喺邊度同點樣注入自訂邏輯。
商品屬性同變體嘅工作原理
WooCommerce 用product_attributes元數據用嚟儲存全局同本地商品屬性。呢啲屬性定義咗商品嘅規格（例如「顏色」、「尺碼」）。當你為商品啟用variable product（可變商品）時，系統會根據呢啲屬性嘅所有可能組合生成product_variation（商品變體）子文章。
推薦閱讀 WooCommerce 電商網站開發同優化完全指南。
每個商品變體都係一個獨立嘅產品文章類型，有自己嘅價格、存貨（_stock）、SKU（_sku）等欄位。關鍵嘅庫存管理邏輯就發生喺變體層面。例如，尺寸為「L」、顏色為「藍色」嘅變體庫存耗盡，唔會影響「M」碼「紅色」變體嘅庫存狀態。
內置元欄位嘅局限性
默認情況下，WooCommerce 為每件商品（包括簡單商品同變體）提供咗一套預定義嘅元欄位，例如_price, _regular_price, _sale_price, _stock, _stock_status, _manage_stock等等。不過，如果你需要追蹤「唔同渠道嘅存貨」、「批次編號」或者「商品嘅自訂材質」呢啲資料，呢啲欄位就遠遠唔夠啦。
呢個時候，我哋就需要透過 WordPress 嘅元數據（Meta Data）API 同 WooCommerce 特定嘅鉤子，嚟加同利用自訂欄位，將呢啲新數據無縫整合到商品嘅增、刪、改、查同埋前台展示嘅整個流程入面。
為商品加自訂屬性欄位
創建新嘅商品屬性，例如「布料成分」或者「產地」，可以大大豐富商品描述同篩選能力。我哋將會分後端管理同前台展示兩部分嚟實現。
喺管理後台註冊並顯示新欄位
為咗等店舖管理員可以方便咁輸入呢啲新屬性，我哋需要將自訂欄位加到產品編輯頁面。呢個通常係透過woocommerce_product_options_general_product_data同埋woocommerce_product_after_variable_attributes等動作鉤子嚟完成。
推薦閱讀 WordPress插件開發指南：手把手教你從零到一打造自己嘅插件。
以下係一個示例，為所有產品加一個「生產批次號」嘅文字框。呢段代碼應該加到主題嘅functions.php喺文件入面或者自訂插件度。
add_action( 'woocommerce_product_options_inventory_product_data', 'add_custom_batch_field' );
function add_custom_batch_field() {
global $product_object;
woocommerce_wp_text_input( array(
'id' => '_custom_batch_number',
'label' => __( '生产批次号', 'your-textdomain' ),
'desc_tip' => true,
'description' => __( '用于追溯商品生产来源的唯一编号。', 'your-textdomain' ),
'value' => $product_object->get_meta( '_custom_batch_number', true ),
) );
}對於可變商品，如果你希望為每個獨立嘅變體設定唔同嘅批次號，就需要將欄位加到變體設定面板。
add_action( 'woocommerce_variation_options_inventory', 'add_custom_field_to_variation', 10, 3 );
function add_custom_field_to_variation( $loop, $variation_data, $variation ) {
woocommerce_wp_text_input( array(
'id' => "_custom_batch_number_{$loop}",
'name' => "_custom_batch_number[{$loop}]",
'label' => __( '变体批次号', 'your-textdomain' ),
'desc_tip' => true,
'description' => __( '该特定变体的生产批次。', 'your-textdomain' ),
'value' => get_post_meta( $variation->ID, '_custom_batch_number', true ),
'wrapper_class' => 'form-row form-row-full',
) );
}保存自訂欄位嘅數值
只係顯示輸入框係唔夠嘅，我哋仲需要喺用戶撳「保存」或者「更新」嗰陣，將輸入嘅數值儲存到對應商品嘅文章元數據入面。呢個需要用到woocommerce_process_product_meta同埋woocommerce_save_product_variation鉤子。
// 保存简单商品的批次号
add_action( 'woocommerce_process_product_meta', 'save_custom_batch_field' );
function save_custom_batch_field( $product_id ) {
$batch_number = isset( $_POST['_custom_batch_number'] ) ? sanitize_text_field( $_POST['_custom_batch_number'] ) : '';
update_post_meta( $product_id, '_custom_batch_number', $batch_number );
}
// 保存变体商品的批次号
add_action( 'woocommerce_save_product_variation', 'save_variation_custom_field', 10, 2 );
function save_variation_custom_field( $variation_id, $loop ) {
$batch_number = isset( $_POST['_custom_batch_number'][ $loop ] ) ? sanitize_text_field( $_POST['_custom_batch_number'][ $loop ] ) : '';
update_post_meta( $variation_id, '_custom_batch_number', $batch_number );
}擴展庫存管理邏輯
自訂庫存欄位嘅核心價值在於能夠同WooCommerce嘅核心庫存管理系統互動，實現基於複雜規則嘅庫存計算同校驗。
創建多倉庫庫存跟蹤欄位
假設你需要管理嚟自「總倉」同「分倉」兩個倉庫嘅庫存。我哋可以為每個商品變體添加兩個獨立嘅庫存欄位，並喺前台根據庫存總量進行判斷。
首先，為變體加入自訂庫存欄位（喺「庫存」分頁下顯示）。
推薦閱讀 深入剖析 WooCommerce 自訂結賬欄位：由創建到數據處理嘅完整實踐。
add_action( 'woocommerce_variation_options_inventory', 'add_multi_warehouse_stock_fields', 10, 3 );
function add_multi_warehouse_stock_fields( $loop, $variation_data, $variation ) {
echo '<div class="multi-warehouse-fields">';
woocommerce_wp_text_input( array(
'id' => "_warehouse_main_stock_{$loop}",
'name' => "_warehouse_main_stock[{$loop}]",
'label' => __( '总仓库存', 'your-textdomain' ),
'type' => 'number',
'value' => get_post_meta( $variation->ID, '_warehouse_main_stock', true ),
) );
woocommerce_wp_text_input( array(
'id' => "_warehouse_branch_stock_{$loop}",
'name' => "_warehouse_branch_stock[{$loop}]",
'label' => __( '分仓库存', 'your-textdomain' ),
'type' => 'number',
'value' => get_post_meta( $variation->ID, '_warehouse_branch_stock', true ),
) );
echo '</div>';
}計算同覆寫總庫存邏輯
跟住，我哋需要計算總庫存（總倉+分倉），然後等 WooCommerce 用呢個計算值作為該變體嘅「總庫存」。呢度要用到woocommerce_product_get_stock_quantity過濾器。
add_filter( 'woocommerce_product_get_stock_quantity', 'calculate_total_stock_from_warehouses', 10, 2 );
function calculate_total_stock_from_warehouses( $stock_quantity, $product ) {
// 确保只对变体商品进行操作
if ( $product->is_type( 'variation' ) ) {
$main_stock = (int) $product->get_meta( '_warehouse_main_stock', true );
$branch_stock = (int) $product->get_meta( '_warehouse_branch_stock', true );
$calculated_total = $main_stock + $branch_stock;
// 如果计算总值与默认_stock值不同，则更新默认_stock字段（可选，用于保持数据一致性）
// update_post_meta( $product->get_id(), ‘_stock', $calculated_total );
return $calculated_total;
}
return $stock_quantity;
}同時，我哋仲要確保落單嗰陣，根據業務規則（例如優先從分倉出貨）來扣減相應倉庫嘅庫存。呢樣可以透過woocommerce_reduce_order_stock或woocommerce_payment_complete_reduce_order_stock鉤子實現，喺扣減預設_stock嘅同時，亦都扣減我哋自訂倉庫欄位嘅值。
喺前台展示同利用自訂數據
添加嘅欄位數據最終需要服務於前端客戶，無論係用嚟展示、篩選定係作為購買決策嘅依據。
喺商品詳情頁顯示自訂資訊
使用woocommerce_product_meta_start或woocommerce_after_variations_table等掛鉤，可以將批次號等資料輸出到商品單頁。
add_action( 'woocommerce_after_variations_table', 'display_batch_number_on_frontend' );
function display_batch_number_on_frontend() {
global $product;
if ( $product->is_type( 'variable' ) ) {
// 对于可变商品，可能需要通过JS动态显示当前选中变体的批次号
echo '<div class="batch-info" style="margin-top: 15px;"><strong>批次資料：</strong><span id="dynamic-batch-number">請揀商品規格</span></div>';
wc_enqueue_js( "
$( ‘input.variation_id’ ).change( function() {
if ( ‘‘ != $( this ).val() ) {
var variation_id = $( this ).val();
// 发起AJAX请求获取该变体的批次号
$.ajax({
url: wc_add_to_cart_params.ajax_url,
type: 'POST',
data: {
action: ‘get_variation_batch_number’,
variation_id: variation_id,
},
success: function( response ) {
$( ‘#dynamic-batch-number’ ).text( response.data );
}
});
} else {
$( ‘#dynamic-batch-number’ ).text( ‘请选择商品规格’ );
}
});
" );
} else {
// 对于简单商品，直接显示
$batch = $product->get_meta( ‘_custom_batch_number’, true );
if ( $batch ) {
echo ‘<p><strong>生產批次號：</strong>‘ . esc_html( $批次 ) . ’</p>’;
}
}
}
// 处理上述的AJAX请求
add_action( ‘wp_ajax_get_variation_batch_number’, ‘get_variation_batch_number_callback’ );
add_action( ‘wp_ajax_nopriv_get_variation_batch_number’, ‘get_variation_batch_number_callback’ );
function get_variation_batch_number_callback() {
$variation_id = intval( $_POST[‘variation_id’] );
$batch = get_post_meta( $variation_id, ‘_custom_batch_number’, true );
wp_send_json_success( $batch );
}基於自訂屬性進行商品篩選
如果您添加嘅欄位係可篩選嘅屬性（例如「產地」），可以將其註冊為可篩選嘅產品屬性，並使用 WooCommerce 嘅[products]用短碼或者小工具嚟篩選。再高級啲嘅做法係，透過woocommerce_product_query掛勾（hook），喺商品歸檔頁（例如商店頁面）直接修改主查詢，根據自訂元欄位嘅值去過濾商品。
add_action( 'woocommerce_product_query', 'filter_products_by_custom_meta' );
function filter_products_by_custom_meta( $q ) {
if ( isset( $_GET[‘special_batch’] ) && ! empty( $_GET[‘special_batch’] ) ) {
$meta_query = $q->get( 'meta_query' );
$meta_query[] = array(
'key‘ => ’_custom_batch_number‘,
’value‘ => sanitize_text_field（ $_GET[‘special_batch’] ),
’compare‘ => ’LIKE‘,
);
$q->set( ’meta_query‘, $meta_query );
}
}摘要
靈活運用 WordPress 嘅元數據功能同 WooCommerce 提供嘅大量掛勾，我哋可以好大程度突破佢默認數據模型嘅限制。由加簡單嘅文字欄位，到實現複雜嘅多倉庫存貨聯動，自訂欄位俾店鋪營運者好強大嘅數據管理能力。
關鍵在於理解數據儲存嘅位置（文章元表）、掌握喺管理後台顯示欄位嘅方法（WooCommerce 包裝函數），同熟練運用過濾器（Filter）同動作（Action）掛勾去介入核心邏輯（例如存貨計算、查詢過濾）。始終將用戶體驗擺喺第一位，確保自訂數據唔單止可以俾管理員方便咁管理，仲能夠以清晰、互動友好嘅方式呈現俾最終顧客，咁樣先至可以真正提升店鋪嘅專業度同營運效率。
常見問題
自訂欄位嘅數據安全點樣保障？
確保喺保存自訂欄位數據時做嚴格清理同驗證係好緊要嘅。一定要用好似sanitize_text_field()、absint()噉樣嘅WordPress清理函數來處理所有用戶輸入。對於數字型庫存欄位，一定要強制轉換成整數類型。同時，喺輸出到前端頁面時，用esc_html()或wc_clean()進行轉義，以防止跨站腳本（XSS）攻擊。
呢啲自訂欄位可唔可以同第三方插件兼容？
兼容性視乎第三方插件嘅工作方式。大多數設計良好嘅插件（例如 SEO 插件、頁面構建器）會透過 WooCommerce 嘅標準掛鉤嚟讀取產品資訊，所以通常唔會受到影響。但係，如果插件直接查詢數據庫或者修改核心邏輯，就可能忽略你嘅自訂欄位。喺關鍵業務功能上線之前，務必喺暫存環境中進行充分嘅兼容性測試。
大量自訂欄位會影響網站效能嗎？
不當嘅實現確實可能影響效能。每一條get_post_meta()調用都會產生一次數據庫查詢。最佳實踐係：喺單個函數或掛鉥中，透過一次get_post_meta($id)唔使指定鍵名嚟攞晒所有元數據（返個陣列），然後喺陣列度讀取需要嘅值；或者用WC_Product物件嘅get_meta()方法。另外，可以考慮將成日要存取又唔會成日改嘅自訂數據，透過物件快取嚟儲存。
搬屋或者備份嗰陣，自訂欄位數據會唔會唔見㗎？
只要你用返標準嘅 WordPress/WooCommerce 元數據 API（例如update_post_meta）嚟保存數據，呢啲數據就會儲存喺 WordPress 數據庫嘅wp_postmeta表入面。用任何標準嘅 WordPress 數據庫備份、遷移插件或者工具（例如 All-in-One WP Migration, Duplicator）都會包含呢啲表，所以數據唔會唔見。請確保喺遷移之後做數據驗證測試。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。