Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Important
If your DokuWiki is older than Angua or if the templates you are using it with are not up-to-date¹⁾, you have to make the following small change to DokuWiki's source code. Otherwise you might get partially (or completely) blank pages.

Remove (or comment) the following lines in <dokuwiki>/inc/init.php:

// DEPRECATED, use tpl_basedir() instead
if(!defined('DOKU_TPL')) define('DOKU_TPL',
        DOKU_BASE.'lib/tpl/'.$conf['template'].'/');
 
// DEPRECATED, use tpl_incdir() instead
if(!defined('DOKU_TPLINC')) define('DOKU_TPLINC',
        DOKU_INC.'lib/tpl/'.$conf['template'].'/');

Fixing templates is easy. Just replace every DOKU_TPLINC with tpl_incdir() and every DOKU_TPL with tpl_basedir() (see their deprecation).

This plugin can be used in two ways:

• Admins can specify different templates for different wiki pages or namespaces.
• Or users can use a select box for the whole wiki.

Although you can use both ways together, it is advisable to only use one method or the other. Because otherwise you need to decide²⁾ which choice is the preferred one.

The plugin comes with an admin component you'll find in the admin menu. Use it to specify the templates to be used for different wiki pages or namespaces. Pages not covered by one of these rules will still use the template specified by the template variable in the admin interface.

Alternatively the plugin can let the user choose the template for the whole wiki through a template switcher. Your users will need to allow cookies for that (otherwise the template won't switch permanently).

The template switcher is automatically put before the wiki content. If you like to put it somewhere else (e.g. near the login button or into the sidebar), you need to switch automaticOutput and put the following code into your template to wherever you like to display it:

<?php
    $loadskinHelper = plugin_load('action', 'loadskin')->loadHelper('loadskin', true);
    echo $loadskinHelper->showTemplateSwitcher();
?>

The styling which come with the plugin will suit most templates when it's automatically put before the wiki content. But some templates might need a little help with user styles.

This plugin doesn't set any new cookies, but uses the DOKU_PREFS cookie which the DokuWiki core already uses. If a user uses the template switcher, it sets loadskinTpl to the chosen template. It also sets loadskinOrig to the original template which would show if nothing had been chosen.

A complete changelog is available here.

• Merge pull request #31 from dokuwiki-translate/lang_update_649_151284… (2018-04-16 22:45)
• translation update (2017-12-09 20:50)
• update copyright year (2017-01-15 22:42)
• version 2017-01-15 (2017-01-15 22:31)
• Fix Security Token issue breaking admin form (closes #28) (2017-01-15 22:24)
• Merge pull request #29 from dokuwiki-translate/lang_update_173 (2017-01-15 21:35)
• translation update (2016-11-02 10:50)
• Merge pull request #27 from dokuwiki-translate/lang_update_92 (2016-09-26 01:05)

You can report any issues on the issue tracker and discuss anything on the separate discussion page.