{{tag>dokuwiki plugin tagalerts todo}}
<WRAP hide>
== Tag Alerts ==
</WRAP>

====== Description ======

This plugin gives the possibility to activate different types of alerts for some specified tags (alerts are based on the same style than Dokuwiki's system messages: error, info, success or notification).

====== Basic usage ======

Simply add the tags (as a comma separated list) to the option corresponding to the wanted tag alert.
{{ info:logiciels:doku:plugins:tagalerts_basic_options_en.jpg?nolink |}}

Here is the result :
{{ info:logiciels:doku:plugins:tagalerts_basic_messages_en.jpg?nolink |}}

<WRAP center round info 60%>
  * A given tag should only be added to one alert type.
  * If more than one tag on a given page are supposed to throw the same alert, only the first one (in the option) will be signaled in the message.
</WRAP>

====== Personnalized alerts ======

It is possible to personnalize alerts according to the tag through the file ''.../conf/tagalerts.conf'' (you will have to create it or use [[doku>plugin:confmanager|the Confmanager plugin]]).

For example :
<code>
# blah blah blah
archive         This pages is marked as archived. It's content might be outdated.

</code>
{{ info:logiciels:doku:plugins:tagalerts_basic_messages_perso_en.jpg?nolink |}}

====== « Inline » alerts ======

Instead of throwing alert messages, the plugin can apply the corresponding style to the tag link itself :
{{ info:logiciels:doku:plugins:tagalerts_presentation_options_inline_en.jpg?nolink |}}

Wich gives this result :
{{ info:logiciels:doku:plugins:tagalerts_inline_en.jpg?nolink |}}

If there's a personnalized alert for a tag, it will be shown as a //tooltip// on mouseover :
{{ info:logiciels:doku:plugins:tagalerts_inline_perso_en.jpg?nolink |}}

===== Tooltip only =====

If you add a personnalized alert in ''.../conf/tagalerts.conf'' file withour adding the tag to one of the categories in plugin options, the alert will be added as a tooltip to the link but no style will be applied.