DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:noiewarning

This is an old revision of the document!


noiewarning plugin

Compatible with DokuWiki

≥ 2009-02-06 (RC2)

plugin Displays warning when visitor uses MSIE

Last updated on
2011-01-14
Provides
Action

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

Tagged with maintenance

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:

Default view of the NoIEWarning plugin

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

Other Plugins by
Luis Machuca:
progrecss
tooltip
clock
divalign2
countdown
hide
gil

Discussion

Feel free to :?: ask questions here.

plugin/noiewarning.1308411784.txt.gz · Last modified: 2011-06-18 17:43 by ach

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki