PTC Placeholders
What is a PTC Placeholder?
A PTC Placeholder is like a variable that will be replaced when the page is copied with the Page Tree Creator.
Any placed placeholder on the page is replaceable with a desired value during the copy procedure.
source page (Before Instantiation) | new created page | |
|---|---|---|
Page Title | Meeting Notes __date__ | Meeting Notes 2021-08-12 |
Page Body | This is for the project __nr__. Author: __author__ | This is for the project P08. Author: @a user |
Labels | __label__ | pr-meeting |
What kind of PTC Placeholders are there?
Placeholder Types are set with the Placeholder Macro
Type | Description | Example |
|---|---|---|
Standard | Placeholder will be replaced with text | P980 |
User | Placeholder will be replaced with one or multiple user mentions | |
Date | Placeholder will be replaced with a date macro It’s also possible to perform operations (+/-) on the date by adding % followed by the operation (e.g. __date%+2w__). Calculations can be performed with the following units:
By adding %+1m to the date placeholder, it will add one month to the selected date. A calculation could look like this: Important:   |
|
Counter | Placeholder will count up with each instantiation |
|
Link | Placeholder will be replaced with a link and a link description | |
Page | Placeholder will be replaced with a page reference | |
Multi Line | Placeholder will be replaced with text that can be multiple lines | This is a description |
Dropdown | Placeholder will be replaced with a single or multi selection of some dropdown values | Dropdown : A,B,C → B |
Regex | Placeholder will be replaced with text that has to match a chosen regular expression | Regex: ([A-Z])\w+ → Text |
Default placeholders | Placeholder will be replaced automatically. For all possible default placeholders see below | __current_country__ → Switzerland |
Where can I use the PTC Placeholder?
Placeholder can be used everywhere in you Confluence page: as title, in the body or in labels. You can also use it in our own macros for example in our Page Create Button Macro and Space Create Button Macro.
When creating new spaces, placeholders in the space description and in space categories can be replaced, too.
PTC Placeholder marker settings
A placeholder is recognizable with his front-marker and tail-marker (the default marker are two underscores “__“ they are changeable in the admin section General Setting
Note: Admin permission needed
PTC Placeholder default placeholder
The Page Tree Creator provides some default placeholders that you can use, these placeholders are:
Default Tag | Example Replacement | Description |
|---|---|---|
__current_user__ | Inserts the current user | |
__current_date__ | 17 Jun 2019 | Inserts the current date |
__current_time__ | 17:24 | Inserts the current time |
__current_country__ | Switzerland | Inserts the current country |
__current_year__ | 2020 | Inserts the current year |
__current_weekday__ | Monday | Inserts the current day of the week, e.g. Monday, Tuesday... |
__current_day__ | 17 | Inserts the current day within the month, e.g. 15 |
__current_week_number__ | 25 | Inserts the current week number, e.g. 29 |
__current_month_text__ | June | Inserts the current month as string, e.g. April |
__current_month_number__ | 06 | Inserts the current month as number, e.g. 8 |
__template_title__ | __ProjectNumber__ Project __ProjectName__ | Inserts the title of the template page |
__template_space__ | Page Tree Creator Template Space | Inserts the space of the template page |
__template_version__ | v.16 | Inserts the version of the template page |
__template_creator__ | Inserts the user, which created the template page | |
__template_last_modifier__ | Inserts the user, which has most recently edited the template page | |
__template_last_modification_date__ | 12 Jun 2019 | Inserts the modification date of the template page |
__source_space_title__ | Page Tree Creator | Inserts the title of the space the original page belongs to |
__source_space_key__ | PEPSPTC | Inserts the key of the space the original page belongs to |
__target_space_title__ | Page Tree Creator Documentation | Inserts the title of the space the new page is created in |
__target_space_key__ | PPTCDOC | Inserts the key of the space the new page is created in |