Customising confluence velocity layouts - should it be allowed?

System admins can customise space-specific velocity templates to make, eg, the view-page layout different.

Belatedly I've realised this is a very bad idea, as when you upgrade, the modified template will be retained, even though the default template has most likely changed. What you'd need to do is diff your changes with the original template, then reapply those to the new template.

As no warnings are giving, most likely you will forget, which will lead to subtly broken pages, or broken plugins. I just spent a day working out why the sticky notes plugin wasn't working.

So what's the question... I guess, should this even be possible? I would say not, it's never going to end well.

Also I think the upgrade should draw attention to customised templates and get you to check them all.

1 answer

1 accepted

2 votes
David Simpson Community Champion Sep 09, 2012

Jamie, I agree.

Allowing edit of the velocity layouts in admin just feels like a very dirty and very hidden hack. It's worse than JS based DOM manipulation and is easily forgotten and yes, the layout doesn't update on upgrade.

At the very least, the upgrade *should* highlight all the spaces that need fixing and how afterwards. I'm guessing that this sort of hackery isn't tolerated in OnDemand precisely because of this.

I'm certain it's not allowed in ondemand... and from now on it's not allowed in my instances either. To be honest mostly I used it to create a docn theme before such a thing existed, now it's not required anymore.

Yes, JS based hackery should at least fail in a more obvious way. My problem was that there was zero indication anything was wrong with the page, except that some meta attributes were not present because they had changed the name of the velocity file that got parsed to produce them.

I'm marking your answer as correct. One person agrees with me so we must be correct.

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Asked May 24, 2018 in Confluence

What are the resources that you use to learn more about Atlassian Products?

I am gathering information about resources available for Atlassian product knowledge transferring for a presentation in our local Atlassian User Group. I want to group them in four categories From ...

604 views 18 16
View question

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you