Searchbar

The page searchbar is the section below the site toolbar, containing the site logo and the search field.

In the simplest form, it can look like this:

The site logo on the left-hand side of the search bar can be customised:

Use the Media Manager to upload an PNG or SVG image with the name “logo” (i.e. use “logo.svg” or “logo.png”) to either the root, or to the “wiki” directory.

Or save a static HTML snippet with the name “sitelogo.html” in the wiki’s conf/ directory and change the sitelogo setting (“How should the site logo be displayed?”) to “Static file”.

In either case, please make sure that the dimensions of the logo fit the available space. Use the template image (shown here and by default) as an example.

DokuWiki’s own search functionality is actually pretty good, and already for this reason it should not be hidden away but presented to visitors in the most inviting way.

The search field you see in the middle of the aptly named “Searchbar” is just the “inactive” state of the search widget. The moment the user activates it – typically by clicking into the search field – it changes to take centre-stage on the page:

In this mode, the web page content is overlaid (and blurred), so the user focusses on the search instead (a click to the background, or pressing the Escape key will of course return everything to the normal state).

More information on the search functionality in an upcoming article…

On smaller screens (e.g. tablets), instead of a search field, a search button (icon plus label) is shown:

On even smaller screens, the labels are also hidden and only the icons are shown: On smaller screens (e.g. tablets), instead of a search field, a search button (icon plus label) is shown:

The functionality, however, is the same: clicking or tapping on the search icon will open the search field, similar to above.

To the right of the search field, there is space for a tool widget. This is similar to the left-hand tool in the toolbar, insofar as it can be configured to hold the same tools, namely:

As usual, if no user is logged in, this place shows the “Log In” button instead.

When the Translation plugin is installed, this place can also hold the translations menu:

This is the default setting, which means for sites that don’t use the Translation plugin, this place will be left blank.

The right side of the Searchbar has three different hooks for loading HTML snippets:

• searchbar_pre.html
• searchbar_mid.html
• searchbar_post.html

TODO: explanations and screenshots.