Confluence

Dashboard

There are numerous global locations that all users can access - as such, there is no need to hide such links depending on who is logged in.

To link to The Dashboard, use the following:

{link-to:dashboard}Go to dashboard{link-to}

Resulting in: Go to dashboard

Home Page

To link to the home page, use the following:

{link-to:homepage}Go to homepage{link-to}

The home page will take the user to one of the following (in order of preference):

• The space defined as the home page in the user's profile (if set)
• The Site Homepage (if set by a system administrator)
• The Dashboard

The result: Go to homepage

Notation Guide

To link to the Notation Guide (which shows brief examples of various Macros and other Wiki Markup Editor), use the following:

{link-to:notation guide}Go to notation guide{link-to}

Resulting in: Go to notation guide

In addition, you may wish to open the notation guide in a new window:

{link-to:notation guide|popup=true|target=_blank}Go to notation guide{link-to}

Resulting in: Go to notation guide

Because the notation guide is usually only useful to registered users (as Wiki Markup Editor can be used on their personal profile, comments, etc), you can hide it from anonymous users as follows:

{show-to:group=confluence-users}
{link-to:notation guide|popup=true|target=_blank}Go to notation guide{link-to}
{show-to}

By only showing the link to confluence users, you are effectively hiding it from anonymous users.

If you are using this macro within a space, you could alter the settings to only show it to people who can add news, comments or pages - for more information see the show-to macro.

Global Templates

Global templates can be used by content authors in any space while adding pages. To link to the global templates, use the following:

{link-to:global templates}View global templates{link-to}

Ideally you should restrict the view of the link to people who could possibly use the global templates, however there is currently no easy way to determine who such people are. However, if you create a user group called editors (or something similar), and add anyone who can edit pages (in any space) to that group, you can then use the show-to macro to display the link only to editors:

{show-to:group=editors}
{link-to:global templates}View global templates{link-to}
{show-to}

Login and Logout Screens

To create a link to the login screen, use the following:

{hide-from:group=confluence-users}
{link-to:login}Login{link-to}
{hide-from}

As you can see, we've hidden the link from anyone who is already logged in using the hide-from macro.

To create a link to the logout screen (which will log the user out when clicked), use the following:

{show-to:group=confluence-users}
{link-to:logout}Logout{link-to}
{show-to}

The show-to macro has been used so that this link is only displayed to logged in users.

User Profile

All registered users have a user profile which allows them to edit their details, notification scheme, etc. To link to the profile of the currently logged in user, use the following:

{show-to:group=confluence-users}
{link-to:user profile}My profile{link-to}
{show-to}

By mixing the profile link with the login link you can ask the user to login if in order to edit their profile:

{show-to:group=confluence-users}
{link-to:user profile}My profile{link-to}
{show-to}{hide-from:group=confluence-users}
{link-to:login}Login to edit your profile{link-to}
{hide-from}

If the user is not logged in, they will see the Login to edit your profile link, othwerwise they will see the My profile link.

User History

As people browse your site, a temporary history of visited pages is maintained allowing them to quickly jump back to pages they've already visited. This applies to both registered and anonymous users. Link to the history page as follows:

{link-to:user history}Which pages have I visited recently?{link-to}

Resulting in: Which pages have I visited recently?

Administration Console

The Administration Console allows administrators to configure all aspects of the server and as such the link should only be shown to them:

{show-to:group=confluence-administrators}
{link-to:admin}Administration Console{link-to}
{show-to}

Spaces List

Some versions of Confluence have a spaces list that lists all Spaces that the current user has access to. To link to this list (if available), use the following:

{link-to:spaces}Space List{link-to}

Note: Not all versions of the {link-to} macro support this link.

Specifying the Space

When you use the macro within a space (e.g. on a page), it will automatically assume that any space locations you refer to are within that space.

However, if you use the macro outside a space (e.g. the Site Welcome Message) or wish to link to a different space then you will need to specify the space parameter.

For example, the following will link to the alphabetical index on our corpoate website ("ADAPTAVIST" space):

{link-to:pages alphabetical|space=ADAPTAVIST}Adaptavist Site Index{link-to}

Resulting in: Adaptavist Site Index

Browse Space

When using the default Confluence theme, the space browser provides tabbed navigation pages for locating content and browsing templates, etc.

To link to the space browser, use the following:

{link-to:browse space|space=ADAPTAVIST}Browse Adaptavist Space{link-to}

Resulting in: Browse Adaptavist Space

If the space parameter is omitted, the current space will be used as default.