This is an old revision of the document!
Table of Contents
noiewarning plugin
Compatible with DokuWiki
≥ 2009-02-06 (RC2)
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to nobadbrowser
NoIEWarning is an adaption of WordPress plugins like Shockingly Big IE Warning, and has the same purpose: display a warning whenever a visitor uses Internet Explorer.
Download and Installation
Download and install the plugin giving the URL at the download icon above to the Plugin Manager. Refer to Plugins on how to install plugins manually.
Configuration
Configuration is available via the Plugin Manager. As of version 0.618
the plugin follows the following directives:
Option | Effect |
---|---|
method | What Display Method is used to show the warning. |
source | What Display Source to pick the warning from. Currently unavailable. |
better | What Alternative Browser is recommended by the wiki installation. |
min_ie_version | The minimum accepted IE version, for which and above the warning will not be shown. Currently Unavailable |
Display Method
The plugin can display a warning using one of two (three in the future) display methods. The available options are subsection
and notify
, with the options note
and splash
reserved for future use.
The subsection method loads the IE warning and preppends it to the content of the wikipage, right above the first header. In this form, the warning will always show in line with the template and look “natural” enough, and will be styled to be recognizable.
The notify method loads the IE warning and displays it using DokuWiki's inbuilt notify capabilities, thus showing in the message area. In this form, warnings use less space and do not affect alternative renderings.
The note method, not available in this release, will attempt to load the Note Plugin and display a Warning Notice right before the first header.
The splash method, not available in this release, will use JavaScript to load the warning into a splash screen which will be displayed to IE visitors for a couple of seconds. The normal rendering and content of the wiki pages will not be affected.
Display Source
Right now, the plugin picks the warning notice from a series of localized strings at DOKU_PLUGIN/lang/*/lang.php
. If a localized notice is not found for the current language, the plugin defaults to English as does the rest of the DokuWiki interface.
In the future, it will be possible to load custom warning notices via the Configuration Manager by indicating the pagename of a wiki page containing the warning; the contents of this page are parsed and passed as the warning without further modification.
Alternative Browser
The plugin offers a facility by which, once it has been determined that the visitor is using Internet Explorer, a better alternative browser will be offered to them. Via the better
(-browser
) configuration option, the Wiki Administrador can determine which browser is offered to visitors.
The configuration option can be left empty, in which no alternative browser is offered, or can be left as custom
, in which the plugin will search for a custom recommendation that the Wiki Administrador sets up as DOKU_CONF/better-browser.txt
. Any other value recommends the indicated browser.
For details on the recommendation file structure and their current rationale, check the official demo page.
Other Details
See This Plugin In Action
To see this plugin in action, visit the Official Demo at my wiki or my plugin testing area while using Internet Explorer (or faking Internet Explorer via another browser's capabilities); you should be shown a warning much like the one in the picture below:
More Information
For more information on the plugin, such as a changelog, projected features for future releases, the versioning scheme or the configuration for localization strings, check the official demo page above.
Other Developments
Discussion
Feel free to ask questions here.