Learn about DokuWiki
Learn about DokuWiki
This is an old revision of the document!
Compatible with DokuWiki
Requirements: This plugin requires jQuery and was originally designed for use with the DokuWiki Template. In its current form, it should work with any template.
This plugin converts DokuWiki headers into toggles which open and close the sections immediately below them.
The plugin will work out of the box with any template without any need for configuration. However, configuring the plugin as described in the section on Configuring for Mobile Devices may be useful for efficiency.1) A group of the most suitable templates for phones come pre-configured in the file templates.ini. You can also configure using the Configuration Manager.
When installed, the sections will initially be closed. Clicking on a header will open the section immediately below the header. Clicking on it again will close the section. Using the two buttons described below, the user can open and close all the sections with a single click.
Headers without any text content below them will not be active and will not show the right arrow icon. They will simply be standard headers and not toggles. In addition, in the Configuration Manager, you can choose to prevent selected headers from being toggled, as in the sample page below. There the End of Page Ø header is an
h5 which is excluded, using the Configuration Manager, from being toggled.
Inserting the following into the page will create two buttons, one which will open all the sections with one click and one which will close them:
These buttons will be hidden if toggling is disabled, as described below under Configuration.
This feature enables you to create a container
div for the page, in which case it is not necessary to set the name option for identifying the div which holds the wiki content. However, you must set the type option either to
id or to
You place the
openDIV at the top of your wiki page and the
closeDIV at the bottom. This will create a div with a
section__toggle id. The entire wiki page will then be enclosed within this div. In all but the simplest of pages, these macros must be at the very top and the very bottom of your page.
|platform||all, mobile, none||all||Selects the platform(s) on which to implement section toggling.|
|type||none,id,class||none||Indicates whether the div which encloses the affected headers is identified by a class or an id.|
|name||Name of the class or id which identifies the enclosing div.|
|headers||h1-h6||h4||Smallest header to activate as toggle. All headers between h1 and this setting will be toggles.|
|suspend||1,0||0||If set to true the plugin will be inactivated and no toggles will be set.|
|xcl_headers||Checkboxes to select headers which should not be set as toggles|
|mobile_alt||An alternate template installed for phones, in case your preferred template does not support phones.|
|tablet_alt||1,0||0||Use the alternate template for tablets|
|tablet_toggle||1,0||0||Use toggles on tablets as well as phones|
all: section toggling will appear on all platforms, mobile and standard desktop systems
mobile: mobile only, desktops are excluded
none: toggling is disabled on all platforms.
typeis either an id or a class and the
namethe id or class attribute of the divs which govern the headers. If you are using the DokuWiki template or one of the templates listed in templates.ini, the plugin automatically detects the template and will use the appropriate settings. In the case of the
typemust be set to
noneor the file will be ignored.
platformis set to
mobile, this option enables you to switch to an alternate template that supports phones, in the event that your preferred template does not. If your preferred template does support phones, then set this option to blank. A check is made to insure that that alternate template is correctly installed, and if not the main template is used.
mobile_alttemplate will be used for tablets.
When the toggle buttons are included on a page, they will not display if the platform is excluded from section toggling. So, if you want toggling only on mobile devices, you can still include these buttons on your page but they will not display on standard desktop systems.
When the DokuWiki template is in use, this plugin uses the template's platform recognition facility. For other templates, it uses the
Mobile_Detect class from http://mobiledetect.net. You can go to that site to update the detection software. Currently, we are at version 18.104.22.168)
The example below is for manual configuration, using the plugin's options. Most templates from Weatherwax on which are usable with phones are pre-configured in templates.ini. That is, like the current
dokuwiki template, they have been designed to accommodate the smaller sizes of phones. What works with a phone will work with a tablet. But there are quite a few templates which will not work with phones that do work on tablets.
default template, which was the template that preceded the
dokuwiki template, contains the following structure:
The wiki page is included in the div which is defined by the class named
page. To use this template, then, you would set type to
class and name to
If you are using the dokuwiki template, the default settings for type and name will take precedence over these configuration settings, as they are hard-coded into the plugin. If you want to use the dokuwiki template with changes to its structure, then you must give it a different template name.
The plugin comes with a group of preconfigured templates. If your template is one of these, then it will work right out of the box and your plugin will read the
name configuration values from an ini file named templates.ini, which is found in the root directory of the plugin. For this to work, the
type option must be set to
none in the sectiontoggle section of the Configuration Manager. This is only an issue if you have already used the Configuration Manager to set up the plugin for another template, since the plugin comes with
type already set to
These templates have been chosen for usability and popularity, covering a period of six years to seven years–Greebo through Weatherwax compatibles. Some popular templates like monobook are not suitable for phones and so have been omitted from this list. And some nice templates do not work as alternates, i.e. as
mobile_alt, because they haven't been kept up-to-date. No doubt there are good early templates that can still be used. So, this list may grow, as more templates are tested. If you would like to have an entry added to the the ini file, open an issue on github. In the meantime you can add your choice to plugins/sectiontoggle/templates.ini.local3), since additions to templates.ini may be overwritten on upgrades. The format for an entry in templates.ini.local is:
[[template name]] type = id or class name = id or class name
Or, you can configure your template manually, as shown in the example.