xref: /plugin/mikioplugin/README.md (revision b007ca42f5dcac2e4da8e8ce8426ac9f91496844)
1<img src="https://raw.githubusercontent.com/nomadjimbob/nomadjimbob/master/wiki/mikioplugin/images/mikio_plugin_header.png">
2
3[![License: GPL-2](https://img.shields.io/github/license/nomadjimbob/mikioplugin?color=blue)](LICENSE)
4[![saythanks](https://img.shields.io/badge/say-thanks-ff69b4.svg)](https://saythanks.io/to/james.collins%40outlook.com.au)
5
6Mikio Plugin adds a heap of layout and Bootstrap 4 elements that can be used on your [DokuWiki](http://dokuwiki.org/) pages.
7
8This plugin can be used by itself, however is designed to complement the [Mikio DokuWiki template](http://dokuwiki.org/template:mikio).
9
10## Updating Styles
11
12You can update the colors used by the elements by editing the `/assets/variables.css` file. From version 2022-10-31 onwards, the theme supports darkmode within browsers.
13
14If you have the [Mikio DokuWiki template](http://dokuwiki.org/template:mikio) 2022-10-31 onwards installed, the `/assetrs/variables.css` will be ignored as the template adds the variables itself. These can be edited using
15**Template Style Settings** in your sites **Administration** page.
16
17## Setting Up
18
19Download the [latest release](https://github.com/nomadjimbob/mikioplugin/releases/latest) and place it in the\
20\
21:file_folder: dokuwiki\
22&nbsp;&nbsp;&nbsp;&nbsp;:file_folder: lib\
23&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:file_folder: plugins
24
25directory of your DokuWiki installation.
26
27Sometimes GitHub releases change the name of the mikioplugin directory, so make sure that the directory is `mikioplugin` else you may see errors in DokuWiki.
28
29## Releases
30
31-   **_2022-05-19_**
32
33    -   Updated to include a polyfill for array_key_first if PHP < 7.3
34
35-   **_2022-10-31_**
36
37    -   Fixed 'link' type for Buttons
38    -   Updated CSS to use CSS Variables (supporting switchable themes and style editor within Mikio template). Thanks chrbinder.
39    -   variables.css no longer included if the mikio template is installed, active and version 2022-10-31 or greator
40
41-   **_2022-01-18_**
42
43    -   Fixed accordian not rendering tables inside itself [#15](https://github.com/nomadjimbob/mikioplugin/issues/15). Thanks Melphios
44
45-   **_2021-12-15_**
46
47    -   Added `autoclose` attribute to Accordions to close any other open accordion items other than the one clicked by the user. Requested by eFreshman
48
49-   **_2021-12-14_**
50
51    -   Fix Carousel not containing image by default [#14](https://github.com/nomadjimbob/mikioplugin/issues/14). Thanks eFreshman
52
53-   **_2021-12-13_**
54
55    -   Fix Struct Plugin Aggregation [#13](https://github.com/nomadjimbob/mikioplugin/issues/13). Thanks eFreshman
56
57-   **_2021-11-13_**
58
59    -   Carousel control colors can now be customized
60    -   Carousel now supports circle indicators
61    -   Dynamically build and fullscreen carousels now supported
62    -   SyntaxRender method now correctly converts tagName to methodNames
63
64-   **_2021-08-11_**
65
66    -   Replace Windows directory separator in CSS paths
67    -   Fixed path check in LESS engine on Windows
68    -   Recompiled CSS
69    -   Fixed PHP warnings
70
71-   **_2021-08-10_**
72
73    -   Button outline styling fix [#12](https://github.com/nomadjimbob/mikioplugin/issues/12)
74    -   Added small margin to left and right of buttons
75
76-   **_2021-07-13_**
77
78    -   Element class shortcuts (eg text-center) working again
79    -   LESS engine updated to match the Mikio theme
80    -   LESS fallback to CSS
81
82-   **_2021-04-23_**
83
84    -   Fixed Card element overflow issues. Cards will now be their own height when inside a row element. To force cards to all be the same height, wrap each card in a col element
85    -   Adding a card-footer element inside a card-body element will now work. This fixes inside card elements
86    -   Cards and Carousel images are now contained inside the element instead of covering the element
87    -   Added `cover` attributes to Card and Carousel for images to cover element instead of being contained
88    -   Height attribute bugfix for placeholders
89
90-   **_2021-04-19_**
91
92    -   Fixed images not always being contained within elements such as card headers [#9](https://github.com/nomadjimbob/mikioplugin/issues/9)
93
94-   **_2021-03-05_**
95
96    -   Added support for custom element types and styling [#6](https://github.com/nomadjimbob/mikioplugin/issues/6)
97
98-   **_2021-03-02_**
99    -   Fixed a dokuwiki rendering issue in card bodies [#7](https://github.com/nomadjimbob/mikioplugin/issues/7)
100    -   Fixed a text alignment not being applied in alerts [#8](https://github.com/nomadjimbob/mikioplugin/issues/8)
101
102## Links
103
104-   DokuWiki Plugin Page: (http://dokuwiki.org/plugin:mikioplugin)
105-   Download: (https://github.com/nomadjimbob/mikioplugin/releases/latest)
106-   Docs: (https://github.com/nomadjimbob/mikioplugin/wiki)
107-   Donate: (https://www.ko-fi.com/nomadjimbob)
108-   License: (https://raw.githubusercontent.com/nomadjimbob/mikioplugin/master/LICENSE)
109
110## Contributing
111
112Any contributions are appreciated. Please feel free to reach out to me at james.collins@outlook.com.au
113