====== TemplatePageName Plugin ======

---- plugin ----
description: Renames the template pages _template.txt and __template.txt (only editable as server admin) to the configurable names c_template and i_template which are normal wikipages
author     : Gerrit Uitslag (Original author: Martin Hamant)
email      : klapinklapin@gmail.com
type       : action
lastupdate : 2024-02-08
compatible : Hogfather, Igor, Jack Jackrum, Kaos
depends    : 
conflicts  : 
similar    : 
tags       : template page

downloadurl: https://github.com/Klap-in/dokuwiki-plugin-templatepagename/archive/master.zip
bugtracker : https://github.com/Klap-in/dokuwiki-plugin-templatepagename/issues
sourcerepo : https://github.com/Klap-in/dokuwiki-plugin-templatepagename/
donationurl: 
----

===== Usage =====

This plugin improves the usage of [[:namespace templates]] (Scaffolding) by changing the name of these templates.

The users of your wiki can add the wiki pages ''c_template'' and ''i_template'' in a namespace via the normal editor. DokuWiki will use these pages as template for new created pages. 

DokuWiki uses by default the template page names ''_template'' and ''%%__%%template'', this plugin changes this to:
  * ''c_template'' (template for new page in the current namespace) 
  * and ''i_template'' (template inherited from higher namespaces as well)

Via the [[plugin:config|Configuration Manager]] you can modify the page names ''c_template'' and ''i_template'' to your own preferences.

=== Example ===

Wiki users can create ''ns:c_template'' in the wiki, which will be recognized now as namespace template. When you create ''ns:page'' next, the content of the page ''c_template'' is prefilled in the edit window of ''page''.

==== Which pagenames are allowed? ====

You may use any name you like, but it depends on the pagename whether a page is editable via the wiki interface. (See next question for details)

==== When are namespace templates editable? ====

By configuring a wikipage with a name following the [[:pagename|page name convention]] as template via this plugin, the users (with of course enough ACL rights) can update these wikipages via the wiki interface like any other wiki page. So you only use the characters ''a-z0-9'' and (but not as first or last character of pagename:) ''-_.''.

Without this plugin, DokuWiki looks for the namespace templates ''_template.txt'' or ''%%__%%template.txt''. These pages don't follow the pagename conventions as they start by ''_''. Therefore they aren't editable via the wiki interface. You have to modify or add them via the filesystem as server administrator.

==== Can this plugin be combined with Templatebyname plugin? ====

Yes. When [[plugin:TemplatebyName]] plugin has a matching page it can already load a template before this plugin is checked. It depends a bit on loading order (which is not sure) of these plugins which one is checked first.

===== Installation =====

Search and install ​the plugin using the [[plugin:extension|Extension ​Manager]]. Refer to [[:plugins|Plugins]] on how to install plugins manually.

===== Configuration and Settings =====

See Configuration Manager, here you can modify the templatenames yourself.

===== Development =====

Original author: [[martin@sound4.biz|Martin Hamant]]

August 2013 adopted by [[user>Klap-in]]

=== Last commits ===

{{rss>https://github.com/Klap-in/dokuwiki-plugin-templatepagename/commits/master.atom date}}

=== Known Bugs and Issues ===

See for the issues or report them at the [[https://github.com/Klap-in/dokuwiki-plugin-templatepagename/issues|issue tracker]].