When you host Confluence yourself, custom Confluence user macros can become a powerful companion for your daily work.
Confluence is a popular Enterprise Wiki and collaboration platform. Made by Atlassian, it is available as a Cloud Service or as an on-premise version. While the Cloud service of Confluence is quite restricted in features, the server or Data Center versions for on-premise installations offer much more freedom and options. You can download a trial version right from their web site here: https://www.atlassian.com/software/confluence.
What are Confluence User Macros ?
If you run your own Confluence instance (Server or Data Center) you can create custom “User Macros”, little scripts that can be included in pages creating content on the fly. With those macros you can create simple HTML code as well as utilize Velocity code accessing information from your Confluence database.
I will not address the basics of writing a user macro here. That is well documented in the Confluence documentation here.
My User Macros
Along my work as a Confluence administrator I ran into several situations where native Confluence Server features did not offer what my admins or my users needed. Plugins were not available either or too expensive for the purpose. In many of those cases I founds that a user macro was just the right solution to the challenge. The Confluence user community helped me a lot writing them. Here are my most useful ones as my contribution back to that community.
Add Parent ID as Label
This Confluence user macro adds the parent content ID (page ID) as a label to the current page.
This Confluence user macro lists all spaces with Anonymous permissions.
This Confluence user macro adds an HTML5 audio control element to your page that can play MP3, OGG and WAV files.
This Confluence user macro adds a styled block quote to your page.
This Confluence user macro adds a Bootstrap like button in different colors and sizes, linking to a URL.
Bootstrap Progress Bar
This set of Confluence user macro adds a Bootstrap like progress bar to your page, offering different color and animation options.
This Confluence user macro displays a “business card” on your page with either
- single user profile info
- group members profile info
- panel display optional
This set of Confluence user macros adds animated diagrams to your page based on Chart.js v2.
This Confluence user macro adds a panel to your page with several coloring options.
This Confluence user macro toggles/expands/collapses all Expand sections on your page.
Font Awesome 5
This Confluence user displays a Font Awesome 5 icon with many options for customization.
This Confluence user macro adds a sorted table with numbered rows for each member of a given group.
This Confluence user macro allows to hide content based on user, groups or permission conditions.
This Confluence user macro hides Confluence sections of your page.
This Confluence user macro displays the user’s local date and time offering several options. Use once per page.
This Confluence user macro adds an HTML5 marquee element to your page.
This Confluence user macro allows you to set a different font incl. size and color for your page.
This Confluence user macro lists space permissions and page restrictions for the current page.
This Confluence user macro allows to show content based on user, groups or permission conditions.
This Confluence user macro lists users and groups having permissions to the current or given space.
This Confluence user macro displays a link to the Tiny URL of the current page.
This Confluence user macro adds an HTML5 video control element to your page that can play MP4 and OGG files.
This Confluence user macro adds a YouTube video frame to your page.