mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 10:25:59 +00:00
54 lines
2.0 KiB
Markdown
54 lines
2.0 KiB
Markdown
---
|
||
id: application.menu-admin.howto
|
||
title: 管理员自定义全员应用菜单
|
||
type: howto
|
||
feature: application
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 自定义应用菜单
|
||
- 给所有人加应用入口
|
||
- 加自定义微应用
|
||
- 全员可见的应用怎么配
|
||
- microapp menu
|
||
related_tools: []
|
||
related_pages: [application]
|
||
prerequisites:
|
||
- 当前用户为系统管理员（userIsAdmin）
|
||
negative:
|
||
- 仅管理员可见入口和保存接口
|
||
- 自定义菜单只是注册一个 URL/iframe 入口，DooTask 不托管业务页面
|
||
- 配置项里没有"权限继承项目角色"的开关
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 管理员自定义全员应用菜单
|
||
|
||
## 是什么
|
||
管理员可以在应用中心追加自定义菜单项（iframe / 外链等），对应一个或多个全员/管理员可见的入口。底层调用 `api/system/microapp_menu`，保存到系统设置的 `microapp_menu` 项。
|
||
|
||
## 入口
|
||
- 桌面端 / 移动端：应用中心右上角「⋯」→「自定义应用菜单」（普通成员看不到此项）
|
||
|
||
## 操作步骤
|
||
1. 应用中心右上角「⋯」→「自定义应用菜单」
|
||
2. 点「新增菜单」生成一张空白配置卡
|
||
3. 填写必填字段：
|
||
- 应用 ID（如 `custom-okr`）
|
||
- 菜单标题
|
||
- 菜单 URL（支持 `{user_token}` 等占位符）
|
||
4. 调整可选项：菜单位置 / 可见范围 / 图标 / 类型（iframe / iframe_blank / inline / inline_blank / external）/ 背景色 / 保活 / 暗黑等
|
||
5. 点「保存」提交，应用中心立即出现新菜单
|
||
|
||
## 关键字段
|
||
| 字段 | 取值 | 说明 |
|
||
|---|---|---|
|
||
| 菜单位置 | `application` / `application/admin` / `main/menu` | 决定卡片放在常用区、管理员区或顶部主导航 |
|
||
| 可见范围 | `admin` / `all` | 仅管理员或全员可见 |
|
||
| 类型 | iframe / iframe_blank / inline / inline_blank / external | 决定打开方式 |
|
||
|
||
## 不支持
|
||
- 普通成员无入口，必须以管理员身份进
|
||
- 不能精细到「按部门可见」，可见范围仅 admin / all 两档
|
||
- 配置不会影响微应用插件本身，只是追加一层菜单
|