User Macro module

Adding a user macro plugin

User macro is a kind of Confluence plugin module.

• For more information about plugins in general, read Confluence plugin guide.
• For an introduction to writing your own plugins, read Writing confluence plugins.

User macro plugin modules

With user macro plugin modules, developers can define simple macros directly in the atlassian-plugin.xml file without writing any additional Java code. User macro plugin modules are functionally identical to user macros configured through the administrative console, except that they can be packaged and distributed in the same way as normal plugins.

Configuring a macro plugin module

Configure entire macro plugin modules inside the atlassian-plugin.xml file as follows:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

<atlassian-plugin name='Hello World Macro' key='confluence.extra.helloworld' pluginsVersion='2'>
    <plugin-info>
        <description>Example user macro</description>
        <vendor name="Atlassian Software Systems" url="http://www.atlassian.com"/>
        <version>1.0</version>
    </plugin-info>

    <user-macro name='helloworld' key='helloworld' hasBody='true' bodyType='raw' outputType='html'>
        <description>Hello, user macro</description>
        <template><![CDATA[Hello, $body and $paramexample !]]></template>
        <parameters>
            <parameter name="example" type="string"/>
        </parameters>      
    </user-macro>

    <!-- more macros... -->
</atlassian-plugin>

• The <template> section is required. It defines the velocity template that renders the macro.
• You can find all available velocity variables in Writing user macros tutorial.
• The name and key of the macro must be specified the same way as in Macro module.
• No class attribute is required.
• The attributes of the user-macro element match the configuration for user macros (see available attributes later on this page).
• The parameter elements are the same as for xhtml-macro.

Available attributes