Writr

This template was converted from the WordPress theme Writr. It was voted for by DokuWiki users from a selection of 19 other WordPress themes to convert.

Description Bold, minimalist and modern
Author Louis Ouellet, Anika Henke
Email louis@laswitchtech.com
Last Update 2024-01-02
Compatible Jack Jackrum
Download Download
Bug Tracker Issues
Source Source
Donation Donation

Download and Install

Search and install the template using the Extension Manager. Refer to Template on how to install a template manually.

Features

  • Improve the general aesthetic for a more modern look and consistency
  • Personalize using template's configurations and template's style configrations
  • Support for Bootstrap Icons
  • Support for many DokuWiki Plugins (See list below)
  • A new toolbar is now available in the template configuration. Based on the original WordPress Theme Writr.
    • A new hook topbar is available to add content to the toolbar. Using the same formatting as topnav.
  • A new set of tooltips is now available in the template configuration.
    • If toggled, the template will replace the browser's tooltips for these new ones
  • Hide/Show Site-Tools based on user login. (CMS mode)
  • Set Logo per namespace
    • If toggled, the template will look for the nearest logo.png file it can find.
  • Set Logo's link per namespace
    • If toggled, the template will use the logo's namespace as the link
  • Set Site Title per namespace
    • If toggled, the template will use the nstitle hook to retrieve the title of the site. If none can be found then the dokuwiki title is used.
  • Set Site Tagline per namespace
    • If toggled, the template will use the nstagline hook to retrieve the tagline of the site. If none can be found then the dokuwiki tagline is used.

Screenshots

Sites using this template

Documentations

Plugins

Plugin Tested Themed Comments
Access Counter and Popularity Plugin Not yet fully supported. Seems like there is a lot to do on this plugin
ACL Manager
Add New Page Styled and added into the page tools
Advanced DokuWiki
Plain Auth
Avatar
Blockquote
Blog
Bloglinks Read below for more details and customizations of the links
Bureaucracy
Captcha
Cloud
Comment Syntax support
Configuration Manager
Structured Data
denyactions
Diagrams
Discussion Styled using the WordPress Theme Writr as reference
DW2pdf Set a more proper icon within the page tool
Extension Manager
folded
fontawesome
Gallery
GH
Hidepages
Icons
Include Read below for more details and customizations of the links
Info
Indexmenu Styled for the topnav page
Keyboard
Linkback
LogViewer
Move Some maintenance is required by the plugin author to fully support PHP8. You may see some PHP Warning if your server is configured to show them.
nspage
Pagelist
Prosemirror
Revert Manager
safefnrecode
Search Form
Socialite
sqlite
styling
svgEmbed
Tag
tagsections
Translation Styled and added into the page tools
Typography
Upgrade
User History Manager
User Manager
userpagecreate
Video Sharing Site
Wrap
yourip

Page Tools

Button Function
| AddNewPage Plugin
Built-in Backlinks
Built-in Back to Top
DW2PDF Plugin
Built-in Edit
Built-in Revisions
Built-in Subscriptions
Translation Plugin

Configuration

  • Show the title of the page tools
  • Show the title of the site tools
  • Show the title of the user tools
  • Should the site tools require login
  • Should the logo changes be by namespace

Plugins

For best results, update your configurations with the following:

  • plugin»bloglinks»prev_template = <span class="icon"></span><span class="title">@@TITLE@@</span>
  • plugin»bloglinks»next_template = <span class="title">@@TITLE@@</span><span class="icon"></span>

Additionally, you may add the class truncate to the <span class=“title truncate”> to truncate the page title. This will truncate the title to a single line that fits within the prev and next buttons.

Include

For best results, add the following configuration files: [WEBROOT]/conf/plugin_lang/include/en/lang.php

<?php
/**
 *
 * English language file
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 *
 */
$lang['readmore']              = 'Read more';

[WEBROOT]/conf/plugin_lang/include/fr/lang.php

<?php
/**
 *
 * French language file
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 *
 */
$lang['readmore']              = 'Lire la suite';

Customization

You can change the logo, favicon and apple touch icon the same way as for the dokuwiki template.

Namespace Logos can be added using the media library. To show a different logo in a namespace, just make sure to add the custom logo.png in the namespace. This feature is recursive.

This templates supports multiple levels of a navigation. For that to work you need to add a page called topnav and add a list of links to it. (No other content is supported.) The example in the screenshot uses this as the content for the topnav page:

  * [[:start|Home]]
  * [[wiki:DokuWiki]]
    * [[wiki:Syntax]]
  * [[:Sample Page]]

~~NOCACHE~~

Other sidebar content

The content of a standard sidebar as configured in Configuration Setting: sidebar will be added between the navigation and the tools list.

Note

I haven't tested a sidebar yet since the last various updates I made. I will check it out soon.

Include hooks

Include hooks allow you to add additional HTML or PHP to the template without modifying any of the template files themselves. This template supports the same include hooks as the dokuwiki template.

Colour Schemes

The original WordPress theme came with 6 different colour schemes. Those can easily be achieved by changing the __theme_color__ and __theme_color_alt__ values in your local style.ini to the following:

Colour scheme theme_color theme_color_alt
turquois #1abc9c #16a085
red #e74c3c #c0392b
purple #a162ba #8e44ad
grey #95a5a6 #7f8c8d
green #2ecc71 #27ae60
blue #3498db #2980b9

This should actually be done in the styling plugin over the admin interface. No need to go out of your way to edit style.ini.

Note

I will be moving this to themes and setup a custom theme so users can set these colors and other css properties not currently supported by the styling plugin.

Content width

The width of the content area can be adjusted with the __content_width__ variable in the style.ini. Since DokuWiki version 2015-08-10 “Detritus” you can do that more easily with the styling plugin over the admin interface.

This is currently limited to px size. Will try to add a full-width option for the template.

Development

Changelog

Planning

  • Add more fonts (suggestions?)
  • Add option to make the content full width
  • Add support for Starred Plugin
  • Work on the Media Library CSS to make it more consistent
  • Add toggle-able sidebar
  • Review existing issues
  • Investigate an issue with the Struct Plugin
  • Revise mobile styling
  • Revise responsive styling

Tags

Comment

Enter your comment:
B B K R E