本教程详细阐述了在WooCommerce中通过自定义数据库查询来准确获取订单客户备注的方法。针对标准函数可能无法满足特定集成需求（如与WooCommerce Bookings插件结合）的问题，文章提供了一个基于`wpdb`的解决方案，解释了客户备注在数据库中的存储机制，并指导如何编写函数来检索、处理和显示这些备注，确保在自定义场景下信息的完整性与准确性。
在WooCommerce中，客户备注是订单处理流程中的重要信息，它们允许客户在下单时提供额外的指示或偏好。通常，我们可以通过WC_Order对象的相关方法来访问这些备注。然而，在某些特定的自定义开发场景下，例如将客户备注集成到第三方插件（如WooCommerce Bookings）的自定义界面中，或需要以特定格式检索所有历史备注时，直接使用标准方法可能无法按预期工作，或者返回的数据格式不符合需求。这通常是因为对WooCommerce底层数据存储机制的理解不足，或者标准方法仅返回特定类型的备注。当遇到这种情况时，深入数据库层面进行自定义查询便成为一种强大且灵活的解决方案。
要有效地自定义检索客户备注，首先需要理解WooCommerce是如何存储这些信息的。在WordPress和WooCommerce的架构中，客户备注并非独立存储在一个专门的表中，而是巧妙地利用了WordPress的评论（Comments）系统。
具体来说：
了解这一机制是编写精准自定义查询的关键。
基于上述存储机制，我们可以编写一个自定义PHP函数，利用WordPress的wpdb对象直接查询数据库，以获取指定订单的所有客户备注。
<?php
/**
* 获取指定订单的所有客户备注
*
* @param int $order_id 订单ID。
* @return array 包含客户备注对象的数组，如果未找到则返回空数组。
*/
function cc_get_customer_notes( $order_id ) {
global $wpdb;
// 确保订单ID是整数，防止SQL注入
$order_id = absint( $order_id );
if ( ! $order_id ) {
return array();
}
// 构建SQL查询，从comments表和commentmeta表联合查询
$query = $wpdb->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 BY comment_date_gmt ASC", // 通常按时间升序排列
$order_id
);
$_customer_notes = $wpdb->get_results( $query );
return $_customer_notes;
}
?>代码解析：
一旦cc_get_customer_notes函数定义完成（建议将其放置在主题的functions.php文件或自定义插件中），就可以在任何需要的地方调用它来获取客户备注数据。
以下示例展示了如何在自定义表单或显示区域中，将获取到的客户备注填充到一个文本区域（textarea）中，这尤其适用于如WooCommerce Bookings插件的自定义订单编辑界面。
<?php
// 假设您已通过某种方式获取到当前的订单对象 $order
// 例如：$order = wc_get_order( $order_id );
if ( isset( $order ) && $order instanceof WC_Order ) {
$order_id = $order->get_id(); // 获取订单ID
$_customer_notes = cc_get_customer_notes( $order_id ); // 调用自定义函数获取备注
// 原始问题代码尝试使用 $customer_note->post_excerpt，这是不正确的。
// 正确的备注内容字段是 WP_Comment 对象中的 comment_content。
// 如果有多个备注，我们通常需要将它们连接起来显示在一个 textarea 中。
$display_notes_content = '';
if ( ! empty( $_customer_notes ) ) {
$all_notes_array = array();
foreach ( $_customer_notes as $note ) {
// 确保备注内容是字符串，并进行清理
$all_notes_array[] = wp_kses_post( $note->comment_content );
}
// 将所有备注用双换行符连接起来，以便在 textarea 中清晰显示
$display_notes_content = implode( "\n\n", $all_notes_array );
} else {
$display_notes_content = __( 'No customer notes found for this order.', 'woocommerce-bookings' );
}
?>
<p class="form-field form-field-wide">
<label for="customer_note_display"><?php _e( 'Customer provided note', 'woocommerce-bookings' ); ?>:</label>
<textarea rows="5" cols="40" name="customer_note_display" tabindex="6" id="customer_note_display" placeholder="<?php esc_attr_e( 'Customer notes about the order', 'woocommerce' ); ?>" readonly>
<?php echo esc_textarea( $display_notes_content ); ?>
</textarea>
</p>
<?php
} else {
// 处理 $order 对象未定义或无效的情况
echo '<p>' . __( 'Order not found or invalid.', 'woocommerce-bookings' ) . '</p>';
}
?>关键优化点：
通过深入理解WooCommerce客户备注的底层存储机制，并结合wpdb进行自定义数据库查询，开发者可以灵活、精准地获取和处理订单客户备注数据。这种方法不仅解决了标准函数可能无法满足的特定集成需求，也为WooCommerce的深度定制和功能扩展提供了坚实的基础。掌握这种自定义查询技术，将使您在开发复杂的WooCommerce解决方案时更加得心应手。
以上就是深入理解与自定义检索WooCommerce订单客户备注的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
912
收藏
