正文
Confluence 6 创建一个用户宏
提示：扫一扫查出行【扫一扫了解最新限行尾号】
复制提示
如果你想创建自定义的宏的话，用户宏能够帮你完成这个任务。这个可以在你系统中应用特定的操作，比如说应用自定义格式等。
用户用是在 Confluence 创建和和管理的，你需要有一定的编码基础才可以。
你需要具有系统管理员权限来创建和应用用户自定义宏。
希望创建一个新的用户宏：
- 进入
> 基本配置（General Configuration） > 用户宏（User Macros） - 选择 创建一个用户宏（Create a User Macro）
- 输入宏的一些详细信息（请查看下面列表）
- 单击 添加（Add）
| 宏名称（Macro name） | 宏的名字，将会出现在代码中。 |
可见（Visibility） | 这个选项控制谁可以在宏浏览器中查看这个宏或者自动完成功能。选项有：
请注意，如果你选择仅系统管理员可见的话，用户任然可以看到用在页面中输出的结果，宏的占位符也还是在编辑页面中出现的，这个仅仅在宏浏览器和自动完成的时候隐藏了。 所有宏的信息都是可以找到的，包括宏的标题，描述，参数名称和其他元数据。尽管宏只能被系统管理员查看到，也请不要在用户宏中定义任何敏感信和保密信息。 |
| 宏标题（Macro Title） | 在宏浏览器和自动完成功能中出现的宏标题。 |
| 描述（Description） | 这个描述信息将会出现在宏浏览器中。宏浏览器的查找将会对查找字段在宏标题和描述中的文字进行匹配。 |
| 分类（Categories） | 为你的宏在宏浏览器中选择一个或多个分类。 |
| 图标 URL（Icon URL） | 如果你希望宏浏览器为你的宏显示图标的话，输入绝对地址（例如 http://mysite.com/mypath/status.png）或相对于 Confluence base URL 的相对地址（例如：/images/icons/macrobrowser/status.png） 。 |
| 文档 URL（Documentation URL） | 如果你的宏有文档的话，请在这里输入文档的 URL。 |
| 宏内容处理（Macro Body Processing） | 指定 Confluence 应该如何处理你的宏的内容。 宏的内容中包含了在 Confluence 页面中如何处理的信息。如果你的宏有一个内容，所有宏的内容将会在 处理宏内容字段选项包括有：
|
模板（Template ） | 这里是你写的代码去确定宏应该是什么样子的。
请查看 Writing User Macros 要么获得更多的信息和示例。 |
希望使用插件完成编辑？
如果你希望将你的自定义宏按照插件进行分发的话，请参考 User Macro plugin module 页面中的内容。如果你希望使用更加复杂，更加程序化的宏的话，你需要写成 Macro plugin 宏。
https://www.cwiki.us/display/CONFLUENCEWIKI/Writing+User+Macros
