如何适配新Checkout Block修改WooCommerce结账页订单备注

原来的woocommerce_checkout_fields过滤器仅对经典短代码结账页面生效，新的Checkout Block基于WooCommerce Blocks实现，需要使用专门的钩子来修改订单备注字段。

替换后的代码 #

function md_custom_checkout_block_order_note_field( $field ) {
    // 修改订单备注的占位文本
    $field['placeholder'] = 'Special notes';
    // 修改订单备注的标签文本
    $field['label'] = 'Add your special note';
    
    return $field;
}
add_filter( 'woocommerce_blocks_checkout_order_note_field', 'md_custom_checkout_block_order_note_field' );

兼容经典结账页面和新Block #

如果需要同时适配两种结账页面，可保留原代码并新增上述代码，这样经典页面和新Checkout Block都会应用你的自定义设置：

// 适配经典结账页面
function md_custom_woocommerce_checkout_fields( $fields ) 
{
    $fields['order']['order_comments']['placeholder'] = 'Special notes';
    $fields['order']['order_comments']['label'] = 'Add your special note';

    return $fields;
}
add_filter( 'woocommerce_checkout_fields', 'md_custom_woocommerce_checkout_fields' );

// 适配新Checkout Block
function md_custom_checkout_block_order_note_field( $field ) {
    $field['placeholder'] = 'Special notes';
    $field['label'] = 'Add your special note';
    
    return $field;
}
add_filter( 'woocommerce_blocks_checkout_order_note_field', 'md_custom_checkout_block_order_note_field' );

说明 #

新Checkout Block采用React驱动的块结构，不依赖传统的结账字段过滤器，因此必须使用WooCommerce Blocks提供的专属钩子来修改字段属性。针对不同类型的字段，还有对应的钩子（如账单字段用woocommerce_blocks_checkout_billing_fields），但订单备注字段专用woocommerce_blocks_checkout_order_note_field即可。

内容的提问来源于stack exchange，提问作者orschiro