Configuration

The PTC Configuration is split up into General Settings and Security Settings.

When resetting the configuration (by clicking the “Reset Config”) button, the General and Security Settings will both be reset to the default configuration.

General Settings

The general settings can be used to adjust the Page Tree Creator, and its appearance according to your desire.

Direct links

Page Tree Creator Pro is:

https://<YOUR-INSTANCE>.atlassian.net/wiki/plugins/servlet/ac/eps.focuspro.PageTreeCreator/ptc-config-page

Page Tree Creator is:

https://<YOUR-INSTANCE>.atlassian.net/wiki/plugins/servlet/ac/eps.focuspro.SpaceTreeCreator/ptc-config-page

General Settings Parameters

Element

Meaning

Default Value

Example

Placeholder Markers*

Markers are used to identify placeholders which can later be replaced

$$ (two dollars)

$$Customer$$

Format marker

Marker for format placeholders

%

$$%d Start date$$

Template Sticker

Here you can change the Template Marker, maybe there is a case where you want an other template identifier. In the copy process the Template Marker will be removed.

Per default the Template Marker will be '_Template'.

Template Page Title:

→ '_Template Meeting Notes'


New Page Title:

→ 'Meeting Notes'

Use new Space Title as hidden landing page title

The Page Title of the Space’s Home / Landing page is hidden and shows the Space name instead.

If this option is checked, the hidden title of the new Space Landing Page will be the same as the Space Title.

Enabled

Space Title Instruction

Optional instruction below the Space Title input in the "Copy Space" form.

Empty

“Enter the project name here.”

Space Key Instruction

Optional instruction below the Space Key input in the "Copy Space" form.

Empty

“Enter the project number here.”

Show EPS Logo

Shows the EPS Header (Logo and Description) in the Page Tree Creator Replacement form

Enabled


Hide Form Options Section

Hide the options section found in the Replacement Forms.

Those include “Copy attachments” and “Page Title Prefix”.

Disabled

Show Context Menu

Choose under what circumstances the Copy Page Tree field in Page Tools should be shown.

Always


Show Context Menu (Create Space)

Choose under what circumstances the Copy Space field in Page Tools should be shown.

Always

Security Settings

The Security settings can be used to adjust app usage permissions for specific users, groups, or even spaces.

Direct links

Page Tree Creator Pro is:

https://<YOUR-INSTANCE>.atlassian.net/wiki/plugins/servlet/ac/eps.focuspro.PageTreeCreator/ptc-security-config-page

Page Tree Creator is:

https://<YOUR-INSTANCE>.atlassian.net/wiki/plugins/servlet/ac/eps.focuspro.SpaceTreeCreator/ptc-security-config-page

Security Settings Parameters

Element

Meaning

Default Value

User becomes admin

The user creating the space, automatically becomes space admin (Confluence standard).

True

Exempt Create Space Permission

The PTC Create Space Button can be used regardless of the global Create Space permission.

When checked:

  • The user can now create a space with the PTC Create Space Button regardless of the global Create Space permission

  • The user still needs view permission on the source page

  • The PTC Create Space Button permissions still apply

  • The Space Permitted spaces configuration still applies

False

Omit Page Restrictions

Omit restrictions for the new Page Tree. If checked, the restrictions from the source Page wont be copied at all. This setting can help if you have unprivileged users which need to use Page Tree Creator on edit restricted template spaces.

Disabled

Space Permission

Exempt View Permission:

If checked, there is no view permission needed on the selected source space to copy pages from it.

Authorize Space Instantiation: If one or more spaces are selected to be authorized, then it is only possible to create spaces from these source spaces. If none is selected here then all spaces can be used as source to create new spaces from. By default all spaces are authorized spaces.

None

Permitted Groups

Users in these groups are allowed to use "Copy Space" and "Copy Page Tree" from every space. (even if they are not listed in “Permitted Spaces”)

None

Placeholder Marker Information

There are some markers you should not use because they are part of the Confluence functions and can result in different behavior or can be annoying while typing the new placeholder.

Character

Example how NOT to use custom marker

Function / Reason

/

/Placeholder/

Open Macro Search

_

_placeholder_

Makes placeholder italic → placeholder

*

*placeholder*

Makes placeholder italic → placeholder

__

__placeholder__

Makes placeholder bold → placeholder

**

**placeholder**

Makes placeholder bold → placeholder

:

:placeholder:

: opens emoticon search

@

@placeholder@

@ Mention Confluence Users

~~

~~placeholder~~

Makes a strikethrough → placeholder

`

`placeholder`

Makes a code block → placeholder

In addition to that, there is a set of characters, which are not supported in labels, and would therefore make it unable to use placeholders in labels:

Set of Characters

Problem

(:, ;, ,, ., , ?, &, [, ], (, ), #, ^, *, @, !, ' ' - spaces ).

throws GraphQL error: com.atlassian.confluence.api.service.exceptions.BadRequestException: Could not add labels to content with id ContentId{id=contentid}

Permissions

The Page Tree Creator permissions are built on top of the confluence permission system.

  • To create a new page with the Page Tree Creator in any way, you need the specific write permissions for the target space.

  • To create a new page tree from a template with the Page Tree Creator, you need at least Confluence view permission for all pages of the template. Pages which restrict you from viewing them won't be copied.