This page last changed on Dec 19, 2010 by don.willis@atlassian.com.
This page tells you how to create a user macro that embeds an expandable text box into your page. (For full details about creating a user macro, see the guide to writing user macros.)
A Working User Macro
This is a working user macro that you may want to install onto your Confluence site. In a future release, we intend to bundle this user macro with Confluence. At present, we are making it available on this documentation page so that you can try it out.
Defining the 'Expand' User Macro
To create the 'Expand' user macro,
- Go to the Confluence Administration Console and click 'User Macros' in the left-hand panel.
- Click the link on the text 'Click here to create a new User Macro' at the top of the list of macros.
- Enter the macro attributes as follows:
- Macro Name: expand
- Visibility: Visible to all users in the Macro Browser
- Macro Title: Expand
- Description: Embeds an expandable text box into your page
- Categories – Formatting
- Icon URL: /images/icons/macrobrowser/expand.png
- Documentation URL: http://confluence.atlassian.com/x/UBpODQ
- Macro Body Processing: Convert wiki markup to HTML
- Output Format: HTML
- Template:
- Click 'Save'.
Example and Usage of the 'Expand' Macro on a Page
See the user guide for the Expand macro.
Prerequisites, Limitations and Other Notes
- HTML exports do not show the expanded text. When you export the page to HTML, the text between the macro tags is not visible. Nothing happens when readers click the 'expand' icon. This issue is logged as CONF-21315. If you like, you can vote for the issue or 'watch' it to keep informed of progress.
- Text is expanded in PDF exports. When you export the page to PDF, the text between the macro tags is expanded so that readers can see it on the PDF page. If this is not working on your Confluence site, please ask your administrator to get the latest version of the macro 'template' above.
- This macro is not bundled with Confluence. If you are interested, you can consider watching and voting for this issue: CONF-2803.
RELATED TOPICS
Writing User Macros
|