WEB-INF/lib/ttTaskHelper.class.php

   1 <?php
   2 // +----------------------------------------------------------------------+
   3 // | Anuko Time Tracker
   4 // +----------------------------------------------------------------------+
   5 // | Copyright (c) Anuko International Ltd. (https://www.anuko.com)
   6 // +----------------------------------------------------------------------+
   7 // | LIBERAL FREEWARE LICENSE: This source code document may be used
   8 // | by anyone for any purpose, and freely redistributed alone or in
   9 // | combination with other software, provided that the license is obeyed.
  10 // |
  11 // | There are only two ways to violate the license:
  12 // |
  13 // | 1. To redistribute this code in source form, with the copyright
  14 // |    notice or license removed or altered. (Distributing in compiled
  15 // |    forms without embedded copyright notices is permitted).
  16 // |
  17 // | 2. To redistribute modified versions of this code in *any* form
  18 // |    that bears insufficient indications that the modifications are
  19 // |    not the work of the original author(s).
  20 // |
  21 // | This license applies to this document only, not any other software
  22 // | that it may be combined with.
  23 // |
  24 // +----------------------------------------------------------------------+
  25 // | Contributors:
  26 // | https://www.anuko.com/time_tracker/credits.htm
  27 // +----------------------------------------------------------------------+
  28
  29 // Class ttTaskHelper is used to help with task related operations.
  30 class ttTaskHelper {
  31
  32   // get - gets details of a task identified by its id.
  33   static function get($id)
  34   {
  35     global $user;
  36
  37     $mdb2 = getConnection();
  38     $group_id = $user->getGroup();
  39     $org_id = $user->org_id;
  40
  41     $sql = "select id, name, description, status from tt_tasks
  42       where id = $id and group_id = $group_id and org_id = $org_id and (status = 0 or status = 1)";
  43     $res = $mdb2->query($sql);
  44
  45     if (!is_a($res, 'PEAR_Error')) {
  46       $val = $res->fetchRow();
  47           if ($val['id'] != '') {
  48         return $val;
  49       } else
  50         return false;
  51     }
  52     return false;
  53   }
  54
  55   // getAssignedProjects - returns an array of projects associatied with a task.
  56   static function getAssignedProjects($task_id)
  57   {
  58     global $user;
  59
  60     $result = array();
  61     $mdb2 = getConnection();
  62     $group_id = $user->getGroup();
  63     $org_id = $user->org_id;
  64
  65     // Do a query with inner join to get assigned projects.
  66     $sql = "select p.id, p.name from tt_projects p
  67       inner join tt_project_task_binds ptb on (ptb.project_id = p.id and ptb.task_id = $task_id)
  68       where p.group_id = $group_id and p.org_id = $org_id and p.status = 1 order by p.name";
  69     $res = $mdb2->query($sql);
  70     if (!is_a($res, 'PEAR_Error')) {
  71       while ($val = $res->fetchRow()) {
  72         $result[] = $val;
  73       }
  74     }
  75     return $result;
  76   }
  77
  78   // The getTaskByName looks up a task by name.
  79   static function getTaskByName($task_name) {
  80
  81     $mdb2 = getConnection();
  82     global $user;
  83
  84     $sql = "select id from tt_tasks where group_id = $user->group_id and name = ".
  85       $mdb2->quote($task_name)." and (status = 1 or status = 0)";
  86       $res = $mdb2->query($sql);
  87
  88       if (!is_a($res, 'PEAR_Error')) {
  89       $val = $res->fetchRow();
  90       if ($val['id'])
  91         return $val;
  92     }
  93     return false;
  94   }
  95
  96   // delete - deletes things associated with a task and marks the task as deleted.
  97   static function delete($task_id) {
  98     global $user;
  99
 100     $mdb2 = getConnection();
 101
 102     // Delete project binds to this task from tt_project_task_binds table.
 103     $sql = "delete from tt_project_task_binds where task_id = $task_id";
 104     $affected = $mdb2->exec($sql);
 105     if (is_a($affected, 'PEAR_Error'))
 106       return false;
 107
 108     // Delete project binds to this task from the tasks field in tt_projects table.
 109     // Get projects where tasks is not NULL.
 110     $sql = "select id, tasks from tt_projects where group_id = $user->group_id and tasks is not NULL";
 111     $res = $mdb2->query($sql);
 112     if (is_a($res, 'PEAR_Error'))
 113       return false;
 114     while ($val = $res->fetchRow()) {
 115       $project_id = $val['id'];
 116       $tasks = explode(',', $val['tasks']);
 117
 118       if (in_array($task_id, $tasks)) {
 119         // Remove task from array.
 120         unset($tasks[array_search($task_id, $tasks)]);
 121         $comma_separated = implode(',', $tasks); // This is a new comma-separated list of associated task ids.
 122
 123         // Re-bind the project to tasks.
 124         $sql = "update tt_projects set tasks = ".$mdb2->quote($comma_separated)." where id = $project_id";
 125         $affected = $mdb2->exec($sql);
 126         if (is_a($affected, 'PEAR_Error'))
 127           return false;
 128       }
 129     }
 130
 131     // Mark the task as deleted.
 132     $sql = "update tt_tasks set status = NULL where id = $task_id";
 133     $affected = $mdb2->exec($sql);
 134     return (!is_a($affected, 'PEAR_Error'));
 135   }
 136
 137  // insert function inserts a new task into database.
 138   static function insert($fields)
 139   {
 140     $mdb2 = getConnection();
 141
 142     $group_id = (int) $fields['group_id'];
 143     $org_id = (int) $fields['org_id'];
 144     $name = $fields['name'];
 145     $description = $fields['description'];
 146     $projects = $fields['projects'];
 147     $status = $fields['status'];
 148
 149     $sql = "insert into tt_tasks (group_id, org_id, name, description, status)
 150       values ($group_id, $org_id, ".$mdb2->quote($name).", ".$mdb2->quote($description).", ".$mdb2->quote($status).")";
 151     $affected = $mdb2->exec($sql);
 152     $last_id = 0;
 153     if (is_a($affected, 'PEAR_Error'))
 154       return false;
 155
 156     $sql = "select last_insert_id() as last_insert_id";
 157     $res = $mdb2->query($sql);
 158     $val = $res->fetchRow();
 159     $last_id = $val['last_insert_id'];
 160
 161     if (is_array($projects)) {
 162       foreach ($projects as $p_id) {
 163         // Insert task binds into tt_project_task_binds table.
 164         $sql = "insert into tt_project_task_binds (project_id, task_id, group_id, org_id)".
 165           " values($p_id, $last_id, $group_id, $org_id)";
 166         $affected = $mdb2->exec($sql);
 167         if (is_a($affected, 'PEAR_Error'))
 168           return false;
 169
 170         // Add task bind to the tasks field of the tt_projects table.
 171         $sql = "select tasks from tt_projects where id = $p_id";
 172         $res = $mdb2->query($sql);
 173         if (is_a($res, 'PEAR_Error'))
 174           return false;
 175
 176         $val = $res->fetchRow();
 177         $task_ids = $val['tasks'];
 178         if ($task_ids) {
 179           $task_ids .= ",$last_id";
 180           $task_ids = ttTaskHelper::sort($task_ids);
 181         } else
 182           $task_ids = $last_id;
 183
 184         $sql = "update tt_projects set tasks = ".$mdb2->quote($task_ids)." where id = $p_id";
 185         $affected = $mdb2->exec($sql);
 186         if (is_a($affected, 'PEAR_Error'))
 187           return false;
 188       }
 189     }
 190     return $last_id;
 191   }
 192
 193   // update function updates a task in the database.
 194   static function update($fields)
 195   {
 196     global $user;
 197     $mdb2 = getConnection();
 198
 199     $group_id = $user->getGroup();
 200     $org_id = $user->org_id;
 201     $task_id = (int)$fields['task_id'];
 202     $name = $fields['name'];
 203     $description = $fields['description'];
 204     $status = $fields['status'];
 205     $projects = $fields['projects'];
 206
 207     $sql = "update tt_tasks set name = ".$mdb2->quote($name).", description = ".$mdb2->quote($description).
 208       ", status = $status where id = $task_id and group_id = $group_id";
 209     $affected = $mdb2->exec($sql);
 210     if (is_a($affected, 'PEAR_Error'))
 211       die($affected->getMessage());
 212
 213     // Insert task binds into tt_project_task_binds table.
 214     $sql = "delete from tt_project_task_binds where task_id = $task_id";
 215     $affected = $mdb2->exec($sql);
 216     if (is_a($affected, 'PEAR_Error'))
 217       die($affected->getMessage());
 218     if (count($projects) > 0)
 219       foreach ($projects as $p_id) {
 220         $sql = "insert into tt_project_task_binds (project_id, task_id, group_id, org_id)".
 221           " values($p_id, $task_id, $group_id, $org_id)";
 222         $affected = $mdb2->exec($sql);
 223         if (is_a($affected, 'PEAR_Error'))
 224           die($affected->getMessage());
 225       }
 226
 227     // Handle task binds in the tasks field of the tt_projects table.
 228     // We need to either delete or insert task id in all affected projects.
 229
 230     // Get all not deleted projects for group.
 231     $sql = "select id, tasks from tt_projects where group_id = $group_id and status is not NULL";
 232     $res = $mdb2->query($sql);
 233     if (is_a($res, 'PEAR_Error'))
 234       die($res->getMessage());
 235
 236     // Iterate through projects.
 237     while ($val = $res->fetchRow()) {
 238       $project_id = $val['id'];
 239       $task_ids = $val['tasks'];
 240       $task_arr = explode(',', $task_ids);
 241
 242       if (is_array($projects) && in_array($project_id, $projects)) {
 243         // Task needs to be available for this project.
 244         if (!in_array($task_id, $task_arr)) {
 245           if ($task_ids) {
 246             $task_ids .= ",$task_id";
 247             $task_ids = ttTaskHelper::sort($task_ids);
 248         } else
 249           $task_ids = $task_id;
 250
 251         $sql = "update tt_projects set tasks = ".$mdb2->quote($task_ids)." where id = $project_id";
 252         $affected = $mdb2->exec($sql);
 253         if (is_a($affected, 'PEAR_Error'))
 254           die($affected->getMessage());
 255         }
 256       } else {
 257         // Task needs to be removed from this project.
 258         if (in_array($task_id, $task_arr)) {
 259           // Remove task from array.
 260           unset($task_arr[array_search($task_id, $task_arr)]);
 261           $comma_separated = implode(",", $task_arr); // This is a comma-separated list of associated task ids.
 262
 263           // Re-bind the project to tasks.
 264           $sql = "update tt_projects set tasks = ".$mdb2->quote($comma_separated)." where id = $project_id";
 265           $affected = $mdb2->exec($sql);
 266           if (is_a($affected, 'PEAR_Error'))
 267             die($affected->getMessage());
 268         }
 269       }
 270     }
 271     return true;
 272   }
 273
 274   // sort function sorts task ids passed as comma-separated list by their name.
 275   static function sort($comma_separated) {
 276         // We can't sort an empty string.
 277         if (!$comma_separated)
 278           return $comma_separated;
 279
 280     $mdb2 = getConnection();
 281
 282         $sql = "select id, name from tt_tasks where id in ($comma_separated)";
 283     $res = $mdb2->query($sql);
 284     if (is_a($res, 'PEAR_Error'))
 285       die ($res->getMessage());
 286
 287     $task_arr = array();
 288     while ($val = $res->fetchRow()) {
 289       $task_arr[] = array('id'=>$val['id'],'name'=>$val['name']);
 290     }
 291     $task_arr = mu_sort($task_arr, 'name');
 292     $task_ids = array();
 293     for($i = 0; $i < count($task_arr); $i++) {
 294           $task_ids[] = $task_arr[$i]['id'];
 295     }
 296         $result = implode(',', $task_ids);
 297     return $result;
 298   }
 299 }