1<?php 2/** 3 * DokuWiki Plugin todo_list (Syntax Component) 4 * 5 * @license GPL 2 http://www.gnu.org/licenses/gpl-2.0.html 6 */ 7 8// must be run within Dokuwiki 9if(!defined('DOKU_INC')) die(); 10 11/** 12 * Class syntax_plugin_todo_list 13 */ 14class syntax_plugin_todo_list extends syntax_plugin_todo_todo { 15 16 /** 17 * @return string Syntax mode type 18 */ 19 public function getType() { 20 return 'substition'; 21 } 22 23 /** 24 * @return string Paragraph type 25 */ 26 public function getPType() { 27 return 'block'; 28 } 29 30 /** 31 * @return int Sort order - Low numbers go before high numbers 32 */ 33 public function getSort() { 34 return 250; 35 } 36 37 /** 38 * Connect lookup pattern to lexer. 39 * 40 * @param string $mode Parser mode 41 */ 42 public function connectTo($mode) { 43 $this->Lexer->addSpecialPattern('~~TODOLIST[^~]*~~', $mode, 'plugin_todo_list'); 44 } 45 46 /** 47 * Handle matches of the todolist syntax 48 * 49 * @param string $match The match of the syntax 50 * @param int $state The state of the handler 51 * @param int $pos The position in the document 52 * @param Doku_Handler $handler The handler 53 * @return array Data for the renderer 54 */ 55 public function handle($match, $state, $pos, Doku_Handler &$handler) { 56 57 $options = substr($match, 10, -2); // strip markup 58 $options = explode(' ', $options); 59 $data = array( 60 'header' => $this->getConf("Header"), 61 'completed' => 'all', 62 'assigned' => 'all', 63 'completeduserlist' => 'all', 64 'ns' => 'all', 65 'showdate' => $this->getConf("ShowdateList"), 66 'checkbox' => $this->getConf("Checkbox"), 67 'username' => $this->getConf("Username"), 68 ); 69 $allowedvalues = array('yes', 'no'); 70 foreach($options as $option) { 71 @list($key, $value) = explode(':', $option, 2); 72 switch($key) { 73 case 'header': // how should the header be rendered? 74 if(in_array($value, array('id', 'firstheader', 'none'))) { 75 $data['header'] = $value; 76 } 77 break; 78 case 'showdate': 79 if(in_array($value, $allowedvalues)) { 80 $data['showdate'] = ($value == 'yes'); 81 } 82 break; 83 case 'checkbox': // should checkbox be rendered? 84 if(in_array($value, $allowedvalues)) { 85 $data['checkbox'] = ($value == 'yes'); 86 } 87 break; 88 case 'completed': 89 if(in_array($value, $allowedvalues)) { 90 $data['completed'] = ($value == 'yes'); 91 } 92 break; 93 case 'username': // how should the username be rendered? 94 if(in_array($value, array('user', 'real', 'none'))) { 95 $data['username'] = $value; 96 } 97 break; 98 case 'assigned': 99 if(in_array($value, $allowedvalues)) { 100 $data['assigned'] = ($value == 'yes'); 101 break; 102 } 103 //assigned? 104 $data['assigned'] = explode(',', $value); 105 // @date 20140317 le: if check for logged in user, also check for logged in user email address 106 if( in_array( '@@USER@@', $data['assigned'] ) ) { 107 $data['assigned'][] = '@@MAIL@@'; 108 } 109 $data['assigned'] = array_map( array($this,"__todolistTrimUser"), $data['assigned'] ); 110 break; 111 case 'completeduser': 112 $data['completeduserlist'] = explode(',', $value); 113 // @date 20140317 le: if check for logged in user, also check for logged in user email address 114 if(in_array('@@USER@@', $data['completeduserlist'])) { 115 $data['completeduserlist'][] = '@@MAIL@@'; 116 } 117 $data['completeduserlist'] = array_map( array($this,"__todolistTrimUser"), $data['completeduserlist'] ); 118 break; 119 case 'ns': 120 $data['ns'] = $value; 121 break; 122 case 'startbefore': 123 list($data['startbefore'], $data['startignore']) = $this->analyseDate($value); 124 break; 125 case 'startafter': 126 list($data['startafter'], $data['startignore']) = $this->analyseDate($value); 127 break; 128 case 'duebefore': 129 list($data['duebefore'], $data['dueignore']) = $this->analyseDate($value); 130 break; 131 case 'dueafter': 132 list($data['dueafter'], $data['dueignore']) = $this->analyseDate($value); 133 break; 134 case 'completedbefore': 135 $data['completedbefore'] = $this->analyseDate($value)[0]; 136 break; 137 case 'completedafter': 138 $data['completedafter'] = $this->analyseDate($value)[0]; 139 break; 140 } 141 } 142 return $data; 143 } 144 145 /** 146 * Render xhtml output or metadata 147 * 148 * @param string $mode Renderer mode (supported modes: xhtml) 149 * @param Doku_Renderer $renderer The renderer 150 * @param array $data The data from the handler() function 151 * @return bool If rendering was successful. 152 */ 153 public function render($mode, Doku_Renderer &$renderer, $data) { 154 global $conf; 155 156 if($mode != 'xhtml') return false; 157 /** @var Doku_Renderer_xhtml $renderer */ 158 159 $opts['pattern'] = '/<todo([^>]*)>(.*)<\/todo[\W]*?>/'; //all todos in a wiki page 160 //TODO check if storing subpatterns doesn't cost too much resources 161 162 // search(&$data, $base, $func, $opts,$dir='',$lvl=1,$sort='natural') 163 search($todopages, $conf['datadir'], array($this, 'search_todos'), $opts); //browse wiki pages with callback to search_pattern 164 165 $todopages = $this->filterpages($todopages, $data); 166 167 $this->htmlTodoTable($renderer, $todopages, $data); 168 169 return true; 170 } 171 172 /** 173 * Custom search callback 174 * 175 * This function is called for every found file or 176 * directory. When a directory is given to the function it has to 177 * decide if this directory should be traversed (true) or not (false). 178 * Return values for files are ignored 179 * 180 * All functions should check the ACL for document READ rights 181 * namespaces (directories) are NOT checked (when sneaky_index is 0) as this 182 * would break the recursion (You can have an nonreadable dir over a readable 183 * one deeper nested) also make sure to check the file type (for example 184 * in case of lockfiles). 185 * 186 * @param array &$data - Reference to the result data structure 187 * @param string $base - Base usually $conf['datadir'] 188 * @param string $file - current file or directory relative to $base 189 * @param string $type - Type either 'd' for directory or 'f' for file 190 * @param int $lvl - Current recursion depht 191 * @param array $opts - option array as given to search() 192 * @return bool if this directory should be traversed (true) or not (false). Return values for files are ignored. 193 */ 194 public function search_todos(&$data, $base, $file, $type, $lvl, $opts) { 195 $item['id'] = pathID($file); //get current file ID 196 197 //we do nothing with directories 198 if($type == 'd') return true; 199 200 //only search txt files 201 if(substr($file, -4) != '.txt') return true; 202 203 //check ACL 204 if(auth_quickaclcheck($item['id']) < AUTH_READ) return false; 205 206 $wikitext = rawWiki($item['id']); //get wiki text 207 208 $item['count'] = preg_match_all($opts['pattern'], $wikitext, $matches); //count how many times appears the pattern 209 if(!empty($item['count'])) { //if it appears at least once 210 $item['matches'] = $matches; 211 $data[] = $item; 212 } 213 return true; 214 } 215 216 /** 217 * Expand assignee-placeholders 218 * 219 * @param $user String to be worked on 220 * @return expanded string 221 */ 222 private function __todolistExpandAssignees($user) { 223 global $USERINFO; 224 if($user == '@@USER@@' && !empty($_SERVER['REMOTE_USER'])) { //$INPUT->server->str('REMOTE_USER') 225 return $_SERVER['REMOTE_USER']; 226 } 227 // @date 20140317 le: check for logged in user email address 228 if( $user == '@@MAIL@@' && isset( $USERINFO['mail'] ) ) { 229 return $USERINFO['mail']; 230 } 231 return $user; 232 } 233 234 /** 235 * Trim input if it's a user 236 * 237 * @param $user String to be worked on 238 * @return trimmed string 239 */ 240 private function __todolistTrimUser($user) { 241 //placeholder (inspired by replacement-patterns - see https://www.dokuwiki.org/namespace_templates#replacement_patterns) 242 if( $user == '@@USER@@' || $user == '@@MAIL@@' ) { 243 return $user; 244 } 245 //user 246 return trim(ltrim($user, '@')); 247 } 248 249 /** 250 * filter the pages 251 * 252 * @param $todopages array pages with all todoitems 253 * @param $data array listing parameters 254 * @return array filtered pages 255 */ 256 private function filterpages($todopages, $data) { 257 global $ID; 258 $pages = array(); 259 // check if we should accept currant namespace+subnamespaces or only subnamespaces 260 $wildsubns = substr($data['ns'], -2) == '.:'; 261 $onlysubns = !$wildsubns && (substr($data['ns'], -1) == ':' || substr($data['ns'], -2) == ':.'); 262// $onlyns = $onlysubns && substr($data['ns'], -1) == '.'; 263 264 // if first char of ns is '.'replace it with current ns 265 if ($data['ns'][0] == '.') { 266 $data['ns'] = substr($ID, 0, strrpos($ID, ':')+1).ltrim($data['ns'], '.:'); 267 } 268 $data['ns'] = trim($data['ns'], '.:'); 269 $len = strlen($data['ns']); 270 271 foreach($todopages as $page) { 272 $parsepage = false; 273 274 if ($parsepage = $data['ns'] == 'all') { 275 // Always return the todo pages 276 } elseif ($data['ns'] == '/') { 277 // Only return the todo page if it's in the root namespace 278 $parsepage = strpos($page['id'], ':') === FALSE; 279 } elseif ($wildsubns) { 280 $p = strpos($page['id'].':', ':', $len+1); 281 $x = substr($page['id'], $len+1, $p-$len); 282 $parsepage = 0 === strpos($page['id'], rtrim($data['ns'].':'.$x, ':').':'); 283 } elseif ($onlysubns) { 284 $parsepage = 0 === strpos($page['id'], $data['ns'].':'); 285 } elseif ($parsepage = substr($page['id'], 0, $len) == $data['ns']) { 286 } 287 288 if ($parsepage) { 289 $todos = array(); 290 // contains 3 arrays: an array with complete matches and 2 arrays with subpatterns 291 foreach($page['matches'][1] as $todoindex => $todomatch) { 292 $todo = array_merge(array('todotitle' => trim($page['matches'][2][$todoindex]), 'todoindex' => $todoindex), $this->parseTodoArgs($todomatch), $data); 293 294 if($this->isRequestedTodo($todo)) { $todos[] = $todo; } 295 } 296 if(count($todos) > 0) { 297 $pages[] = array('id' => $page['id'], 'todos' => $todos); 298 } 299 } 300 } 301 return $pages; 302 } 303 304 305 306 /** 307 * Create html for table with todos 308 * 309 * @param Doku_Renderer_xhtml $R 310 * @param array $todopages 311 * @param array $data array with rendering options 312 */ 313 private function htmlTodoTable($R, $todopages, $data) { 314 $R->table_open(); 315 foreach($todopages as $page) { 316 if ($data['header']!='none') { 317 $R->tablerow_open(); 318 $R->tableheader_open(); 319 $R->internallink($page['id'], ($data['header']=='firstheader' ? p_get_first_heading($page['id']) : $page['id'])); 320 $R->tableheader_close(); 321 $R->tablerow_close(); 322 } 323 foreach($page['todos'] as $todo) { 324//echo "<pre>";var_dump($todo);echo "</pre>"; 325 $R->tablerow_open(); 326 $R->tablecell_open(); 327 $R->doc .= $this->createTodoItem($R, $page['id'], array_merge($todo, $data)); 328 $R->tablecell_close(); 329 $R->tablerow_close(); 330 } 331 } 332 $R->table_close(); 333 } 334 335 /** 336 * Check the conditions for adding a todoitem 337 * 338 * @param $data array the defined filters 339 * @param $checked bool completion status of task; true: finished, false: open 340 * @param $todouser string user username of user 341 * @return bool if the todoitem should be listed 342 */ 343 /** 344 * Check the conditions for adding a todoitem 345 * 346 * @param $data array the defined filters 347 * @param $checked bool completion status of task; true: finished, false: open 348 * @param $todouser string user username of user 349 * @return bool if the todoitem should be listed 350 */ 351 private function isRequestedTodo($data) { 352 //completion status 353 $condition1 = $data['completed'] === 'all' //all 354 || $data['completed'] === $data['checked']; //yes or no 355 356 // resolve placeholder in assignees 357 $requestedassignees = array(); 358 if(is_array($data['assigned'])) { 359 $requestedassignees = array_map( array($this,"__todolistExpandAssignees"), $data['assigned'] ); 360 } 361 //assigned 362 $condition2 = $condition2 363 || $data['assigned'] === 'all' //all 364 || (is_bool($data['assigned']) && $data['assigned'] == $data['todouser']); //yes or no 365 366 if (!$condition2 && is_array($data['assigned']) && is_array($data['todousers'])) 367 foreach($data['todousers'] as $todouser) { 368 if(in_array($todouser, $requestedassignees)) { $condition2 = true; break; } 369 } 370 371 //completed by 372 if($condition2 && is_array($data['completeduserlist'])) 373 $condition2 = in_array($data['completeduser'], $data['completeduserlist']); 374 375 //compare start/due dates 376 if($condition1 && $condition2) { 377 $condition3s = true; $condition3d = true; 378 if(isset($data['startbefore']) || isset($data['startafter'])) { 379 if(is_object($data['start'])) { 380 if($data['startignore'] != '!') { 381 if(isset($data['startbefore'])) { $condition3s = $condition3s && new DateTime($data['startbefore']) > $data['start']; } 382 if(isset($data['startafter'])) { $condition3s = $condition3s && new DateTime($data['startafter']) < $data['start']; } 383 } 384 } else { 385 if(!$data['startignore'] == '*') { $condition3s = false; } 386 if($data['startignore'] == '!') { $condition3s = false; } 387 } 388 } 389 390 if(isset($data['duebefore']) || isset($data['dueafter'])) { 391 if(is_object($data['due'])) { 392 if($data['dueignore'] != '!') { 393 if(isset($data['duebefore'])) { $condition3d = $condition3d && new DateTime($data['duebefore']) > $data['due']; } 394 if(isset($data['dueafter'])) { $condition3d = $condition3d && new DateTime($data['dueafter']) < $data['due']; } 395 } 396 } else { 397 if(!$data['dueignore'] == '*') { $condition3d = false; } 398 if($data['dueignore'] == '!') { $condition3d = false; } 399 } 400 } 401 $condition3 = $condition3s && $condition3d; 402 } 403 404 // compare completed date 405 $condition4 = true; 406 if(isset($data['completedbefore'])) { 407 $condition4 = $condition4 && new DateTime($data['completedbefore']) > $data['completeddate']; 408 } 409 if(isset($data['completedafter'])) { 410 $condition4 = $condition4 && new DateTime($data['completedafter']) < $data['completeddate']; 411 } 412 413 return $condition1 AND $condition2 AND $condition3 AND $condition4; 414 } 415 416 417 /** 418 * Analyse of relative/absolute Date and return an absolute date 419 * 420 * @param $date string absolute/relative value of the date to analyse 421 * @return array absolute date or actual date if $date is invalid 422 */ 423 private function analyseDate($date) { 424 $result = array($date, ''); 425 if(is_string($date)) { 426 if($date == '!') { 427 $result = array('', '!'); 428 } elseif ($date =='*') { 429 $result = array('', '*'); 430 } else { 431 if(substr($date, -1) == '*') { 432 $date = substr($date, 0, -1); 433 $result = array($date, '*'); 434 } 435 436 if(date('Y-m-d', strtotime($date)) == $date) { 437 $result[0] = $date; 438 } elseif(preg_match('/^[\+\-]\d+$/', $date)) { // check if we have a valid relative value 439 $newdate = date_create(date('Y-m-d')); 440 date_modify($newdate, $date . ' day'); 441 $result[0] = date_format($newdate, 'Y-m-d'); 442 } else { 443 $result[0] = date('Y-m-d'); 444 } 445 } 446 } else { $result[0] = date('Y-m-d'); } 447 448 return $result; 449 } 450 451 452} 453