如何Hook Elementor Posts Widget添加ACF自定义H2标题

字符串替换不是该需求的最优实现，不需要解析完整HTML，直接用Elementor官方提供的循环阶段专用钩子即可，兼容性更强，也不需要做复杂的字符串处理。

核心实现逻辑 #

不要使用elementor/widget/render_content这个全局过滤器——该钩子触发时，小工具的完整HTML已经输出完毕，文章循环已经执行结束，你自然拿不到循环过程中单篇文章的上下文ID，才会需要从HTML字符串里正则匹配ID，这种方案只要后续Elementor调整文章卡片的HTML结构、类名就会失效。

Elementor的文章类小工具（免费版Posts、Pro版Posts/Portfolio/Archive Posts、主题归档渲染）在单篇文章循环的各个渲染节点都提供了精准的动作钩子，其中正好在文章标题渲染完成后触发的钩子为elementor/widget/posts/after_post_title，该钩子触发时处于WordPress主循环上下文，可直接获取当前文章ID，直接输出内容即可插入到标题下方位置。

可直接使用的代码 #

将以下代码加入主题的functions.php或者自定义功能插件中即可：

// 给Elementor Posts小工具每篇文章标题下插入ACF自定义字段的H2内容
add_action( 'elementor/widget/posts/after_post_title', function() {
    // 直接从当前循环上下文获取文章ID，无需额外解析
    $post_id = get_the_ID();
    // 读取ACF自定义字段值，字段名替换为你自己的字段键
    $extra_heading = get_field( 'extra_heading', $post_id );
    
    // 字段值非空时输出H2标签，输出内容做转义避免XSS问题
    if ( ! empty( $extra_heading ) ) {
        printf(
            '<h2 class="elementor-post-extra-heading">%s</h2>',
            esc_html( $extra_heading )
        );
    }
}, 10 );

扩展场景适配 #

• 如果需要区分不同的Posts小工具实例（比如页面上有多个文章列表，只给指定列表加内容），可以在回调中获取当前渲染的小工具实例，通过小工具设置项做判断：

add_action( 'elementor/widget/posts/after_post_title', function() {
    // 获取当前渲染的小工具实例
    $current_widget = \Elementor\Plugin::instance()->widgets_manager->get_current_widget();
    $widget_settings = $current_widget->get_settings();
    
    // 示例：只给开启了"显示额外标题"自定义开关的小工具输出内容
    if ( empty( $widget_settings['show_extra_heading'] ) ) {
        return;
    }

    $post_id = get_the_ID();
    $extra_heading = get_field( 'extra_heading', $post_id );
    if ( ! empty( $extra_heading ) ) {
        printf( '<h2 class="elementor-post-extra-heading">%s</h2>', esc_html( $extra_heading ) );
    }
}, 10 );

• 如果是Elementor主题构建器渲染的归档页面，把钩子名换成elementor/theme/after_post_title即可，逻辑完全一致。
• 如果使用的是3.7以前的老旧Elementor版本没有对应位置钩子，可以在elementor/widget/posts/loop_start钩子触发时临时挂载the_title过滤器给标题追加内容，在elementor/widget/posts/loop_end触发时移除过滤器，这种方案依然比正则替换整段HTML的兼容性更好。

注意：任何情况下都不推荐通过正则匹配渲染完成的HTML字符串来插入内容，这类方案的维护成本极高，只要插件版本迭代调整前端HTML结构就会直接失效。

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