WEB-INF/lib/ttProjectHelper.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 import('ttTeamHelper');
  30 import('ttUserHelper');
  31
  32 // Class ttProjectHelper is used to help with project related tasks.
  33 class ttProjectHelper {
  34
  35   // getAssignedProjects - returns an array of assigned projects.
  36   static function getAssignedProjects($user_id)
  37   {
  38     global $user;
  39
  40     $result = array();
  41     $mdb2 = getConnection();
  42
  43     // Do a query with inner join to get assigned projects.
  44     $sql = "select p.id, p.name, p.tasks, upb.rate from tt_projects p".
  45       " inner join tt_user_project_binds upb on (upb.user_id = $user_id and upb.project_id = p.id and upb.status = 1)".
  46       " where p.group_id = ".$user->getGroup()." and p.status = 1 order by p.name";
  47     $res = $mdb2->query($sql);
  48     if (!is_a($res, 'PEAR_Error')) {
  49       while ($val = $res->fetchRow()) {
  50         $result[] = $val;
  51       }
  52     }
  53     return $result;
  54   }
  55
  56   // getRates - returns an array of project rates for user, including deassigned and deactivated projects.
  57   static function getRates($user_id)
  58   {
  59     global $user;
  60
  61     $result = array();
  62     $mdb2 = getConnection();
  63
  64     $sql = "select p.id, upb.rate from tt_projects p".
  65       " inner join tt_user_project_binds upb on (upb.user_id = $user_id and upb.project_id = p.id)".
  66       " where group_id = ".$user->getGroup();
  67     $res = $mdb2->query($sql);
  68     if (!is_a($res, 'PEAR_Error')) {
  69       while ($val = $res->fetchRow()) {
  70         $val['rate'] = str_replace('.', $user->decimal_mark, $val['rate']);
  71         $result[] = $val;
  72       }
  73     }
  74     return $result;
  75   }
  76
  77   // getProjects - returns an array of active and inactive projects in group.
  78   static function getProjects()
  79   {
  80     global $user;
  81
  82     $result = array();
  83     $mdb2 = getConnection();
  84
  85     $sql = "select id, name, tasks from tt_projects".
  86       " where group_id = ".$user->getGroup()." and (status = 0 or status = 1) order by name";
  87
  88     $res = $mdb2->query($sql);
  89     if (!is_a($res, 'PEAR_Error')) {
  90       while ($val = $res->fetchRow()) {
  91         $result[] = $val;
  92       }
  93     }
  94     return $result;
  95   }
  96
  97   // getProjectsForClient - returns an array of active and inactive projects in a group for a client.
  98   static function getProjectsForClient()
  99   {
 100     global $user;
 101
 102     $result = array();
 103     $mdb2 = getConnection();
 104
 105     $sql = "select p.id, p.name, p.tasks from tt_projects p".
 106       " inner join tt_client_project_binds cpb on (cpb.client_id = $user->client_id and cpb.project_id = p.id)".
 107       " where p.group_id = ".$user->getGroup()." and (p.status = 0 or p.status = 1)".
 108       " order by p.name";
 109
 110     $res = $mdb2->query($sql);
 111     if (!is_a($res, 'PEAR_Error')) {
 112       while ($val = $res->fetchRow()) {
 113         $result[] = $val;
 114       }
 115     }
 116     return $result;
 117   }
 118
 119
 120   // get - gets details of the project identified by its id.
 121   static function get($id)
 122   {
 123     global $user;
 124
 125     $mdb2 = getConnection();
 126
 127     $sql = "select id, name, description, status, tasks from tt_projects where id = $id and group_id = ".
 128             $user->getGroup()." and (status = 0 or status = 1)";
 129     $res = $mdb2->query($sql);
 130     if (!is_a($res, 'PEAR_Error')) {
 131       $val = $res->fetchRow();
 132           if ($val && $val['id'])
 133         return $val;
 134     }
 135     return false;
 136   }
 137
 138   // The getProjectByName looks up a project by name.
 139   static function getProjectByName($name) {
 140
 141     $mdb2 = getConnection();
 142     global $user;
 143
 144     $sql = "select id from tt_projects where group_id = ".
 145       $user->getGroup()." and name = ".$mdb2->quote($name).
 146       " and (status = 1 or status = 0)";
 147     $res = $mdb2->query($sql);
 148     if (!is_a($res, 'PEAR_Error')) {
 149       $val = $res->fetchRow();
 150       if ($val && $val['id'])
 151         return $val;
 152     }
 153     return false;
 154   }
 155
 156
 157   // delete - deletes things associated with a project and marks the project as deleted.
 158   static function delete($id) {
 159     global $user;
 160     $mdb2 = getConnection();
 161
 162     $group_id = $user->getGroup();
 163     $org_id = $user->org_id;
 164
 165     // Start with project itself. Reason: if the passed in project_id is bogus,
 166     // we'll fail right here and don't damage any other data.
 167
 168     // Mark project as deleted and remove associated tasks.
 169     $sql = "update tt_projects set status = NULL, tasks = NULL where id = $id and group_id = $group_id and org_id = $org_id";
 170     $affected = $mdb2->exec($sql);
 171     if (is_a($affected, 'PEAR_Error') || 0 == $affected)
 172       return false; // An error ocurred, or 0 rows updated.
 173
 174     // Delete user binds to this project.
 175     $sql = "delete from tt_user_project_binds where project_id = $id and group_id = $group_id and org_id = $org_id";
 176     $affected = $mdb2->exec($sql);
 177     if (is_a($affected, 'PEAR_Error'))
 178       return false;
 179
 180     // Delete task binds to this project.
 181     $sql = "delete from tt_project_task_binds where project_id = $id and group_id = $group_id and org_id = $org_id";
 182     $affected = $mdb2->exec($sql);
 183     if (is_a($affected, 'PEAR_Error'))
 184       return false;
 185
 186     return true;
 187   }
 188
 189   // insert function inserts a new project into database.
 190   static function insert($fields)
 191   {
 192     $mdb2 = getConnection();
 193
 194     $group_id = (int) $fields['group_id'];
 195     $org_id = (int) $fields['org_id'];
 196
 197     $name = $fields['name'];
 198     $description = $fields['description'];
 199     $users = $fields['users'];
 200     $tasks = $fields['tasks'];
 201     $comma_separated = implode(',', $tasks); // This is a comma-separated list of associated task ids.
 202     $status = $fields['status'];
 203
 204     $sql = "insert into tt_projects (group_id, org_id, name, description, tasks, status)
 205       values ($group_id, $org_id, ".$mdb2->quote($name).", ".$mdb2->quote($description).", ".$mdb2->quote($comma_separated).", ".$mdb2->quote($status).")";
 206     $affected = $mdb2->exec($sql);
 207     if (is_a($affected, 'PEAR_Error'))
 208       return false;
 209
 210     $last_id = 0;
 211     $sql = "select last_insert_id() as last_insert_id";
 212     $res = $mdb2->query($sql);
 213     $val = $res->fetchRow();
 214     $last_id = $val['last_insert_id'];
 215
 216     // Bind the project to users.
 217     $active_users = ttTeamHelper::getActiveUsers(array('getAllFields'=>true));
 218     foreach ($active_users as $u) {
 219       if(in_array($u['id'], $users)) {
 220         $sql = "insert into tt_user_project_binds (project_id, user_id, group_id, org_id, status, rate) values(
 221           $last_id, ".$u['id'].", $group_id, $org_id, 1, ".$u['rate'].")";
 222         $affected = $mdb2->exec($sql);
 223         if (is_a($affected, 'PEAR_Error'))
 224           return false;
 225       }
 226     }
 227
 228     // Bind the project to tasks in tt_project_task_binds table.
 229     $all_tasks = ttTeamHelper::getAllTasks($group_id);
 230     foreach ($all_tasks as $task) {
 231       if(in_array($task['id'], $tasks)) {
 232         $sql = "insert into tt_project_task_binds (project_id, task_id, group_id, org_id)".
 233           " values($last_id, ".$task['id'].", $group_id, $org_id)";
 234         $affected = $mdb2->exec($sql);
 235         if (is_a($affected, 'PEAR_Error'))
 236           return false;
 237       }
 238     }
 239
 240     return $last_id;
 241   }
 242
 243   // update function - updates the project in database.
 244   static function update($fields) {
 245     global $user;
 246     $mdb2 = getConnection();
 247
 248     $group_id = $user->getGroup();
 249     $org_id = $user->org_id;
 250     $project_id = $fields['id']; // Project we are updating.
 251     $name = $fields['name']; // Project name.
 252     $description = $fields['description']; // Project description.
 253     $users_to_bind = $fields['users']; // Users to bind with project.
 254     $tasks_to_bind = $fields['tasks']; // Tasks to bind with project.
 255     $status = $fields['status']; // Project status.
 256
 257     // Update records in tt_user_project_binds table.
 258     $sql = "select user_id, status from tt_user_project_binds where project_id = $project_id";
 259     $all_users = array();
 260     $users_to_update = array();
 261     $res2 = $mdb2->query($sql);
 262     while ($row = $res2->fetchRow()) {
 263       if(!in_array($row['user_id'], $users_to_bind)) {
 264         // Delete tt_user_project_binds record (safely).
 265         ttUserHelper::deleteBind($row['user_id'], $project_id);
 266       } elseif (!$row['status']) {
 267         // If we are here, status of the bind is not active. Memorize such users to update their bind status.
 268         $users_to_update[] = $row['user_id'];  // Users we need to update in tt_user_project_binds.
 269       }
 270       $all_users[] = $row['user_id']; // All users from tt_user_project_binds for project.
 271     }
 272     // Insert records.
 273     $users_to_add = array_diff($users_to_bind, $all_users); // Users missing from tt_user_project_binds, that we need to insert.
 274     if(count($users_to_add) > 0) {
 275       $sql = "select id, rate from tt_users where id in (".join(', ', $users_to_add).")";
 276       $res = $mdb2->query($sql);
 277       while ($row = $res->fetchRow()) {
 278         $user_rate[$row['id']] = $row['rate'];
 279       }
 280       foreach ($users_to_add as $id) {
 281         $sql = "insert into tt_user_project_binds (user_id, project_id, group_id, org_id, rate, status)".
 282           " values($id, $project_id, $group_id, $org_id, ".$user_rate[$id].", 1)";
 283         $affected = $mdb2->exec($sql);
 284         if (is_a($affected, 'PEAR_Error'))
 285           return false;
 286       }
 287     }
 288     // Update status (to active) in existing tt_user_project_binds records.
 289     if ($users_to_update) {
 290       $sql = "update tt_user_project_binds set status = 1 where project_id = $project_id and user_id in (".join(', ', $users_to_update).")";
 291       $affected = $mdb2->exec($sql);
 292       if (is_a($affected, 'PEAR_Error'))
 293         return false;
 294     }
 295     // End of updating tt_user_project_binds table.
 296
 297     // Update records in tt_project_task_binds table.
 298     // Obtain existing task binds.
 299     $existing_task_binds = array();
 300     $sql = "select task_id from tt_project_task_binds where project_id = $project_id";
 301     $res = $mdb2->query($sql);
 302     while ($val = $res->fetchRow()) {
 303       $existing_task_binds[] = $val['task_id'];
 304     }
 305     // Determine which task binds to delete and which ones to add.
 306     $task_binds_to_delete = array_diff($existing_task_binds, $tasks_to_bind);
 307     $task_binds_to_add = array_diff($tasks_to_bind, $existing_task_binds);
 308     foreach ($task_binds_to_delete as $task_id) {
 309       $sql = "delete from tt_project_task_binds where project_id = $project_id and task_id = $task_id";
 310       $affected = $mdb2->exec($sql);
 311       if (is_a($affected, 'PEAR_Error'))
 312         return false;
 313     }
 314     foreach ($task_binds_to_add as $task_id) {
 315       $sql = "insert into tt_project_task_binds (project_id, task_id, group_id, org_id)".
 316         " values($project_id, $task_id, $group_id, $org_id)";
 317       $affected = $mdb2->exec($sql);
 318       if (is_a($affected, 'PEAR_Error'))
 319         return false;
 320     }
 321     // End of updating tt_project_task_binds table.
 322
 323     // Update project name, description, tasks and status in tt_projects table.
 324     $comma_separated = implode(",", $tasks_to_bind); // This is a comma-separated list of associated task ids.
 325     $sql = "update tt_projects set name = ".$mdb2->quote($name).", description = ".$mdb2->quote($description).
 326            ", tasks = ".$mdb2->quote($comma_separated).", status = $status where id = $project_id and group_id = ".$user->getGroup();
 327     $affected = $mdb2->exec($sql);
 328     return (!is_a($affected, 'PEAR_Error'));
 329   }
 330
 331   /*
 332   // getAssignedUsers - returns an array of user ids assigned to a project.
 333   static function getAssignedUsers($project_id)
 334   {
 335         global $user;
 336
 337     $result = array();
 338     $mdb2 = getConnection();
 339
 340     // Do a query with inner join to get assigned users.
 341     $sql = "select id, name from tt_users u
 342       inner join tt_user_project_binds ub on (ub.user_id = u.id and ub.project_id = $project_id and ub.status = 1)";
 343     $res = $mdb2->query($sql);
 344     if (!is_a($res, 'PEAR_Error')) {
 345       while ($val = $res->fetchRow()) {
 346         $result[] = $val;
 347       }
 348     }
 349     return $result;
 350   }*/
 351 }