Documentation for Page Tree Creator 5.1.5

Documentation for earlier versions of Page Tree Creator is available too. 

ContentUpdate the Page Tree Creator from version 4 to version 5.1.5
DetailsWhat has changed and how to migrate your old templates

All your PTC buttons will still work as before the update

The old templates need to be moved to a new template space, so they show up in the Confluence create from template dialog more...

Content

Overview

This guidance will help you to update the Page Tree Creator from version 4 to version 5.1.5

The big differences are:

  • (Plus) Multiple template spaces, migrate your templates
  • (Plus) Create dialogs instead of replacement forms
  • (Plus) Simplified consecutive tags
  • (Plus) Simplified general configuration
  • (Plus) Improvement of tag descriptions and button macros
  • (Warnung) Tag format marker not supported anymore more...




New Features

Multiple Template Spaces

Add as many template spaces as desired

New Categories

Categories are used in template spaces to help organize the templates

New Create Dialog

Instead of a replacement form

Tag Description Macro

  • New field to select a separator for displaying multiple dropdown entries after instantiation.
  • New format "Regex" with a pattern field to match the tag
  • New textbox "Info"

PTC Button Macro

  • Renamed "Hide Select a new destination" to "Fixed Target"
  • Renamed "Show Page Selection" to "Page Selection"
  • New checkbox "Resolve Page Titles" to forbid duplicate page titles


Changes

Migrate Templates

Templates have to be located in a template space (Migrate your templates)

Consecutive Tags

Simplified functionality to only counting up after each instantiation

e.g. 001 → 002 → 003...

General Configuration

  • Simplified General PTC Configuration
  • New second configuration: "Template Spaces"
  • Don't forget to check if your configuration are still correct after the update


Migrate your templates

  1. Create a new template space (How to create a Template Space)
  2. Set up some categories if needed (How to create a new Category)
  3. Got to your old template space and move every template individually (How to create a new template from an old one)
    1. Move global templates
    2. Move templates for space
  4. Migrate tag formats
    1. Remove the tag format marker: __%uUser__ →  __User__
    2. Add a tag description macro for tag __User__ with format "User"
    3. Remove the cascade tags: ____cascade____ → __cascade__

Migrate global template to template space

Migrate space scoped template to template space

General Configuration

Version 4Version 5Alternative
Tag Markers(Haken)
Tag Format Marker(Fehler)

Use the PTC tag description macro to give a tag a special format

Page prefix(Fehler)

Suffix instead of prefix, when duplicate page title

e.g. "page title" → "page title (1)"

Template Sticker(Haken)
Hide Tag Markers(Fehler)Tag markers are always hidden in the replace dialog
Use Comala Workflow(Haken)
Show PTC logo and description(Fehler)No more PTC logo or description in the dialog
Show context menu(Haken)Renamed to Show Copy Page Tree
Icon in context menu(Haken)Renamed to Show Icons in Page Tools
Confluence Create Dialog(Fehler)Each template can be configured to be shown in the Create dialog individually
Use Template Space(Fehler)Templates have to be in a template space
Template Space Key(Warnung)

Second PTC configuration: Template Spaces

Multiple template spaces are now possible

Template Groups(Fehler)User with Create Page Permission on a template space can create new
Templates
Permitted Spaces(Fehler)Not supported anymore, replaced with concept of multiple template spaces
Special Users(Fehler)Not supported anymore, replaced with concept of multiple template spaces
Special Groups(Fehler)Not supported anymore, replaced with concept of multiple template spaces

Deprecated Functionality

Tag Format Marker

__%uUser__ is not supported anymore → Use the PTC tag description macro instead