[All Adaptavist Apps]
This macro creates a link to a specific Confluence feature or page relative to the current location in the wiki.
Each link destination abides by all applicable permissions - should the user not have sufficient permission to use the link, or simply be in a location where the link is not applicable, the body of the macro is returned un-linked (which is then usually hidden by the menuitem macro).
This macro requires [Theme Builder 2.0] or above.
{menulink:linktype|tootlip=tooltip text|accesskey=key}Link Text{menulink}
Property |
Required |
Default |
Notes |
---|---|---|---|
default |
|
The destination to link to (see list below) |
|
space |
current space |
Optionally set the space to which the link relates. |
|
page |
current page |
Optionally set the page to which the link relates, eg. when using the "newpage" destination you can define the parent page with this parameter. Unknown macro: {footnote} Use Builder 2.0.7 or above if you are using Confluence 2.5 or above to get the "page" parameter to work properly. |
|
parent |
space homepage |
When using the "exportMail" destination, this defines the page that will be the parent of the new page containing the exported mail message. |
|
link |
|
When using the "custom" destination (see examples) this is the URL to link to. |
|
target |
|
When using the "toggleVisibility" destination (see examples) this is the HTML id of the tag to show/hide. |
|
tooltip |
|
The tooltip to display when the mouse hovers over the link (max: 77 chars for cross-platform compatibility) 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. |
|
accesskey |
|
An optional shortcut key for the link which can be any alphanumeric character 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. |
|
target |
current browser window |
An optional target window or frame in which to load the link destination. |
|
class |
|
Optional HTML classes to associated with the hyperlink. |
The following link destinations can be used in the menulink macro and also the compound-menuitem macro.
The Ver column denotes which version of Theme Builder is required.
You can create keyboard shortcuts by adding empty menulinks to a panel in builder (eg. title or footnotes panel, etc), for example:
{menulink:edit|tooltip=Edit this content|accesskey=e}{menulink}
This would add the keyboard shortcut "Alt+E" to all screens that can be edited (eg. blogposts, pages, etc). The shortcut would only be available if the current user has sufficient privileges to edit the page, etc.