Showing content based on Decorator

What is a decorator?

A decorator is template that is applied to content. Confluece passes a decoratror to Theme Builder.

How to show content in spaces.

{builder-show:decorator=space} using the space decorator {builder-show}

How to show content at global level.

{builder-show:decorator=global} using the global decorator {builder-show}

Switching layout based on decorator.

{use-layout} macro

Example switching to a different layout based on decorator

{builder-show:decorator=printable}{use-layout:LAYOUTID}{builder-show}

Current decorators.

Decorator
main
mail
page
space
blogpost
printable
footer
global
labels
profile
search

Decorators, Contexts and Modes for pages in Confluence.

Finding

View the source of a page that has theme builder applied to it.
Near the top of the page you will find a comment containing the information:

 <!--
  userAgent: 'Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-GB; rv:1.9.0.5) Gecko/2008120121 Firefox/3.0.5'
  layout : 'com.adaptavist.confluence.builder.layouts.model.Layout@4086fd'
  layoutId : 'DEFAULT'
  spaceName : 'Test Space'
  currentURL : '/pages/listpages-dirview.action?key=test&openId=622595'
  contextPath : ''
  action name : 'listpages-dirview'
         ----------
adaptavist.builder.sitemeshPage: com.opensymphony.module.sitemesh.parser.FastPage@a5bf0d
adaptavist.builder.helper: com.atlassian.confluence.themes.GlobalHelper@a2200d
adaptavist.builder.labelsString: null
adaptavist.builder.pageTitle: List Pages - Tree View
adaptavist.builder.mode: list-content-tree
adaptavist.builder.context: space-pages
adaptavist.builder.decorator: space
adaptavist.builder.pageContext: com.atlassian.confluence.renderer.PageContext@7463bf7e
-->

This may not be a complete list

Page Title	Action Name	Decorator	Context	Mode
Login	login	null	null	null
Sign Up For Confluence	signup	null	null	null
Dashboard	dashboard	global	global	dashboard
RSS Feed Builder	configurerssfeed	global	global	rss
People Directory	browsepeople	global	global	userdir
Popular Labels	listlabels-heatmap	labels	labels	view-labels-popular
User Profile	viewuserprofile	profile	profile	view-profile
Edit My Profile	editmyprofile	profile	profile	edit-profile
Personal Labels	viewmylabels	profile	profile	my-labels
Watches	viewnotifications	profile	profile	edit-notifications-profile
Drafts	viewmydrafts	profile	profile	drafts
Create Space	createspace-start	null	null	null
Adding News	createblogpost	space	space-blogposts	create-blogpost
Viewing News	viewpage	blogpost	blogpost	view
Editing News	editblogpost	blogpost	blogpost	edit
Viewing News Attachments	viewpageattachments	blogpost	blogpost	view-attachments
Copying A Page	copypage	space	space-pages	create-page
Adding A Page	createpage	space	space-pages	create-page
Viewing A Page	viewpage	page	page	view
Editing A Page	editpage	page	page	edit
Viewing Page Attachments	viewpageattachments	page	page	view-attachments
Viewing Page Information	viewinfo	page	page	view-information
List Pages - Tree View	listpages-dirview	space	space-pages	list-content-tree

Page tree