本文详解如何通过 CMB2 的 cmb2-attached-posts 字段获取并安全渲染关联文章的标题、缩略图等内容，避免误用主循环导致内容错乱，直接基于 ID 调用 WordPress 原生模板函数即可高效实现。

本文详解如何通过 cmb2 的 `cmb2-attached-posts` 字段获取并安全渲染关联文章的标题、缩略图等内容，避免误用主循环导致内容错乱，直接基于 id 调用 wordpress 原生模板函数即可高效实现。

在使用 CMB2 的 cmb2-attached-posts 扩展时，你已成功将多个自定义文章（如“产品”或“案例”）关联到某个分类类自定义文章类型（如 category_item）中。该字段存储的是一个整数 ID 数组（例如 [123, 456, 789]），而非完整的 post 对象。因此，无需调用 get_post() 构建对象——WordPress 大多数模板函数（如 get_the_title()、get_the_post_thumbnail()、get_the_excerpt() 等）原生支持直接传入 $post_id 参数。

以下是在分类页（如 single-category_item.php 或 archive-category_item.php）中正确输出所有关联文章内容的推荐写法：

Teleport tsh SSH (Identity-First SSH Access, no passwords/static keys)

使用tbot机器ID身份文件配合tsh CLI，通过Teleport访问控制SSH登录托管主机或执行远程命令。

下载

<?php // 获取当前分类文章的关联文章 ID 数组
$attached_post_ids = get_post_meta( get_the_ID(), 'pr2_cmb2_attached_posts', true );

// 确保是数组且非空（避免 warning）
if ( ! empty( $attached_post_ids ) && is_array( $attached_post_ids ) ) :
    foreach ( $attached_post_ids as $post_id ) {
        // 安全检查：确保文章存在且已发布
        if ( get_post_status( $post_id ) === 'publish' ) {
            ?><article class="attached-post"><h3><?php echo esc_html( get_the_title( $post_id ) ); ?></h3>
                <?php echo get_the_post_thumbnail( $post_id, 'medium', [ 'class' => 'wp-post-image' ] ); ?>
                <div class="excerpt">
                    <?php echo wp_kses_post( wp_trim_words( get_post_field( 'post_content', $post_id ), 30 ) ); ?>
</div>
                <a href="<?php%20echo%20esc_url(%20get_permalink(%20%24post_id%20)%20);%20?>" class="read-more">查看详情</a>
            </article><?php }
    }
endif;
?>

⚠️ 关键注意事项：

• ❌ 不要将 get_post($id) 的返回值用于 have_posts() / the_post() 循环——这会覆盖主查询，导致页面标题、内容等显示异常；
• ✅ 直接使用 $post_id 调用 get_the_*() 函数更轻量、更安全；
• ✅ 建议添加 get_post_status() 校验，避免输出草稿或私密文章；
• ✅ 使用 esc_html()、esc_url() 和 wp_kses_post() 等函数保障输出安全；
• ✅ 若需排序或分页，应改用 WP_Query（配合 'post__in' => $attached_post_ids 和 'orderby' => 'post__in' 保持原始顺序）。

总结：CMB2 的 attached posts 字段本质是 ID 映射表，善用 WordPress 的 ID 直接调用机制，既能提升性能，又能规避主循环污染风险——这是构建可维护、健壮的 WordPress 自定义关系展示逻辑的核心实践。