Manual:Extension/BlueSpicePageTemplates

A page template applies a predefined content structure and layout to new pages. That way, certain page types can be applied during page creation to produce consistent sets of related pages.

When to use page templates

Page templates are useful for frequently used content formats such as meeting minutes, 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 of a page template

• can be created by administrators
• can only be used for new pages
• based on templates in the Template namespaces
• can be limited to certain namespaces
• substitution of variables is possible
• can integrate with the extension Page Forms

Standard page templates

is available from BlueSpice 4.2.

Page templates that are installed by default can be deleted from the page template manager (1). link=https://de.wiki.bluespice.com/wiki/Datei:Handbuch:seitenvorlagen_l%C3%B6schen.png|alt=Seitenvorlagen löschen|center|thumb|750x750px|Delete (1) or edit the content of (2) page templates Alternatively, the templates can be adapted directly in the template namespace. To do this, click on the template link in the column Vemplate (2).

List of standard templates

Page template	Edition	Description
Decision Matrix	pro	Make an informed decision by comparing your options
Event	pro	Plan an event from beginning to end
Guideline	pro	Create a code of conduct or other guideline
How-to Article	free, pro	Step-by-step instructions for completing a task
Management Meeting Minutes	pro	Create minutes for a regular management meeting
Meeting Agenda	free	Create a generic meeting agenda with minutes
Request for Comments	pro	Ask for feedback about an important decision that needs to be made
Status Report	pro	Stakeholder über den derzeitigen Stand eines Projekts informieren
To-do List	free, pro	Track and update your to-dos

Creating a page template

Administrators can create new page templates, as well as edit and remove existing ones in the Page templates manager, located under Global actions.

Page template manager

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

When creating or editing a page template, the following information needs to be provided before the page template can be saved:

• Name - the name of the page template
• Description - a short description of the page template
• Namespace - a list of the namespace where the template is active. If the template should be available on all pages, select (all) from the list.
• Template - page in the Template namespace from which to pull the content.

Creating a page template

Using page templates

A list of available templates appears when a user creates a new page. It is usually shown below the "Empty page" default template. Selecting one of these page templates will create the new page that is pre-filled with the content from the actual template page.

There are two important settings:

• Assigning namespaces (in the page templates administration): Page templates can be linked to specific namespaces. If a namespace is not added here, the template will not be displayed in that namespace.
• Namespace manager: The PageTemplates option for a namespace must be activated in the Namespace manager so that the associated templates are automatically displayed when a new page is created in that namespace (e.g., if the "+" button is used to create the page).

Selecting a page template

A list of available templates to choose from is displayed below the default "Blank Page" template when a user creates a new page.

You can also customize the look-and-feel of this page.

Configuration

In the Config manager, you can change the following settings:

• Force target namespace: The page is always created in the target namespace that is associated with the template, even if the user provided a different namespace prefix. In the screenshot below, the user wants to create the page "NewPage" and then selects a template for the QM namespace. The page is, therefore, created as "QM:NewPage" if this setting is activated.
  

  force the namespace of the template

• Hide default templates: Hides the default Empty page template.
• Hide template if the page is not to be created in the target namespace: Depending on the namespace prefix of the page to be created, templates that are associated with other namespaces will not be shown to the user for selection.

Related info

• Reference:BlueSpicePageTemplates

Technical Reference: BlueSpicePageTemplates

---

To submit feedback about this documentation, visit our community forum.