用途:在 Umbraco 后台为特定实体类型创建自定义权限控件。与作用于所有实例的通用实体权限不同,细粒度权限可按实体配置,实现更精细的访问控制,常见于文档权限,让不同用户对不同内容节点拥有不同权限。
主要能力:通过清单(manifest)声明 userGranularPermission 类型扩展,指定 forEntityTypes 与 meta(schemaType、label、description 等),并用 Lit 元素渲染权限勾选项,通过 change 事件回传权限集合。常用实体类型包括 document(内容节点)、media(媒体项)、member(成员)。
使用方式:实现前先用 WebFetch 获取最新官方文档,包括 Foundation、Extension Registry、User Permissions 三个链接;参考 Umbraco 源码中的示例目录 /Umbraco-CMS/src/Umbraco.Web.UI.Client/examples/user-permission/。流程为:获取文档、确认实体类型与权限及 schema 类型、依据最新文档生成 manifest 与元素文件、说明创建内容与测试方法。相关基础技能:控制权限可见性时参考 umbraco-conditions,访问用户或工作区上下文时参考 umbraco-context-api。
限制:资料未提供具体版本要求、安装命令、收费与平台信息;实现细节以官方最新文档为准,示例代码应保持最小化。