如何创建WordPress动态区块Zip安装包？解决文件缺失与区块不显示问题

• 修正files字段的路径格式：将/build改为build/（移除开头的斜杠，使用相对路径）——npm的files字段仅识别相对路径，绝对路径会被忽略。修改后的配置如下：

"files": [
    "build/",
    "plugin.js",
    "plugin.php",
    "functions-library.php"
],

• 检查.gitignore或.npmignore文件：如果这两个文件中存在排除plugin.php、plugin.js等目标文件的规则，npm会优先遵循忽略规则，即使files字段中声明了这些文件也会被排除。确保目标文件未被这两个配置文件标记为忽略。
• 确认文件位置：确保plugin.js、plugin.php等文件与package.json处于同一目录下，若文件在子目录中，需调整files字段内的路径（例如文件在src目录下则写src/plugin.php）。

动态区块作为WordPress插件，Zip包必须包含以下关键内容及配置：

• 插件主文件（如plugin.php）：必须带有WordPress插件头部注释，示例：

<?php
/*
Plugin Name: 你的动态区块插件名称
Plugin URI: https://example.com/
Description: 自定义Gutenberg动态区块
Version: 1.0.0
Author: 你的名字
License: GPL2
*/

同时文件内需包含区块注册逻辑，示例：

// 引入辅助函数文件
require_once plugin_dir_path( __FILE__ ) . 'functions-library.php';

// 注册动态区块
function register_my_dynamic_block() {
    // 加载区块元数据文件
    register_block_type( __DIR__ . '/build' );
}
add_action( 'init', 'register_my_dynamic_block' );

• block.json文件：这是Gutenberg区块的核心配置文件，必须放在build目录（或你注册区块时指定的路径）内，示例内容：

{
    "apiVersion": 3,
    "name": "my-plugin/my-dynamic-block",
    "title": "我的动态区块",
    "category": "widgets",
    "icon": "smiley",
    "description": "自定义动态区块",
    "supports": {
        "html": false
    },
    "editorScript": "file:./index.js",
    "editorStyle": "file:./index.css",
    "style": "file:./style-index.css",
    "render": "file:./render.php" // 动态区块的PHP渲染文件（若使用函数渲染可改为在register_block_type中指定render_callback）
}

• 完整的build目录：必须包含wp-scripts编译生成的所有文件，包括index.js、index.css、style-index.css、index.asset.php（该文件包含脚本依赖与版本号，WordPress依赖它正确加载前端资源），若有自定义渲染文件如render.php也需包含在内。
• 依赖文件正确引入：确保functions-library.php等辅助文件在plugin.php中通过require_once正确引入，避免区块渲染时出现函数未定义错误。
• plugin.js（若存在）：如果该文件是额外的前端脚本，需在PHP中通过wp_enqueue_script正确注册并关联到区块，或在block.json中指定对应的脚本路径。

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