點解需要自訂結帳欄位
標準 WooCommerce 結帳流程預設收集嘅資料係基本同通用嘅，例如姓名、地址、電話同電郵。不過，當你嘅業務有特定需求嗰陣，呢啲資料就遠遠唔夠。透過加自訂欄位，你可以為客戶提供更貼心、更精準嘅購物體驗。
例如，賣訂製蛋糕嘅舖頭可能需要客人提供蛋糕上面嘅祝福語、需唔需要蠟燭等；B2B 業務可能需要記錄客戶嘅公司稅號或者採購單號；而活動票務類商店就可能需要收集參加者嘅身份證資料做驗證。自訂欄位令你可以收集標準流程以外嘅關鍵數據，呢啲數據可以用喺訂單處理、客戶分群、個人化營銷甚至法律合規。
從技術角度睇，WooCommerce 嘅結帳頁面係一個由一系列標準欄位組成嘅表單，其結構由動作掛鉤（Action Hook）同過濾器掛鉤（Filter Hook）定義。即係話我哋透過插件或者主題嘅函數檔案，利用呢啲掛鉤嚟「鉤入」結帳流程，從而加、刪或者改欄位。理解呢個核心機制係做任何自訂操作嘅基礎。
推薦閱讀 WooCommerce電商網站開發全攻略：從搭建到高級功能實現。
建立自訂結帳欄嘅三種方法
WooCommerce 提供咗靈活嘅方式去加自訂欄位，你可以根據自己嘅技術水平同需求揀最適合嘅方法。
用插件進行快速無代碼添加
對於唔熟代碼嘅網站管理員或者需要快速上線嘅項目，用專用插件係最方便嘅方式。市面上有例如「Checkout Field Editor for WooCommerce」或者「WooCommerce Checkout Manager」等優秀插件。
呢啲插件通常會提供一個直觀嘅後台界面，容許你透過點擊同選擇嚟新增欄位。你可以定義欄位類型（例如文字框、下拉選單、核取方塊、單選按鈕）、標籤、佔位符、係咪必填項，同埋呢個欄位喺結帳頁面嘅具體位置（喺帳單區定係配送區）。插件方法唔使寫任何程式碼，大大降低咗技術門檻，適合大多數標準需求。但係要留意，插件可能會增加網站嘅負載，而且喺自訂邏輯非常複雜嘅時候可能唔夠靈活。
透過程式碼新增自訂欄位
呢個係最強大同靈活嘅方法，透過編輯主題嘅 functions.php 檔案或者創建一個自訂插件嚟實現。核心係使用 woocommerce_checkout_fields 過濾器掛鈎。
呢個掛鈎容許你修改結賬欄位陣列。例如，如果你想喺「賬單資料」部分加一個用嚟輸入公司名嘅欄位，可以寫以下代碼：
推薦閱讀 點樣為 WooCommerce 產品頁面加自訂欄位同元數據。
add_filter( 'woocommerce_checkout_fields', 'custom_add_checkout_field' );
function custom_add_checkout_field( $fields ) {
$fields['billing']['billing_company_custom'] = array(
'label' => __('公司名称（自定义）', 'woocommerce'),
'placeholder' => _x('请输入您的完整公司名', 'placeholder', 'woocommerce'),
'required' => true,
'class' => array('form-row-wide'),
'clear' => true,
'priority' => 25, // 控制显示顺序，数字越小越靠前
);
return $fields;
}呢段代碼將一個必填嘅文字框加咗落賬單欄位度。關鍵在於欄位陣列嘅鍵名（例如 billing_company_custom）同埋所在嘅欄位集（['billing'] 或 ['shipping']、['order']）。
使用 WooCommerce 條件邏輯功能
有時你會希望某個欄位只喺特定條件下顯示。例如，當客戶揀咗「禮品包裝」服務嗰陣，先至顯示「禮品賀卡留言」欄位。呢個可以透過結合 JavaScript 或者用支援條件邏輯嘅插件嚟實現。
純代碼實現通常需要借助 woocommerce_after_checkout_billing_form 或 woocommerce_after_checkout_shipping_form 鉤子嚟輸出欄位嘅 HTML 結構，同埋編寫 jQuery 腳本監聽其他欄位（例如核取方塊）嘅變化，從而控制目標欄位嘅顯示或者隱藏。不過，呢種方法對 JavaScript 能力有啲要求。更簡單嘅方法仍然係用嗰啲提供可視化條件邏輯設定嘅高級欄位管理插件。
驗證並保存自訂欄位數據
單單喺頁面上顯示欄位係唔夠嘅，確保數據嘅有效性同安全噉保存到數據庫係至關重要嘅步驟。
前端同後端嘅數據驗證
為咗防止無效或者惡意數據提交，必須喺伺服器端（後端）進行驗證。呢個係透過 woocommerce_checkout_process 係用動作鈎子實現嘅。
接返上個例子，如果我哋加嘅 billing_company_custom 係必填欄位，我哋需要確保客戶冇留空：
推薦閱讀 WooCommerce開發實戰：從零開始構建專業電商網站。
add_action('woocommerce_checkout_process', 'custom_validate_checkout_field');
function custom_validate_checkout_field() {
if ( isset($_POST['billing_company_custom']) && empty($_POST['billing_company_custom']) ) {
wc_add_notice( __( '请填写“公司名称（自定义）”。', 'woocommerce' ), 'error' );
}
}wc_add_notice() 個函數會喺結賬頁面頂部顯示一條錯誤信息，阻止訂單提交，直到用戶修正錯誤。你可以喺入面實現更複雜嘅驗證邏輯，例如檢查電郵格式、數字範圍或者正則表達式匹配。
將欄位數據保存到訂單度
驗證通過之後，我哋需要將自訂欄位嘅值保存到訂單元數據（Order Meta）度，方便之後喺後台同電郵度查閱。呢個要用到 woocommerce_checkout_update_order_meta 動作鈎子。
add_action('woocommerce_checkout_update_order_meta', 'custom_save_checkout_field');
function custom_save_checkout_field( $order_id ) {
if ( ! empty($_POST['billing_company_custom']) ) {
update_post_meta( $order_id, '_billing_company_custom', sanitize_text_field($_POST['billing_company_custom']) );
}
}update_post_meta() 函數會將清理好嘅欄位值以鍵值對形式保存喺 wp_postmeta 表入面，鍵名通常以下劃線開頭（例如 _billing_company_custom），咁樣可以喺某啲後台介面度當佢係「隱藏」嘅元數據。
喺前端同後台顯示欄位數據
數據保存咗之後，你需要確保佢可以喺多個關鍵位置被睇到同管理到。
喺訂單詳情同電郵度顯示
為咗等店主同客都可以睇到已保存嘅資料，我哋需要將佢輸出到管理後台嘅訂單詳情頁面，同埋寄畀客同管理員嘅訂單電郵度。
修改管理後台訂單詳情，可以用 woocommerce_admin_order_data_after_billing_address 鉤子：
add_action('woocommerce_admin_order_data_after_billing_address', 'custom_display_field_in_admin', 10, 1);
function custom_display_field_in_admin($order){
$company_custom = get_post_meta( $order->get_id(), '_billing_company_custom', true );
if ( $company_custom ) {
echo '<p><strong>'.__('自定义公司名').':</strong> ' . $公司自訂 . '</p>';
}
}同樣地，用 woocommerce_email_order_meta_fields 過濾器可以將呢個欄位加到訂單電郵嘅內容入面。
喺「我嘅賬戶」訂單視圖度顯示
客戶喺佢哋嘅賬戶頁面睇返歷史訂單詳情嗰陣，都應該睇到佢哋當時填寫嘅資料。呢個係透過 woocommerce_order_details_after_order_table 動作掛鉤實現：
add_action('woocommerce_order_details_after_order_table', 'custom_display_field_in_order_view', 10, 1);
function custom_display_field_in_order_view( $order ) {
$company_custom = get_post_meta( $order->get_id(), '_billing_company_custom', true );
if ( $company_custom ) {
echo '<h2>'.__('额外信息').'</h2>';
echo '<table class="woocommerce-table shop_table extra_info"><tbody>';
echo '<tr><th>'.__('自定义公司名').':</th><td>' . $公司自訂 . '</td></tr>';
echo '</tbody></table>';
}
}摘要
為 WooCommerce 結賬流程加自訂欄位係一個由需求分析、開發實現到數據管理嘅過程。核心在於理解同運用 WooCommerce 嘅掛鉤系統：使用 woocommerce_checkout_fields 過濾器加欄位，利用 woocommerce_checkout_process 動作進行驗證，透過 woocommerce_checkout_update_order_meta 動作儲存數據，最後借助多個顯示掛鉤將數據呈現喺後台、電郵同用戶前台。對於初學者，可以從可靠插件入手；而對於追求高度定制同性能嘅開發者，寫程式碼係最佳途徑。無論邊種方式，清晰嘅數據流設計同嚴謹嘅驗證都係保障功能穩定、提升用戶體驗嘅關鍵。
常見問題
點解我加嘅自訂欄位喺結帳頁面唔顯示出嚟？
請跟住以下步驟檢查：首先，確認你嘅程式碼已經正確加咗落主題嘅 functions.php 檔案或者自訂插件入面，同埋冇語法錯誤。其次，檢查欄位陣列嘅鍵係咪正確噉嵌套喺 $fields['billing']、$fields['shipping'] 或 $fields['order'] 之中。然后，查看浏览器控制台是否有 JavaScript 错误，这可能与字段的 class 或优先级设置冲突。最后，清空网站和浏览器的缓存后再次尝试。
點樣將自訂欄位設定為可選或者必填？
喺透過代碼加欄位嗰陣，你可以喺欄位陣列度設定 'required' => true 或 'required' => false。如果欄位已經係必填但你想改做可選，只需要喺相應嘅 woocommerce_checkout_fields 過濾器函數度將該欄位嘅 required 參數改做 false 就得。請注意，改咗之後亦都需要相應噉調整或者移除喺 woocommerce_checkout_process 入面嘅驗證邏輯。
自訂欄位嘅數據儲存喺數據庫嘅邊個位置？
自訂欄位嘅值主要儲存喺 WordPress 嘅 wp_postmeta 數據庫表入面（表前綴可能唔同）。每條記錄透過 post_id（對應訂單ID）同 wp_posts 表入面嘅訂單記錄關聯，透過 meta_key（即係你保存嗰陣用嘅鍵名，例如 _billing_company_custom）嚟標示，meta_value 即係儲存欄位嘅實際數值。你可以透過數據庫管理工具或者 WordPress 嘅 get_post_meta() 函數去查詢呢啲數據。
可唔可以根據唔同產品顯示唔同嘅自訂欄位？
可以，但係需要更複雜嘅邏輯。一個常見嘅方法係：首先，為產品加一個自訂分類或者元欄位去標記佢嘅類型。跟住喺結賬頁面，用 woocommerce_after_checkout_form 用鉤子或者類似嘅方法，輸出所有可能嘅自訂欄位HTML，但係預設用CSS隱藏。跟住，寫JavaScript腳本，監聽購物車內容嘅變化或者特定產品嘅選擇，根據當前購物車入面嘅產品類型，動態顯示或者隱藏對應嘅欄位組。最後，喺後端驗證同保存嗰陣，亦都需要根據產品類型來有條件咁處理對應欄位嘅數據。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。