页面树结构
Skip to end of metadata
Go to start of metadata

用户列表(User List)宏用于在 Confluence 页面基于他们所在的用户组,显示注册的用户列表。

使用用户列表宏

在页面中使用用户列表宏:


  1. 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
  2. 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
  3. 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(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}




  • 无标签