WordPress REST API meta_query冲突解决指南

// 为REST API添加自定义字段过滤器
function chld_thm_post_meta_request_params( $args, $request ) {
    $meta_query_args = array(
        'relation' => 'AND'
    );

    // meta query for course number
    if (isset($request['course_no']) && $request['course_no'] !== null) {
        $meta_query_args[] = array(
            'key'     => 'course_no',
            'value'   => $request['course_no'],
            'compare' => '='
        );
    }

    // meta query for course cycles
    if (isset($request['course_cycles']) && $request['course_cycles'] !== null) {
        $courseCycleMetaQuery = array(
            'relation' => 'OR'
        );
        foreach (explode(",", $request['course_cycles']) as $course_cycle) {
            $courseCycleMetaQuery[] = array(
                'key' => 'course_cycles',
                'value' => serialize($course_cycle), // 注意：如果存储的是序列化数据
                'compare' => 'LIKE'
            );
        }
        $meta_query_args[] = $courseCycleMetaQuery;
    }

    // meta query for course type
    if (isset($request['course_type']) && $request['course_type'] !== null) {
        $meta_query_args[] = array(
            'key'     => 'course_type',
            'value'   => $request['course_type'],
            'compare' => '='
        );
    }

    // 将构建好的meta_query添加到查询参数中
    if (count($meta_query_args) > 1 || (count($meta_query_args) === 1 && isset($meta_query_args['relation']))) {
        $args['meta_query'] = $meta_query_args;
    }

    return $args;
}
add_filter( 'rest_course_query', 'chld_thm_post_meta_request_params', 99, 2 );

// 错误的示例：直接覆盖 meta_query
function my_custom_pre_get_posts( $query ) {
    if ( $query->is_main_query() && ! is_admin() ) {
        $meta_query_order = array(
            'order_course_date' => array(
                'key' => 'course_date_start',
                'value' => date("Ymdhi"),
                'compare' => '<='
            )
        );
        // 这里的set操作会直接覆盖掉之前设置的meta_query
        $query->set('meta_query', $meta_query_order);
        $query->set('orderby', 'order_course_date');
        $query->set('order', 'ASC');
    }
}
add_action( 'pre_get_posts', 'my_custom_pre_get_posts' );

function my_custom_pre_get_posts( $query ) {
    // 确保只影响主查询且不是在后台
    if ( $query->is_main_query() && ! is_admin() ) {

        // 1. 获取当前已存在的 meta_query
        $existing_meta_query = $query->get('meta_query');

        // 2. 定义需要添加的新的 meta_query 条件
        $new_meta_query_conditions = array(
            'order_course_date' => array( // 可以是命名键，也可以是数字键
                'key' => 'course_date_start',
                'value' => date("Ymdhi"),
                'compare' => '<='
            )
        );

        // 3. 合并现有的 meta_query 和新的条件
        $merged_meta_query = array();
        if ( is_array( $existing_meta_query ) ) {
            // 如果现有的是数组，则合并
            $merged_meta_query = array_merge( $existing_meta_query, $new_meta_query_conditions );
        } else {
            // 如果现有不是数组（可能为空或null），则直接使用新条件
            $merged_meta_query = $new_meta_query_conditions;
        }

        // 4. 将合并后的 meta_query 设置回查询对象
        $query->set('meta_query', $merged_meta_query);

        // 设置排序参数
        $query->set('orderby', 'order_course_date');
        $query->set('order', 'ASC');
    }
}
add_action( 'pre_get_posts', 'my_custom_pre_get_posts' );