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
  39     $sql = "select id, name, description, status from tt_tasks
  40       where id = $id and group_id = $user->group_id and (status = 0 or status = 1)";
  41     $res = $mdb2->query($sql);
  42
  43     if (!is_a($res, 'PEAR_Error')) {
  44       $val = $res->fetchRow();
  45           if ($val['id'] != '') {
  46         return $val;
  47       } else
  48         return false;
  49     }
  50     return false;
  51   }
  52
  53   // getAssignedProjects - returns an array of projects associatied with a task.
  54   static function getAssignedProjects($task_id)
  55   {
  56         global $user;
  57
  58     $result = array();
  59     $mdb2 = getConnection();
  60
  61     // Do a query with inner join to get assigned projects.
  62     $sql = "select p.id, p.name from tt_projects p
  63       inner join tt_project_task_binds ptb on (ptb.project_id = p.id and ptb.task_id = $task_id)
  64       where p.group_id = $user->group_id and p.status = 1 order by p.name";
  65     $res = $mdb2->query($sql);
  66     if (!is_a($res, 'PEAR_Error')) {
  67       while ($val = $res->fetchRow()) {
  68         $result[] = $val;
  69       }
  70     }
  71     return $result;
  72   }
  73
  74   // The getTaskByName looks up a task by name.
  75   static function getTaskByName($task_name) {
  76
  77     $mdb2 = getConnection();
  78     global $user;
  79
  80     $sql = "select id from tt_tasks where group_id = $user->group_id and name = ".
  81       $mdb2->quote($task_name)." and (status = 1 or status = 0)";
  82       $res = $mdb2->query($sql);
  83
  84       if (!is_a($res, 'PEAR_Error')) {
  85       $val = $res->fetchRow();
  86       if ($val['id'])
  87         return $val;
  88     }
  89     return false;
  90   }
  91
  92   // delete - deletes things associated with a task and marks the task as deleted.
  93   static function delete($task_id) {
  94     global $user;
  95
  96     $mdb2 = getConnection();
  97
  98     // Delete project binds to this task from tt_project_task_binds table.
  99     $sql = "delete from tt_project_task_binds where task_id = $task_id";
 100     $affected = $mdb2->exec($sql);
 101     if (is_a($affected, 'PEAR_Error'))
 102       return false;
 103
 104     // Delete project binds to this task from the tasks field in tt_projects table.
 105     // Get projects where tasks is not NULL.
 106     $sql = "select id, tasks from tt_projects where group_id = $user->group_id and tasks is not NULL";
 107     $res = $mdb2->query($sql);
 108     if (is_a($res, 'PEAR_Error'))
 109       return false;
 110     while ($val = $res->fetchRow()) {
 111       $project_id = $val['id'];
 112       $tasks = explode(',', $val['tasks']);
 113
 114       if (in_array($task_id, $tasks)) {
 115         // Remove task from array.
 116         unset($tasks[array_search($task_id, $tasks)]);
 117         $comma_separated = implode(',', $tasks); // This is a new comma-separated list of associated task ids.
 118
 119         // Re-bind the project to tasks.
 120         $sql = "update tt_projects set tasks = ".$mdb2->quote($comma_separated)." where id = $project_id";
 121         $affected = $mdb2->exec($sql);
 122         if (is_a($affected, 'PEAR_Error'))
 123           return false;
 124       }
 125     }
 126
 127     // Mark the task as deleted.
 128     $sql = "update tt_tasks set status = NULL where id = $task_id";
 129     $affected = $mdb2->exec($sql);
 130     return (!is_a($affected, 'PEAR_Error'));
 131   }
 132
 133  // insert function inserts a new task into database.
 134   static function insert($fields)
 135   {
 136     $mdb2 = getConnection();
 137
 138     $group_id = (int) $fields['group_id'];
 139     $org_id = (int) $fields['org_id'];
 140     $name = $fields['name'];
 141     $description = $fields['description'];
 142     $projects = $fields['projects'];
 143     $status = $fields['status'];
 144
 145     $sql = "insert into tt_tasks (group_id, org_id, name, description, status)
 146       values ($group_id, $org_id, ".$mdb2->quote($name).", ".$mdb2->quote($description).", ".$mdb2->quote($status).")";
 147     $affected = $mdb2->exec($sql);
 148     $last_id = 0;
 149     if (is_a($affected, 'PEAR_Error'))
 150       return false;
 151
 152     $sql = "select last_insert_id() as last_insert_id";
 153     $res = $mdb2->query($sql);
 154     $val = $res->fetchRow();
 155     $last_id = $val['last_insert_id'];
 156
 157     if (is_array($projects)) {
 158       foreach ($projects as $p_id) {
 159         // Insert task binds into tt_project_task_binds table.
 160         $sql = "insert into tt_project_task_binds (project_id, task_id, group_id, org_id)".
 161           " values($p_id, $last_id, $group_id, $org_id)";
 162         $affected = $mdb2->exec($sql);
 163         if (is_a($affected, 'PEAR_Error'))
 164           return false;
 165
 166         // Add task bind to the tasks field of the tt_projects table.
 167         $sql = "select tasks from tt_projects where id = $p_id";
 168         $res = $mdb2->query($sql);
 169         if (is_a($res, 'PEAR_Error'))
 170           return false;
 171
 172         $val = $res->fetchRow();
 173         $task_ids = $val['tasks'];
 174         if ($task_ids) {
 175           $task_ids .= ",$last_id";
 176           $task_ids = ttTaskHelper::sort($task_ids);
 177         } else
 178           $task_ids = $last_id;
 179
 180         $sql = "update tt_projects set tasks = ".$mdb2->quote($task_ids)." where id = $p_id";
 181         $affected = $mdb2->exec($sql);
 182         if (is_a($affected, 'PEAR_Error'))
 183           return false;
 184       }
 185     }
 186     return $last_id;
 187   }
 188
 189   // update function updates a task in the database.
 190   static function update($fields)
 191   {
 192     global $user;
 193     $mdb2 = getConnection();
 194
 195     $group_id = $user->getActiveGroup();
 196     $org_id = $user->org_id;
 197     $task_id = (int)$fields['task_id'];
 198     $name = $fields['name'];
 199     $description = $fields['description'];
 200     $status = $fields['status'];
 201     $projects = $fields['projects'];
 202
 203     $sql = "update tt_tasks set name = ".$mdb2->quote($name).", description = ".$mdb2->quote($description).
 204       ", status = $status where id = $task_id and group_id = $group_id";
 205     $affected = $mdb2->exec($sql);
 206     if (is_a($affected, 'PEAR_Error'))
 207       die($affected->getMessage());
 208
 209     // Insert task binds into tt_project_task_binds table.
 210     $sql = "delete from tt_project_task_binds where task_id = $task_id";
 211     $affected = $mdb2->exec($sql);
 212     if (is_a($affected, 'PEAR_Error'))
 213       die($affected->getMessage());
 214     if (count($projects) > 0)
 215       foreach ($projects as $p_id) {
 216         $sql = "insert into tt_project_task_binds (project_id, task_id, group_id, org_id)".
 217           " values($p_id, $task_id, $group_id, $org_id)";
 218         $affected = $mdb2->exec($sql);
 219         if (is_a($affected, 'PEAR_Error'))
 220           die($affected->getMessage());
 221       }
 222
 223     // Handle task binds in the tasks field of the tt_projects table.
 224     // We need to either delete or insert task id in all affected projects.
 225
 226     // Get all not deleted projects for group.
 227     $sql = "select id, tasks from tt_projects where group_id = $group_id and status is not NULL";
 228     $res = $mdb2->query($sql);
 229     if (is_a($res, 'PEAR_Error'))
 230       die($res->getMessage());
 231
 232     // Iterate through projects.
 233     while ($val = $res->fetchRow()) {
 234       $project_id = $val['id'];
 235       $task_ids = $val['tasks'];
 236       $task_arr = explode(',', $task_ids);
 237
 238       if (is_array($projects) && in_array($project_id, $projects)) {
 239         // Task needs to be available for this project.
 240         if (!in_array($task_id, $task_arr)) {
 241           if ($task_ids) {
 242             $task_ids .= ",$task_id";
 243             $task_ids = ttTaskHelper::sort($task_ids);
 244         } else
 245           $task_ids = $task_id;
 246
 247         $sql = "update tt_projects set tasks = ".$mdb2->quote($task_ids)." where id = $project_id";
 248         $affected = $mdb2->exec($sql);
 249         if (is_a($affected, 'PEAR_Error'))
 250           die($affected->getMessage());
 251         }
 252       } else {
 253         // Task needs to be removed from this project.
 254         if (in_array($task_id, $task_arr)) {
 255           // Remove task from array.
 256           unset($task_arr[array_search($task_id, $task_arr)]);
 257           $comma_separated = implode(",", $task_arr); // This is a comma-separated list of associated task ids.
 258
 259           // Re-bind the project to tasks.
 260           $sql = "update tt_projects set tasks = ".$mdb2->quote($comma_separated)." where id = $project_id";
 261           $affected = $mdb2->exec($sql);
 262           if (is_a($affected, 'PEAR_Error'))
 263             die($affected->getMessage());
 264         }
 265       }
 266     }
 267     return true;
 268   }
 269
 270   // sort function sorts task ids passed as comma-separated list by their name.
 271   static function sort($comma_separated) {
 272         // We can't sort an empty string.
 273         if (!$comma_separated)
 274           return $comma_separated;
 275
 276     $mdb2 = getConnection();
 277
 278         $sql = "select id, name from tt_tasks where id in ($comma_separated)";
 279     $res = $mdb2->query($sql);
 280     if (is_a($res, 'PEAR_Error'))
 281       die ($res->getMessage());
 282
 283     $task_arr = array();
 284     while ($val = $res->fetchRow()) {
 285       $task_arr[] = array('id'=>$val['id'],'name'=>$val['name']);
 286     }
 287     $task_arr = mu_sort($task_arr, 'name');
 288     $task_ids = array();
 289     for($i = 0; $i < count($task_arr); $i++) {
 290           $task_ids[] = $task_arr[$i]['id'];
 291     }
 292         $result = implode(',', $task_ids);
 293     return $result;
 294   }
 295 }