====== Sidebar Template ======

---- template ----
description   : Provide DokuWiki with a flexible sidebar
author        : ChrisS
email         : chris@jalakai.co.uk
lastupdate    : 2009-01-27
compatible    : 2009-02-14
depends       : 
conflicts     : 
similar       : 
screenshot_img: http://dokuwiki.jalakai.co.uk/dokuwiki-sidebartemplate-2x2.jpg
tags          : sidebar

downloadurl   : http://dokuwiki.jalakai.co.uk/template-sidebar.zip
bugtracker    : # eg. https://github.com/example/dokuwiki-template-sample/issues
sourcerepo    : # eg. https://github.com/example/dokuwiki-template-sample/
donationurl   : # eg. https://www.paypal.com/...
---- 



Provide DokuWiki with a flexible sidebar.

===== Download and Install ======

Use the following URL to download this template:

  * [[http://dokuwiki.jalakai.co.uk/index.html#templates]]

Refer to [[:template]] on how to install and use templates in DokuWiki.
===== Sites using this Template =====

  * [[http://wiki.jalakai.co.uk/dokuwiki|sidebar demonstration site]] (includes additional resources)  
===== Security Fix =====

Sidebar shows navigation even I do not have access to the resources (like all resources are readable for signed on users only). \\
I cooked such trivial [[ http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/packages/dokuwiki-tpl-sidebar/acl-check.patch| fix ]] and notified ''Chris--S'' on IRC.

--- //[[glen@pld-linux.org|Elan Ruusamäe]] 2010-03-23 10:58 EET//

===== Bug found =====
Using citation ((remark)) I recognized, that obviously the same
stylesheet (of the main page) is used for showing the citation-text
while MouseOver. This results in partly invisibility of the
citation/popup, because the first column is blank (sidebar) and the border/size of
the main window is ignored. While the citations at the end of the line is not visible,
you see nothing of the text. //DokuWiki 2009-02-14 & latest plugin sidebar //

===== Feature Request =====
Is it possible to install a config-switch (checkOnOff) to open the namespace
start-page by clicking on the sidebar-navigation entry of the namespace.
Instead of listing "start" in the sidebar. The name of the
"start"-page is a config-data of DokuWiki, where the name can be achieved, 
if it is changed by the admin. Like plugin indexmenu.

===== Bug found =====
In DokuWiki v2008-05-05 In the template that I use the side bar includes index of the whole wiki. When expanding the index the side bar does not resize, so many of the name spaces and pages in the index are cropped and are half shown or not shown at all. One fix would be for the user to be able to dynamically resize the side bar frame. Another solution would be for the side bar to automatically resize itself so that all its text is shown correctly.

===== Bug found =====

**FIXED** In DokuWiki v2008-05-05 I had to change lib/tpl/sidebar/main.php from

      <div class="bar-right" id="bar__bottomright">
        <?php tpl_button('subscribe')?>
        <?php tpl_button('subscribens')?>
        <?php tpl_button('admin')?>
        <?php tpl_button('profile')?>
        <?php tpl_button('login')?>
        <?php tpl_button('index')?>
        <?php tpl_button('top')?>&nbsp;
      </div>


to
      <div class="bar-right" id="bar__bottomright">
        <?php tpl_button('subscription')?>
        <?php tpl_button('admin')?>
        <?php tpl_button('profile')?>
        <?php tpl_button('login')?>
        <?php tpl_button('index')?>
        <?php tpl_button('top')?>&nbsp;
      </div>

to get the "subscription" buttons OK.

> Acknowledged. I'll mark the current release as develonly and release one with the single button put back ASAP. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2009/01/21 09:36//
>> Fixed.  Download packages and darcs versions updated. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2009/01/25 03:41//

===== Bug Found =====

**FIXED** I've been trying to use the sidebar template. I like it except for one bug I've found. The menu never expands to the current location.

Example: If I'm at main:second:third:topic the menu will look like this:
<code>
\/ main
  \/ second
     + third
</code>

Third should be expanded so anything relevant can be accessed in a single click.
<code>
\/ main
  \/ second
     \/ third
         topic
         topic2
         topic3
</code>

Fix
<code>
92c92
< #    $ID = getNS($ID);
---
>     $ID = getNS($ID);
</code>

> Fixed. Download packages and darcs versions updated.  --- //[[chris@jalakai.co.uk|Christopher Smith]] 2009/01/25 03:41//


===== Plugin Version =====

Since this template only adds a few lines to the original DokuWiki template, I implemented this as an Action plugin. See [[:plugin:sidebar]]. Hope you don't mind.  --- //[[mbirth@webwriters.de|Markus Birth]] 2009/02/10 01:58//

===== Discussion =====
Minor point but would it be possible to have a better screenshot?

How do I make font size bigger on Sidebar templates?

===== Broken Link =====
The download link for this template is broken (as is the link to the demonstration site).  Does anybody have a copy or the latest version of this template they could provide?  It would be much appreciated.  Thanks!  --- //[[bbuchanan@ailancorp.com|Brad Buchanan]] 2010/03/26//
> (long since) fixed.  --- [[user>ChrisS|ChrisS]] //2013/12/18 17:00//

> I found that the link to the demonstration site was broken today [[tony.james@etas.com|Tony James]] //2015/04/01 13:52//