如何在HTML任意位置添加自定义占位符调用收藏按钮函数？

核心问题 #

1. 直接调用the_favorites_button()会立即输出内容，而地图插件采用占位符替换的方式渲染列表项，导致按钮提前显示在列表外部，无法对应到模板中的{is_favorite}位置。
2. 代码中未正确定义$post_id变量，导致部分文章无法生成有效收藏按钮。

解决方案步骤 #

1. 用输出缓冲捕获收藏按钮HTML

the_favorites_button()函数会直接输出内容，我们需要通过**输出缓冲（OB）**捕获它的HTML代码，再赋值给占位符对应的变量，避免提前输出。

2. 修正文章ID参数

循环中执行the_post()后，当前文章ID为$post->ID，替换原代码中未定义的$post_id；单站点环境下$site_id可传入get_current_blog_id()，或省略（插件默认取当前站点）。

3. 关联按钮HTML到占位符

将捕获到的按钮HTML加入$replace_data数组，对应模板中的{is_favorite}占位符。

修改后的循环代码片段 #

if ( $wpgmp_the_query->have_posts() ) {
    while ( $wpgmp_the_query->have_posts() ) {
        $wpgmp_the_query->the_post();
        global $post;
        
        // 捕获收藏按钮的HTML内容
        ob_start();
        // 使用当前文章ID替换未定义的$post_id，$site_id按需传入
        the_favorites_button($post->ID, get_current_blog_id());
        $favorite_button = ob_get_clean();
        
        $places         = array();
        $content        = $infowindow_post_view_source;
        $category_names = '';
        if ( isset( $value['acf_key'] ) ) {
            $acf_key        = get_post_meta( $post->ID, $value['acf_key'], true );
        } else {
            $acf_key = array();
        }

        if ( empty( $acf_key['lat'] ) && empty( $acf_key['lng'] ) ) {
            if ( empty( $value['latitude'] ) or empty( $value['longitude'] ) ) {
                continue; 
            }
            // 检查文章是否关联当前地图ID
            if ( '_wpgmp_location_address' == $value['address'] ) {
                $wpgmp_map_ids = get_post_meta( $post->ID, '_wpgmp_map_id', true );
                $wpgmp_map_id  = unserialize( $wpgmp_map_ids );

                if ( ! is_array( $wpgmp_map_id ) ) {
                    $wpgmp_map_id = array( $wpgmp_map_ids );
                }
                if ( ! in_array( $map->map_id, $wpgmp_map_id ) ) {
                    continue;
                }
            }
        }

        $replace_data['post_title']   = get_the_title();
        // 将按钮HTML绑定到{is_favorite}占位符
        $replace_data['is_favorite'] = $favorite_button;
        
        // 后续的内容替换、地点数据填充逻辑...
    }
    wp_reset_postdata();
}

额外检查 #

• 确认模板中的{is_favorite}占位符位置正确（当前模板已放在.fc-bookmark-info内，无需调整）。
• 如果仍有文章不显示按钮，检查这些文章是否满足循环中的过滤条件（如经纬度存在、关联了当前地图ID）——continue会跳过不符合条件的文章，这类文章不会生成列表项，自然不会显示按钮。

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