FAQ.

学习 DXPR Builder参考获取帮助

如何向现有内容类型添加 DXPR Builder？

请使用内容类型已有的长文本字段，例如 Body，或添加一个字段。然后将该字段的 Format 设为 DXPR Builder（在 Manage display 下）。不需要子模块；DXPR Builder 核心模块负责渲染。在内容类型上使用 DXPR Builder 中有具体步骤。

将鼠标悬停在内容区域上时，为什么不显示编辑控件？

请按顺序检查以下各项：

  1. 您位于已保存的页面上，而不是编辑表单上。DXPR Builder 在页面本身上工作。
  2. 您的角色拥有 Edit with DXPR Builder 权限（位于 /admin/people/permissions），并且可以编辑该内容。
  3. 您的账户有有效的电子邮件地址。构建器不会为没有电子邮件地址的账户加载。
  4. 免费版只允许一位编辑。更多编辑人员需要付费订阅。
  5. 如果您的用户档案关闭了 Start editor when page loads，请先点击构建器工具栏上的眼睛图标。

产品密钥控制什么？

产品密钥将您的站点与您的 DXPR 账户关联，并决定您的许可数量（多少用户可以编辑）和内容项上限。请在 /admin/dxpr_studio/dxpr_builder/settings 输入它。请在 dxpr.com/getting-started 获取密钥。

如何安全地存储产品密钥？

请使用 Key 模块。请在 /admin/config/system/keys 使用 File 或 Environment 提供者创建一个密钥。然后，在 DXPR Builder 设置的 License 分区中，选择 Key module 作为 Storage method 并选择该密钥。使用 Configuration 提供者的密钥仍会进入配置导出。

DXPR Builder 是开源的吗？

Drupal 模块采用 GPL 许可，与 drupal.org 上的所有代码一样。只有编辑器的脚本会在有人编辑时从 DXPR CDN 加载。您的页面以标准 Bootstrap 5 HTML 保存在您自己的数据库中，访问者永远不会从 DXPR 服务器加载任何内容。

如果取消订阅会怎样？

您的站点继续正常运行，访问者仍能看到每个已发布的页面。免费版允许一位编辑和 100 个内容项。超出该上限的页面保持在线，但可视化编辑器不再在其上加载。请参见 许可概览。

DXPR Builder 需要 Bootstrap 吗？

DXPR Builder 生成 Bootstrap 5 HTML。如果您的主题已加载 Bootstrap 5，请将 Sideload Bootstrap files 设为 None (theme provides Bootstrap)（在 /admin/dxpr_studio/dxpr_builder/settings 中）。否则请选择 Bootstrap 5，DXPR Builder 会为您加载它。

提供哪些 AI 功能？

提供三项 AI 功能（每项可独立开关）：

  1. Text editing assistant：内联 CKEditor 工具栏中的 AI 写作工具
  2. Page creation assistant：根据文本描述生成完整页面布局
  3. Image generation：根据文本提示词创建图像

这三项都需要 AI 模块和 DXPR AI Provider。请参见 AI 功能指南。

如何设置 AI？

  1. 安装 drupal/ai 和 drupal/ai_provider_dxpr
  2. 启用这两个模块，使用 drush en ai ai_provider_dxpr
  3. 配置提供者：/admin/config/ai/providers/dxpr
  4. 开关功能：/admin/dxpr_studio/dxpr_builder/ai_settings

AI 积分如何运作？

所有 AI 操作（文本编辑、页面创建、图像生成）都会消耗您 DXPR 订阅中的积分。请在 /admin/dxpr_studio/dxpr_builder/ai_settings 查看余额，或在 dxpr.com/user/me/subscription/credits 充值。

DXPR Builder AI 能处理现有内容吗？

能。Edit with AI 可用于您之前构建的页面元素，构建器会将普通 Bootstrap 5 HTML 转换为可编辑元素。您无需先重建页面。

可以撤销 AI 生成的更改吗？

可以。AI 更改是撤销历史中的步骤，与其他编辑一样；请参见 撤销与重做。每次保存还会在保留修订的内容类型上创建 Drupal 修订。Diff 模块显示修订之间更改的内容。

可以关闭 AI 功能吗？

可以。请在 /admin/dxpr_studio/dxpr_builder/ai_settings 取消勾选 Enable text editing assistant、Enable page creation assistant 和 Enable image generation（在 AI Features 下）。没有 AI 模块时，构建器完全不显示 AI 功能，其他一切照常工作。

页面模板和用户模板有什么区别？

Page templates 是由管理员在 /admin/dxpr_studio/dxpr_builder/page_template 管理的整页布局。编辑人员在空白页面上通过 Choose a template 选择其一。

User templates 是编辑人员在编辑器内保存的可复用版块，可以是私有（仅创建者可见）或全局（所有用户可见），显示在元素选择器的 Saved templates 选项卡上。全局模板在 /admin/dxpr_studio/dxpr_builder/user_templates 管理。

请参见 Templates 指南。

用户档案如何工作？

用户档案让您可以控制每个角色看到的元素、区块、视图、模板、图标集和文本编辑器按钮。请在 /admin/dxpr_studio/dxpr_builder/profile 创建档案，将其分配给角色，并配置可用功能。当用户匹配多个档案时，权重最低的档案生效。请参见 用户档案指南。

为什么新创建的区块、视图和模板不显示在元素选择器中？

用户档案列出其允许的区块、视图、页面模板和全局用户模板。当列表的全选框（例如 Check/Uncheck all Blocks）被勾选时，新项目会自动出现。否则新项目保持隐藏：请在 /admin/dxpr_studio/dxpr_builder/profile 编辑档案，并在相关分区中勾选它们。

可以将 DXPR Builder 与 Drupal 的 Layout Builder 一起使用吗？

DXPR Builder 作用于单个字段（通常是 Body 字段），而不是 Drupal 的 Layout Builder。两者用途不同：Layout Builder 管理页面的整体布局（区域和区块），而 DXPR Builder 在字段内提供丰富的内容编辑。您可以在同一站点、甚至同一页面上同时使用两者：DXPR CMS 将其构建器字段放在 Layout Builder 布局中。

如何创建全宽版块？

  1. 添加 Section 元素（位于 Layout 选项卡）。
  2. 在版块上打开 More 并选择 Settings
  3. 打开 Full width（在 General 面板中）并点击 Save
  4. 在版块内添加 Row，然后在行内添加您的内容

Full width 让行填满版块，从一边到另一边。只有当字段周围的主题区域也是全宽时，版块本身才能触及窗口边缘。请参见 全宽布局。

提供哪些图标集？

DXPR Builder 附带 14 个图标集：Bootstrap Icons、ET Line Icons、Font Awesome（v4 compat、Brands、Regular、Solid）、Glyphicon Halflings 和 Pixeden Line Icons。另外六个是 Phosphor Icons 变体：Regular、Bold、Duotone、Fill、Light 和 Thin。请在 /admin/dxpr_studio/dxpr_builder/profile 控制每个用户档案可用的图标集。

如何更新 DXPR Builder？

composer update drupal/dxpr_builder --with-dependencies
drush updatedb
drush cr

更新后请务必运行 drush updatedb；DXPR Builder 包含在版本之间迁移设置的数据库更新钩子。更新 DXPR Builder 介绍了备份和回滚。

接下来做什么？

DXPR Builder 入门，继续探索 DXPR Builder。