1<img src="https://raw.githubusercontent.com/nomadjimbob/nomadjimbob/master/wiki/mikioplugin/images/mikio_plugin_header.png" alt="Mikio Plugin"> 2 3[](LICENSE) 4[](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## Flexbox Fix 11 12A flexbox fix was applied to the card body element. This may affect existing layouts that relied on the previous (incorrect) formatting. For example, buttons that were unintentionally displayed as `block` elements will now render with their correct inline behavior. 13 14## Updating Styles 15 16You 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. 17 18If 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 19**Template Style Settings** in your sites **Administration** page. 20 21## Setting Up 22 23Download the [latest release](https://github.com/nomadjimbob/mikioplugin/releases/latest) and place it in the\ 24\ 25:file_folder: dokuwiki\ 26 :file_folder: lib\ 27 :file_folder: plugins 28 29directory of your DokuWiki installation. 30 31Sometimes GitHub releases change the name of the mikioplugin directory, so make sure that the directory is `mikioplugin` else you may see errors in DokuWiki. 32 33## Disabling Tags 34 35If 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. 36 37Simply 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. 38 39## Releases 40 41- **_2026-06-24_** 42 - Fixed tabgroup content normalization so source indentation can be preserved without breaking tab body formatting. [#47](https://github.com/nomadjimbob/mikioplugin/issues/47). Thanks danielhofer. 43 44- **_2026-06-18_** 45 - Fixed unauthenticated reflected XSS in carousel. Thanks radiospikes. 46 - Fixed image attribute functioning correctly with the overlay attribute in cards. Thanks LMayer. 47 - Fix function name for ctype_xdigit [#46](https://github.com/nomadjimbob/mikioplugin/pull/46). Thanks jorge-leon 48 49- **_2026-01-28_** 50 - Improved support for older themes [#44](https://github.com/nomadjimbob/mikioplugin/issues/44). Requested by jheim2. 51 - Added support for the attribute [`collapse-opened-text`](https://github.com/nomadjimbob/mikioplugin/wiki/Collapse#attributes-button) for buttons that support a collapsable element. 52 53- **_2025-11-01_** 54 - Fixed Collapse elements not supporting other markdown items inside [#43](https://github.com/nomadjimbob/mikioplugin/issues/43). Thanks locodarwin. 55 56- **_2025-10-05_** 57 - Fixed bug in icon engine where bootstrap icons were not being rendered correctly [#42](https://github.com/nomadjimbob/mikioplugin/issues/42). Thanks nhratos. 58 - Fixed rendering bug inside columns in certain instances due to flexbox [#41](https://github.com/nomadjimbob/mikioplugin/issues/41). Thanks reissmann. 59 - Fixed rendering bug inside card body in certain instances due to flexbox [#40](https://github.com/nomadjimbob/mikioplugin/issues/40). Thanks mueniko. 60 - Other Navs now close when a second one is opened [#39](https://github.com/nomadjimbob/mikioplugin/issues/39). Thanks aloade. 61 - Fixed undefined array key errors under PHP 8.1 [#37](https://github.com/nomadjimbob/mikioplugin/issues/37). Thanks MartijnSanders. 62 63- **_2025-07-24_** 64 - Fixed security vulnerability, parsing less error discloses the physical path. Reported by B Mercer. 65 - Fixed invalid white-space property in stylesheet. 66 - Various PHP optimizations and code cleanup. 67 68- **_2024-06-05_** 69 70 - Added `<tags>` element to support rendering the page tags anywhere if using the Mikio theme [Mikio-#70](https://github.com/nomadjimbob/mikio/issues/70). Requested by garanovich. 71 - Fixed images being stretched in cards [#32](https://github.com/nomadjimbob/mikioplugin/issues/32). Thanks Elanndelh. 72 - Added `align-` support to cards [#35](https://github.com/nomadjimbob/mikioplugin/issues/35). Requested by garanovich. 73 - `<right-sidebar>` element added for making right handed sidebars within the page. 74 75- **_2024-02-09_** 76 77 - Added support for DokuWiki Kaos 78 - Updated to support PHP 8.2 79 80- **_2024-01-14_** 81 82 - `<col>` now supports the `vertical-align` option, defaulting to top [#30](https://github.com/nomadjimbob/mikioplugin/issues/30). Thanks EmmaKnijn. 83 - `<right-sidebar>` element added for making right handed sidebars within the page. 84 85- **_2024-01-06_** 86 87 - Fix missing default options of height and width in nav element [#29](https://github.com/nomadjimbob/mikioplugin/issues/29). Thanks armandostyl. 88 89- **_2023-12-10_** 90 91 - Fix a LESS compiliation error introduced in [#26](https://github.com/nomadjimbob/mikioplugin/issues/26). Thanks WetenSchaap. 92 93- **_2023-12-04_** 94 95 - Multiple paginations on a single page is now supported. 96 - Pagination will try it best in resolving malformed URLs with missing content. 97 - Fixed parsing to ignore <> symbols in element options which used to break the element. 98 - Added ability to create group radio items in a multiple quiz item by surrounding options in []. Requested by Dylan. 99 - Renamed pagenation to pagination while keep backwards compatibility. 100 - Fixed pagination when using nice urls, rewrites and slashes [#26](https://github.com/nomadjimbob/mikioplugin/issues/26). Thanks armandostyl. 101 - Updated pagination to use its own variables inside variables.css. 102 - Fixed up some border radius issues and dark mode theming on pagination element. 103 104- **_2023-11-19_** 105 106 - Fix quiz results not shown correctly when markdown formatting applied. 107 - Quiz placeholders can now be markdown formatted. 108 - Quiz result elements now have classes that can be manually styled through css. 109 - Fix button backgrounds being overridden by the DokuWiki theme when styled. 110 111- **_2023-11-18_** 112 113 - Better handling when a `quizitem` does not contain a `scores` or `answer` attribute. 114 - Added `full` attribute to `quiz` to show the entire quiz. 115 - Quiz questions, text and options support basic markdown to bold and italic points. 116 - Quiz now supports [style](https://github.com/nomadjimbob/mikioplugin/wiki/Common-Attributes#styles) attribute for buttons. 117 - Custom styles now automatically builds the `outline-` style. 118 119- **_2023-11-17_** 120 121 - Added scoring and multiple options to the `quiz` elements. Requested by Dylan. 122 123- **_2023-10-16_** 124 125 - Added support to justify individual components of the card. Requested by Dylan. 126 127- **_2023-10-10_** 128 129 - Fixed custom styles not being implemented correctly and added direct type support. Thanks Dylan 130 - Heading element now supports `color` and `text-decoration` options. Requested by Dylan. 131 132- **_2023-09-11_** 133 134 - Fixed small tag not being inline [#22](https://github.com/nomadjimbob/mikioplugin/issues/22). Thanks Rayaqu 135 - Added support to disable tags. 136 137- **_2023-09-03_** 138 139 - Fixed card height issues on smaller viewports. 140 - Fixed columns not stacking on small viewports when using sizing. [#21](https://github.com/nomadjimbob/mikioplugin/issues/21). Thanks armandostyl 141 142- **_2023-06-16_** 143 144 - Fixed spacing issues with listgroup items with mixed styles. [#20](https://github.com/nomadjimbob/mikioplugin/issues/20). Thanks armandostyl 145 146- **_2023-06-06_** 147 148 - Added Nav item to create dropdown navigation items. [#18](https://github.com/nomadjimbob/mikioplugin/issues/18). Thanks armandostyl 149 - Added support for elements in sidebars 150 151- **_2023-05-20_** 152 153 - AccordionItem, Alert, Blockquote, Card and CardBody now support containing 'protected' type which fixes some elements not rendering correctly (ie <<>code<>>) 154 155- **_2023-05-19_** 156 157 - Updated to include a polyfill for array_key_first if PHP < 7.3 158 159- **_2022-10-31_** 160 161 - Fixed 'link' type for Buttons 162 - Updated CSS to use CSS Variables (supporting switchable themes and style editor within Mikio template). Thanks chrbinder. 163 - variables.css no longer included if the mikio template is installed, active and version 2022-10-31 or greator 164 165- **_2022-01-18_** 166 167 - Fixed accordian not rendering tables inside itself [#15](https://github.com/nomadjimbob/mikioplugin/issues/15). Thanks Melphios 168 169- **_2021-12-15_** 170 171 - Added `autoclose` attribute to Accordions to close any other open accordion items other than the one clicked by the user. Requested by eFreshman 172 173- **_2021-12-14_** 174 175 - Fix Carousel not containing image by default [#14](https://github.com/nomadjimbob/mikioplugin/issues/14). Thanks eFreshman 176 177- **_2021-12-13_** 178 179 - Fix Struct Plugin Aggregation [#13](https://github.com/nomadjimbob/mikioplugin/issues/13). Thanks eFreshman 180 181- **_2021-11-13_** 182 183 - Carousel control colors can now be customized 184 - Carousel now supports circle indicators 185 - Dynamically build and fullscreen carousels now supported 186 - SyntaxRender method now correctly converts tagName to methodNames 187 188- **_2021-08-11_** 189 190 - Replace Windows directory separator in CSS paths 191 - Fixed path check in LESS engine on Windows 192 - Recompiled CSS 193 - Fixed PHP warnings 194 195- **_2021-08-10_** 196 197 - Button outline styling fix [#12](https://github.com/nomadjimbob/mikioplugin/issues/12) 198 - Added small margin to left and right of buttons 199 200- **_2021-07-13_** 201 202 - Element class shortcuts (eg text-center) working again 203 - LESS engine updated to match the Mikio theme 204 - LESS fallback to CSS 205 206- **_2021-04-23_** 207 208 - 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 209 - Adding a card-footer element inside a card-body element will now work. This fixes inside card elements 210 - Cards and Carousel images are now contained inside the element instead of covering the element 211 - Added `cover` attributes to Card and Carousel for images to cover element instead of being contained 212 - Height attribute bugfix for placeholders 213 214- **_2021-04-19_** 215 216 - Fixed images not always being contained within elements such as card headers [#9](https://github.com/nomadjimbob/mikioplugin/issues/9) 217 218- **_2021-03-05_** 219 220 - Added support for custom element types and styling [#6](https://github.com/nomadjimbob/mikioplugin/issues/6) 221 222- **_2021-03-02_** 223 - Fixed a dokuwiki rendering issue in card bodies [#7](https://github.com/nomadjimbob/mikioplugin/issues/7) 224 - Fixed a text alignment not being applied in alerts [#8](https://github.com/nomadjimbob/mikioplugin/issues/8) 225 226## Links 227 228- DokuWiki Plugin Page: (http://dokuwiki.org/plugin:mikioplugin) 229- Download: (https://github.com/nomadjimbob/mikioplugin/releases/latest) 230- Docs: (https://github.com/nomadjimbob/mikioplugin/wiki) 231- Donate: (https://www.ko-fi.com/nomadjimbob) 232- License: (https://raw.githubusercontent.com/nomadjimbob/mikioplugin/master/LICENSE) 233 234## Contributing 235 236Any contributions are appreciated. Please feel free to reach out to me at james.collins@outlook.com.au 237
){kind=link}