输入产品密钥和全站设置.
在 General Settings 选项卡中，您可以用产品密钥将网站连接到 DXPR 订阅。您还可以选择适用于每位编辑人员的设置：控制栏、文本样式、Bootstrap 和媒体浏览器。安装构建器、更改订阅或切换媒体浏览器时，请来这里。AI 功能有自己的选项卡；请参阅 AI 配置。
开始之前
- 您的角色需要 Administer DXPR Builder configuration 权限。
- 请准备好产品密钥。选项卡上的 Find your product key 链接会打开 dxpr.com/getting-started。
设置
- 前往 DXPR Studio > DXPR Builder > General Settings
(
/admin/dxpr_studio/dxpr_builder/settings)。 - 在 License 下选择一种 Storage method。
- 使用 Configuration storage 时，将密钥粘贴到 Product key 中。使用 Key module 时，在 Key 下选择保存密钥的键。
- 打开其他部分，按需修改。下面 Settings 表格解释了每一项。
- 点击 Save settings。
Configuration storage 将密钥与网站设置一起保存。Key module 从您在 Manage keys (/admin/config/system/keys) 下管理的键中读取密钥。根据密钥的提供方，密钥值可以存放在文件或环境变量中，而不是数据库中。
您会看到的内容
表单会带上您保存的值重新加载，并显示消息“The configuration options have been saved.”。License 部分保持展开，其他部分为折叠状态。要确认密钥有效，请打开 User Licenses 选项卡：顶部的框会显示您的订阅套餐并统计许可证数量。编辑人员现在可以在带有 DXPR Builder 字段的页面上看到构建器控件。
设置
| 设置 | 作用 | 默认值 |
|---|---|---|
| Storage method (License) | 产品密钥的保存位置：Configuration storage 或 Key module。 | Configuration storage |
| Product key (License) | 您的密钥。仅在使用 Configuration storage 时显示。 | 空 |
| Key (License) | 保存产品密钥的键。仅在使用 Key module 时显示。保存此表单不会更改该键的值；请在 Manage keys 下编辑它。 | 无 |
| Scroll offset selector (Advanced Settings) | 固定或粘性页眉的 CSS 选择器。平滑滚动到锚点时会在该页眉下方停住。 | .dxpr-theme-header--sticky, .dxpr-theme-header--fixed |
| Control bars (Advanced Settings) | 编辑人员找到元素控制栏的位置。On each element：每个元素都有自己的控制栏。One row：在您指向的元素上方显示一行控制栏，页面保持已发布的布局。用户档案可以按角色设置此项，每位编辑人员也可以在编辑器中的 Editor settings 下或在自己的账户页面上选择。 | On each element |
| Custom styles (Text Editor) | 文本编辑器 Styles 列表的条目，每行一条，格式为 [label]=[element].[class]，例如 Sassy Title=h1.sassy-title。清空该字段可恢复自带列表。请参阅 文本编辑器。 |
DXPR Builder 自带样式，首项为 Lead=p.lead |
| Sideload Bootstrap files (Bootstrap) | None (theme provides Bootstrap)，或选择 Bootstrap 5 让构建器在其页面上加载 Bootstrap。 | 未选择任何项，因此不加载 Bootstrap 文件 |
| Browser type (Media) | 编辑人员选择图片的方式：Basic file upload、Media Library、配合 Acquia DAM 模块的 Media Library (Acquia DAM)，或配合 Entity Browser 模块、按机器名列出的 entity browser。请参阅 媒体库。 | Media Library（启用该模块时），否则为 Basic file upload |
| Apply text format filters to frontend content (Text Filters) | 为访客运行字段的文本格式过滤器。能用构建器编辑的人员看到的是未过滤的内容。某些过滤器可能与构建器标记不兼容。 | 关闭 |
| Asset source (Editor Assets) | 编辑器 JavaScript 的来源：Cloud、Local (minified) 或 Local (unminified)。仅当模块包含本地构建时才会显示此部分。只要本地文件存在，Cloud 也会加载它们，因为云端文件只随发行版提供。请参阅 编辑器资源。 | Cloud |
如果您看到错误或没有构建器
- “Product key required”（在 Product key 下）。 Storage method 为 Configuration storage，但该字段为空。请粘贴密钥，或选择 Key module 并挑选一个键。
- “Invalid product key. Copy the complete key without extra spaces.” 粘贴的文本不是完整的密钥，或是为 DXPR Builder 1.x 生成的密钥。请通过 Find your product key 链接重新复制当前密钥，不要带空格或换行。
- “Select a key”（在 Key 下）。 Key module 已选择，但没有选择键。请选择您的密钥，或先在 Manage keys (
/admin/config/system/keys) 下创建一个。 - “The selected key does not hold a valid product key.”（在 Key 下）。 所选的键保存的是其他密钥，例如 AI 服务商的密钥。请选择保存产品密钥的键，或在 Manage keys 下将产品密钥粘贴进去。
- Product key 字段不见了。 Storage method 设置为了 Key module。模块更新可能会将密钥从 Configuration storage 移到名为 DXPR Builder JWT 的键中，Key 现在显示的就是它。
- 错误提示“We are having trouble connecting to the DXPR servers”。 您的服务器无法连接到 DXPR 许可证服务。请参阅 防火墙和数据驻留，了解需要放行的主机。
- 没有 Editor Assets 部分。 模块文件夹中没有本地构建，因此编辑器从 DXPR CDN 加载。无需修复。