====== mikioplugin Plugin ======

---- plugin ----
description: Mikio Plugin adds a heap of layout and Bootstrap 4 elements that can be used on your DokuWiki pages
author     : nomadjimbob
email      : james.collins@outlook.com.au
type       : syntax
lastupdate : 2024-02-09
compatible : Igor, Hogfather, Greebo, Jack Jackrum, Kaos
depends    : 
conflicts  : 
similar    : combo, wrap
tags       : alerts, anchor, badge, blockquote, bootstrap, box, button, cards, carousel, chart, columns, diagram, dropdown, grid, headings, icon, list, placeholders, progressbar, quiz, rows, slides, statistics, style, tabs

downloadurl: https://github.com/nomadjimbob/mikioplugin/zipball/master
bugtracker : https://github.com/nomadjimbob/mikioplugin/issues
sourcerepo : https://github.com/nomadjimbob/mikioplugin/
----

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. 

Alternatively, refer to [[:Plugins]] on how to install plugins manually. Download the plugin package and unpack it to your plugin-directory (**lib/plugins/**). This will create a new folder called **mikioplugin**.

===== About =====

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 [[template:Mikio]] theme.

The plugin currently adds support for:

  * Accordion
  * Alerts
  * Anchor
  * Badges
  * Blockquote
  * Box
  * Button & Button Groups
  * Cards
  * Carousel / Slides
  * Columns, Rows and Grid layouts
  * Custom headings
  * Icon Engine
  * Listgroups
  * Navigation Dropdowns
  * Pagination
  * Placeholders
  * Progress Bars
  * Quizes
  * Statistics
  * Steps
  * Tabs

===== Syntax =====

The syntax for the plugin is available at the [[https://github.com/nomadjimbob/mikioplugin/wiki|Mikio Plugin Wiki]].

===== Styling =====

You can edit the ''/assets/variables.css'' file to modify most of the colours used across the Mikio Plugin elements.

If you install the [[template:Mikio]] template, the ''/assets/variables.css'' will be ignored and replaced by the colours used within the template. These can be edited directly using the **Template Style Settings** editor.

===== 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 [[https://github.com/nomadjimbob/mikioplugin/issues/30|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 [[https://github.com/nomadjimbob/mikioplugin/issues/29|29]]. Thanks armandostyl.


==== 2023-12-10 ====

  * Fix a LESS compiliation error introduced in [[https://github.com/nomadjimbob/mikioplugin/issues/26|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 [[https://github.com/nomadjimbob/mikioplugin/issues/26|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.


Older release notes can be found on GitHub.


===== Discussion =====

**[APPLAUSE]** This plugin rocks! Unlike [[plugin:bootswrapper|Bootstrap Wrapper Plugin]] (which only support Bootstrap-based templates), this __can work on non-Bootstrap-based templates__ including default [[template:dokuwiki|DokuWiki Template]] and [[template:writr|Writr Template]] (styles of elements may vary, but at least they are functional). God knows I have abandoned Bootstrap elements for 4 yrs because not all my wiki instances use [[template:bootstrap3|Bootstrap3 Template]], but now I may consider to get back to use them. --- [[user>MilchFlasche|milchflasche aka GJRobert]] //2020-10-29 15:48//