Download

Note for existing users: Since 2014-02-09, there is no separate update .tar.gz anymore. The current archive is used for both install and update now. Instead of providing a separate update archive without the /user sub-directory, all example files in /user are delivered with the .dist extensions now to make sure your files won't get overwritten. This should be easier an more DokuWiki-like than the previous approach.

Important release notes for 2014-02-09

Fixed a major bug, the configuration option were un-savable on DokuWiki 2013-12-08 “Binky” (cf. Issue 22).

Update

Simply uncompress and copy it over your current /lib/tpl/vector. This works without problems when you follow the rules described in the README (⇒ the place for *all* user-defined, custom stuff is /lib/tpl/vector/user!) because previously existing files in /lib/tpl/vector/user will not be touched or overwritten.3)

Recommended: Also update the plugins Translation, Open Office Export, dw2pdf and html2pdf if you are using one ore more of them. This is especially important regarding Translation (some older versions may cause problems and/or results are looking badly).

FAQ

What are these "Please fill or disable this placeholder ([pagename])" everywhere?

The template optionally imports normal wiki pages and shows their content as

navigation

toolbox

global, sitewide notice

copyright note (off by default, default is the common copyright note by DokuWiki)

This means you can create the page mentioned in the “Please fill or disable this placeholder” message (e.g. “:wiki:navigation”) and its content will be shown instead of the message. All of these placeholders are configurable. Have a look at the DokuWiki admin section:

Show site wide notice?

If yes, use following wiki page for the site wide notice:
[…]

Show navigation?

If yes, use following wiki page as navigation:
[…]

Show copyright notice?

If yes, use default copyright notice?

If not default, use following wiki page as copyright notice:
[…]

Show toolbox?

If yes, use default toolbox?

If not default, use following wiki page as toolbox location:

How can I check which version is currently installed?

Simply have a look at /lib/tpl/vector/VERSION. This is a textfile containing the version you are using (e.g. 2010-06-12).

How can I create a custom toolbox or exportbox? How can I change the built-in boxes order?

First of all, remember: make changes to /vector/user/boxes.php ONLY. Do NOT edit /vector/conf/boxes.php to prevent trouble on updates.4)

If you are not happy

with the default toolbox (or exportbox) and importing a normal wiki page is not flexible enough

and/or the order the built-in boxes are rendered

simply

disable them via config

copy the PHP code of the original boxes from /vector/conf/boxes.php into /vector/user/boxes.php and do all your customization there.

To do so, go to the DokuWiki admin section and have a look at the following options to disable the boxes you do not like:

Show navigation?
[…]

Show 'print/export' box?
[…]

Show toolbox?

Now copy the code of the box you want to customize from /vector/conf/boxes.php into /vector/user/boxes.php and start editing them as you like. Useful coding hints:

You may want to remove the checks which disable some boxes. Especially watch out for:

if (tpl_getConf(“vector_exportbox”)){

if (tpl_getConf(“vector_toolbox”)){.

The DokuWiki function getID() returns the uncleaned ID of the current wiki page, including namespace.

The DokuWiki function getNS() returns the namespace-part of an absolute wiki page ID. To get the cleaned namespace of the current wiki page, you may use:

How can I hide the edit tab and boxes until users are logged in?

Is the template compatible to the Discussion plugin?

Short answer: yes.

The template brings support for basic discussion pages without the need to install any additional plugin. However, if you are interested to use the Discussion plugin (which allows threaded replies, avatars, captcha and other controls at the bottom of the wikipage instead of a separated basic discussionpage), simply install it and deactivate the template option “Use discussion tabs/sites?” at the DokuWiki admin section.

The insitu JS footnotes are displayed at the wrong position. Why don't you fix this?

Even if the footnotes may work as expected in some other templates, the wrong insitu footnote popup position is not a template but a DokuWiki 2010-11-07 “Anteater” issue (see Bug 2114). All templates with relative positioning are affected. This bug is fixed since DokuWiki 2011-04-22 “Rincewind RC1”. If you update your DokuWiki installation, the problem should be gone.

Browser compatibility

The template should be compatible with all modern browsers:

Firefox ≥ 3

Opera ≥ 10

Safari ≥ 4, Chrome ≥ 1 and other newer Webkit based browsers.

MS Internet Explorer ≥ 7

Please note:

MS Internet Explorer 6 is also supported in general, there are only some cosmetic issues at the admin menu. These issues do not affect normal wiki pages. The new Media Manager (introduced with DokuWiki 2011-11-10 “Angua RC1”) does not work with IE6.

I can't test every browser (version) out there. Therefore it does not mean the template does not work if your browser is not listed above. Just try it out if you want to be sure.

The place for all user-defined, custom stuff is “vector/user”. Reason: this folder will not be touched on updates.

If you want to replace the default logo showed in the upper left, simply create a /vector/user/logo.[png|gif|jpg]. The template recognizes the file automatically and will use it instead of the default logo.

If you want to add own tabs, have a look at /vector/user/tabs.php (NOT/vector/conf/tabs.php).

If you want to add own buttons (footer), have a look at /vector/user/buttons.php (NOT/vector/conf/buttons.php).

If you want to add own boxes (left-column), have a look at /vector/user/boxes.php (NOT/vector/conf/boxes.php).

Footer buttons (default template style): on hover highlighting

I prefer the default template way that the footer buttons highlight when you put you mouse on them (or rather, how they are faded when you do not have your mouse on them), like they do at the bottom of this page, so I added this to /vector/user/screen.css:

Full support for DokuWiki 2012-10-13 “Adora Belle”; New option: vector_qrcodebox (controls if a box with a QR Code of current wiki page URL will be shown in the sidebar); Multilingual side-wide and copyright notices for Translation plugin users (cf. commit message); Added Slovak and Persion language, French language update.

This version introduces a multilingual navigation for Translation plugin users. Users of the existing translation box snippet should edit some source code in /vector/user/boxes.php: just replace the old with the new lines.
Added fix for wrong horizontal rule clearing (---- / <hr>-Tag); Catalan language update.

Full support for DokuWiki's new Media Manager; Multilingual navigation for Translation plugin users (NOTE: Users of the existing translation box snippet should edit some source code in /vector/user/boxes.php: just replace the old with the new lines); Apple Touch Icon support (see README for details); added Russian, Spanish and Catalan language.

New config options (user pages optional, closed wiki - most tabs/boxes will be hidden until user is logged in if active); added Italian, Brazilian Portuguese and Dutch language; support for PNG favicon.