给WooCommerce的运费（Shipping Method）增加自定义描述字段

如果一个 WooCommerce 网站存在多种不同的运费（Shipping Method），则可能有必要让用户在运费选择的模块中了解不同运费的区别。你可以解释运输的时长，或者解释价格的构成等，总之就是提供更多信息帮助用户做出最好的选择。比如在这里，我就对每个运费添加了时长的解释：

一个便捷的办法是通过以下代码实现的：

add_filter('woocommerce_cart_shipping_method_full_label', 'brain1981_custom_shipping_method_label', 10, 2);
function brain1981_custom_shipping_method_label( $label, $method ){
$txt = "";
if( $method->id=="flat_rate:1" || $method->id=="free_shipping:4" ){
$txt = 'In 15 Business days';
}else if( $method->id=="flat_rate:2" || $method->id=="free_shipping:3" ){
$txt = '7-10 Business days';
}
return $label . ' ' . $txt . '';
}

需注意的是，WooCommerce 的运费 ID 的格式都是以这样的形式呈现的：

以上这段代码就是事先辨认出这些运费 ID，通过 woocommerce_cart_shipping_method_full_label 这个钩子在运费的标题后面增加一小段描述。如果你的运费数量不多且比较固定，这段代码就足够用了。

那么如果一个网站有很多种运费，并且经常会修改运费种类，上面这种 hard codding 的写法就会变得很臃肿且不易维护了。我们就需要给每个运费添加一个自定义的描述字段，实现后台管理描述，方便运维人员自己去修改运费设置。

首先实现给后台添加自定义字段：

add_action( 'woocommerce_init', 'brain1981_shipping_instance_form_fields_filters' );
function brain1981_shipping_instance_form_add_extra_fields( $settings ) {
$settings['shipping_extra_field_description'] = array(
'title' => esc_HTML__( 'Description', 'woocommerce' ),
'type' => 'textarea',
'placeholder' => esc_html__( 'Your shipping method description', 'woocommerce' ),
'description' => '',
);
return $settings;
}
function brain1981_shipping_instance_form_fields_filters() {
$shipping_methods = WC()->shipping->get_shipping_methods();
foreach ( $shipping_methods as $shipping_method ) {
add_filter( 'woocommerce_shipping_instance_form_fields_' . $shipping_method->id, 'brain1981_shipping_instance_form_add_extra_fields' );
}
}

以上代码实现了这样的功能：

接下来是在开头第一张图的位置，调用出这个字段的内容：

add_filter('woocommerce_cart_shipping_method_full_label', 'brain1981_custom_shipping_method_label', 10, 2);
function brain1981_custom_shipping_method_label( $label, $method ){
$rate_id = $method->id; // The Method rate ID (Method Id + ':' + Instance ID)
$rate_id = str_replace(':', '_', $rate_id);
$txt = get_option('woocommerce_'.$rate_id.'_settings')['shipping_extra_field_description'];
return $label . ' ' . $txt . '';
}