WooCommerce已完成订单邮件添加产品自定义字段及取值失败排查
代码问题定位与修正方案
原代码存在的核心问题
- 变量未定义:
woocommerce_email_after_order_table钩子的回调函数仅会传入订单对象$order、管理员收件标记$sent_to_admin、纯文本格式标记$plain_text、当前邮件对象$email四个参数,函数作用域内不存在预定义的$product_id变量,直接用未定义的变量调用get_post_meta(),无法读取到对应产品的自定义字段值。同时订单可能包含多个不同商品,需要遍历订单内的商品条目才能拿到每个商品对应的ID和自定义字段值。 - HTML标签错配:代码中列表项的内容提前闭合了未开启的
</strong>标签,会造成邮件HTML结构渲染异常。 - 兼容场景缺失:没有判断
$plain_text纯文本邮件的格式场景,会导致纯文本格式的邮件输出冗余HTML标签,破坏邮件阅读体验。
修正后的可运行代码
将以下代码替换你之前写入functions.php的内容即可正常运行:
add_action( 'woocommerce_email_after_order_table', 'add_content_on_specific_email', 20, 4 ); function add_content_on_specific_email( $order, $sent_to_admin, $plain_text, $email ) { // 仅对客户已完成订单邮件生效 if ( $email->id !== 'customer_completed_order' ) return; // 适配纯文本邮件格式 if ( $plain_text ) { echo "\nInformasi Pengambilan Barang\n"; echo "Terima Kasih telah mengkonfirmasi pembayaran Anda, Silahkan tunjukan email ini pada saat pengambilan barang dan berikut informasi dan alamat pengambilan barang:\n"; // 遍历订单内所有商品条目 foreach ( $order->get_items() as $item ) { $product = $item->get_product(); $product_id = $product->get_id(); $pickup_addr = get_post_meta( $product_id, 'kontak_pemberi', true ); $pickup_tel = get_post_meta( $product_id, 'no_hp_pemberi', true ); $pickup_contact = get_post_meta( $product_id, 'nama_pemberi', true ); echo "Alamat Pengambilan: " . $pickup_addr . "\n"; echo "No. Telepon: " . $pickup_tel . "\n"; echo "Nama Pemberi Barang: " . $pickup_contact . "\n"; } return; } // 适配HTML邮件格式 echo '<h3>Informasi Pengambilan Barang</h3>'; echo '<p class="email-upsell-p">Terima Kasih telah mengkonfirmasi pembayaran Anda, Silahkan tunjukan email ini pada saat pengambilan barang dan berikut informasi dan alamat pengambilan barang:</p>'; echo '<ul>'; // 遍历订单内所有商品条目 foreach ( $order->get_items() as $item ) { $product = $item->get_product(); $product_id = $product->get_id(); $pickup_addr = get_post_meta( $product_id, 'kontak_pemberi', true ); $pickup_tel = get_post_meta( $product_id, 'no_hp_pemberi', true ); $pickup_contact = get_post_meta( $product_id, 'nama_pemberi', true ); echo '<li>Alamat Pengambilan: <strong>' . esc_html( $pickup_addr ) . '</strong></li>'; echo '<li>No. Telepon: <strong>' . esc_html( $pickup_tel ) . '</strong></li>'; echo '<li>Nama Pemberi Barang: <strong>' . esc_html( $pickup_contact ) . '</strong></li>'; } echo '</ul>'; }
补充说明
如果你的自定义字段是设置在父级可变产品上,而非产品变体本身,只需将代码中两处$product_id = $product->get_id();替换为$product_id = $product->get_parent_id();,即可正常读取父产品下的自定义字段值。
内容的提问来源于stack exchange,提问作者Yanuar
相关产品推荐
相关产品推荐

