用户列表(User List)宏用于在 Confluence 页面基于他们所在的用户组,显示注册的用户列表。
使用用户列表宏
在页面中使用用户列表宏:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 默认值 | 说明 |
---|
参数 | 默认值 | 说明 |
---|
组(Group)
(groups ) | none | 为你希望显示的用户列表指定一个或者多个用户组。如果指定多个用户组的话,使用逗号分隔符进行分隔。 如果希望查看注册的所有用户,使用星号('*')在这个参数中。 |
显示在线或者离线用户(Display Online/Offline Users)
(online ) | 所有注册的用户 | 列表显示在线或者离线的用户,如果这里留空的话,将会显示所有的用户而忽略用户的在线状态。 可以接受的值: - Unspecified – 宏将会显示所有的用户。
true – 宏将会只显示在线用户。false – 宏将会值显示离线用户。
如果需要这个参数能够正确工作,系统管理员需要在 Confluence 站点中启用 用户登录监听器 。 |
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称: userlister
宏内容: None
存储格式示例
< ac:structured-macro ac:name = "userlister" >
< ac:parameter ac:name = "groups" >confluence-users</ ac:parameter >
< ac:parameter ac:name = "online" >false</ ac:parameter >
</ ac:structured-macro >
|
Wiki 标记格式
{userlister:groups=confluence-users|online= false }
|