在Restrict Content Pro客户列表添加‘同意条款’列的实现问题

问题分析 #

你当前代码存在两个关键错误：

• 钩子名称不匹配：自定义列的key是terms，但你使用了针对company列的钩子rcp_customer_list_table_column_company，导致字段内容无法渲染到目标列。
• 元数据获取函数错误：你使用了rcp_get_membership_meta（用于获取会员资格的元数据），但客户列表的元数据应该通过rcp_get_customer_meta来获取，因为$customer对象对应的是客户实体，而非会员资格。

修正后的代码 #

function ag_rcp_customers_list_table_columns( $columns ) 
{
  $key = 'terms'; // 列的唯一ID，小写无空格
  $name = __( 'Agreed Terms', 'rcp' ); // 列标题
  $columns[ $key ] = $name;

  return $columns;
}
add_filter( 'rcp_customers_list_table_columns', 'ag_rcp_customers_list_table_columns' );

function ag_rcp_customers_list_table_column_terms( $value, $customer ) 
{
  // 获取客户的"agree-terms"元数据，不存在则返回'none'
  $terms = rcp_get_customer_meta( $customer->get_id(), 'agree-terms', true );
  return empty( $terms ) ? 'none' : $terms;
}
add_filter( 'rcp_customer_list_table_column_terms', 'ag_rcp_customers_list_table_column_terms', 10, 2 );

关键说明 #

1. 钩子命名规则：针对客户列表的自定义列，钩子格式为rcp_customer_list_table_column_{你的列key}，必须和你定义的列ID完全一致。
2. 元数据函数选择：
   • rcp_get_customer_meta()：用于获取客户级别的元数据
   • rcp_get_membership_meta()：仅用于获取会员资格（客户的会员记录）的元数据
3. 默认值处理：添加了empty()判断，当元数据不存在时返回none，符合你的需求。

参考文档核心内容翻译（适配客户表场景） #

原文档介绍了给Restrict Content Pro后台表格添加自定义列的核心逻辑，分为两步：

1. 通过rcp_{对应表格}_list_table_columns过滤器添加列标题（客户表对应rcp_customers_list_table_columns，会员表对应rcp_memberships_list_table_columns）。
2. 通过rcp_{对应表格}_list_table_column_{列ID}过滤器填充列内容，函数接收当前列值和对应实体对象（客户表为$customer对象，会员表为$membership对象）。

内容的提问来源于stack exchange，提问作者Kieran Lythgoe