Revision as of 14:34, 2 December 2022

Extension: BlueSpicePageTemplates

Overview
Description:	Displays a list of templates marked as page templates
State:	stable	Dependency:	BlueSpice
Developer:	HalloWelt	License:	GPL-3.0-only
Type:	BlueSpice	Category:	Content Structuring
Edition:	BlueSpice free, BlueSpice pro, BlueSpice Farm"BlueSpice Farm" is not in the list (BlueSpice free, BlueSpice free (deactivated), BlueSpice pro, BlueSpice pro (deactivated), BlueSpice farm, BlueSpice farm (deactivated), BlueSpice cloud, BlueSpice cloud (deactivated)) of allowed values for the "BSExtensionInfoEdition" property., BlueSpice Cloud"BlueSpice Cloud" is not in the list (BlueSpice free, BlueSpice free (deactivated), BlueSpice pro, BlueSpice pro (deactivated), BlueSpice farm, BlueSpice farm (deactivated), BlueSpice cloud, BlueSpice cloud (deactivated)) of allowed values for the "BSExtensionInfoEdition" property.	Version:	4.1+
View user help page

Features

BlueSpicePageTemplates allows users to create new pages from predefined templates to start with a basic page structure.

Create a template (with headers, categories, boxes and other content) in the template namespace.
Create a page template using the special page Special_PageTemplatesAdmin give the page template a name and a description.
Each template should be assigned a template from the "Template" namespace that represents the structure of a document.
Page templates can be assigned to a particular namespace, so that a certain template will only appear when creating pages in that namespace.
The page template is shown as a choice when a new page is created.

Some aspects of this extension can be configured on the page Special:BlueSpiceConfigManager, under "Page templates". Here, wiki administrators can:

Force a target namespace for the page that was created from the template
Hide default templates

Default page templates

Since BlueSpice 4.2, several default page templates are provided through the page template manager. The templates themselves are located in the "Template" namespace and prefixed with the letters "PT" (example:Template:PT How-to article).

It is advisable not to change the content of these default templates, since they could be overwritten during updates of BlueSpice. Users should create a renamed copy of any default template and edit it based on their needs.

For more information on how to add or remove available page templates, see the help page.

Updates to the default templates:

The ContentProvisioner will import the default page templates during an update/upgrade again if there are changes in any of the manifests that define these templates.

Updates of the templates can be forced with the following command from the wiki root

php maintenance/update.php --quick --force

Technical Information

This information applies to BlueSpice 4. Technical details for BlueSpice cloud can differ in some cases.

Requirements

MediaWiki: 1.39.0

BlueSpiceFoundation: 4.3

Integrates into

MWStakeContentProvisioner

Special pages

PageTemplatesAdmin

Permissions

Name	Description	Role
pagetemplatesadmin-viewspecialpage	Access to the Special:PageTemplatesAdmin special page, where page templates can be managed	admin, maintenanceadmin, structuremanager

Configuration

Name	Value
PageTemplatesExcludeNs	array ( 0 => -2, 1 => -1, 2 => 6, 3 => 7, 4 => 8, 5 => 9, 6 => 10, 7 => 11, 8 => 14, 9 => 15, )
PageTemplatesForceNamespace	false
PageTemplatesHideDefaults	false
PageTemplatesHideIfNotInTargetNs	true

API Modules

bs-pagetemplate-tags-store
bs-pagetemplates-store
bs-pagetemplates-tasks

Hooks

Accessibility

Test status:	2-testing complete
Checked for:	Web, Authoring tool
Last test date:	2022-08-05
WCAG level:	AA
WCAG support:	partially supports (workaround: no)
Comments:	keyboard access works. Screenreader: Extjs: Pagination in grids not announcing button labels at top and pagination buttons at bottom; actions menu has no keyboard support. switching between browse/focus modes enables finding out how many pages there are and moving to the next page. erm:27716
Extension type:	core
Extension focus:	admin

@@ Line 21: / Line 21: @@
 *Force a target namespace for the page that was created from the template
 *Hide default templates
 ===Default page templates===
-Since BlueSpice 4.2, several default page templates are provided through the page template manager. The templates themselves are located in the "Template" namespace and prefixed with the letters "PT" (example:Template:PT How-to article). It is advisable not to change the content of default templates, since they could be updated automatically during updates of BlueSpice. You can create a renamed copy of the template and edit it based on your needs. For more information on how to add or remove available page templates, [[Manual:Extension/BlueSpicePageTemplates|see the help page]].
-Updates to the default templates:
+Since BlueSpice 4.2, several default page templates are provided through the page template manager. The templates themselves are located in the "Template" namespace and prefixed with the letters "PT" (example:Template:PT How-to article).
-The ContentProvisioner will import the default page templates during an update/upgrade again if there are changes in any of the manifests. These are files which contain information about the default page templates.
+It is advisable not to change the content of these default templates, since they could be overwritten during updates of BlueSpice. Users should create a renamed copy of any default template and edit it based on their needs.
+For more information on how to add or remove available page templates, [[Manual:Extension/BlueSpicePageTemplates|see the help page]].
+'''Updates to the default templates:'''
+The ContentProvisioner will import the default page templates during an update/upgrade again if there are changes in any of the manifests that define these templates.
 Updates of the templates can be forced with the following command from the wiki root
 <syntaxhighlight>php maintenance/update.php --quick --force</syntaxhighlight>
-After that templates should show up again
 }}

Reference:BlueSpicePageTemplates: Difference between revisions