Page History

{menulink:destination}Link Text{menulink}

{menubar:id=example}
 {menuitem}{menulink:destination}Link Text{menulink}{menuitem}
{menubar}

Code Block
{menulink:edit}Edit this %page%{menulink}

You can create a link to the dashboard as follows:

Code Block
{menulink:dashbaorddashboard}Go to the dashbaorddashboard{menulink}

You can link to a feature in another space as follows:

Code Block
{menulink:map|space=wibble}Wibble Site Map{menulink}

This would show the site map in the Space with a key of "wibble", regardless of where you are in your site.

To add tooltips and access keys, use the following notation:

Code Block
{menulink:newcomment|accesskey=c|tooltip=Add comment}Add a comment...{menulink}

If a menulink is not applicable (eg. user doesn't have privilages or the link does not relate to the current location within your site, etc) then the body text of the link will be output unlinked.

For example, if a user does not have comment privileges, then they would see the link shown in the previous example as:

Add a comment...

Obviously, that's not very useful so you want to hide inactive menu links. To do this, use the menuitem macro which will hide it's body content if there are no links in it:

Code Block
{menuitem:flat=true}{menulink:newcomment}Add a comment...{menulink}{menuitem}

If the body of the menuitem macro doesn't contain a link, it will not be shown.

You

can

open

the

link

destination

in

a

specific

frame

or

window

using

the

??

target

??

parameter:

Code Block
{code} {menulink:map|target=_blank}Open site map in new window{menulink} {code} Which results in: {menulink:map|target=_blank}Open site map in new window{menulink}

You can toggle the visibility of any HTML tag with a unique id using the code below:

Code Block
Wiki Markup
You can toggle the visibility of any HTML tag with a unique id using the code below: {code} {div:id=visdemo}*This is a div tag with id of "visdemo" that you can show or hide using the link below.*{div} {menulink:toggleVisibility|toggle=visdemo}Toggle the text above{menulink} {code}

As

you

can

see,

the

div

tag

has

been

given

a

HTML

id

-

the

raw

HTML

looks

like

this:

Code Block
html html
{code:html} <div id="visdemo"> ... <div> {code}

And

the

"target"

parameter

in

the

menulink

macro

states

what

id

will

be toggled.

If you want the tag to initially be hidden, use the "display:none" CSS style:

Code Block

toggled. The result: {div:id=visdemo=visdemo1|style=display:none;}*This is a div tag with id of "visdemovisdemo1" that you can show or hide using the link below.*{div} {menulink:toggleVisibility|toggle=visdemovisdemo1}ToggleShow/hide the text above{menulink} If you want the tag to initially be hidden, use the "display:none" CSS style: {code} {div:id=visdemo1|style=display:none;}*This is a div tag with id of "visdemo1" that you can show or hide using the link below.*{div} {menulink:toggleVisibility|toggle=visdemo1}Show/hide the text above{menulink} {code} The div tag will now be output with a style attribute like this: {code:html} <div id="visdemo1" style="display:none;"> ... <div> {code} Note that we've changed the id from "visdemo" to "visdemo1" - that's because a HTML id must be unique to the entire web page. If there are two or more occurrences of the same id, the results can be very unpredictable so make sure to use unique id's. The result (it starts hidden so click the link to see it): {div:id=visdemo1|style=display:none;}*This is a div tag with id of "visdemo1" that you can show or hide using the link below.*{div} {menulink:toggleVisibility|toggle=visdemo1}Show/hide the text above{menulink}

The div tag will now be output with a style attribute like this:

Code Block
html html
<div id="visdemo1" style="display:none;"> ... <div>

Note that we've changed the id from "visdemo" to "visdemo1" - that's because a HTML id must be unique to the entire web page. If there are two or more occurrences of the same id, the results can be very unpredictable so make sure to use unique id's.

Web UI links are a feature of Confluence plugins that allow them to add additional navigation to the default themes.

However, because Theme Builder displays navigation in a significantly different format, we can't display those links by default otherwise we'd end up with duplicate and confusing navigation in the default menus.

Web UI link support was added in Theme Builder 2.0.8 and above.

Before adding Web UI links as shown below, please check the table above the Examples section on this page which lists a number of aliases for popular third party plugins.

To add Web UI links to Theme Builder meuns, use the following syntax:

Code Block
{menulink:webui|location=XXXX|key=YYYY}webui link{menulink}

For example, here's the markup used for the podcasting plugin:

Podcast Page Tab

Code Block
{menulink:webui|location=system.page|key=podcast-episode-page-webui}Edit Podcast{menulink}

Podcast News Item Tab

Code Block
{menulink:webui|location=system.news|key=podcast-episode-blogpost-webui}Edit Podcast{menulink}

Podcast Channels Space Tab

Code Block
{menulink:webui|location=system.space|key=space-podcast-channel-webui}Podcast Channels{menulink}

Note: There are aliases for these links in the table further up the page, the links shown above are just to illustrate how to manually construct those links.

If you don't specify any link text (eg. "Edit Podcast") then the default text supplied by the plugins' Web UI link will be used.

Important
Many third party plugins don't do strict checking of the mode and context to determine whether a Web UI link should be displayed. Because Theme Builder can display Web UI links in any area of Confluence, you might need to use the builder-show macro or builder-hide macro to show/hide Web UI links that start appearing in too many places.

If you need a technical explanation as to why this is the case, or any help with working with Web UI links in third party plugins, please contact our support desk.

When using the menulink inside a menu, it needs to be wrapped in the menuitem macro, eg:

Code Block
{menuitem}{menulink:webui|location=system.space|key=space-podcast-channel-webui}Podcast Channels{menulink}{menuitem}

{menulink:edit|tooltip=Edit this content|accesskey=e}{menulink}