Skip to content

Latest commit

 

History

History
195 lines (130 loc) · 8.94 KB

README.md

File metadata and controls

195 lines (130 loc) · 8.94 KB
Raw

Confluence User Macros

Velocity Support

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 snippets 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 admins or users needed. Plugins were not available either or too expensive for the purpose. In many of those cases I found 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.

Anonymous Access

This Confluence user macro lists all spaces for which 'Anonymous' has at least view permission.

Audio Control

This Confluence user macro adds an HTML5 audio control element to your page that can play MP3, OGG and WAV files.

Blockquote

This Confluence user macro adds a styled blockquote to your page.

Bootstrap Button

This Confluence user macro adds a Bootstrap 3 styled button, supporting different colors and sizes, and linking to a URL.

Bootstrap Progress Bar

This set of two Confluence user macros adds a Bootstrap like progress to your page, offering different coloring and animation options.

ChartJs v2

This set of Confluence user macros adds animated diagrams to your page based on Chart.js v2.

Colored Panel

This Confluence user macro adds a headed panel to your page with several coloring options.

Confluence Users Access

This macro lists all spaces for which the group 'confluence-users' has at least view permission.

Expand All

This Confluence user macro adds a button group that toggles/expands/collapses all Expand sections on your page.

Group Members

This Confluence user macro adds a sorted table with numbered rows for each member of a given group.

Hide If

This Confluence user macro allows to hide content from users, groups or permissions.

Hide Sections

This Confluence user macro hides different Confluence sections of your page.

Horizontal Ruler

This Confluence user macro adds a customizable HR element to your page.

Legend

This Confluence user macro adds a legend box to the top right of the page.

Local Time

This Confluence user macro displays the user's local date and time offering several options. Use once per page.

Marquee

This Confluence user macro adds an HTML5 marquee element to your page.

Page Font

This Confluence user macro allows you to set a different font incl. size and color for your page.

Page Permissions

This Confluence user macro lists space permissions and page restrictions for the current page.

Profile Info

This Confluence user macro displays a panel with the profile info of a single user or all users of a group.

Risk Matrix

Creates a risk matrix based on an issue type, likelihood field and impact field from a linked Jira instance.

Show If

This Confluence user macro allows to show content only to certain users, groups or permissions.

Space Permissions

This Confluence user macro lists users and groups having permissions to the current or given space.

Spacer

This Confluence user macro adds a vertical space into your page.

Telephone Link

This Confluence user macro adds an HTML telephone link to your page.

Tiny Link

This Confluence user macro displays a link to the Tiny URL of the current page.

Tooltip

This Confluence user macro adds an inline text with a hover tooltip.

User Permissions

This Confluence user macro lists all spaces in which a user has either View, Edit or Admin permission.

Video Control

This Confluence user macro adds an HTML5 video control element to your page that can play MP4 and OGG files.

YouTube Video

This Confluence user macro adds a sizeable YouTube video frame to your page.