Difference between revisions of "Manual:Extension/BlueSpicePageTemplates"

[unchecked revision][quality revision]
m
(Tag: 2017 source edit)
m
(Tag: 2017 source edit)


What is BlueSpicePageTemplates

What is a page template?[edit | edit source]

BlueSpicePageTemplates offers creating new pages using predefined templates to set basic page structure.

Usage[edit | edit source]

Page template manager Editing a template in the Page template manager Available page templates when creating a new pageCreating template pages

A page template allows you to apply a predefined content structure to new pages. Thus, certain page types can be created, which are initially always the same structure. This is especially useful for frequently used content formats such as logs, reference pages, product descriptions, or short manuals. When a page is created with a page template, the page becomes "detached" from the original page template. This means that subsequent changes to the template will not affect pages that have originally been created with that page template. This distinguishes page templates from regular templates.

Characteristics[edit | edit source]

Every page template depends on an actual page in namespace Template (NS_TEMPLATE) to provide the content that will be inserted into new pages when created using this page template. This must exist before creating a page template.

Creating page templates
  • Listed as template choices when a page is created
  • Create an independent new page with pre-filled content
  • Based on templates in the Template namespaces

Creating a page template[edit | edit source]

Page template manager
Wiki admins can create new page templates, as well as edit and remove existing ones in the Page template templates manager. It is located in the left navigation, in , located under "Global actions" tab, under "Management" section. From here, when selected, page template can be edited by clicking on the "wrench" icon, or deleted by clicking on the "X" icon. New templates can be created using .

Note: Every page template depends on an actual page in the namespace Template. This template must exist before creating a page template.

A new page template can be created by clicking the "Plus" button above the template list.

Template fields[edit | edit source]

Editing a template in the Page template manager
When creating or editing a page template, the following information need needs to be inserted. provided:
  • Name - the name of the template
  • Description - a short description of the template
  • Namespace - list of the namespace where using this template will be offeredthe template is active
  • Template - page from the Template namespace from which to pull the data from


Using page templates

when creating new pages

[edit | edit source]

Once the page template can be saved, it can be used
Available page templates when creating
new pages in namespaces that the template is set for. List of availble templates to choose from will appear when creating new page,
a new page
A list of available templates appears when a user creates a new page. It is shown below the "Empty page" default template. Selecting one of these page templates will create the new page that is prefilled with the content of the page in Template namespace that choosen page template is related to.

Tips for working with page templates[edit | edit source]

  • PageTemplates are particularly good for designing structures for minutes and logs, but they are also excellent for typical business or product data for marketing, sales and product management.

See also[edit | edit source]

Reference page for this extension. that is transcluded from the actual template page.


Related info

  • Reference:BlueSpicePageTemplates



Attachments

Discussions