1# Material Design Template for DokuWiki
2
3This Material template is very easy to install and use, whilst offering a multitude of customization options.
4
5You can begin by choosing between several color themes in the style.ini file. From there on, you can fully customize the sidebar, making use of the entire material icon pack.
6
7Visit the template page on the [DokuWiki forums](https://www.dokuwiki.org/template:material)
8
9It is based off [Material Design Lite](https://getmdl.io/) with some minor changes and adjustements.
10
11
12## Design
13
14![Screenshot of the template on two devices](https://i.imgur.com/1QibmKg.jpg)
15
16## Beautiful themes
17
18![There are 8 unique themes to choose from](https://i.imgur.com/bnWd8k3.png)
19
20## Elegant Editor
21
22![Screenshot of editor](https://i.imgur.com/e9TqMB2.png)
23
24The material template now sports an elegant looking editor. You can further improve it by replacing the toolbar icons found in `DOKUWIKI_ROOT/lib/images/toolbar` with those found in the `copy these icons to the toolbar` folder. Alternatively, you can choose your own, for example from [the Material Icons page](https://material.io/icons/).
25
26The toolbar can then looking like the following:
27
28![Image of toolbar with material icons](https://i.imgur.com/XSyhyPU.png)
29
30## Installation
31
32Use the following URL to download this template:
33
34  * [Link to ZIP file on GitHub](https://github.com/LeonStaufer/material-dokuwiki/zipball/master)
35
36Refer to [this guide](https://www.dokuwiki.org/template) on how to install and use templates in DokuWiki.
37
38## Upgrading
39
40Regularly visit the installed templates via the configuration manager in order to update this template to the latest version.
41
42**WARNING**: updating overrides all changed files. That means if you edited the `main.php` or `sidebar.php` you will need to backup these or any others before upgrading.
43
44## Configuration
45
461. install the template
472. navigate to the `DOKUWIKI ROOT/lib/tpl/material` folder
483. open the `style.ini` file and scroll to the "replacements" section
494. follow the instructions there to change the colors
505. if you wish you can now open the `sidebar.php` file and change its contents to your liking
516. and you're set!
52
53The template also comes with several configuration options, which you can set via the Configuration Manager.
54
55| Key                   | Description                                                  | Default |
56| --------------------- | ------------------------------------------------------------ | ------- |
57| `dokuwikiSidebar`     | use the sidebar page within the wiki instead of the `sidebar.php` file | `false` |
58| `feedbackForm`        | add a button that allows users to give feedback              | `true`  |
59| `technicalFeedbackForm` | technical information is included in the feedback email          | `true`  |
60| `feedbackEmail`       | the recipient Email address for the feedback | `address@domain.com` |
61| `feedbackSubjectLine` | subject line of the Email | `Feedback for Website` |
62| `feedbackBody`       | body of the Email | `Thank you so much for taking the time to write feedback. We really appreciate it :) \n\n [your message] \n\n\n You can ignore all the technical information below. It only helps us track down what the problem might be.` |
63| `hiddenActions`      | DokuWiki actions that are hidden | `backlink,top` |
64| `protrudingDrawer`   | if the drawer should stick out on the left | `true` |
65| `subtlePagename`     | if the title of the page should not be the focus | `false` |
66
67
68## Feedback
69
70If you encounter any problems or would like to see functionality added, please head over to the issue page on GitHub and submit your bug/request.
71