AiOffice 能力组合,开箱即用,为您的工作流提速
菜单是在整个 Umbraco 后台界面中显示的扩展组件,包括侧边栏和按钮弹出窗口。它们充当一个或多个菜单项扩展的容器,从而实现有组织的导航和操作分组。菜单项单独配置,可以添加到现有菜单或自定义菜单中。
<umb-input-manifest> 组件提供了一个选择器 UI,用于从 Umbraco 扩展注册表中选择已注册的扩展。它允许用户从任何扩展类型(工作区、仪表板、属性编辑器等)中进行选择并返回选定的清单。这对于用户需要引用其他扩展的配置 UI 非常有用。
本地化通过扩展注册表管理的本地化文件启用 UI 翻译,并以英语(iso 代码:“en”)作为后备语言。本地化控制器(通过 this.localize 在 Umbraco Elements 中自动可用)使用键提供对翻译字符串的访问。可以通过扩展注册表添加自定义翻译,并使用 # 前缀在清单中引用。
Kind 是扩展继承以保持一致性的预设配置。它通过定义多个扩展可以共享的默认属性来减少冗余。种类确保跨扩展的标准化结构,并通过提供扩展自动继承的预定义属性来简化定义。
图标是自定义视觉元素,扩展作者可以注册在整个 Umbraco 后台使用。自定义图标通过清单注册,然后可以在任何接受图标属性的扩展中使用。图标被定义为从 JavaScript 模块导出的 SVG 内容。
Umbraco 中的运行状况检查允许您创建显示在运行状况检查仪表板中的自定义系统诊断。他们验证您的 Umbraco 安装和相关服务是否正常运行。运行状况检查可以报告状态、显示警告并提供解决问题的可行建议。
标题应用程序是单一用途的扩展程序,出现在 Umbraco 的顶部导航栏中,位于用户个人资料头像和全局搜索旁边。它们为后台提供全局可访问的功能,例如文档、工具或自定义交互功能的快速链接。标题应用程序可以是简单的链接或打开模式或执行操作的自定义交互式组件。
细粒度用户权限允许您为 Umbraco 中的特定实体类型创建自定义权限控制。与适用于所有实例的一般实体权限不同,可以为每个实体配置细粒度权限,从而允许细粒度的访问控制。这通常用于文档权限,其中不同用户可以对不同内容节点拥有不同的权限。
全局上下文创建了一个共享的、类型安全的数据层和可在整个后台访问的功能。与范围上下文(如工作空间上下文)不同,全局上下文在整个后台会话中持续存在。使用它们在扩展之间共享状态、管理集中服务或协调通信。注意:如果可能,更喜欢更具体的上下文类型 - Umbraco 很少使用全局上下文。
文件上传预览是自定义 Web 组件,可在 Umbraco 中上传期间呈现特定文件类型的预览。它们允许您根据 MIME 类型创建文件的视觉表示,例如显示图像的缩略图、音频的波形或特定文件格式的自定义图标。
Umbraco 扩展模板是用于创建后台扩展的官方 .NET 模板。它提供了带有 TypeScript/Vite 工具的预配置项目结构、正确的文件夹结构以及扩展开发所需的所有基本文件。每个 Umbraco 后台扩展都应从此模板开始。
扩展注册表是管理所有 Umbraco 后台 UI 元素的核心系统 - 后台中的几乎所有 UI 都是由扩展注册表管理的扩展。注册表允许开发人员使用 umbExtensionsRegistry 在运行时动态添加、删除或修改扩展。开发人员拥有与 Umbraco 总部相同的可能性,这意味着您可以更改 Umbraco 中默认存在的几乎所有内容。
为 Umbraco 后台生成完整的、可测试的示例扩展,并使用 Umbraco 源的开发基础设施运行它们。
入口点是在 Umbraco 后台启动时执行 JavaScript 代码的扩展。 Backoffice 入口点在用户身份验证后运行,用于初始化逻辑、加载外部库、动态注册 UI 扩展或包含全局 CSS。可选的 onUnload 函数负责处理清理。
实体创建选项操作在创建实体时添加可自定义的选项。当选择“创建”实体操作时,这些选项将出现在创建选项对话框中,允许用户在不同的创建方法或路径之间进行选择。这实现了可扩展性,其他开发人员可以将自己的创建选项添加到现有工作流程中。
实体批量操作一次对多个项目的选择执行操作。当用户选择多个项目时,它们会出现在集合选择工具栏中,从而支持同时跨多个实体进行批量发布、删除或自定义处理等批量操作。
实体操作对 Umbraco 中的特定项目执行操作。它们为与文档、媒体或自定义实体等实体类型相关的辅助功能提供通用扩展点。这些操作出现在整个后台的上下文菜单中,并且可以通过用户权限进行控制。
使用 Playwright 和 @umbraco/playwright-testhelpers 对 Umbraco 后台扩展进行端到端测试。此方法针对真实运行的 Umbraco 实例进行测试,验证完整的用户工作流程。
动态根允许内容选取器具有动态确定的起点(原点),而不是固定节点。这包括两种扩展类型:
仪表板是可定制的组件,出现在 Umbraco 的后台部分以显示信息和功能。当未选择任何项目时,它们会显示树中所选项目的“编辑器”或默认部分信息。仪表板使用条件来控制它们在后台出现的位置和时间。