使用wp_update_post更新自定义文章类型后，Gutenberg显示经典块的转换方法问询

WordPress确实提供了内置工具可以将纯HTML转换为Gutenberg可识别的块结构，核心思路是先把HTML解析成块对象，再序列化成Gutenberg兼容的内容格式，替代直接存储纯HTML。

具体实现步骤 #

1. 清理HTML内容：先过滤不安全标签，同时优化后续解析的准确性。
2. 解析HTML为块结构：使用WP_Block_Parser类将纯HTML解析成块数组，它会自动识别段落、标题、列表等常见HTML元素，并映射为对应的Gutenberg核心块。
3. 序列化块内容：用serialize_blocks()函数把解析后的块数组转换为Gutenberg能识别的字符串格式。
4. 更新文章：将序列化后的内容传入wp_update_post()完成更新。

代码示例 #

// 假设$frontend_html是从前端获取的纯HTML内容
$post_id = 123; // 你的自定义文章ID

// 清理HTML内容
$clean_html = wp_kses_post( $frontend_html );

// 确保块解析器类已加载
if ( ! class_exists( 'WP_Block_Parser' ) ) {
    require_once ABSPATH . 'wp-includes/class-wp-block-parser.php';
}

// 解析HTML为块结构
$block_parser = new WP_Block_Parser();
$blocks = $block_parser->parse( $clean_html );

// 序列化块内容
$block_content = serialize_blocks( $blocks );

// 更新文章内容
wp_update_post( array(
    'ID'           => $post_id,
    'post_content' => $block_content,
) );

注意事项 #

• 该方法仅支持转换Gutenberg核心块对应的HTML元素，复杂的自定义HTML或特殊标签可能仍会被包裹在Classic块中，这取决于块解析器的支持范围。
• 如果你的REST API端点在前端异步调用，要注意做好权限验证，避免未授权的内容更新操作。

内容的提问来源于stack exchange，提问作者KodeFor.Me