在WordPress自定义文章类型单页输出ACF自定义字段遇问题求助

先解决模板文件失效的问题 #

1. 修正模板文件后缀：你使用的single-myCustomPostType.htm不是WordPress默认识别的模板格式，需要改成single-myCustomPostType.php，确保系统能正确加载这个自定义文章类型的单页模板。
2. 解除编辑器模板覆盖：在WordPress站点编辑器中找到对应模板，点击「还原」按钮，这样系统会优先加载主题文件中的模板，之后修改single-myCustomPostType.php的内容就能正常生效了。

ACF字段输出的优化方案 #

方案1：PHP模板内正确调用（适合传统开发流） #

确保模板内存在正确的文章循环，the_field()依赖全局$post对象，示例代码：

<?php
get_header();

if ( have_posts() ) :
    while ( have_posts() ) : the_post();
        // 输出自定义字段
        the_field('mycustomfield');
        // 如果需要在循环外调用，可传入文章ID
        // the_field('mycustomfield', get_the_ID());
    endwhile;
endif;

get_footer();
?>

方案2：区块主题适配方案（可视化编辑流） #

方法A：ACF短代码直接插入

在站点编辑器的模板中，添加「自定义HTML」或「段落」区块，插入ACF短代码即可输出字段：

[acf field="mycustomfield" post_id="current"]

• post_id="current"表示调用当前文章的字段，可替换为具体文章ID。

方法B：自定义ACF区块

1. 在ACF后台创建自定义区块，设置字段关联，然后在区块的渲染模板中调用the_field()输出内容。
2. 回到站点编辑器，直接将这个自定义区块拖入模板的对应位置，无需修改PHP文件，完全适配区块主题的可视化工作流。

方法C：注册动态区块（进阶开发）

通过代码注册WordPress动态区块，在区块的回调函数中调用ACF函数渲染字段，示例代码（放在子主题的functions.php中）：

function register_acf_dynamic_block() {
    register_block_type('acf/custom-field-block', array(
        'render_callback' => 'render_acf_custom_field_block',
    ));
}
add_action('init', 'register_acf_dynamic_block');

function render_acf_custom_field_block($attributes) {
    ob_start();
    // 输出自定义字段
    the_field('mycustomfield');
    return ob_get_clean();
}

注册完成后，即可在站点编辑器中找到这个动态区块并添加到模板。

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