如何在WordPress中使用register_block_pattern加载外部文件的content

完全可以实现，你之前的问题在于没有正确获取文件内容并传递给register_block_pattern的content参数，以下是正确的实现方式：

核心思路 #

register_block_pattern的content参数需要的是区块的HTML字符串，而不是文件URL或直接执行文件。我们可以通过file_get_contents读取单独文件中的未压缩代码，再将其作为字符串传递给content。

步骤1：创建单独的模式内容文件 #

在插件目录下新建一个HTML文件（比如my-pattern-content.html），写入未压缩的区块代码：

<!-- wp:group {"backgroundColor":"vivid-green-cyan","layout":{"type":"constrained"}} -->
<div class="wp-block-group has-vivid-green-cyan-background-color has-background">
    <!-- wp:heading -->
    <h2 class="wp-block-heading">Testing my block</h2>
    <!-- /wp:heading -->
</div>
<!-- /wp:group -->

步骤2：修改注册函数读取文件内容 #

替换你原来的注册代码，用file_get_contents读取上述文件：

function register_my_pattern() {
    // 获取模式文件的绝对路径
    $pattern_file = plugin_dir_path( __FILE__ ) . 'my-pattern-content.html';
    
    // 先检查文件是否存在，避免报错
    if ( ! file_exists( $pattern_file ) ) {
        return;
    }
    
    // 读取文件内容作为区块模式的content
    $pattern_content = file_get_contents( $pattern_file );
    
    register_block_pattern(
        'my-plugin/my-pattern',
        array(
            'title'      => __( 'My Pattern Name', 'my-plugin' ),
            'categories' => array( 'my-pattern-category' ),
            'content'    => $pattern_content,
        )
    );
}
add_action( 'init', 'register_my_pattern' );

为什么之前的方法无效？ #

• 直接使用plugin_dir_url返回的是文件的网络地址，content参数需要的是HTML字符串，所以编辑器会直接显示URL文本。
• 使用include时，如果文件里是纯HTML，include会直接把内容输出到页面（破坏WordPress的输出流程），而不是将内容作为字符串传递给content参数；即使在文件里用return返回字符串，也不如file_get_contents直接读取纯HTML文件方便。

进阶：批量加载多个模式 #

如果你有很多预设计的区块模式，可以批量读取某个目录下的所有HTML文件自动注册，提升管理效率：

function register_all_my_patterns() {
    // 存放模式文件的目录
    $patterns_dir = plugin_dir_path( __FILE__ ) . 'patterns/';
    
    // 检查目录是否存在
    if ( ! is_dir( $patterns_dir ) ) {
        return;
    }
    
    // 遍历目录下所有HTML文件
    $pattern_files = glob( $patterns_dir . '*.html' );
    
    foreach ( $pattern_files as $file ) {
        // 从文件名生成模式ID和标题（例如：my-awesome-pattern.html → ID: my-plugin/my-awesome-pattern，标题: My Awesome Pattern）
        $file_name = basename( $file, '.html' );
        $pattern_id = 'my-plugin/' . $file_name;
        $pattern_title = ucwords( str_replace( '-', ' ', $file_name ) );
        
        $pattern_content = file_get_contents( $file );
        
        register_block_pattern(
            $pattern_id,
            array(
                'title'      => __( $pattern_title, 'my-plugin' ),
                'categories' => array( 'my-pattern-category' ),
                'content'    => $pattern_content,
            )
        );
    }
}
add_action( 'init', 'register_all_my_patterns' );

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