本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=139546

将用户列表宏添加到页面以显示指定组中的Confluence用户列表。该宏还可以指示用户何时在线或离线。

这是一个遗留宏，可能会在非常大的站点中导致性能问题。我们建议您不要使用此宏来尝试显示站点中的所有用户。

截图：包含用户列表宏的页面。

限制

在拥有大量用户的站点中，用户列表宏可能会占用大量内存。为防止它在您的站点中导致内存不足错误，如果指定组中的人数超过10,000，我们不会显示此宏。您的管理员可以使用 confluence.extra.userlister.limit系统属性更改此限制。

在页面中添加宏

在页面中添加User List宏

  1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
  2. 从Confluence content类别中选择User List。
  3. 输入要显示的组。
  4. 点击Insert。

然后，您可以发布您的页面以查看宏的效果。

截图：配置用户列表宏以显示组成员。

修改宏参数

宏参数用于设置宏的行为。

要更改宏参数：

  1. 在编辑器中，点击宏占位符并选择“编辑（Edit）”。
  2. 根据需要设置参数，然后选择“插入（Insert）”。

这是此宏中可用的参数列表。 

参数

默认值

描述

Group(s)
(groups) 

none

指定组名。指定多个用逗号分隔的组，或使用*显示Confluence中的所有用户。

有关控制哪些用户可以查看其他用户的详细信息的文档，请参阅this knowledge base page。

Display Online/Offline Users
(online) 

All registered users

列出在线或离线用户。留空以显示所有用户，无论状态如何。

接受值：

  • Unspecified – 宏将显示所有注册用户。
  • true – 宏将仅显示在线用户。
  • false – 宏将仅显示离线用户。

如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同，则会在参数名下方用括号列出，例如（example）。

其它添加方式

用键盘输入添加宏

输入左大括号{，然后输入宏名称的几个起始字符，就可以看到一个相关的宏列表。

通过wiki标记添加宏

当您想在编辑器之外添加宏时，这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。

Macro name: userlister

Macro body: None.

{userlister:groups=confluence-users|online=false}
CODE