Skip to main content
Skip table of contents

Button Macro

PTC Button Macro can be inserted on a regular confluence page. With a click on the button the page tree can be recreated at a new target. Parameters that can be configured are explained in the next section.

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


Property Panel

Go to Source Page Opens a new tab referencing to the Source Page of the PTC Button.


Macro Parameters

Parameter

Description

Button Name

Any name you can think of is allowed, also special characters. You can also use tags if you need to.

The name of an Button in a page should be unique.

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.

Hover over the page in the drop down selection list, it will show you the space the template is located in.

Target Page

Defines where the new pages are added to.

  • This field is not required

  • To refer to the current page, leave this field empty. This allows a user to edit it later in the replacement form

Top Page Labels

Values entered here are attached only to the root page of the newly created page tree.

  • No special characters are allowed

  • Don't use whitespaces

  • Separate multiple labels only with commas, e.g. "firstlabel,secondlabel,thirdlabel"

Permitted Groups

Groups entered here are allowed to use the button. If no group is specified all users are allowed to use the button.

Watch Pages

Select if only the main/source page, all pages or no pages should be watched after instantiation.

Fixed Target

If checked, uses the configured target and skips the selection screen.

Page Selection

If checked, users see a list of all pages which are copied and can choose which pages they want to create.

Hide disabled Button

If checked, the button is hidden for users, those who haven't got permission to use the button.

Resolve Page Titles

If unchecked and using the button with same parameters for a second time would result in an error.

If checked, duplicated page title conflicts are avoided

Edit mode

If checked, you get redirected to the edit mode of the copied page after instantiation.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.