ACF短代码无法获取关联自定义文章的自定义字段该如何解决

代码存在的核心问题 #

1. 变量类型不匹配：从你打印的$intervenant结果可以看出，它是单个WP_Post对象，并非多篇文章组成的数组，直接对单个对象执行foreach逻辑完全错误，遍历得到的是对象的属性值，无法进入正确的文章上下文，自然拿不到自定义字段。
2. 短代码输出规则错误：WordPress短代码要求必须return输出内容，不能直接echo，否则内容会渲染到页面的错误位置。
3. 上下文重置缺失：如果手动修改全局$post变量，使用完必须调用wp_reset_postdata()恢复默认上下文，避免影响页面其他循环逻辑。

修正后的代码方案 #

这里提供两种写法，任选一种即可：

方案1：直接传文章ID获取字段（更简洁，不需要修改全局变量）

add_shortcode('display_acf_image', 'acf_image');
function acf_image() {
    // 开启输出缓冲，收集内容后统一返回
    ob_start();
    $intervenant = get_field('intervenant');
    
    if( $intervenant ): 
        // 第二个参数传入关联文章ID，直接获取自定义字段
        $job = get_field('job', $intervenant->ID);
        // 假设你的ACF image字段返回格式为数组，如果是ID/URL可自行调整取值逻辑
        $image = get_field('image', $intervenant->ID);
?>
        <h3><?php echo esc_html( $intervenant->post_title ); ?></h3>
        <?php if($job): ?>
            <h4><?php echo esc_html($job); ?></h4>
        <?php endif; ?>

        <?php if($image): 
            $img_url = $image['url'];
            $img_alt = $image['alt'] ? $image['alt'] : $intervenant->post_title;
        ?>
            <img src="<?php echo esc_url($img_url); ?>" alt="<?php echo esc_attr($img_alt); ?>">
        <?php endif; ?>

        <!-- 输出关联文章正文 -->
        <div class="intervenant-content">
            <?php echo apply_filters('the_content', $intervenant->post_content); ?>
        </div>
<?php 
    endif;
    // 返回收集到的内容
    return ob_get_clean();
}

方案2：使用setup_postdata切换上下文（和原生循环写法一致）

add_shortcode('display_acf_image', 'acf_image');
function acf_image() {
    ob_start();
    $intervenant = get_field('intervenant');
    
    if( $intervenant ): 
        global $post;
        // 把全局post变量替换为关联的intervenant文章
        $post = $intervenant;
        setup_postdata($post);
?>
        <h3><?php the_title(); ?></h3>
        <h4><?php the_field('job'); ?></h4>
        
        <?php 
        $image = get_field('image');
        if($image): 
            $img_url = $image['url'];
            $img_alt = $image['alt'] ? $image['alt'] : get_the_title();
        ?>
            <img src="<?php echo esc_url($img_url); ?>" alt="<?php echo esc_attr($img_alt); ?>">
        <?php endif; ?>

        <div class="intervenant-content">
            <?php the_content(); ?>
        </div>
<?php 
        // 必须重置post数据，否则会影响页面其他的文章循环
        wp_reset_postdata();
    endif;
    return ob_get_clean();
}

补充说明 #

如果你的ACF image字段设置的返回格式为附件ID，获取图片地址的写法调整为：

$img_url = wp_get_attachment_image_url($image, 'full'); // 第二个参数可以指定图片尺寸，比如medium、thumbnail

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