{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 | Required | 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:
|
| 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}
Discussions