xref: /plugin/mikioplugin/README.md (revision 8fd4b27d8b693b5773285f44383682ecf2a4e2f4)
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 `/assets/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## Disabling Tags
30
31If a Mikio Plugin tag is conflicting with another plugins tag, or you want to simply disable a tag, you can do this in the `disabled-tags.php` file.
32
33Simply change the tag you want to disable to `true` instead of `false`. Pages that have already been generated while the tag was enabled will need to be regenerated.
34
35## Releases
36
37-   **_2023-12-10_**
38
39    -   Fix a LESS compiliation error introduced in [#26](https://github.com/nomadjimbob/mikioplugin/issues/26). Thanks WetenSchaap.
40
41-   **_2023-12-04_**
42
43    -   Multiple paginations on a single page is now supported.
44    -   Pagination will try it best in resolving malformed URLs with missing content.
45    -   Fixed parsing to ignore <> symbols in element options which used to break the element.
46    -   Added ability to create group radio items in a multiple quiz item by surrounding options in []. Requested by Dylan.
47    -   Renamed pagenation to pagination while keep backwards compatibility.
48    -   Fixed pagination when using nice urls, rewrites and slashes [#26](https://github.com/nomadjimbob/mikioplugin/issues/26). Thanks armandostyl.
49    -   Updated pagination to use its own variables inside variables.css.
50    -   Fixed up some border radius issues and dark mode theming on pagination element.
51
52-   **_2023-11-19_**
53
54    -   Fix quiz results not shown correctly when markdown formatting applied.
55    -   Quiz placeholders can now be markdown formatted.
56    -   Quiz result elements now have classes that can be manually styled through css.
57    -   Fix button backgrounds being overridden by the DokuWiki theme when styled.
58
59-   **_2023-11-18_**
60
61    -   Better handling when a `quizitem` does not contain a `scores` or `answer` attribute.
62    -   Added `full` attribute to `quiz` to show the entire quiz.
63    -   Quiz questions, text and options support basic markdown to bold and italic points.
64    -   Quiz now supports [style](https://github.com/nomadjimbob/mikioplugin/wiki/Common-Attributes#styles) attribute for buttons.
65    -   Custom styles now automatically builds the `outline-` style.
66
67-   **_2023-11-17_**
68
69    -   Added scoring and multiple options to the `quiz` elements. Requested by Dylan.
70
71-   **_2023-10-16_**
72
73    -   Added support to justify individual components of the card. Requested by Dylan.
74
75-   **_2023-10-10_**
76
77    -   Fixed custom styles not being implemented correctly and added direct type support. Thanks Dylan
78    -   Heading element now supports `color` and `text-decoration` options. Requested by Dylan.
79
80-   **_2023-09-11_**
81
82    -   Fixed small tag not being inline [#22](https://github.com/nomadjimbob/mikioplugin/issues/22). Thanks Rayaqu
83    -   Added support to disable tags.
84
85-   **_2023-09-03_**
86
87    -   Fixed card height issues on smaller viewports.
88    -   Fixed columns not stacking on small viewports when using sizing. [#21](https://github.com/nomadjimbob/mikioplugin/issues/21). Thanks armandostyl
89
90-   **_2023-06-16_**
91
92    -   Fixed spacing issues with listgroup items with mixed styles. [#20](https://github.com/nomadjimbob/mikioplugin/issues/20). Thanks armandostyl
93
94-   **_2023-06-06_**
95
96    -   Added Nav item to create dropdown navigation items. [#18](https://github.com/nomadjimbob/mikioplugin/issues/18). Thanks armandostyl
97    -   Added support for elements in sidebars
98
99-   **_2023-05-20_**
100
101    -   AccordionItem, Alert, Blockquote, Card and CardBody now support containing 'protected' type which fixes some elements not rendering correctly (ie <&lt>code<&gt>)
102
103-   **_2023-05-19_**
104
105    -   Updated to include a polyfill for array_key_first if PHP < 7.3
106
107-   **_2022-10-31_**
108
109    -   Fixed 'link' type for Buttons
110    -   Updated CSS to use CSS Variables (supporting switchable themes and style editor within Mikio template). Thanks chrbinder.
111    -   variables.css no longer included if the mikio template is installed, active and version 2022-10-31 or greator
112
113-   **_2022-01-18_**
114
115    -   Fixed accordian not rendering tables inside itself [#15](https://github.com/nomadjimbob/mikioplugin/issues/15). Thanks Melphios
116
117-   **_2021-12-15_**
118
119    -   Added `autoclose` attribute to Accordions to close any other open accordion items other than the one clicked by the user. Requested by eFreshman
120
121-   **_2021-12-14_**
122
123    -   Fix Carousel not containing image by default [#14](https://github.com/nomadjimbob/mikioplugin/issues/14). Thanks eFreshman
124
125-   **_2021-12-13_**
126
127    -   Fix Struct Plugin Aggregation [#13](https://github.com/nomadjimbob/mikioplugin/issues/13). Thanks eFreshman
128
129-   **_2021-11-13_**
130
131    -   Carousel control colors can now be customized
132    -   Carousel now supports circle indicators
133    -   Dynamically build and fullscreen carousels now supported
134    -   SyntaxRender method now correctly converts tagName to methodNames
135
136-   **_2021-08-11_**
137
138    -   Replace Windows directory separator in CSS paths
139    -   Fixed path check in LESS engine on Windows
140    -   Recompiled CSS
141    -   Fixed PHP warnings
142
143-   **_2021-08-10_**
144
145    -   Button outline styling fix [#12](https://github.com/nomadjimbob/mikioplugin/issues/12)
146    -   Added small margin to left and right of buttons
147
148-   **_2021-07-13_**
149
150    -   Element class shortcuts (eg text-center) working again
151    -   LESS engine updated to match the Mikio theme
152    -   LESS fallback to CSS
153
154-   **_2021-04-23_**
155
156    -   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
157    -   Adding a card-footer element inside a card-body element will now work. This fixes inside card elements
158    -   Cards and Carousel images are now contained inside the element instead of covering the element
159    -   Added `cover` attributes to Card and Carousel for images to cover element instead of being contained
160    -   Height attribute bugfix for placeholders
161
162-   **_2021-04-19_**
163
164    -   Fixed images not always being contained within elements such as card headers [#9](https://github.com/nomadjimbob/mikioplugin/issues/9)
165
166-   **_2021-03-05_**
167
168    -   Added support for custom element types and styling [#6](https://github.com/nomadjimbob/mikioplugin/issues/6)
169
170-   **_2021-03-02_**
171    -   Fixed a dokuwiki rendering issue in card bodies [#7](https://github.com/nomadjimbob/mikioplugin/issues/7)
172    -   Fixed a text alignment not being applied in alerts [#8](https://github.com/nomadjimbob/mikioplugin/issues/8)
173
174## Links
175
176-   DokuWiki Plugin Page: (http://dokuwiki.org/plugin:mikioplugin)
177-   Download: (https://github.com/nomadjimbob/mikioplugin/releases/latest)
178-   Docs: (https://github.com/nomadjimbob/mikioplugin/wiki)
179-   Donate: (https://www.ko-fi.com/nomadjimbob)
180-   License: (https://raw.githubusercontent.com/nomadjimbob/mikioplugin/master/LICENSE)
181
182## Contributing
183
184Any contributions are appreciated. Please feel free to reach out to me at james.collins@outlook.com.au
185