本文详细阐述了在 woocommerce 中获取订单客户备注的挑战与解决方案。针对 `wc_order::get_customer_note()` 方法无法获取特定类型客户备注的问题，文章提供了一个基于数据库直接查询的自定义 php 函数。该方案通过识别存储为订单评论并带有特定元数据标记的客户备注，确保在 woocommerce bookings 等插件场景中能够准确显示所需的客户信息。
理解 WooCommerce 中的客户备注
在 WooCommerce 中，”客户备注”可以有多种形式。最常见的一种是客户在结账过程中填写的订单备注，这些备注通常存储为订单的元数据（_customer_note）。另一种情况是，系统或管理员可能会将一些重要信息作为“订单评论”添加到订单中，并将其标记为“客户可见”（is_customer_note 元键值为 1）。这些评论在数据库中以 WordPress 评论的形式存在。
当开发者尝试使用 WC_Order 对象上的 get_customer_note() 方法时，它主要返回的是存储在订单元数据中的结账备注。如果期望获取的是那些以评论形式存在的、标记为客户可见的备注，那么此方法将无法满足需求。这在某些特定插件（如 WooCommerce Bookings）的自定义显示场景中尤其明显，可能导致无法正确展示客户提供的所有相关信息。
WC_Order::get_customer_note() 的局限性
原始尝试的代码片段展示了对 WC_Order::get_customer_note() 方法的调用，并试图访问其 post_excerpt 属性：
$customer_note = $order->get_customer_note();echo wp_kses_post( $customer_note->post_excerpt );
这里的关键问题在于：
$order->get_customer_note() 方法通常返回的是一个字符串（即存储在 _customer_note 订单元数据中的值），而不是一个 WordPress WP_Post 或 WP_Comment 对象。因此，尝试访问 $customer_note->post_excerpt 将导致错误或不期望的结果。即使该方法返回了数据，它也只针对订单元数据中的客户备注。对于那些作为评论存储的客户备注，此方法无能为力。
为了获取以评论形式存储的客户备注，我们需要直接查询 WordPress 数据库。
自定义查询获取订单客户备注
要精确获取那些被标记为客户可见的订单评论，我们可以编写一个自定义函数，通过 SQL 查询直接访问 wp_comments 和 wp_commentmeta 表。
以下是实现此功能的 PHP 函数：
prepare( "SELECT * FROM {$wpdb->prefix}comments WHERE comment_post_ID = %d AND comment_ID IN ( SELECT comment_id FROM {$wpdb->prefix}commentmeta WHERE meta_key = 'is_customer_note' AND meta_value = 1 )", $order_id // 使用 %d 占位符安全地插入订单ID ); // 执行查询并获取结果 $_customer_note = $wpdb->get_results($q); // 如果查询到结果，则将其赋值给结果数组 if (count($_customer_note) > 0) { $_customer_note_data = $_customer_note; } return $_customer_note_data;}?>
函数解析：
global $wpdb;：引入 WordPress 全局数据库操作对象，用于执行 SQL 查询。$wpdb->prepare()：这是一个非常重要的函数，用于安全地构建 SQL 查询。它通过使用占位符（如 %d 代表整数）来防止 SQL 注入攻击。SELECT * FROM {$wpdb->prefix}comments：从 wp_comments 表中选择所有评论数据。{$wpdb->prefix} 确保使用了正确的数据库表前缀。WHERE comment_post_ID = %d：筛选出与特定订单 ID 关联的评论。在 WordPress 中，订单也是一种自定义文章类型，其评论的 comment_post_ID 字段会存储订单 ID。AND comment_ID IN (…)：进一步筛选评论，只包括那些在 wp_commentmeta 表中拥有 meta_key 为 is_customer_note 且 meta_value 为 1 的评论。这是识别“客户可见”备注的关键。
如何使用此自定义函数
一旦定义了 cc_get_customer_notes 函数，你就可以在任何需要的地方调用它，传入订单 ID 即可获取相关的客户备注。
示例调用：
<?php// 假设你已经获取到了订单ID，例如：$order_id = 703; // 替换为实际的订单ID// 调用自定义函数获取客户备注$customer_notes = cc_get_customer_notes($order_id);// 检查是否有备注并输出if (!empty($customer_notes)) { echo "客户提供的备注:
"; echo "- "; foreach ($customer_notes as $note) { // $note 是一个 WP_Comment 对象，其 comment_content 字段包含备注内容 echo "
- " . wp_kses_post($note->comment_content) . " "; } echo "
没有找到客户提供的备注。
";}?>集成到 WooCommerce Bookings 插件场景：
如果你需要在 WooCommerce Bookings 的模板或自定义文件中显示这些备注，通常可以从当前的预订或订单上下文中获取 $order_id。然后，你可以将获取到的备注内容填充到 textarea 标签中：
<textarea rows="5" cols="40" name="customer_notes_display" tabindex="6" id="customer_notes_display" placeholder="" readonly> get_id(); $customer_notes = cc_get_customer_notes($order_id); if (!empty($customer_notes)) { $all_notes_content = array_map(function($note) { return $note->comment_content; }, $customer_notes); echo esc_textarea( implode("n---n", $all_notes_content) ); // 使用换行符分隔多个备注 } } ?>
注意事项：
安全性： 直接操作数据库需要谨慎。始终使用 $wpdb->prepare() 来构建 SQL 查询，以防止 SQL 注入。在输出任何用户提供的数据时，务必使用 wp_kses_post() 或 esc_textarea() 等函数进行适当的转义和清理。性能： 对于高流量网站，频繁地执行自定义数据库查询可能会影响性能。如果这些备注是静态的或不经常变化的，可以考虑实现简单的缓存机制。代码位置： 将 cc_get_customer_notes 函数放置在主题的 functions.php 文件中，或更推荐地，放置在一个自定义插件中，以确保在主题更新时代码不会丢失。WooCommerce API： 尽管此自定义查询解决了特定问题，但在可能的情况下，建议优先使用 WooCommerce 提供的 API 函数（例如 wc_get_order_notes()，虽然它需要额外的逻辑来过滤出客户可见的备注）来确保更好的兼容性和未来的可维护性。然而，对于这种精确过滤特定元数据标记的评论，直接查询通常是最直接有效的方法。
总结
当 WC_Order::get_customer_note() 无法满足获取所有类型客户备注的需求时，特别是那些以评论形式存储并标记为客户可见的备注，通过自定义 SQL 查询直接访问 WordPress 数据库是一个强大而有效的解决方案。本文提供的 cc_get_customer_notes 函数能够精确地检索这些信息，帮助开发者在 WooCommerce Bookings 或其他自定义场景中完整展示客户提供的所有相关备注。在实施此类自定义查询时，务必注意代码的安全性、性能和可维护性。
以上就是在 WooCommerce 中获取订单客户备注的自定义方法与实践的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1328695.html
微信扫一扫 
支付宝扫一扫 
