What is the PTC Create Page Tree Button Macro?

The “Create Page Tree Button” macro creates a new Page Tree from the template. Parameters that can be configured are explained in the next section.


How to use the PTC Button Macro

The Page Tree Creator Button can be inserted on any regular Confluence page. For more information visit Template Usage section.


Parameters

Parameter

Description

Type

Default Value

Button Name

Give your button a name, special characters and placeholders are allowed.

Text-Input

Create Page Tree

Source Page

Specifies the root page of your template. This template is a normal confluence page. When the button is clicked, the root page and all its children are used as template for the new page tree.

  • This field is required.

  • "@self" uses the current page as root page. You can also use the final page name.

For all other pages, there are three ways in which to define the source page:

  1. Search for the page in the search box. Results are displayed as: PAGE_TITLE (SPACE_NAME). Select the desired page. After selection, the source page will be displayed as SPACE_KEY:PAGE_TITLE

  2. Search via Page ID. Whenever a Page ID is used as a search query, the corresponding page will be displayed as a search result

  3. Input the desired Space Key and Page Title combination directly into the search box and click "Create "INPUT_TEXT"". The syntax for this is: SPACE_KEY:PAGE_TITLE.

Text-Input

@self

Target Page

Specifies the parent page of the created page tree.

  • "@home" uses the home (/ landing) page of the space as root page.

For all other pages, there are three ways in which to define the target page:

  1. Search for the page in the search box. Results are displayed as: PAGE_TITLE (SPACE_NAME). Select the desired page. After selection, the target page will be displayed as SPACE_KEY:PAGE_TITLE

  2. Search via Page ID. Whenever a Page ID is used as a search query, the corresponding page will be displayed as a search result

  3. Input the desired Space Key and Page Title combination directly into the search box and click "Create "INPUT_TEXT"". The syntax for this is: SPACE_KEY:PAGE_TITLE.

Text-Input

empty

Top Page Labels

Labels which are applied to the root page of the new space. Separate multiple labels with commas.

Placeholders can be input as labels which can be replaced when using the button.

Text-Input

empty

Permitted Groups

If groups are selected only users in these groups will be able to use the button, for all other users the button will be disabled. If no group is selected no additional restrictions will be set.

Multi-Dropdown

empty

Fixed Target

When checked, the Target Selection will be disabled in the Wizard.

Checkbox

false

Hide disabled Button

When checked, the button will only be displayed if the user is permitted to use it.

Checkbox

false

Resolve Page Titles

When checked, the Page Titles will be automatically resolved to avoid duplicated Page Title conflicts.

Checkbox

true

Copy Attachments

When checked, attachments will be copied

Checkbox

true

Edit Mode

When checked, the user will be go straight into the edit mode of the newly created page.

Checkbox

false

Page Selection

When checked, the user will be able to select/deselect sub-pages of the page being copied in the wizard. If a page is selected, it will be copied.

Checkbox

true