如何在Woocommerce Analytics订单报告中添加email和phone字段

架构老林

2026-10-6

WooCommerce Analytics订单报表添加email/phone字段解决方案

步骤1：注册自定义列到报表表头

添加过滤器在订单报表的表头注册邮箱和手机号两个字段，代码如下：

add_filter( 'woocommerce_analytics_reports_orders_columns', 'wc_custom_add_analytics_order_columns' );
function wc_custom_add_analytics_order_columns( $columns ) {
    $columns['billing_email'] = '账单邮箱';
    $columns['billing_phone'] = '账单手机号';
    return $columns;
}

步骤2：关联字段到Analytics查询逻辑

修改报表的SQL查询语句，将订单的邮箱、手机号字段加入查询结果集：

add_filter( 'woocommerce_analytics_order_query_select', 'wc_custom_add_fields_to_analytics_query' );
function wc_custom_add_fields_to_analytics_query( $select_clause ) {
    $select_clause .= ', order_data.billing_email, order_data.billing_phone';
    return $select_clause;
}

步骤3：渲染列内容

配置自定义列的显示逻辑，为空时展示占位符：

add_filter( 'woocommerce_analytics_order_report_column_value', 'wc_custom_render_analytics_column_content', 10, 3 );
function wc_custom_render_analytics_column_content( $output, $column_name, $order_item ) {
    if ( 'billing_email' === $column_name ) {
        return $order_item->billing_email ?? '-';
    }
    if ( 'billing_phone' === $column_name ) {
        return $order_item->billing_phone ?? '-';
    }
    return $output;
}

可选：适配CSV导出

如果需要导出的CSV文件也包含这两个字段，添加以下代码：

add_filter( 'woocommerce_analytics_orders_export_columns', 'wc_custom_add_columns_to_analytics_export' );
function wc_custom_add_columns_to_analytics_export( $export_columns ) {
    $export_columns['billing_email'] = '账单邮箱';
    $export_columns['billing_phone'] = '账单手机号';
    return $export_columns;
}