Skip to main content
Skip table of contents

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

@a 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

Counter

Placeholder will count up with each instantiation

  1. P01

  2. P02

  3. 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__

@a 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__

@a user

Inserts the user, which created the template page

__template_last_modifier__

@a 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

JavaScript errors detected

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

If this problem persists, please contact our support.