WordPress自定义文章类型(CPT)列无法排序问题求助

一、修复后台「Last Name」列排序不生效问题 #

由于你的自定义文章类型（CPT）设置了hierarchical=true，WordPress对层级型CPT的后台查询有特殊处理，需调整逻辑适配：

1. 修正查询与排序逻辑
   替换原smashing_posts_orderby函数，同时兼容后台和前端排序需求，避免层级CPT默认排序的干扰：

add_action( 'pre_get_posts', 'smashing_posts_orderby' );
function smashing_posts_orderby( $query ) {
    // 跳过非主查询、后台AJAX查询
    if ( ! $query->is_main_query() || ( is_admin() && defined( 'DOING_AJAX' ) && DOING_AJAX ) ) {
        return;
    }

    // 后台排序处理
    if ( is_admin() && $query->get( 'post_type' ) === 'leadership' ) {
        if ( 'last_name' === $query->get( 'orderby' ) ) {
            $query->set( 'orderby', 'meta_value_string' ); // 用字符串排序避免数字干扰
            $query->set( 'meta_key', 'last_name' );
            // 移除层级CPT默认的menu_order排序规则，避免冲突
            $query->set( 'orderby', array( 'meta_value_string' => $query->get( 'order' ) ) );
        }
    }

    // 前端排序处理
    if ( ! is_admin() && $query->get( 'post_type' ) === 'leadership' ) {
        $orderby = isset( $_GET['orderby'] ) ? sanitize_text_field( $_GET['orderby'] ) : 'menu_order';
        $order = isset( $_GET['order'] ) ? sanitize_text_field( $_GET['order'] ) : 'ASC';

        switch ( $orderby ) {
            case 'title':
                $query->set( 'orderby', 'title' );
                $query->set( 'order', $order );
                break;
            case 'last_name':
                $query->set( 'orderby', 'meta_value_string' );
                $query->set( 'meta_key', 'last_name' );
                $query->set( 'order', $order );
                break;
            default:
                // 默认按菜单顺序排序
                $query->set( 'orderby', 'menu_order' );
                $query->set( 'order', 'ASC' );
                break;
        }
    }
}

2. 提升排序过滤器优先级
   给排序过滤器添加更高优先级，避免被其他代码覆盖：

add_filter( 'manage_edit-leadership_sortable_columns', 'smashing_leadership_sortable_columns', 99 );
function smashing_leadership_sortable_columns( $columns ) {
    $columns['last_name'] = 'last_name';
    return $columns;
}

二、解决列旁带“0”的红色圆圈问题 #

该红圈大概率是字段空值触发的插件提示（如ACF扩展插件），可通过以下方式修复：

1. 处理空字段输出
   修改自定义列渲染函数，空值时输出占位文本：

function smashing_leadership_column( $column, $post_id ) {
    if ( 'last_name' == $column ) {
        $lastName = get_field('last_name', $post_id );
        echo $lastName ? esc_html( $lastName ) : '-'; // 空值时输出短横线
    }
}
add_action( 'manage_leadership_posts_custom_column', 'smashing_leadership_column', 10, 2);

2. 排查插件冲突
   临时禁用后台管理类插件（尤其是ACF相关扩展），确认是否为插件冲突导致。

三、实现前端排序功能 #

在前端列表页面添加排序控件，让用户选择排序方式：

1. 添加排序控件
   在Leadership列表模板中插入以下代码：

<form method="get" class="leadership-sort-form">
    <div class="leadership-sort">
        <label for="leadership-orderby">排序方式：</label>
        <select id="leadership-orderby" onchange="this.form.submit()">
            <option value="menu_order" <?php echo ( isset( $_GET['orderby'] ) && $_GET['orderby'] == 'menu_order' ) ? 'selected' : ''; ?>>菜单顺序</option>
            <option value="title" <?php echo ( isset( $_GET['orderby'] ) && $_GET['orderby'] == 'title' ) ? 'selected' : ''; ?>>标题</option>
            <option value="last_name" <?php echo ( isset( $_GET['orderby'] ) && $_GET['orderby'] == 'last_name' ) ? 'selected' : ''; ?>>姓氏</option>
        </select>
        <select id="leadership-order" onchange="this.form.submit()">
            <option value="ASC" <?php echo ( isset( $_GET['order'] ) && $_GET['order'] == 'ASC' ) ? 'selected' : ''; ?>>升序</option>
            <option value="DESC" <?php echo ( isset( $_GET['order'] ) && $_GET['order'] == 'DESC' ) ? 'selected' : ''; ?>>降序</option>
        </select>
        <input type="hidden" name="post_type" value="leadership">
        <?php wp_nonce_field( 'leadership_sort_nonce', 'leadership_sort' ); ?>
    </div>
</form>

2. 添加安全验证（可选）
   在pre_get_posts的前端排序处理部分添加nonce验证：

// 插入到前端排序处理的开头
if ( ! isset( $_GET['leadership_sort'] ) || ! wp_verify_nonce( $_GET['leadership_sort'], 'leadership_sort_nonce' ) ) {
    return;
}

内容的提问来源于stack exchange，提问作者S.N. Beagle