====== PagesIcon ======

===== Description =====

''pagesicon'' permet d'associer des icônes aux pages et aux médias.

===== Usage =====

Depuis une page, l'action dédiée permet de :

  * importer une icône principale
  * importer une vignette
  * supprimer l'icône courante

===== Configuration =====

Dans le gestionnaire de configuration :

  * ''icon_name'' : noms candidats pour l'icône principale, avec support de ''~pagename~''
  * ''icon_thumbnail_name'' : noms candidats pour la vignette
  * ''default_image'' : image par défaut fournie au helper quand on demande un fallback
  * ''icon_size'' : taille affichée en haut de page
  * ''extensions'' : extensions autorisées
  * ''show_on_top'' : affiche l'icône dans la page
  * ''show_as_favicon'' : utilise l'icône comme favicon
  * ''parent_fallback'' : héritage d'icône depuis les namespaces parents
  * ''link_icons'' : affiche une icône devant les liens internes

===== Helper =====

Le plugin expose un helper réutilisable par d'autres extensions.

Méthodes principales :

  * ''getPageIconId()``
  * ''getMediaIconId()``
  * ''getPageIconUrl()``
  * ''getMediaIconUrl()``
  * ''getDefaultIconUrl()``
  * ''notifyIconUpdated()``

===== Intégrations =====

Le plugin est réutilisé notamment par ''visualindex'', ''catmenu'' et ''randompagelinks''.

===== Héritage =====

Si une page ne possède pas d'icône propre, le plugin peut :

  * ne rien hériter
  * prendre l'icône du parent direct
  * prendre la première icône trouvée en remontant

===== Dépôt =====

[[https://github.com/Lortet/dokuwiki-plugin-pagesicon|dokuwiki-plugin-pagesicon]]