本文详解如何通过 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）中正确输出所有关联文章内容的推荐写法：
<?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 echo esc_url( get_permalink( $post_id ) ); ?>" 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 自定义关系展示逻辑的核心实践。
