PTC Placeholders | EPS Atlassian Apps

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: @Unknown user
Labels	__label__	pr-meeting

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: @Unknown 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	@Unknown user
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: d (days) b (business days) w (weeks) m (months) y (years) By adding %+1m to the date placeholder, it will add one month to the selected date. A calculation could look like this: __next meeting%+1m__ Important: The same placeholder without any date has to be present on the page. Page before replacement \| Image Page after replacement \| Image	2021-05-27
Counter	Placeholder will count up with each instantiation	P01 P02 P03
Link	Placeholder will be replaced with a link and a link description	Google
Page	Placeholder will be replaced with a page reference	PTC Placeholders
Multi Line	Placeholder will be replaced with text that can be multiple lines	This is a description with multiple lines
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
Advanced Dropdown	Placeholder will be replaced with the selected value from the current Easy Dropdown Menu set	Predefined Set Weekdays → Friday
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__	@Unknown 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__	@Unknown user	Inserts the user, which created the template page
__template_last_modifier__	@Unknown user	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