使用Advanced Custom Fields查询游艇CPT特色列表的实现问题

核心问题定位 #

• 自定义文章类型查询参数缺失：后续修改的多版查询代码中，均未在WP_Query参数内指定post_type => 'yachts'，默认仅查询WordPress内置的post类型，完全不会拉取「yachts」CPT的内容
• 字段值匹配逻辑错误：将字段从复选框切换为真/假类型后，ACF存储在数据库的字段值为「1（勾选）/ 0（未勾选）」，之前沿用的'yes'是复选框字段的返回值，无法匹配到已标记为特色的条目
• 元查询规则不匹配：真/假字段为精确匹配值，无需使用LIKE比较符，默认=即可满足查询需求
• 自定义字段输出遗漏：调用get_post_meta()时未添加echo输出语句，导致即使获取到价格字段也不会渲染到页面

修正后可直接运行的完整代码 #

<section class="featured-yachts">
    <h2>FEATURED YACHTS</h2>
    <?php
    $args = array(
        'posts_per_page' => -1,
        'post_type' => 'yachts',
        'meta_query' => array(
            array(
                'key' => 'featured',
                'value' => '1',
                'compare' => '='
            )
        ),
        'post_status' => 'publish'
    );
    $featured_yachts = new WP_Query( $args );
    if ( $featured_yachts->have_posts() ) : ?>
        <ul class="featured-yachts-list">
            <?php while ( $featured_yachts->have_posts() ) : $featured_yachts->the_post(); ?>
                <li class="featured-yacht-item">
                    <a href="<?php the_permalink(); ?>">
                        <h3 class="yacht-title"><?php the_title(); ?></h3>
                        <!-- 可直接扩展其他自定义字段输出 -->
                        <p class="yacht-price">价格：<?php the_field( 'price' ); ?></p>
                        <?php if ( has_post_thumbnail() ) : ?>
                            <div class="yacht-thumb">
                                <?php the_post_thumbnail( 'medium' ); ?>
                            </div>
                        <?php endif; ?>
                    </a>
                </li>
            <?php endwhile; ?>
        </ul>
    <?php else : ?>
        <p>暂未设置特色展示游艇</p>
    <?php endif; ?>
    <?php wp_reset_postdata(); ?>
</section>

后续扩展说明 #

• 所有游艇详情页配置的自定义字段，均可在上述循环内通过the_field('字段名')直接输出，无需额外修改查询逻辑
• 若需要限制展示数量，可将posts_per_page改为对应数值（例如3表示最多展示3条特色游艇）

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