preset-options

Macros

repeat-filter

{redirect}

Plugin: Redirection Plugin

This will redirect the browser to the specified page or URL.

Usage

{redirect:[Page,^attachment.ext,http://wherever.com]|delay=[seconds]}

Parameters

Name	Required	Default	Description
[default]/location			Specifies the Confluence content or URL to redirect to. Eg. Another Page, ^attachment.ext or http://www.randombits.org/. Note: If the external URL contains an '=' character, you must specify it using the 'location' parameter name, or you will get error messages asking for the URL.
delay		0	The number of seconds to delay before redirecting the browser.

Examples

I have some software which is updated semi-regularly. To make it easy to link, I want a single 'Release Notes' page which is updated to have the latest notes in it. However, I also want to keep an archive of previous release notes too.

1. Create a release notes page called 'Release Notes 1.1'
2. Create another page called 'Release Notes' with the following contents:

   {redirect:Release Notes 1.1}

When a new version is released, do the following:

1. Create a page called 'Release Notes 1.2' with the new notes.
2. Edit the original 'Release Notes' page by adding '?redirect=false' to the URL. Eg:

   http://www.foo.com/confluence/display/MYSPACE/Release+Notes?redirect=false

3. Change the contents to:

   {redirect:Release Notes 1.2}

Notes

• This macro does not keep track of whether the page being redirected to has had its name changed.
• To edit a page which redirects instantly, add '?redirect=false' to the URL manually.
• This macro uses JavaScript to redirect, so browsers with JavaScript turned off will have to click through manually.

See Also

• redirect macro guide
• alias

preset-options

Macros

repeat-filter