Difference between revisions of "Manual:Extension/BlueSpicePageTemplates"

[quality revision][quality revision]
m
m


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

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]

  • Just for new pages
  • Can be limited to certain namespaces
  • Can force Namespaces
  • Based on templates in the "Template" namespaces
  • Integrates with "PageForms"

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 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[edit | edit source]

Editing a template in the Page template manager

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

  • Name - the name of the template
  • Description - a short description of the template
  • Namespace - list of the namespace where the template is active
  • Template - page from the Template namespace from which to pull the data

PageTemplates2.png

Using page templates[edit | edit source]

Available page templates when creating 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 that is transcluded from the actual template page. :
Screenshot: selecting a page template

Related info

{{DISPLAYTITLE:Page template}}
        

        ==What is a page template?==
        

        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==
        

        *Just for new pages
        
        *Can be limited to certain namespaces
        
        *Can force Namespaces
        
        *Based on templates in the "Template" namespaces
        
        *Integrates with "PageForms"
        

        ==Creating a page template==
        [[File:PageTemplates1a.png|thumb|Page template manager]]Wiki admins can create new page templates, as well as edit and remove existing ones in the Page templates manager, located under "Global actions".:[[File:PageTemplates1a.png|Page template manager|link=https://en.wiki.bluespice.com/wiki/File:PageTemplates1a.png|center|650x650px]]{{Box Note|boxtype=note|Note text=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===
        
            
            [[File:PageTemplates2.png|thumb|Editing a template in the Page template manager]]When creating or editing a page template, the following information needs to be provided:
        

        *'''Name''' - the name of the template
        
        *'''Description''' - a short description of the template
        
        *'''Namespace''' - list of the namespace where the template is active
        
        *'''Template''' - page from the Template namespace from which to pull the data
        

            
            ==Using page templates==
            
            [[File:PageTemplates3a.png|thumb|Available page templates when creating a new page]][[File:PageTemplates2.png|link=https://en.wiki.bluespice.com/wiki/File:PageTemplates2.png|650x650px]]
            

            == Using page templates ==
            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 that is transcluded from the actual template page.
            
:[[File:PageTemplates3a.png|Available page templates when creating a new page|link=https://en.wiki.bluespice.com/wiki/File:PageTemplates3a.png|alt=Screenshot: selecting a page template|center|650x650px]]{{Box_Links-en
        
        |Topic1= [[Reference:BlueSpicePageTemplates]]
        
        }}
        

        [[en:{{PAGENAME}}]]
        
        [[de:Handbuch:Erweiterung/BlueSpicePageTemplates]]
        

        [[Category:Content]]
        
        [[Category:Organization]]
Line 14: Line 14:
  
 
==Creating a page template==
 
==Creating a page template==
[[File:PageTemplates1a.png|thumb|Page template manager]]Wiki admins can create new page templates, as well as edit and remove existing ones in the Page templates manager, located under "Global actions".{{Box Note|boxtype=note|Note text=Every page template depends on an actual page in the namespace Template. This template must exist before creating a page template.}}
+
Wiki admins can create new page templates, as well as edit and remove existing ones in the Page templates manager, located under "Global actions":[[File:PageTemplates1a.png|Page template manager|link=https://en.wiki.bluespice.com/wiki/File:PageTemplates1a.png|center|650x650px]]{{Box Note|boxtype=note|Note text=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.
 
A new page template can be created by clicking the "Plus" button above the template list.
  
 
===Template fields===
 
===Template fields===
 
+
When creating or editing a page template, the following information needs to be provided:
[[File:PageTemplates2.png|thumb|Editing a template in the Page template manager]]When creating or editing a page template, the following information needs to be provided:
 
  
 
*'''Name''' - the name of the template
 
*'''Name''' - the name of the template
Line 26: Line 25:
 
*'''Template''' - page from the Template namespace from which to pull the data
 
*'''Template''' - page from the Template namespace from which to pull the data
  
 +
[[File:PageTemplates2.png|link=https://en.wiki.bluespice.com/wiki/File:PageTemplates2.png|650x650px]]
  
==Using page templates==
+
== Using page templates ==
[[File:PageTemplates3a.png|thumb|Available page templates when creating 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 that is transcluded from the actual template 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 that is transcluded from the actual template page:[[File:PageTemplates3a.png|Available page templates when creating a new page|link=https://en.wiki.bluespice.com/wiki/File:PageTemplates3a.png|alt=Screenshot: selecting a page template|center|650x650px]]{{Box_Links-en
 
 
 
 
{{Box_Links-en
 
 
|Topic1= [[Reference:BlueSpicePageTemplates]]
 
|Topic1= [[Reference:BlueSpicePageTemplates]]
 
}}
 
}}

Attachments

Discussions