Link Page

Description

(warning) This macro is currently not available on Cloud.

This will create a link to a page, or a link to create a page based on a template and/or parent page.

If the page doesn't exist or is untitled, it generates an Add Page link which, when clicked, can take the user directly to a template and/or set the page parent.

The page name may also contain substitution markers, indicated with "%" surrounding a Supplier key chain value.

e.g:

%content:title% - %global:current user > user:full name%

This will link to a page with the name being the parent page's title, followed by " - " followed by the current user's name.


Parameters

NameRequiredAvailable InDefault ValueDescription

Page Name

 (error)

Server


{injected} The name of the specific page to link to. If not provided, the link will always create a new page when clicked.

Link Text

 (tick)

Server


Text display for the link.

Source

 (error)

Server


The name of the template or page to copy the new page content from.

Source Type

 (error)

Server

template

The type of source, either template or page.

Live Template

 (error)

Server

false

If set to true, the template will be live when the page is created. Requires Scaffolding to be installed.

Prefix

 (error)

Server


{injected} The %injectable% prefix to apply to the page name.

The user will not be able to modify this section of the name while creating it.

e.g:

'%page:title% - ' will add the current page title plus ' - ' to the start of the page name. 


Postfix

 (error)

Server


{injected} The %injectable% postfix to apply to the page name.

The user will not be able to modify this section of the name while creating it.

e.g:

' - %page:title%' will add ' - ' plus the current page title to the end of the page name. 


Parent

 (error)

Server

@self

The name of the parent page. If no parent page is desired, set parent to a blank value.

May also have the following markers:

  • @self - (default) the parent will be the page the macro is in.
  • @parent - the parent will be the parent of the page the macro is in.
  • @home - the parent will be home page for the Space the page is in. 

Labels

 (error)

Server


The list of labels to apply to the new page.

Tip

 (error)

Server


If you want popup text to appear when the mouse is hovered over the link, enter it here.

Allow Rename

 (error)

Server


If set to true, the user will be allowed to rename the page when it is being created.