Configuration and Permissions
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.
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$$ |
Hide Placeholder markers | A checkbox that can be used to select whether the placeholder markers should be hidden or not in the Page Tree Creator Replacement Form | Enabled | |
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 Page Tree Creator context menu entries are shown. | Always | |
Omit 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 |
Security Settings
The Security settings can be used to adjust app usage permissions for specific users, groups, or even spaces.
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 | Example |
|---|---|---|---|
Permitted Spaces | If at least one space is selected, only spaces from this list can serve as template spaces. If none is selected, all spaces can be used. This includes both “Copy Page Tree” and “Copy Space”. | None (all spaces are permitted) | |
Special 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` | Makes a code block → |
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.