本文介绍如何在 woocommerce subscriptions 后台订阅列表页（/wp-admin/edit.php?post_type=shop_subscription）中新增一列，准确显示每条订阅下已完成和待处理的续订订单总数，并关联到对应商品。

本文介绍如何在 woocommerce subscriptions 后台订阅列表页（/wp-admin/edit.php?post_type=shop_subscription）中新增一列，准确显示每条订阅下已完成和待处理的续订订单总数，并关联到对应商品。

要在 WooCommerce 订阅管理界面中增强数据可视化能力，最实用的方式之一是在订阅列表页添加自定义列。默认情况下，该页面仅展示订阅状态、用户、开始/结束日期等基础信息，但无法直观反映续订行为的活跃度。本文将指导你通过两个核心钩子——manage_edit-shop_subscription_columns（控制列头）和 manage_shop_subscription_posts_custom_column（渲染列内容）——安全、高效地插入“续订订单计数”列，并确保数据按商品粒度准确呈现。

首先，使用 manage_edit-shop_subscription_columns 过滤器在“结束日期”列之后插入新列。我们采用 array_slice 精确定位插入位置（索引 10），避免硬编码依赖列顺序变化：

function dd_columns_head( $defaults ) {
    return array_slice( $defaults, 0, 10, true ) +
        array( 'count' => '续订订单数' ) +
        array_slice( $defaults, 10, count( $defaults ) - 1, true );
}
add_filter( 'manage_edit-shop_subscription_columns', 'dd_columns_head', 30 );

接着，在 manage_shop_subscription_posts_custom_column 动作中实现列内容渲染。关键点在于：
✅ 必须先通过 wcs_get_subscription( $post_ID ) 获取订阅对象，并做类型校验（is_a( $subscription, 'WC_Subscription' )），防止空值或异常导致白屏；
✅ 使用 $subscription->get_payment_count() 方法分别统计 'completed' 和 'pending' 状态的续订订单（即 renewal 类型），再求和得到总续订次数；
✅ 若订阅含多个商品（如组合订阅），需遍历 $subscription->get_items() 并为每个商品生成一行表格，提升可读性与业务匹配度；
✅ 所有输出必须经 esc_html_e() 或 absint() 安全过滤，杜绝 XSS 风险与类型隐患。

完整实现如下：

function dd_column_content( $column_name, $post_ID ) {
    if ( 'count' !== $column_name ) {
        return;
    }

    $subscription = wcs_get_subscription( $post_ID );
    if ( ! is_a( $subscription, 'WC_Subscription' ) ) {
        echo '<span class="na">—</span>';
        return;
    }

    $completed_count = $subscription->get_payment_count( 'completed', 'renewal' );
    $pending_count   = $subscription->get_payment_count( 'pending', 'renewal' );
    $total_count     = absint( $completed_count + $pending_count );

    echo '

'; foreach ( $subscription->get_items() as $item ) { $product = $item->get_product(); $title = $product ? $product->get_name() : esc_html__( '未知商品', 'woocommerce-subscriptions' ); echo ''; echo ''; } echo '

' . esc_html( '商品：' . $title ) . '

' . $total_count . '

'; } add_action( 'manage_shop_subscription_posts_custom_column', 'dd_column_content', 30, 2 );

⚠️ 注意事项：

• 请勿在 woocommerce_subscription_before_actions 等前端钩子中尝试渲染管理列，该钩子作用于单个订阅详情页，与列表页列逻辑完全无关；
• get_payment_count() 的第二个参数 'renewal' 明确限定只统计续订订单（排除初始订阅订单），确保数据语义准确；
• 如需区分“仅已完成续订”，可单独输出 $completed_count；若需支持导出或排序，需额外实现 manage_edit-shop_subscription_sortable_columns 及 SQL 查询优化；
• 建议将代码放入子主题的 functions.php 或独立插件中，避免主题更新覆盖。

通过以上方案，你将获得一个稳定、可维护且符合 WooCommerce 最佳实践的管理列扩展，显著提升订阅运营的数据洞察效率。