本文介绍如何在 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 '<table class="wc-subscription-items-table" style="width:100%; border-collapse:collapse; font-size:13px;">';
foreach ( $subscription->get_items() as $item ) {
$product = $item->get_product();
$title = $product ? $product->get_name() : esc_html__( '未知商品', 'woocommerce-subscriptions' );
echo '<tr><td style="padding:4px 8px; border-bottom:1px solid #eee;">' . esc_html( '商品：' . $title ) . '</td>';
echo '<td style="padding:4px 8px; text-align:right; border-bottom:1px solid #eee;">' . $total_count . '</td></tr>';
}
echo '</table>';
}
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 最佳实践的管理列扩展，显著提升订阅运营的数据洞察效率。
