====== Do プラグイン ======

---- plugin ----
description: Do プラグインを使用すると、wiki ページ内に簡単なタスクを作成できます。
author     : Adrian Lang, Andreas Gohr, Dominik Eckelmann
email      : dokuwiki@cosmocode.de 
type       : syntax, action, helper
lastupdate : 2017-04-26
compatible : Frusterick Manners, !Elenor Of Tsort, !Detritus, !Hrun, !Ponder Stibbons
depends    : sqlite
conflicts  : 
similar    : 
tags       : task, list, todo

downloadurl: https://github.com/cosmocode/do/tarball/master
bugtracker : https://github.com/cosmocode/do/issues
sourcerepo : https://github.com/cosmocode/do
donationurl: 

securitywarning: 
screenshot_img: :plugin:do_plugin.png
----

Do プラグインを使用すると、wiki ページ内に簡単なタスクを作成できます。
タスクには担当者として他のユーザーを指定、期日を指定できます。
また、ページ内にタスクの一覧表示もできます。

[[http://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]

プラグインの文章とダウンロードは [[http://ickewiki.de/dokumentation/do|ICKEwiki.de]] にあります。

===== 構文 =====

二種類の構文があります。

==== タスク ====

''<do USER DATE>TEXT</do>''

TEXT という新しいタスクを作成し、必要に応じて USER を担当者、DATE を期日として指定します。
このためのツールバーボタンもあります。 


| USER  | 現在の認証バックエンドが認めたユーザーID   | 	+	| USER  | User id - bbi-Benutzername (rw, kw, tk, ...)    | -	| DATE  | ​''​yyyy-mm-dd'' 形式の日付   | 	+	| DATE  | ''​yyyy-mm-dd'' 形式の日付   | -	| TEXT  | タスクの説明。タスクの文章は、**ページ内で一意**でなければなりません。重複は同一タスク扱いです。  |

==== 一覧 ====

''%%{{dolist>NAMESPACE?id=ID&status=(DONE|UNDONE)&limit=COUNT&md5=MD5&user=ASSIGNEE&creator=CREATOR}}%%''

省略可能な抽出条件付きの名前空間内のタスク一覧

^項目 ^説明 ^
|NAMESPACE  |タスクを検索する名前空間 |
|''id''     |タスクを検索するページ |
|''status'' |有効値は ''DONE'' か ''UNDONE''。大文字と小文字を区別しない。 |
|''limit''  |表示項目の最大数。  |
|''md5''    |この MD5 値付きのタスクのみ表示 |
|''user''   |担当者のユーザーID  |
|''creator''|作成者のユーザーID   |

==== テンプレートにユーザーの未完のタスクを表示する  ====

テンプレートに次のコードを追加すると、現在のユーザーの未完のタスクのアイコンを表示できます：

<code php>
/** @var helper_plugin_do $do */
$do = plugin_load('helper', 'do');
if ($do) {
    echo $do->tpl_getUserTasksIconHTML();
}
</code>

未完のタスクがある場合アイコンをクリックすると、すべての未完のタスクの表がオーバーレイとして表示されます。

===== ツールバー =====

ツールバーボタン {{https://raw.githubusercontent.com/cosmocode/do/master/pix/toolbar.png|ボタンアイコン}} は担当者や期日を入力するダイアログを表示します。
期日は日付選択が表示されます。
[[plugin:bureaucracy|Bureaucracy]] プラグインがインストールされている場合、担当者の提案もダイアログ表示します。

===== デモ =====

[[http://ickewiki.de/dokumentation/do|ICKEwiki.de]] のデモを参照して下さい。