{{tag>app dokuwiki extensions plugins}}

====== Gestion des extensions ======

Les différents plugins disponibles pour Dokuwiki sont disponibles à l'URL https://www.dokuwiki.org/plugins

Le dossier **lib/plugins** doit être accessible en écriture à utilisateur www-data pour pouvoir installer les plugins directement via l'interface d'administration. Sinon l’installation devra se faire manuellement.

^ Plugin         ^ Description                                  |
| sortablejs     | Fonction de trie sur les tableaux    | 
| Authorplugins  | Produit des statistiques sur les contributions apportées par chaque utilisateur. |
| numberof       | Comptabilise le nombre total de pages ou dans l'espace de nom indiqué |
| tag plugin     | Marquer les notes wiki avec des étiquettes (tags) |
| cloud plugin   | Créer des nuages avec les mots les plus utilisés ou les tags si "tag plugin" est installé.|
| autostart      | Redirige vers la page d'accueil de la catégorie (namespace) si elle existe. |
| Page Redirect  | Rediriger vers une autre page. |
| nspages        | générer des liens vers les catégories (namespaces) |


===== Comment =====

Permet de laisser des commentaires sur les pages sources du wiki. Les commentaires entre les balises **%%/*%%** et **%%*/%%** seront disponible en mode édition mais n’apparaîtront pas sur la page générée.

<code>
/* Le texte en commentaire ne sera pas affiché dans la page resultat */
</code> 

===== Authorplugin =====

<code>

Statistiques globales
<AUTHORSTATS>

Sur les 12 derniers mois
<AUTHORSTATS 12>
</code>

===== Numberof =====

Total des pages existantes:
<code>
{{NUMBEROFPAGES}}
</code>

Pour comptabiliser les pages dans une catégorie particulière (namespace):
<code>
{{NUMBEROFPAGES:sysadmin}}
</code>

Syntaxe identique pour les médias:
<code>
{{NUMBEROFMEDIAS}}
{{NUMBEROFMEDIAS:photos}}
</code>

<note>
Utiliser %%~~NOCACHE~~%% pour que la page soit générée systématiquement et que les compteurs restent exacts.
</note>

===== Page Redirect =====

Pour rediriger la page courante sur une page internet ou externe:

<code>
#REDIRECT namespace:start
</code>

===== tag =====

Les tags (étiquettes) sont ajoutées aux pages. On pourra ensuite rechercher, afficher les pages ayant les mêmes étiquettes.

Pour ajouter un ou plusieurs tags à la page courante:

<code>
{{tag>tag1 tag2 tag_n}}
</code>

<note>
Pour les mots composés, utiliser le caractère underscore: **tag_mot_compose**
</note>

===== Cloud =====

Générer un nuage avec les termes les plus utilisés
<code>
~~CLOUD~~
</code>

On peut spécifier le nombre de mots max (par défaut 30)
<code>
~~CLOUD:80~~
</code>

<note>
Il est possible de blacklister des mots. Il faut créer un fichier texte **./config/stopwords.txt** contenant un mot par ligne et se terminant par une ligne vide. 
</note>

Générer un nuage à partir des tags les plus utilisés:
<code>
~~TAGCLOUD~~
</code> 

===== nspages =====

Pour générer dans la page courante les liens des pages appartenant à la catégorie courante, aux sous-catégories etc
<code>
<nspages>
</code>

De nombreuses options existent. Ici on n'affiche pas les pages de la catégorie courante, on liste les sous catégories et on définit le texte de titre pour les sous-catégories:
<code>
<nspages -subns -nopages -textNS="Liste des sous-catégories disponibles:">
</code>

===== Références =====

  * https://www.dokuwiki.org/plugins
  * https://www.dokuwiki.org/plugin:authorstats
  * https://www.dokuwiki.org/plugin:numberof