网络(Network)宏将会在 Confluence 页面和博客页面中显示分享网络的相关活动,请参考 分享网络概述 页面中的内容。
你可以在这个宏中指定你希望显示的用户。这些活动包括指定用户链接到其他用户或者跟随到指定用户的用户。网络分享宏使用用户的属性图标来显示没一个用户,同时还提供了 2 个主题,你也可以为这个宏限制用户列表中显示用户的数量。
屏幕截图:网络(Network)宏
使用网络(Network)宏
希望在页面中使用网络(Network)宏:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 默认值 | 说明 |
---|
用户名(Username) | 当前用户的用户名 | 你希望在 Confluence 页面中显示用户网络的用户名。如果你在这里不指定值的话,那么当前用户(就是你自己)的社交网络连接情况将会显示出来。、 |
模式(Mode) | following | 选择那些用户被列出来,对指定的用户而言: - following – 这个用户关注的用户。
- followers – 这个用户被那些用户关注。
这个参数在存储格式和 Wiki 标记格式中不能被使用。 |
主题(Theme) | full | 确定用户的网络在页面中如何被显示: - full – 显示用户属性图标的大版本。同时如果你启用了 following 模式,将会提供一个完整的字段函数来关注更多用户。
- tiny – 显示用户属性图标的小版本。
|
最大结果(Maximum Results) (max )
| 如果没有设置的话,最大显示 30 个。 | 限制用户在页面中显示的数量。如果用户的用户数量超过了最大显示的值,那么将会提供 显示所有(Show All)链接。 这个链接将会链接到用户的网络视图。请参考 分享网络概述 页面中的内容。 |
禁用网络宏
网络宏是在系统中的网络模块中的''Profile Macros'插件提供的。如果希望从你的网站中删除这个宏,你需要在插件管理中禁用这个插件才可以。 请参考本维基中有关插件启用和禁用的相关文章。
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称: network
宏内容: None.
存储格式示例
< ac:structured-macro ac:name = "network" >
< ac:parameter ac:name = "username" >
< ri:user ri:userkey = "12345678912345678912345" />
</ ac:parameter >
< ac:parameter ac:name = "max" >10</ ac:parameter >
< ac:parameter ac:name = "theme" >full</ ac:parameter >
< ac:parameter ac:name = "" >followers</ ac:parameter >
</ ac:structured-macro >
|
Wiki 标记格式示例
{network:followers|username=admin|max= 10 |theme=full}
|