批量创建页面功能配置指南

概述

工作流程

系统交互流程

1. 用户在页面管理界面中点击"批量创建"按钮
   ↓
2. 系统获取该页面的模板及其子模板信息
   ↓
3. 如果子模板的 schema 中配置了 batch_create_url，则显示批量创建选项
   ↓
4. 用户点击某个模板的批量创建选项
   ↓
5. 系统生成包含认证信息的 batch_create_url 并在 iframe 中打开
   ↓
6. 用户在 iframe 中进行批量导入操作
   ↓
7. iframe 中的页面通过 API 调用创建页面

配置步骤

1. 在模板 Schema 中添加 batch_create_url

{% schema %}
  {
    "name": "页面模板名称",
    "description": "页面模板描述",
    "batch_create_url": "https://your-import-service.com/batch_import", // 或者 "/s/batch_import"（模版中静态地址）
    "settings": [
      // ... 其他模板设置
    ]
  }
{% endschema %}

2. batch_create_url 的两种形式

2.1 绝对 URL（推荐用于外部服务）

{
  "batch_create_url": "https://external-service.com/batch_import"
}

https://external-service.com/batch_import?
  token=JWT+eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJleHAiOjE3NzAyOTY1NTh9...
  &site_id=34
  &full_path=%2F80ec12
  &template_name=page
  &template_style=style

2.2 相对路径 URL（建议页面构建在模版中静态页面中）

{
  "batch_create_url": "/s/batch_import"
}

http://site-demo.baklib.localhost:3000/s/batch_import?
  token=JWT+eyJhbGciOiJIUzI1NiJ9...
  &site_id=34
  &full_path=%2Fparent
  &template_name=page
  &template_style=style

3. 完整的模板配置示例

{%
  # 模板的 HTML/Liquid 内容
%}

{% schema %}
  {
    "name": "数据批量导入页面",
    "description": "支持批量创建页面的模板",
    "thumb_url": "images/theme/batch_import_page.png",
    "batch_create_url": "https://api.example.com/pages/batch_import",
    "settings": [
      {
        "id": "title",
        "type": "text",
        "label": "页面标题"
      },
      {
        "id": "description",
        "type": "richtext",
        "label": "页面描述"
      },
      {
        "id": "enable_batch_import",
        "type": "checkbox",
        "label": "启用批量导入",
        "default": true
      }
    ]
  }
{% endschema %}

在批量创建 iframe 中的操作

接收的查询参数

调用 API 创建页面

最佳实践

1. 选择合适的 URL 类型

• 外部服务：使用绝对 URL（完整的 http/https 地址）
• 站点内部：使用相对路径（以 / 开头）

2. 安全考虑

• 传递给 iframe 的 token 是临时 API token，有过期时间限制
• 确保你的批量创建服务在安全的 HTTPS 连接上运行
• 验证 site_id 和 full_path 参数的有效性

3. 用户体验

• 在模板中明确说明支持批量创建功能
• 在 batch_create_url 指向的页面中提供清晰的导入说明
• 实现进度提示和错误处理

4. 模板命名规范

• template_name: 模板的基础名称（如 page, article）
• template_style: 模板的风格变体（如 default, dark, compact）

故障排查

问题：批量创建选项不显示

问题：iframe 加载失败

问题：无法创建页面