WordPress Playground 中 Blueprint 导入错误的解决方案

问题背景

在使用 WordPress Playground 时，开发者可能会遇到 Blueprint 导入错误的问题。具体表现为尝试导入 WordPress 文件时出现 "Invalid blueprint: value of tag 'step' must be in oneOf at /steps/1" 的错误提示。

错误原因分析

这个错误的核心原因是 Blueprint 配置文件中使用了不正确的步骤定义。在文档中存在一个拼写错误，导致开发者使用了错误的步骤名称。正确的步骤名称应为 "importWordPressFiles"，而文档中错误地写成了 "importWordPressFilesStep"。

解决方案

要解决这个问题，需要按照以下格式修改 Blueprint 配置文件：

{
  "step": "importWordPressFiles",
  "wordPressFilesZip": {
    "resource": "url",
    "url": "文件下载地址"
  }
}

完整示例

以下是一个可用的完整 Blueprint 配置示例：

{
  "landingPage": "/",
  "preferredVersions": {
    "php": "8.0",
    "wp": "latest"
  },
  "phpExtensionBundles": [
    "kitchen-sink"
  ],
  "features": {
    "networking": true
  },
  "steps": [
    {
      "step": "importWordPressFiles",
      "wordPressFilesZip": {
        "resource": "url",
        "url": "https://example.com/your-wordpress-files.zip"
      }
    }
  ]
}

注意事项

1. 确保文件下载地址可访问且没有 CORS 限制
2. 目前 WordPress Playground 不会自动生成 Blueprint 文件，开发者需要手动创建或修改
3. 对于复杂的插件设置（如需要 WooCommerce 的插件），建议先在 Playground 中完成所有配置，然后导出为 ZIP 文件，最后通过 importWordPressFiles 步骤导入

最佳实践

1. 先在 Playground 中完成所有必要的设置和配置
2. 使用导出功能获取 WordPress 文件
3. 创建包含 importWordPressFiles 步骤的 Blueprint 文件
4. 测试 Blueprint 确保一切按预期工作

这个解决方案已经帮助多位开发者解决了 Blueprint 导入问题，文档中的错误也已得到修复。