[All Adaptavist Apps]
This page provides a quick-reference guide to the parameters and features of the menulink macro and compound-menuitem macro (click for more information when/where to use each macro).
This page is still under construction - some parameters and destinations are not yet listed
The Ver column denotes the minimum version of Theme Builder that is required.
The following parameters are available in both the menulink macro and compound-menuitem macro:
Parameter |
Required |
Default |
Description |
Ver |
---|---|---|---|---|
default |
|
Defines the type of link to output (see Destinations and Aliases below). |
2.0 |
|
accesskey |
|
Assign a access key (alpha or numeric keyboard shortcut) to the link. Unknown macro: {footnote}
When using links inside menus, you can also prefix a letter in the link text with an "_" to define the access key - this letter will then be underlined when displayed in the menu. Access keys only work when the associated item is visible on screen.
|
|
|
checkexists |
|
Determines how the "userspace" destination will work:
|
|
|
class |
|
Adds one or more classes to the link, for use with CSS Selectors. |
|
|
force |
|
Determines how the "comments" or "children" destinations function:
|
|
|
key |
When used with the "webui" destination, this defines the link key. Unknown macro: {div}
Deprecated – use Aliases instead.
|
2.0.8 |
||
latch |
|
Determines the effect of the "use-layout" destination:
|
3.0 |
|
layout |
|
When using the "use-layout" destination, defines the ID of the layout to use. |
3.0 |
|
link |
|
When using the "custom" destination, defines the URL to use for the link. Unknown macro: {div}
Tip: Centrally define and manage custom links via the [Menulinks Aliases Tab]
|
|
|
location |
|
When used with the "webui" destination, this defines the link location. Unknown macro: {div}
Deprecated – use Aliases instead.
|
2.0.8 |
|
page |
current page |
For Destinations that would normally apply to the current page, you can use this parameter to specify a different page by it's page title. |
Unknown macro: {footnote} For Confluence 2.5 and above, use Theme Builder 2.0.7 or later to ensure this parameter works correctly. |
|
parent |
space home page |
Defines the parent that the "exportMail" destination will use when exporting mail archive messages to wiki pages. |
|
|
space |
current space |
For Destinations that would normally apply to the current space, or a page in that space, you can use this parameter to specify a different space by it's space key. |
|
|
target |
|
Defines the link target, eg. |
2.0.9 |
|
title |
Page title to (used with "newpage" destination) |
|
||
toggle |
|
Defines the ID of the HTML element to toggle when using the "toggleVisibility" destination. |
3.0 |
|
tooltip |
|
Defines the tooltip that will be displayed when hovering over the link. Unknown macro: {footnote}
When using the link in a menu, tooltips will only be shown if enabled in theme configuration. In all other formats, the tooltip will always be shown when the mouse hovers over the link.
|
|
The following parameters are only available in the compound-menuitem macro:
Parameter |
Required |
Default |
Description |
Ver |
---|---|---|---|---|
forceicon |
|
|
force the icon to be displayed irrespective of the layout (default false) |
|
icon |
|
|
the icon to use |
|
imginside |
|
|
should the icon appear inside the link (default=false) |
|
size |
|
The size of the icon (if applicable) |
|
Destination |
Description |
---|---|
advanced |
go to advanced config page |
children |
show/hide children toggle |
comments |
show/hide comments toggle |
configuretheme |
configure the theme |
copy |
copy the current page |
dashboard |
go to dashboard |
edit |
edit the current page |
exportMail |
export email to page |
exportPDF |
export page to pdf |
exportWord |
export page to word doc |
favourite |
add page to favourites |
favouritespace |
add space to favourites |
globaltemplates |
display list of global templates |
history |
show account history |
home |
go to space home page |
index |
go to space index |
information |
show page information |
labels |
show labels heatmap |
login |
go to login screen |
logout |
log out |
show space email |
|
map |
go to space map |
newcomment |
add a comment |
newnews |
create a new blogpost |
newpage |
create a new page |
newspace |
create a new space |
news |
view space news |
normalView |
view page as normal |
pageattachments |
show page attachments |
viewattachments |
show page attachments without checking attachment permission |
printableView |
view page as printable |
profile |
show user profile |
recent |
view recently updated in space |
remove |
delete the current page |
RSS |
go to rss feed editor |
search |
links to the search screen |
signup |
create a new account |
siteadmin |
go to site administration |
spaceadmin |
go to space administration |
colourscheme |
go to colour scheme selector |
spaceattachments |
display space attachments |
spacetemplates |
display list of space templates |
userspace |
show user's space |
watch |
watch current page/space |
watchspace |
watch current space |
custom |
define a custom link |
toggleVisibility |
toggle the visibility of an html element |
people |
show the people directory |
activity |
show site/space activity |
webui |
show a webui link, requires location & key parameters |
use-layout |
change the layout |
wikipage |
link to the page specified by the page & space parameters |
next |
the next sibling page |
prev |
the previous sibling page |
first |
the first sibling page |
last |
the last sibling page |
parent |
the current page's parent |
firstchild |
the first child page |
lastchild |
the last child page |
notationguide |
link to the macro notation guide |
managelayouts |
link to manage layouts |
pageView |
view the current page in normal mode |
viewSource |
view the wiki markup source of the current page |
editinword |
edit the current page using MS-Word (requires the office connector plugin) |
This feature requires Theme Builder 3.3 or above.
You can create any number of custom destinations via the Menulink Aliases Tab. Once defined, the alias can be used in the default parameter of the menulink macro and compound-menuitem macro just like any of the Destinations listed above.
A number of pre-defined aliases are available for linking to features in popular third-party plugins:
Alias |
Destination |
Plugin |
---|---|---|
pagewatcher |
system.page:pagewatcher |
|
newswatcher |
system.news:newswatcher |
|
pagefavourites |
system.page:pagefavourites |
|
newsfavourites |
system.news:newsfavourites |
|
emailpage |
system.page.operations:mail-page |
|
addgliffydiagram |
system.space.actions:gliffy_system_space_add_diagram_action |
|
admingliffy |
system.admin/administration:gliffyshowadminwebitem |
|
podcastpage |
system.page:podcast-episode-page-webui |
|
podcastnews |
system.news:podcast-episode-blogpost-webui |
|
podcastchannels |
system.space:space-podcast-channel-webui |
|
customusermanagement |
system.space:space-custom-usermanagement |
|
editgridaddbook |
system.space.action:editgrid-space-add-book |
|
inviteothersadmin |
system.space.admin/security:admin.invitelink |
|
invitelistadmin |
system.space.admin/security:admin.invitelistlink |
|
inviteothers |
system.space.advanced/advanced:advanced.invitelink |
|
invitelist |
system.space.advanced/advanced:advanced.invitelink |
|
invite |
system.space.actions:space.invitelink |
|
review |
system.page:review |
|
reviewreport |
system.space:space-markforreview-report |
|
reviewspaceconfig |
system.space.admin/security:configure-markforreview-space |
|
reviewglobalconfig |
system.space.admin/security:configure-markforreview-global |
|
space-socialbookmarks |
system.space:space-socialbookmarks |
|
addbookmark |
system.space.actions:addbookmark |
|
config-approvals |
system.admin:approvalsWorkflowConfig |
|
manage-approvals |
system.space.admin:editspaceapprovals |
|
space-approvals |
system.space:space-approvals |
|
page-approvals |
system.page:page-approvals |
|
released-approvals |
system.page:released |
When you first use any of the aliases listed above, an entry will automatically be added to the list of aliases on the Menulink Aliases Tab.