Include macro in Confluence Custom HTML

[Matt Johnson]

I would like to know if it's possible to include a macro in the Custom HTML at the end of the body in Confluence. We would like to add the viewtracker plugin to every page, but I've been unable to find a viable solution for that. If the macro can't be included there, does anybody have an idea how we can add those statistics to each page without having to manually add to every page?

The issue is that we would like to see the page views for blog posts, which can contain macros, however the blog posts cannot be created from a template. No template means it's totally up to the user to add the tracking info macro at creation, which could be mandated but I'm not optimistic that our userbase would always add it.

Thanks in advance for any help.

MJ

[Amalia · Accepted solution]

Hi MJ!

I don't think it's possible to include macro in Custom HTML. However, you have the option of including the macro in one of Confluence Layouts by adding the following velocity code:

$helper.renderConfluenceMacro("{macroname}")

This will render macro in the layout. You can add this in a Global Layout, Page Layout, or Blog Post Layout. However, please note that this will only work if you are using the Default Confluence Theme and not Documentation Theme.

Hope it helps!

[Matt Johnson]

Hi Amalia,

Thank you for your reply. Unfortunately we are using the Documentation Theme and chaning to the Confluence Default would cause my users to revolt. I did find that I can add to the Documentation Theme footer, however that does not display the macro on the Blog Post pages. One step closer to an answer though, so thank you again.

MJ

[Amalia]

There is no straight forward way to customize the Documentation Theme, other than editing the JAR file itself. Go to <confluence-install>/confluence/WEB-INF/classes/com/atlassian/confluence/setup and open atlassian-bundled-plugins.zip (if you are on Confluence 5.x and above, go to <confluence-install>/confluence/WEB-INF/atlassian-bundled-plugins). Locate and open usage-doctheme--x.xx.x.jar which is the JAR file of the Doc Theme. The file that you need to look at is located in decorators, called page.vmd. Please refer to the following documentation for more info:

• https://confluence.atlassian.com/display/CONFKB/How+to+Display+Different+Appearance+for+Different+Users+Using+Confluence+Layouts
• https://confluence.atlassian.com/display/CONFKB/How+to+Edit+Bundled+or+System+Plugins

Once the file is edited, you can then save the file and JAR file and then restart Confluence

[Amalia]

Sorry there's a typo there. It should be doctheme-x.xx.x.jar

[Amalia]

sorry there's a typo. It should be doctheme-x.xx.x.jar