What is the Create Space Button?

The Create Space Button macro always creates a new space with the respective tree structure (result) on the basis of a source document in the form of a tree (template). The template may include several tags which are replaced depending on the situation upon creation of the new tree structure.

The Space Creation function is started mainly using the Create Space Button macro, or in exceptional cases, by selecting the ‘Copy / Create Space’ in the Tool bar. Before the Space Creation will create the new space with the new tree structure, you are prompted to replace the tags in the template by your values using the Page Tree Creator Replacement Form.


Parameter Information

Parameter

Input Field Type

Description

Button Name

required

Text Field

Give your button a name, special characters and placeholders are allowed.

Source Page

required

Text Field / Dropdown

Specifies the root page of your template. This template is a normal confluence page. When the button is clicked, the root page and all its children are used as template for the new page tree. The root page will become the new home page.

Space Title Instruction

Text Field (Multi field)

Optional instruction below the ‘Space Title’ input in the Create Space dialog. (Overrides ‘General Setting’ instruction)

Space Key Instruction

Text Field (Multi field)

Optional instruction below the ‘Space Key’ input in the Create Space dialog.. (Overrides ‘General Setting’ instruction)

Default Target Space Key

Text Field

Default Target Space Key will be displayed when creating a new Space with the Space Create Button macro. The key may only consist of ASCII letters or numbers (A-Z, a-z, 0-9), without any spaces.

Disable Target Space Key Input

Checkbox

When setting a Default Target Space Key the input field in the Create Space dialog will be disabled and cannot be changed. When the space key already exists a number will be appended to its key, since the space key has to be unique

Permitted Groups

Text Field

Restrict the usage of the button to specific groups

Hide disabled Button

Checkbox

The Space Create Button can be hidden when the user has no permission, else the button is just disabled

Labels for Top Page

Text Field

A label can be added to the newly created top page. Tags will not be replaced. Separate labels with commas, No Whitespaces!

Show Page Selection

Checkbox

If checked, the user chooses which pages get copied when the Create Space Button is used.

Copy Attachments

Checkbox

If checked, all attachments will be copied to the new space.

Copy Space Favorite

Checkbox

If checked, the new space will be added to “My Spaces”, if the source space was already in “My Spaces”. If unchecked, the space won’t be added to “My Spaces”

Copy Page Favorite

Checkbox

If checked, new pages are “saved for later” if the associated source page was “saved for later”, too. If unchecked, no new page is “saved for later”

Copy Page-Templates

Checkbox

If checked, spaces created from this button inherit all page templates from the source space.

Copy Space-Permissions

Checkbox

If checked, spaces created from this button inherit it's space permissions from the source space.

Create Personal Space

Checkbox

Let the user create his own Personal Space.

Existing Category Key for Refined-Theme Plugin

Text Field

Use if Refined-Theme for Confluence is installed to preselect a Category