Compatible with DokuWiki

Greebo, Detritus, "Ponder Stibbons", Hrun, "Elenor of Tsort", "Frusterick Manners"

• Download
• Report bugs
• Donate

High customizable Bootstrap based template for DokuWiki

Last updated on

2018-02-16

Repository

Source

Conflicts with

tablelayout

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Tagged with bootstrap, bootswatch, cms, cookielaw, hooks, html5, navbar, responsive, right-sidebar, semantic, sidebar, themes

Needed for twistienav4bootstrap3

By Giuseppe Di Terlizzi

• bootswrapper
• advanced
• icons
• semantic
• datatables
• webdav

Highly customizable Bootstrap based template for DokuWiki.

This template is responsive and is designed for all devices (mobile, tablet, desktop, etc).

To complete the visual/user experience use my Bootstrap Wrapper and Icons plugins.

• HTML5 and CSS3
• Responsive
• Bootstrap 3.x based template
• Glyphicons and FontAwesome icons
• AnchorJS support
• Typeahead support
• High customizable via the configuration manager
• Many html and DokuWiki hooks
• Sidebar support ( left and/or right )
• [Bootswatch](https://bootswatch.com) themes
• Theme switcher
• Cookie Law Banner Notice
• Google Analytics integration
• Avatar support for Gravatar, Libravatar and Office365

• All Bootswatch.com themes
• Glyphicons and FontAwesome icons
• Anchor.JS
• Typeahead

See the visual tour.

Read the release note of template:

• v2024-02-06
• v2022-07-27
• v2021-03-11
• v2020-08-28
• v2020-07-29

• Bootstrap Wrapper Plugin
• Diagram Plugin
• Discussion Plugin
• Edittable Plugin
• Explain Plugin
• Inlinetoc Plugin
• Linkback Plugin
• Move Plugin
• Overlay Plugin
• Publish Plugin
• Rack Plugin
• Tagging Plugin
• Tags Plugin
• Translation Plugin
• User Home-Page Plugin
• Wrap Plugin - Tabs

• Faster DokuWiki Plugin

This template is available in:

• Chinese
• Czech
• French
• German
• Hungarian
• Indonesian
• Italian
• Japanese
• Korean
• Norwegian
• Persian
• Polish
• Portuguese
• Portuguese (Brazil)
• Russian
• Slovak
• Spanish

Join on Transifex platform to translate this template in your favorite language.

Use the extension manager to install this template.

Refer to template on how to install and use templates in Dokuwiki.

The template can be widely configured via the Configuration Manager or manually edit the <dokuwiki>/conf/local.php file, including a line like:

$conf['tpl']['bootstrap3']['fluidContainerBtn'] = '1';

(This adds a button to turn on / off fluid layout. See the fluidContainerBtn option below.)

Adds Schema.org markup to enable basic support for semantic data. For full support use the semantic plugin.

NOTE For local DokuWiki avatar, upload the avatar image with the name of username on user namespace (:user:<dokuwiki-username>.png – also support .jpg file extension).

The Cookie Law Banner Notice add a cookie called cookieNoticeAccepted to use in your JavaScript/PHP code (eg. to add Google Analytics only when the user accept the policy).

JavaScript Snippet:

if (DokuCookie.getValue('cookieNoticeAccepted')) {
  // Your JS code (eg. in userscript.js or in 3th-party plugin)
}

PHP Snippet:

if ( ! (get_doku_pref('cookieNoticeAccepted', null)
     || get_doku_pref('cookieNoticeAccepted', '')) ) {
  // Your PHP code (eg. in 3th-party plugin)
}

To customize the theme, edit your conf/userstyle.css (or userall.css).

Bootstrap3 theme provides a special class and attribute in <body/> tag to identify the current theme and current page or namespace.

  /** Vanilla Bootstrap Theme */
 
  body.default .page-header {
    font-weight: 900;
  }
 
 
  /** Optional Bootstrap Theme */
 
  body.optional .img-responsive {
    display: inline-block;
  }
 
 
  /** Custom Bootstrap Theme */
 
  body.custom .btn-success {
    background-color: green;
  }
 
 
  /** Lumen - Bootswatch.com theme */
 
  body.lumen .navbar-default {
    background-color: red;
  }

  /** Single page (eg. "wiki:syntax") */
 
  body[data-page-id="wiki:synax"] {
    background-color: green;
  }
 
 
  /** Namespace (eg. "wiki:*") */
 
  body[data-page-id^="wiki:"] {
    background-color: red;
  }

For more information see Mozilla Developer Network - Attribute selectors.

The Logo, Favicon and Apple Touch (bookmark) icons are referenced from multiple locations. The default icons (DokuWiki logo) provided by the template can easily be changed by uploading new image files to the given locations using the Media Manager popup or Fullscreen Media Manager.

• :wiki:logo.png
• :logo.png

• :wiki:favicon.ico
• :favicon.ico

• :wiki:apple-touch-icon.png
• :apple-touch-icon.png

Since v2016-12-12 release it's possible use different Bootstrap theme for namespace. To enable this feature enable themeByNamespace option and create bootstrap3.themes.conf configuration file in your DOKU_CONF directory:

NOTE: To manage bootstrap3.themes.conf configuration file from DokuWiki use advanced plugin.

ns:page  theme

Example:

wiki         default
wiki:syntax  optional
playground   bootswatch/yeti

All files must be located in the template directory (lib/tpl/bootstrap3/) or your conf/ directory (upgrade-safe).

NOTE for navbar.html

This c10c048 commit introduced a new navbar hook (:navbar). Please use this new hook, because the navbar.html is deprecated and will be removed in the future release of template.

If you want to add only the Home-Page link, set the showHomePageLink.

You can customize various parts of your page by creating simple DokuWiki “hook” pages. The bootstrap3 template will plug these page snippets contained in each of these custom pages into the overall layout of the page.

This “hook” page is a standard DokuWiki page with an unordered-list of links (internal or external). The templating engine replaces the unordered-list with a menu bar with a dropdown-menu.

This is an example:

  * [[:start|Home]]
  * DokuWiki
    * [[:wiki:welcome]]
    * [[:wiki:syntax]]
    * [[:wiki:dokuwiki]]
  * [[:playground:playground]]
~~NOCACHE~~

It is possible to create different navbars for every namespaces with the same behavior of sidebar page.

• http://lotar.altervista.org/dokuwiki
  Main site – see the syntax page
• http://www.scenic-shop.com/structure
• http://garethwilliams.me.uk
• http://www.furope.it
• http://collectifdessel.org
  and using navbar by namespace (see above Dokuwiki hook) :
  • http://collectifdessel.org/doku.php/seluzege:accueil
• https://radeff.red/dokuwiki/
• Wiki of psiconauti.net
  with much warm gratitude to the author of the template!
• https://wikidurable.org
• http://kody.magazynek.org/
• http://poorterweide.nl/
  In Dutch only, based on the great bootstrap3 template, but further customized
• http://forestryforminecraft.info/
• http://www.tributieimposte.it/portale2016/doku.php
• http://wiki.bash-hackers.org/
• http://www.animint.net/note/
• http://telegram.wiki/
  Unofficial Telegram Wiki, with customized Bootstrap3 Template
• https://dokuwiki.nausch.org
• https://wiki.lede-project.org
• http://www.chtiland.fr
• http://docs.selfcomposer.com/templating/doku.php
  Selfcomposer documentation with customized Bootstrap3 Template
• http://british-caving.org.uk
• https://mk4-wiki.denkdose.de
• https://iskconpress.com
• https://fhtagn.deutschelovecraftgesellschaft.de

• v2024-02-06
• v2022-07-27
• v2021-03-11
• v2020-08-28
• v2020-07-29

• Bootstrap3 Template v2024-02-06 by giterlizzi (2024-02-06 18:50)
• Merge branch 'develop' by giterlizzi (2024-02-06 18:47)
• Fix typo in detail.php by giterlizzi (2024-02-06 18:43)
• Fix warnings by giterlizzi (2024-02-06 18:40)
• Merge branch 'ludenticus-patch-1' into develop by giterlizzi (2024-02-06 17:48)

• Fix typo in detail.php by giterlizzi (2024-02-06 18:43)
• Fix warnings by giterlizzi (2024-02-06 18:40)
• Merge branch 'ludenticus-patch-1' into develop by giterlizzi (2024-02-06 17:48)
• Merge branch 'patch-1' of https://github.com/ludenticus/dokuwiki-temp… by giterlizzi (2024-02-06 17:48)
• Update template.less by ludenticus (2023-04-01 11:55)

Please report bugs or feature requests at the Bug tracker.

The landing page is a special page without a sidebar (left and right) and the panel around the content. The landing page is enabled when the current page matches with the doku pages stored in the config landingPages. The default value is (intro) but if you want enable other pages, insert the name with regex syntax. For example:

• (intro|start), enable the landing pages for all “intro” and “start” pages of every namespaces

Thanks for the great template. What I like best that the toolbox is supported with Plugins. my page that I run here with the template: http://wiki.cigolla.ch

The H3~H5 tags are collapsed in TOC and are displayed only during the scroll of the page. This behavior save much space in TOC especially with page with more sections (eg. :wiki:syntax).

The function tpl_pageinfo() does not provide options to remove the name of the page or other customization.

The correct way to remove the page info, is change value to displayPageInfo in Configuration Manager (see: Others configuration).

To implement the Google CSE see this steps (adapted from Google CSE - Implementing search box):

Copy and paste in your meta.html hook this code:

<script>
  (function() {
    var cx = 'YOUR_ENGINE_ID';
    var gcse = document.createElement('script');
    gcse.type = 'text/javascript';
    gcse.async = true;
    gcse.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') +
        '//cse.google.com/cse.js?cx=' + cx;
    var s = document.getElementsByTagName('script')[0];
    s.parentNode.insertBefore(gcse, s);
  })();
</script>

Select and save the two-page layout in the Google CSE Control Panel. On one page, implement a stand-alone search box, changing the resultsUrl attribute to point to the url where you want to display the results (eg. http://example.org/dokuwiki/search).

Copy and paste this code in the sidebar (or in one of many hooks or in your preferred location):

<gcse:searchbox-only resultsUrl="YOUR_RESULTS_PAGE_URL"></gcse:searchbox-only>

To implement a stand-alone search results page, create a new DokuWiki page (eg. search) and paste the results code snippet into your results page:

<gcse:searchresults-only></gcse:searchresults-only>

Now you can trigger search results on this page by passing a q argument in the url:

http://example.org/dokuwiki/search?q=myQuery

NOTE: If you use the <html> tag, enable the htmlok option.

How can I add something like: “this site is using cookies, … you have to accept…” to the cookies banner. (Thanks for the template).

Adding text in the cookie banner is simple:

• Enable the flag showCookieLawBanner in Configuration Manager
• Create a new DokuWiki page with a text “this site is using cookies, … you have to accept…”. The default DokuWiki page is :cookie:banner
• Optional, create a policy page (the default DokuWiki page is :cookie:policy)

Hello, thanks for your awesome template. I would like everyone passing by to see the license of the wiki, in other template is pretty visible at the bottom, is there a way to enable it with this template too or I should tweak around? — arimane 2015-11-30 21:36

Hi. Is there any way to add some part of namespace to <title> tag?
I have dozens of pages witch same ID but in different namespaces. It would be nice to display in page title mayby two last namespaces.

Example:
Now:

http://abcd.ef/favorite/dogs/timmi      <title>Timmi [MyWiki]</title>
http://abcd.ef/disliked/cartoons/timmi  <title>Timmi [MyWiki]</title>

Nicer it would look like this:

http://abcd.ef/favorite/dogs/timmi      <title>Timmi - Favorite - Dogs - [MyWiki]</title>
http://abcd.ef/disliked/cartoons/timmi  <title>Timmi - Disliked - Cartoons - [MyWiki]</title>

— Alekk 2015-12-03 01:22

Thank You for this functionality. I like it. There is one bug. When first header contains sign ' (#39), e.g.

====== I'm very old =====

then its printed twice

<title>I'm very old - I'm very old - Some category [MyWIKI]</title>

I'm change ' (#39) to ` (#96)

— Alekk 2015-12-22 23:20

2016-01-15 First of all, this is a really impressive template. Thank you! On mobile phones (both iPhone and Android), my sidebar is especially long and won't stay open. When a user opens the sidebar and scrolls up/down, the sidebar automatically disappears. Is there a way to fix this? If it helps, my site is http://studyfruit.com.

This behavior iwas fixed in the v2016-01-25 release of template (see the commit on GitHub)
— Giuseppe Di Terlizzi 2016-02-22 15:08

Is there a list of used fonts and where they are defined?

Just a table as the one below would be fine.

E.g. I tried to change the edit window font face and size but defining the wiki__text element in conf/userstyle.css has no effect:

/conf/userstyle.css

…
dokuwiki textarea.edit, #wiki__text {
   font-family: courier, monospace !important;
   font-size: 110%;
}
…

— Thomas Templin 2016-04-13 05:55

I'm sorry, but the last time I really got into PHP is long ago. I'd just like to:

1. stop the edit/last revisions/link here buttons from changing their size when mousing over
2. remove the bottom footer

But I just don't understand it. Any help is greatly appreciated!

— clemo 2016-09-16 14:18

Hi, for the first question, can your send a screenshot of your page (via email or via GitHub issue) ? For remove the bottom footer elements (eg. badges, pageinfo) see showPageInfo and showBadges options.

— Giuseppe Di Terlizzi 2016-09-28 12:35

Hi, since the v2016-12-12 template version it's possible disable the page-tools animation via pageToolsAnimation option.

— Giuseppe Di Terlizzi 2016-12-13 17:09

The pagetools animations are a little bit bugged. Hover over the lowest button and moving up to the one above works. But moving the mouse from a upper button to lower button triggers the animations two times in a row. Now i added another color at hover in css and would like to disable the animations completely. Is there a more elegant way to disable the animations than removing the function in template.js in row 617ff (developer branch)?

— bobdeh 2016-11-15 20:00

Hi, since the v2016-12-12 template version it's possible disable the page-tools animation via pageToolsAnimation option.

— Giuseppe Di Terlizzi 2016-12-13 17:09

For a moment I thought I had found the answer with “showUserHomeLink” however that is the home page for the wiki. I'd really like to have a “showUserParentHomeLink” with a check box and a URL entry form! That would be really helpful. Thank you.

2017-02-19a “Frusterick Manners” - appears to be a Javascript issue.

didn't notice that. Works perfectly for me. By the way, you can report on Github if you encounter issues. — Digitalin 2017-02-24 14:19

I suggest:

- Fix file permission (specially for the new jQuery/jQueryUI dispatcher)
- Flush Cache (DokuWiki + Browser cache)
- Touch configuration file (or change an option in Configuration Manager)

— Giuseppe Di Terlizzi 2017-02-24 14:55

Clearing browser cache fixes that issue. Thanks!

Is there any way of disabling pagetools on the “start” page? My start page is readable by ALL (non-logged in) but I don't want casual visitors to be able to see any pagetools. Or maybe and option for no pagetools unless a user is logged-in (only if user is not-ALL). Thanks in advance for any relevant information! — Branmabon Kaesgard 2017-02-25 17:34

As far as I can see you can go to the Admin / Configuration page, lookup

tpl»bootstrap3»showPageTools
Enable the DokuWiki-style Page Tools

and change the associated selection box to When logged in.

However, if you do change only this setting then there's still the tools menu in the navbar at the top of the page, so you also may want to change this item

tpl»bootstrap3»showTools
Display Tools in navbar

to the same setting as above.

Unfortunately this doesn't seem to prevent the actions from working, so if you manually append ?do=edit to a page URL you can still see the source code of that page.

It would be nice if there was a global DW configuration option where you could disable these tools menus, as well as prevent users from viewing the page source, older revisions of the page, etc., and wouldn have to make these settings in a specific theme template like bootstrap3.

— Martin Burnicki 2017-04-04 14:48

Any chance to add an option in configuration to enable back to top link?

— Icmtf 2017-07-12 21:09

On Github there is a large quantity of improvements and enhancements. So meanwhile I'm getting very impatient for the moment, when these great updates will be rolled out.

— Juergen_aus_Zuendorf 2017-08-15 17:46

right? I also can not wait anymore! :(
How about making a beta if you don't fell like wanting to release a buggy experience?

— berot3 2017-10-09

Upgraded to Release 2018-04-22 Release “Greebo”

Stylesheet ../dokuwiki/css/_search.css not found, using ../dokuwiki/css/_search.less instead. Please contact developer of “bootstrap3” template.

Then found that the in Extension Manager the Template for Bootstrap3 could be upgraded and the error still seems to be present. How would this get fixed?

rgleason April 22, 2018

Hi, i have added all DokuWiki core styles into Bootstrap3 template to prevent this issue with new DokuWiki release.

Please reinstall the template again.

— Giuseppe Di Terlizzi 2018-04-23 22:06

Thanks that worked! rgleason May 10, 2018

Excellent template, thank you. I'm trying to set some table data styles and failing miserably at the moment. Ideally I'd like to be able to set them for just one table leaving others at default but even being able to set them globally would be useful.

To set the TD CSS for just one table I've tried <HTML>stuff here</HTML> but can't make it work (I know there are security issues with this but it's a personal wiki). I've also tried putting TD settings in more global sort of places but still can't make them take effect.

Can anyone help please?