如何使用ACF Gallery自定义字段为WP Grid Builder填充网格内容

你的实现方向存在多处核心错误，无法达到预期效果，具体问题如下： #

• 语法错误：WordPress过滤器钩子只能返回单个值，你写的return $query_args,$images;不符合PHP语法和钩子要求，这个钩子必须返回$query_args数组，额外返回的$images不会被识别，甚至会触发报错。
• 逻辑无效：你读取ACF Gallery字段、遍历取图片ID的代码没有和WPGRIDBUILDER的查询参数产生关联，这段代码执行后没有修改任何查询规则，对网格内容输出不会产生任何影响。
• 内容类型逻辑错误：你要展示ACF字段里的图片，图片本身属于WordPress内置的attachment（附件）内容类型，不需要指定你自己的自定义文章类型realizacje-cpt作为查询对象。

正确的实现逻辑如下： #

首先确认你的ACF Gallery字段的返回格式设置为「ID数组」，可以简化后续逻辑，避免额外的字段取值操作，调整后的代码示例：

function custom_grid_query_from_acf_gallery( $query_args, $grid_id ) {
    // 只对你指定的ID为2的网格生效
    if ( 2 !== $grid_id ) {
        return $query_args;
    }

    // 读取当前页面/文章的ACF Gallery字段值，提前做非空判断避免报错
    $gallery_image_ids = get_field( 'gallery-cf' );
    if ( empty( $gallery_image_ids ) || ! is_array( $gallery_image_ids ) ) {
        return $query_args;
    }

    // 修改查询参数：查询附件类型，只返回Gallery里的图片ID对应的内容
    $query_args['post_type'] = 'attachment';
    $query_args['post_status'] = 'inherit'; // 附件的发布状态固定为inherit
    $query_args['post__in'] = $gallery_image_ids;
    $query_args['orderby'] = 'post__in'; // 保持和ACF Gallery里的图片排序一致

    return $query_args;
}
add_filter( 'wp_grid_builder/grid/query_args', 'custom_grid_query_from_acf_gallery', 10, 2 );

如果你的ACF Gallery字段返回格式是数组格式，把读取ID的部分替换成下面的代码即可：

$gallery_images = get_field( 'gallery-cf' );
if ( empty( $gallery_images ) || ! is_array( $gallery_images ) ) {
    return $query_args;
}
$gallery_image_ids = wp_list_pluck( $gallery_images, 'ID' );

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