add-page-form

add-page

Macros

alias

Get Satisfaction support network

{add-page-form}

Plugin: Linking Plugin, from version 2.5.0

Creates a simple form on a page for users to enter the name of the new page to add.

Description

Very similar to the add-page macro, this will then create a new page, which may be based on a template if so desired.

Usage

{add-page-form:template=A Template|live=true}Add new page{add-page-form}

Parameters

Name	Default	Description
template		The name of the Template to use when creating the page.
live	false	If set to 'true', the template will be 'live' - that it it uses the live-template macro to import and execute the current value of the template every time the page is viewed. Requires the Scaffolding Plugin to be installed.
parent	@self	The page you would like to be the parent of the new page. If no parent page is desired, set parent to a blank value. ie. 'parent='. There are also three special values: @self - sets the parent to the new page the macro appears in. @parent - sets the parent of the new page to the parent of the current page. @home - sets the parent of the new page to the home page of the current space.
labels		The list of labels to attach to the new page. Only works for live template pages.
allowRename		(Since 2.4) If set to `true`, the user will be allowed to rename the page when it is being created.
nameWidth		If set, this specifies the width of the name text field. Can be any valid CSS width value, such as '300px' or '60%'.
class		(Since 2.6.5) Sets a class for the displayed form items.
prefix		(Since 2.8.0) The %injectable% prefix to apply to the page name. The user will not be able to modify this section of the name while creating it. Eg: 'prefix=%page:title% - ' will add the current page title plus ' - ' to the start of the page name.
postfix		(Since 2.8.0) The %injectable% postfix to apply to the page name. The user will not be able to modify this section of the name while creating it. Eg: 'postfix=%page:title% - ' will add the current page title plus ' - ' to the end of the page name.

Examples

Create a new page based on a live template

(+) {add-page-form:template=My Template|live=true}Add new page{add-page-form}

Create a new page with a fixed postfix

(+) {add-page-form:template=My Template|live=true|postfix= - %page:title%}Add a new page{add-page-form}

add-page-form

Discussion