====== Tagalerts Plugin ======

---- plugin ----
description: Adds alerts (as system messages or simple tag styling)
author     : Simon DELAGE 
email      : simon.geekitude@gmail.com 
type       : 
lastupdate : 2015-06-20
compatible : 
depends    : tag
conflicts  : 
similar    : 
tags       : tags, alert

downloadurl: http://github.com/geekitude/dokuwiki-plugin-tagalerts/zipball/master
bugtracker : http://github.com/geekitude/dokuwiki-plugin-tagalerts/issues
sourcerepo : http://github.com/geekitude/dokuwiki-plugin-tagalerts/
donationurl: 

screenshot_img : http://www.geekitude.fr/externe/dokuwiki/tagalerts/screenshot.jpg
----

===== Installation =====

:!: **External requirements:** This plugin requires today's (2015-07-24) version of [[plugin:tag|Tag Plugin]]. It's info file is not updated yet as I write these lines so you will have to manually upgrade it by clicking "Reinstall" button even if plugin manager doesn't propose the update on it's own.

Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples =====

Here is an example of "inline" alert with a custom message shown as a tooltip on mouseover :

{{http://www.geekitude.fr/externe/dokuwiki/tagalerts/screenshot.jpg}}

And here is an example of "message" alert, this time with just the basic message :

{{http://www.geekitude.fr/externe/dokuwiki/tagalerts/message.jpg}}

It is possible to have more than one alert at once :

{{http://www.geekitude.fr/externe/dokuwiki/tagalerts/multiple_inline.jpg}}
{{http://www.geekitude.fr/externe/dokuwiki/tagalerts/multiple_message.jpg}}

And it is finally possible to have more than one //inline// alert of same type :

{{http://www.geekitude.fr/externe/dokuwiki/tagalerts/multiple_inline_same_type.jpg}}

But it is currently not possible to have a given message alert more than once.

===== Configuration and Settings =====

  * **action** : type of alert (ie //inline// or //message//) [default: inline]
  * **error**, **info**, **success** and **notify** : comma separated lists of tags that will trigger the corresponding alert

Here is an example of configuration :

{{http://www.geekitude.fr/externe/dokuwiki/tagalerts/configuration.jpg}}

===== Custom messages =====

To have custom messages, you have to create a file named //tagalerts.conf// in your wiki's //conf// folder (''.../conf/tagalerts.conf'').

Here is an example with custom messages for //archive// and //todo// tags :
<file bash tagalerts.conf>
archive	Cette page a été archivée et son contenu pourrait être dépassé.
todo	Au boulot !

</file>

** Notes :**
  * an empty line is needed at the end of the file
  * [[https://www.dokuwiki.org/plugin:confmanager|ConfManager]] plugin can manage this conf file for you.

===== Change Log =====

{{rss>https://github.com/geekitude/dokuwiki-plugin-tagalerts/commits/master.atom date 5}}

===== Known Bugs and Issues =====

Please refer to the [[https://github.com/geekitude/dokuwiki-plugin-userhomepage/issues|GitHub issue tracker]] for reporting issues.

===== Discussion =====

Please use [[https://forum.dokuwiki.org/thread/11755|this forum thread]] or mails.