====== Planifier des tâches à réaliser ======

<WRAP center round important 60%>
Le module [[doku>plugin:do|Do]] n'est plus installé et est remplacé par le module [[doku>plugin:todo|ToDo]].

<todo>Revoir le texte de la page pour le module ToDo
</todo>

</WRAP>


Le module [[doku>plugin:do|Do]] permet d'enregistrer des tâches à réaliser dans les pages du wiki. Les tâches peuvent être assignées à un utilisateur donné. Il est aussi possible de créer une liste des tâches à réaliser.

=====Insérer une tâche =====

Il suffit d'insérer ce code dans la page :
<code txt tache.txt>
  <do UTILISATEUR DATE>DESCRIPTION</do>
</code>
où

  * UTILISATEUR (information facultative) est l'identifiant de l'utilisateur à qui est assigné la tâche 
  * DATE (information facultative) est la date de réalisation au format ''AAAA-MM-JJ''
  * DESCRIPTION est le texte décrivant la tâche et qui doit être unique par page (2 tâches identiques dans la même page seront considérées comme une instance unique). 

On peut aussi utiliser le bouton de la barre d'outils de l'éditeur 
{{https://raw.githubusercontent.com/cosmocode/do/master/pix/toolbar.png?16x16&recache|button icon}} 
. Dans ce cas un formulaire permet de choisir la date et l'utilisateur concerné (la liste est fournie si le module [[doku>plugin:bureaucracy]] est installé).

==== Exemple ====
<WRAP group>
<WRAP half column>
<do>Ajouter des exemples en bas de page</do>
</WRAP>

<WRAP half column>
<code>
<do>Ajouter des exemples en bas de page</do>
</code>
</WRAP>
</WRAP>



===== Lister les tâches =====

La liste des tâches d'une catégorie (et de toute son arborescence) est obtenue par cette syntaxe :

<code txt liste.txt>
  {{dolist>NAMESPACE?id=ID&status=(DONE|UNDONE)&limit=COUNT&user=ASSIGNEE&creator=CREATOR}}
</code>

Les paramètres de la requête sont tous facultatifs après le ''?''.

^Paramètre        ^Description ^
|NAMESPACE   |Chemin complet de la catégorie à afficher |
|''id''      |identifiant de la page |
|''status''  |Valeur ''DONE'' ou ''UNDONE'' (fait ou à faire), si non spécifié tout est listé |
|''limit''   |Nombre maximum de tâches à afficher  |
|''user''    |Identifiant utilisateur de la personne affectée à  la tâche|
|''creator'' |Identifiant utilisateur de la personne ayant créée  la tâche |

===== Exemples =====
==== Dans une catégorie ====
Liste des tâches dans la catégorie ''wiki:logiciels:dokuwiki''
<code>
{{dolist>wiki:logiciels:dokuwiki}}
</code>
++++ Voir le tableau |
{{dolist>wiki:logiciels:dokuwiki}}
++++

==== Dans tout le Wiki ====



Liste des tâches dans la catégorie ''wiki'' :\\
<code>
{{dolist>wiki:}}
</code>
++++ Voir le tableau |
{{dolist>wiki:}}
++++


~~SNIPPET_O1768662366~~prive:fragments:pages_dans_ce_dossier~~
<WRAP center round box 95%>


++++ Voir la liste des pages de ce dossier |
<nspages -h1  -exclude -textPages="Pages dans ce dossier" -hideNoPages  -hideNoSubns -actualTitle=4 -nbCol=2>
++++

Retour [[.sommaire]]

</WRAP>
~~SNIPPET_C~~prive:fragments:pages_dans_ce_dossier~~