[All Adaptavist Apps]
It's possible to customise panel content based on the page being viewed or it's location within the space...
Use the builder-show macro or builder-hide macro to display or hide content based on properties of the current page such as its title, labels or metadata.
For example, to show content for a page with a specific title use:
{builder-show:title=Meeting Notes} The title of this page is "Meeting Notes" {builder-show}
To hide content based on page labels, use:
{builder-hide:label=do-not-show} This will be shown everywhere, except pages with a label of "do-not-show". {builder-hide}
You can mix the macros together, for example if you wanted to show some content on the "Meeting Notes" page except when it has a label of "do-not-show", use:
{builder-show:title=Meeting Notes} {builder-hide:label=do-not-show} This will be shown if the page title is "Meeting Notes" except when the page has a label of "do-not-show". {builder-hide} {builder-show}
For more examples, please see builder-show macro or builder-hide macro.
Use the recurse=true
parameter on the builder-show or builder-hide macros to check both the current page and all it's parent pages. For example:
{builder-show:title=Tutorials|recurse=true} This page is in the tutorials section of the space. {builder-show}
We've used this method to create the Tabs shown to the left.
The move-to macro allows you to move content defined within a page to a place holder within a panel.
You first need to create a place holder (or target) for the content within the panel:
{div:id=left-sidebar-custom-panel}This is the target{div}
To move content from the current page, wrap it in the move-to macro and specify it's target:
{move-to:left-sidebar-custom-panel} This will be moved in to the target, replacing any existing content in the target {move-to}
If nothing is moved in to the target, it's content ("This is the target" in the example above) will be shown by default. If the page being viewed moves something in to the target, it's existing contents will be overwritten.
This is useful because it allows you to customise panel content from within your wiki pages so long as the theme design provides targets for the moved content.
If you need extreme customisation for a specific page, you can choose to use a completely different layout. For more information, please see use-layout macro.