Mikio Plugin adds a heap of layout and Bootstrap 4 elements that can be used on your DokuWiki pages.

This plugin can be used by itself, however is designed to complement the Mikio DokuWiki template.

Updating Styles

You 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.

If you have the Mikio DokuWiki template 2022-10-31 onwards installed, the /assets/variables.css will be ignored as the template adds the variables itself. These can be edited using Template Style Settings in your sites Administration page.

Setting Up

Download the latest release and place it in the

📁 dokuwiki
    :file_folder: lib
        :file_folder: plugins

directory of your DokuWiki installation.

Sometimes GitHub releases change the name of the mikioplugin directory, so make sure that the directory is mikioplugin else you may see errors in DokuWiki.

Disabling Tags

If 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.

Simply 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.

Releases

• 2024-02-09

  • Added support for DokuWiki Kaos
  • Updated to support PHP 8.2

• 2024-01-14

  • <col> now supports the vertical-align option, defaulting to top #30. Thanks EmmaKnijn.
  • <right-sidebar> element added for making right handed sidebars within the page.

• 2024-01-06

  • Fix missing default options of height and width in nav element #29. Thanks armandostyl.

• 2023-12-10

  • Fix a LESS compiliation error introduced in #26. Thanks WetenSchaap.

• 2023-12-04

  • Multiple paginations on a single page is now supported.
  • Pagination will try it best in resolving malformed URLs with missing content.
  • Fixed parsing to ignore <> symbols in element options which used to break the element.
  • Added ability to create group radio items in a multiple quiz item by surrounding options in []. Requested by Dylan.
  • Renamed pagenation to pagination while keep backwards compatibility.
  • Fixed pagination when using nice urls, rewrites and slashes #26. Thanks armandostyl.
  • Updated pagination to use its own variables inside variables.css.
  • Fixed up some border radius issues and dark mode theming on pagination element.

• 2023-11-19

  • Fix quiz results not shown correctly when markdown formatting applied.
  • Quiz placeholders can now be markdown formatted.
  • Quiz result elements now have classes that can be manually styled through css.
  • Fix button backgrounds being overridden by the DokuWiki theme when styled.

• 2023-11-18

  • Better handling when a quizitem does not contain a scores or answer attribute.
  • Added full attribute to quiz to show the entire quiz.
  • Quiz questions, text and options support basic markdown to bold and italic points.
  • Quiz now supports style attribute for buttons.
  • Custom styles now automatically builds the outline- style.

• 2023-11-17

  • Added scoring and multiple options to the quiz elements. Requested by Dylan.

• 2023-10-16

  • Added support to justify individual components of the card. Requested by Dylan.

• 2023-10-10

  • Fixed custom styles not being implemented correctly and added direct type support. Thanks Dylan
  • Heading element now supports color and text-decoration options. Requested by Dylan.

• 2023-09-11

  • Fixed small tag not being inline #22. Thanks Rayaqu
  • Added support to disable tags.

• 2023-09-03

  • Fixed card height issues on smaller viewports.
  • Fixed columns not stacking on small viewports when using sizing. #21. Thanks armandostyl

• 2023-06-16

  • Fixed spacing issues with listgroup items with mixed styles. #20. Thanks armandostyl

• 2023-06-06

  • Added Nav item to create dropdown navigation items. #18. Thanks armandostyl
  • Added support for elements in sidebars

• 2023-05-20

  • AccordionItem, Alert, Blockquote, Card and CardBody now support containing 'protected' type which fixes some elements not rendering correctly (ie <&lt>code<&gt>)

• 2023-05-19

  • Updated to include a polyfill for array_key_first if PHP < 7.3

• 2022-10-31

  • Fixed 'link' type for Buttons
  • Updated CSS to use CSS Variables (supporting switchable themes and style editor within Mikio template). Thanks chrbinder.
  • variables.css no longer included if the mikio template is installed, active and version 2022-10-31 or greator

• 2022-01-18

  • Fixed accordian not rendering tables inside itself #15. Thanks Melphios

• 2021-12-15

  • Added autoclose attribute to Accordions to close any other open accordion items other than the one clicked by the user. Requested by eFreshman

• 2021-12-14

  • Fix Carousel not containing image by default #14. Thanks eFreshman

• 2021-12-13

  • Fix Struct Plugin Aggregation #13. Thanks eFreshman

• 2021-11-13

  • Carousel control colors can now be customized
  • Carousel now supports circle indicators
  • Dynamically build and fullscreen carousels now supported
  • SyntaxRender method now correctly converts tagName to methodNames

• 2021-08-11

  • Replace Windows directory separator in CSS paths
  • Fixed path check in LESS engine on Windows
  • Recompiled CSS
  • Fixed PHP warnings

• 2021-08-10

  • Button outline styling fix #12
  • Added small margin to left and right of buttons

• 2021-07-13

  • Element class shortcuts (eg text-center) working again
  • LESS engine updated to match the Mikio theme
  • LESS fallback to CSS

• 2021-04-23

  • 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
  • Adding a card-footer element inside a card-body element will now work. This fixes inside card elements
  • Cards and Carousel images are now contained inside the element instead of covering the element
  • Added cover attributes to Card and Carousel for images to cover element instead of being contained
  • Height attribute bugfix for placeholders

• 2021-04-19

  • Fixed images not always being contained within elements such as card headers #9

• 2021-03-05

  • Added support for custom element types and styling #6

• 2021-03-02

  • Fixed a dokuwiki rendering issue in card bodies #7
  • Fixed a text alignment not being applied in alerts #8

Links

• DokuWiki Plugin Page: (http://dokuwiki.org/plugin:mikioplugin)
• Download: (https://github.com/nomadjimbob/mikioplugin/releases/latest)
• Docs: (https://github.com/nomadjimbob/mikioplugin/wiki)
• Donate: (https://www.ko-fi.com/nomadjimbob)
• License: (https://raw.githubusercontent.com/nomadjimbob/mikioplugin/master/LICENSE)

Contributing

Any contributions are appreciated. Please feel free to reach out to me at james.collins@outlook.com.au