WEB-INF/lib/ttTeamHelper.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('ttUserHelper');
  30 import('DateAndTime');
  31 import('ttInvoiceHelper');
  32
  33 // Class ttTeamHelper - contains helper functions that operate with groups.
  34 class ttTeamHelper {
  35
  36   // The getUsersForClient obtains all active and inactive users in a group that are relevant to a client.
  37   static function getUsersForClient() {
  38     global $user;
  39     $mdb2 = getConnection();
  40
  41     $sql = "select u.id, u.name from tt_user_project_binds upb".
  42       " inner join tt_client_project_binds cpb on (upb.project_id = cpb.project_id and cpb.client_id = $user->client_id)".
  43       " inner join tt_users u on (u.id = upb.user_id)".
  44       " where (u.status = 1 or u.status = 0)".
  45       " group by u.id".
  46       " order by upper(u.name)";
  47     $res = $mdb2->query($sql);
  48     $user_list = array();
  49     if (is_a($res, 'PEAR_Error'))
  50       return false;
  51     while ($val = $res->fetchRow()) {
  52       $user_list[] = $val;
  53     }
  54     return $user_list;
  55   }
  56
  57   // The getActiveUsers obtains all active users in a given group.
  58   static function getActiveUsers($options = null) {
  59     global $user;
  60     global $i18n;
  61     $mdb2 = getConnection();
  62
  63     if (isset($options['getAllFields']))
  64       $sql = "select u.*, r.name as role_name, r.rank from tt_users u left join tt_roles r on (u.role_id = r.id) where u.group_id = $user->group_id and u.status = 1 order by upper(u.name)";
  65     else
  66       $sql = "select id, name from tt_users where group_id = $user->group_id and status = 1 order by upper(name)";
  67     $res = $mdb2->query($sql);
  68     $user_list = array();
  69     if (is_a($res, 'PEAR_Error'))
  70       return false;
  71     while ($val = $res->fetchRow()) {
  72       // Localize top manager role name, as it is not localized in db.
  73       if ($val['rank'] == 512)
  74         $val['role_name'] = $i18n->get('role.top_manager.label');
  75       $user_list[] = $val;
  76     }
  77
  78     if (isset($options['putSelfFirst'])) {
  79       // Put own entry at the front.
  80       $cnt = count($user_list);
  81       for($i = 0; $i < $cnt; $i++) {
  82         if ($user_list[$i]['id'] == $user->id) {
  83           $self = $user_list[$i]; // Found self.
  84           array_unshift($user_list, $self); // Put own entry at the front.
  85           array_splice($user_list, $i+1, 1); // Remove duplicate.
  86         }
  87       }
  88     }
  89     return $user_list;
  90   }
  91
  92   // The swapRolesWith swaps existing user role with that of another user.
  93   static function swapRolesWith($user_id) {
  94     global $user;
  95     $mdb2 = getConnection();
  96
  97     // Obtain role id for the user we are swapping ourselves with.
  98     $sql = "select u.id, u.role_id from tt_users u left join tt_roles r on (u.role_id = r.id) where u.id = $user_id and u.group_id = $user->group_id and u.status = 1 and r.rank < $user->rank";
  99     $res = $mdb2->query($sql);
 100     if (is_a($res, 'PEAR_Error'))
 101       return false;
 102     $val = $res->fetchRow();
 103     if (!$val['id'] || !$val['role_id'])
 104       return false;
 105
 106     $modified_part = ', modified = now(), modified_ip = '.$mdb2->quote($_SERVER['REMOTE_ADDR']).', modified_by = '.$mdb2->quote($user->id);
 107
 108     // Promote user.
 109     $sql = "update tt_users set role_id = $user->role_id".$modified_part." where id = $user_id and group_id = $user->group_id";
 110     $affected = $mdb2->exec($sql);
 111     if (is_a($affected, 'PEAR_Error')) return false;
 112
 113     // Demote self.
 114     $role_id = $val['role_id'];
 115     $sql = "update tt_users set role_id = $role_id".$modified_part." where id = $user->id and group_id = $user->group_id";
 116     $affected = $mdb2->exec($sql);
 117     if (is_a($affected, 'PEAR_Error')) return false;
 118
 119     return true;
 120   }
 121
 122   // The getUsersForSwap obtains all users a current user can swap roles with.
 123   static function getUsersForSwap() {
 124     global $user;
 125     $mdb2 = getConnection();
 126
 127     $sql = "select u.id, u.name, r.rank, r.rights from tt_users u left join tt_roles r on (u.role_id = r.id) where u.group_id = $user->group_id and u.status = 1 and r.rank < $user->rank order by upper(u.name)";
 128     $res = $mdb2->query($sql);
 129     $user_list = array();
 130     if (is_a($res, 'PEAR_Error'))
 131       return false;
 132     while ($val = $res->fetchRow()) {
 133       $isClient = in_array('track_own_time', explode(',', $val['rights'])) ? 0 : 1; // Clients do not have track_own_time right.
 134       if ($isClient)
 135         continue; // Skip adding clients.
 136       $user_list[] = $val;
 137     }
 138
 139     return $user_list;
 140   }
 141
 142   // The getUsers obtains all active and inactive (but not deleted) users in a group.
 143   static function getUsers() {
 144     global $user;
 145     $mdb2 = getConnection();
 146     $sql = "select id, name from tt_users where group_id = $user->group_id and (status = 1 or status = 0) order by upper(name)";
 147     $res = $mdb2->query($sql);
 148     $user_list = array();
 149     if (is_a($res, 'PEAR_Error'))
 150       return false;
 151     while ($val = $res->fetchRow()) {
 152       $user_list[] = $val;
 153     }
 154     return $user_list;
 155   }
 156
 157   // The getInactiveUsers obtains all inactive users in a group.
 158   static function getInactiveUsers($group_id, $all_fields = false) {
 159     $mdb2 = getConnection();
 160
 161     if ($all_fields)
 162       $sql = "select u.*, r.name as role_name from tt_users u left join tt_roles r on (u.role_id = r.id) where u.group_id = $group_id and u.status = 0 order by upper(u.name)";
 163     else
 164       $sql = "select id, name from tt_users where group_id = $group_id and status = 0 order by upper(name)";
 165     $res = $mdb2->query($sql);
 166     $result = array();
 167     if (!is_a($res, 'PEAR_Error')) {
 168       while ($val = $res->fetchRow()) {
 169         $result[] = $val;
 170       }
 171       return $result;
 172     }
 173     return false;
 174   }
 175
 176   // getActiveProjects - returns an array of active projects for a group.
 177   static function getActiveProjects($group_id)
 178   {
 179     $result = array();
 180     $mdb2 = getConnection();
 181
 182     $sql = "select id, name, description, tasks from tt_projects
 183       where group_id = $group_id and status = 1 order by upper(name)";
 184     $res = $mdb2->query($sql);
 185     $result = array();
 186     if (!is_a($res, 'PEAR_Error')) {
 187       while ($val = $res->fetchRow()) {
 188         $result[] = $val;
 189       }
 190     }
 191     return $result;
 192   }
 193
 194   // getInactiveProjects - returns an array of inactive projects for a group.
 195   static function getInactiveProjects($group_id)
 196   {
 197     $result = array();
 198     $mdb2 = getConnection();
 199
 200     $sql = "select id, name, description, tasks from tt_projects
 201       where group_id = $group_id and status = 0 order by upper(name)";
 202     $res = $mdb2->query($sql);
 203     $result = array();
 204     if (!is_a($res, 'PEAR_Error')) {
 205       while ($val = $res->fetchRow()) {
 206         $result[] = $val;
 207       }
 208     }
 209     return $result;
 210   }
 211
 212   // The getAllProjects obtains all projects in a group.
 213   static function getAllProjects($group_id, $all_fields = false) {
 214     $mdb2 = getConnection();
 215
 216     if ($all_fields)
 217       $sql = "select * from tt_projects where group_id = $group_id order by status, upper(name)";
 218     else
 219       $sql = "select id, name from tt_projects where group_id = $group_id order by status, upper(name)";
 220     $res = $mdb2->query($sql);
 221     $result = array();
 222     if (!is_a($res, 'PEAR_Error')) {
 223       while ($val = $res->fetchRow()) {
 224         $result[] = $val;
 225       }
 226       return $result;
 227     }
 228     return false;
 229   }
 230
 231   // getActiveTasks - returns an array of active tasks for a group.
 232   static function getActiveTasks($group_id)
 233   {
 234     $result = array();
 235     $mdb2 = getConnection();
 236
 237     $sql = "select id, name, description from tt_tasks where group_id = $group_id and status = 1 order by upper(name)";
 238     $res = $mdb2->query($sql);
 239     $result = array();
 240     if (!is_a($res, 'PEAR_Error')) {
 241       while ($val = $res->fetchRow()) {
 242         $result[] = $val;
 243       }
 244     }
 245     return $result;
 246   }
 247
 248   // getInactiveTasks - returns an array of inactive tasks for a group.
 249   static function getInactiveTasks($group_id)
 250   {
 251     $result = array();
 252     $mdb2 = getConnection();
 253
 254     $sql = "select id, name, description from tt_tasks
 255       where group_id = $group_id and status = 0 order by upper(name)";
 256     $res = $mdb2->query($sql);
 257     $result = array();
 258     if (!is_a($res, 'PEAR_Error')) {
 259       while ($val = $res->fetchRow()) {
 260         $result[] = $val;
 261       }
 262     }
 263     return $result;
 264   }
 265
 266   // The getAllTasks obtains all tasks in a group.
 267   static function getAllTasks($group_id, $all_fields = false) {
 268     $mdb2 = getConnection();
 269
 270     if ($all_fields)
 271       $sql = "select * from tt_tasks where group_id = $group_id order by status, upper(name)";
 272     else
 273       $sql = "select id, name from tt_tasks where group_id = $group_id order by status, upper(name)";
 274     $res = $mdb2->query($sql);
 275     $result = array();
 276     if (!is_a($res, 'PEAR_Error')) {
 277       while ($val = $res->fetchRow()) {
 278         $result[] = $val;
 279       }
 280       return $result;
 281     }
 282     return false;
 283   }
 284
 285   // getActiveRolesForUser - returns an array of relevant active roles for user with rank less than self.
 286   // "Relevant" means that client roles are filtered out if Client plugin is disabled.
 287   static function getActiveRolesForUser()
 288   {
 289     global $user;
 290     $result = array();
 291     $mdb2 = getConnection();
 292
 293     $sql = "select id, name, description, rank, rights from tt_roles where group_id = $user->group_id and rank < $user->rank and status = 1 order by rank";
 294     $res = $mdb2->query($sql);
 295     $result = array();
 296     if (!is_a($res, 'PEAR_Error')) {
 297       while ($val = $res->fetchRow()) {
 298         $val['is_client'] = in_array('track_own_time', explode(',', $val['rights'])) ? 0 : 1; // Clients do not have data entry right.
 299         if ($val['is_client'] && !$user->isPluginEnabled('cl'))
 300           continue; // Skip adding a client role.
 301         $result[] = $val;
 302       }
 303     }
 304     return $result;
 305   }
 306
 307   // getActiveRoles - returns an array of active roles for a group.
 308   static function getActiveRoles($group_id)
 309   {
 310     $result = array();
 311     $mdb2 = getConnection();
 312
 313     $sql = "select id, name, description, rank, rights from tt_roles where group_id = $group_id and status = 1 order by rank";
 314     $res = $mdb2->query($sql);
 315     $result = array();
 316     if (!is_a($res, 'PEAR_Error')) {
 317       while ($val = $res->fetchRow()) {
 318         $val['is_client'] = in_array('track_own_time', explode(',', $val['rights'])) ? 0 : 1; // Clients do not have track_own_time right.
 319         $result[] = $val;
 320       }
 321     }
 322     return $result;
 323   }
 324
 325   // getInactiveRoles - returns an array of inactive roles for a group.
 326   static function getInactiveRoles($group_id)
 327   {
 328     $result = array();
 329     $mdb2 = getConnection();
 330
 331     $sql = "select id, name, rank, description from tt_roles
 332       where group_id = $group_id and status = 0 order by rank";
 333     $res = $mdb2->query($sql);
 334     $result = array();
 335     if (!is_a($res, 'PEAR_Error')) {
 336       while ($val = $res->fetchRow()) {
 337         $result[] = $val;
 338       }
 339     }
 340     return $result;
 341   }
 342
 343   // getInactiveRolesForUser - returns an array of relevant active roles for user with rank less than self.
 344   // "Relevant" means that client roles are filtered out if Client plugin is disabled.
 345   static function getInactiveRolesForUser()
 346   {
 347     global $user;
 348     $result = array();
 349     $mdb2 = getConnection();
 350
 351     $sql = "select id, name, description, rank, rights from tt_roles where group_id = $user->group_id and rank < $user->rank and status = 0 order by rank";
 352     $res = $mdb2->query($sql);
 353     $result = array();
 354     if (!is_a($res, 'PEAR_Error')) {
 355       while ($val = $res->fetchRow()) {
 356         $val['is_client'] = in_array('track_own_time', explode(',', $val['rights'])) ? 0 : 1; // Clients do not have data entry right.
 357         if ($val['is_client'] && !$user->isPluginEnabled('cl'))
 358           continue; // Skip adding a client role.
 359         $result[] = $val;
 360       }
 361     }
 362     return $result;
 363   }
 364
 365   // The getActiveClients returns an array of active clients for a group.
 366   static function getActiveClients($group_id, $all_fields = false)
 367   {
 368     $result = array();
 369     $mdb2 = getConnection();
 370
 371     if ($all_fields)
 372       $sql = "select * from tt_clients where group_id = $group_id and status = 1 order by upper(name)";
 373     else
 374       $sql = "select id, name from tt_clients where group_id = $group_id and status = 1 order by upper(name)";
 375
 376     $res = $mdb2->query($sql);
 377     $result = array();
 378     if (!is_a($res, 'PEAR_Error')) {
 379       while ($val = $res->fetchRow()) {
 380         $result[] = $val;
 381       }
 382     }
 383     return $result;
 384   }
 385
 386   // The getInactiveClients returns an array of inactive clients for a group.
 387   static function getInactiveClients($group_id, $all_fields = false)
 388   {
 389     $result = array();
 390     $mdb2 = getConnection();
 391
 392     if ($all_fields)
 393       $sql = "select * from tt_clients where group_id = $group_id and status = 0 order by upper(name)";
 394     else
 395       $sql = "select id, name from tt_clients where group_id = $group_id and status = 0 order by upper(name)";
 396
 397     $res = $mdb2->query($sql);
 398     $result = array();
 399     if (!is_a($res, 'PEAR_Error')) {
 400       while ($val = $res->fetchRow()) {
 401         $result[] = $val;
 402       }
 403     }
 404     return $result;
 405   }
 406
 407   // The getAllClients obtains all clients in a group.
 408   static function getAllClients($group_id, $all_fields = false) {
 409     $mdb2 = getConnection();
 410
 411     if ($all_fields)
 412       $sql = "select * from tt_clients where group_id = $group_id order by status, upper(name)";
 413     else
 414       $sql = "select id, name from tt_clients where group_id = $group_id order by status, upper(name)";
 415
 416     $res = $mdb2->query($sql);
 417     $result = array();
 418     if (!is_a($res, 'PEAR_Error')) {
 419       while ($val = $res->fetchRow()) {
 420         $result[] = $val;
 421       }
 422       return $result;
 423     }
 424     return false;
 425   }
 426
 427   // The getActiveInvoices returns an array of active invoices for a group.
 428   static function getActiveInvoices($localizeDates = true)
 429   {
 430     global $user;
 431     $addPaidStatus = $user->isPluginEnabled('ps');
 432
 433     $result = array();
 434     $mdb2 = getConnection();
 435
 436     if ($user->isClient())
 437       $client_part = " and i.client_id = $user->client_id";
 438
 439     $sql = "select i.id, i.name, i.date, i.client_id, i.status, c.name as client_name from tt_invoices i
 440       left join tt_clients c on (c.id = i.client_id)
 441       where i.status = 1 and i.group_id = $user->group_id $client_part order by i.name";
 442     $res = $mdb2->query($sql);
 443     $result = array();
 444     if (!is_a($res, 'PEAR_Error')) {
 445       $dt = new DateAndTime(DB_DATEFORMAT);
 446       while ($val = $res->fetchRow()) {
 447         if ($localizeDates) {
 448           $dt->parseVal($val['date']);
 449           $val['date'] = $dt->toString($user->date_format);
 450         }
 451         if ($addPaidStatus)
 452           $val['paid'] = ttInvoiceHelper::isPaid($val['id']);
 453         $result[] = $val;
 454       }
 455     }
 456     return $result;
 457   }
 458
 459   // The getAllInvoices returns an array of all invoices for a group.
 460   static function getAllInvoices()
 461   {
 462     global $user;
 463
 464     $result = array();
 465     $mdb2 = getConnection();
 466
 467     $sql = "select * from tt_invoices where group_id = $user->group_id";
 468     $res = $mdb2->query($sql);
 469     $result = array();
 470     if (!is_a($res, 'PEAR_Error')) {
 471       $dt = new DateAndTime(DB_DATEFORMAT);
 472       while ($val = $res->fetchRow()) {
 473         $result[] = $val;
 474       }
 475     }
 476     return $result;
 477   }
 478
 479   // The getRecentInvoices returns an array of recent invoices (max 3) for a client.
 480   static function getRecentInvoices($group_id, $client_id)
 481   {
 482     global $user;
 483
 484     $result = array();
 485     $mdb2 = getConnection();
 486
 487     $sql = "select i.id, i.name from tt_invoices i
 488       left join tt_clients c on (c.id = i.client_id)
 489       where i.group_id = $group_id and i.status = 1 and c.id = $client_id
 490       order by i.id desc limit 3";
 491     $res = $mdb2->query($sql);
 492     $result = array();
 493     if (!is_a($res, 'PEAR_Error')) {
 494       $dt = new DateAndTime(DB_DATEFORMAT);
 495       while ($val = $res->fetchRow()) {
 496         $result[] = $val;
 497       }
 498     }
 499     return $result;
 500   }
 501
 502   // getUserToProjectBinds - obtains all user to project binds for a group.
 503   static function getUserToProjectBinds($group_id) {
 504     $mdb2 = getConnection();
 505
 506     $result = array();
 507     $sql = "select * from tt_user_project_binds where user_id in (select id from tt_users where group_id = $group_id) order by user_id, status, project_id";
 508     $res = $mdb2->query($sql);
 509     $result = array();
 510     if (!is_a($res, 'PEAR_Error')) {
 511       while ($val = $res->fetchRow()) {
 512         $result[] = $val;
 513       }
 514       return $result;
 515     }
 516     return false;
 517   }
 518
 519   // The getAllCustomFields obtains all custom fields in a group.
 520   static function getAllCustomFields($group_id) {
 521     $mdb2 = getConnection();
 522
 523     $sql = "select * from tt_custom_fields where group_id = $group_id order by status";
 524
 525     $res = $mdb2->query($sql);
 526     $result = array();
 527     if (!is_a($res, 'PEAR_Error')) {
 528       while ($val = $res->fetchRow()) {
 529         $result[] = $val;
 530       }
 531       return $result;
 532     }
 533     return false;
 534   }
 535
 536   // The getAllCustomFieldOptions obtains all custom field options in a group.
 537   static function getAllCustomFieldOptions($group_id) {
 538     $mdb2 = getConnection();
 539
 540     $sql = "select * from tt_custom_field_options where field_id in (select id from tt_custom_fields where group_id = $group_id) order by id";
 541
 542     $res = $mdb2->query($sql);
 543     $result = array();
 544     if (!is_a($res, 'PEAR_Error')) {
 545       while ($val = $res->fetchRow()) {
 546         $result[] = $val;
 547       }
 548       return $result;
 549     }
 550     return false;
 551   }
 552
 553   // The getCustomFieldLog obtains all custom field log entries for a group.
 554   static function getCustomFieldLog($group_id) {
 555     $mdb2 = getConnection();
 556
 557     $sql = "select * from tt_custom_field_log where field_id in (select id from tt_custom_fields where group_id = $group_id) order by id";
 558
 559     $res = $mdb2->query($sql);
 560     $result = array();
 561     if (!is_a($res, 'PEAR_Error')) {
 562       while ($val = $res->fetchRow()) {
 563         $result[] = $val;
 564       }
 565       return $result;
 566     }
 567     return false;
 568   }
 569
 570   // getFavReports - obtains all favorite reports for all users in a group.
 571   static function getFavReports($group_id) {
 572     $mdb2 = getConnection();
 573
 574     $result = array();
 575     $sql = "select * from tt_fav_reports where user_id in (select id from tt_users where group_id = $group_id)";
 576     $res = $mdb2->query($sql);
 577     $result = array();
 578     if (!is_a($res, 'PEAR_Error')) {
 579       while ($val = $res->fetchRow()) {
 580         $result[] = $val;
 581       }
 582       return $result;
 583     }
 584     return false;
 585   }
 586
 587   // getExpenseItems - obtains all expense items for all users in a group.
 588   static function getExpenseItems($group_id) {
 589     $mdb2 = getConnection();
 590
 591     $result = array();
 592     $sql = "select * from tt_expense_items where user_id in (select id from tt_users where group_id = $group_id)";
 593     $res = $mdb2->query($sql);
 594     $result = array();
 595     if (!is_a($res, 'PEAR_Error')) {
 596       while ($val = $res->fetchRow()) {
 597         $result[] = $val;
 598       }
 599       return $result;
 600     }
 601     return false;
 602   }
 603
 604   // getPredefinedExpenses - obtains predefined expenses for a group.
 605   static function getPredefinedExpenses($group_id) {
 606     global $user;
 607     $replaceDecimalMark = ('.' != $user->decimal_mark);
 608
 609     $mdb2 = getConnection();
 610
 611     $result = array();
 612     $sql = "select id, name, cost from tt_predefined_expenses where group_id = $group_id";
 613     $res = $mdb2->query($sql);
 614     $result = array();
 615     if (!is_a($res, 'PEAR_Error')) {
 616       while ($val = $res->fetchRow()) {
 617         if ($replaceDecimalMark)
 618           $val['cost'] = str_replace('.', $user->decimal_mark, $val['cost']);
 619         $result[] = $val;
 620       }
 621       return $result;
 622     }
 623     return false;
 624   }
 625
 626   // getNotifications - obtains notification descriptions for a group.
 627   static function getNotifications($group_id) {
 628     $mdb2 = getConnection();
 629
 630     $result = array();
 631     $sql = "select c.id, c.cron_spec, c.email, c.report_condition, fr.name from tt_cron c
 632       left join tt_fav_reports fr on (fr.id = c.report_id)
 633       where c.group_id = $group_id and c.status = 1 and fr.status = 1";
 634     $res = $mdb2->query($sql);
 635     $result = array();
 636     if (!is_a($res, 'PEAR_Error')) {
 637       while ($val = $res->fetchRow()) {
 638         $result[] = $val;
 639       }
 640       return $result;
 641     }
 642     return false;
 643   }
 644
 645   // getMonthlyQuotas - obtains monthly quotas for a group.
 646   static function getMonthlyQuotas($group_id) {
 647     $mdb2 = getConnection();
 648
 649     $result = array();
 650     $sql = "select year, month, minutes from tt_monthly_quotas where group_id = $group_id";
 651     $res = $mdb2->query($sql);
 652     $result = array();
 653     if (!is_a($res, 'PEAR_Error')) {
 654       while ($val = $res->fetchRow()) {
 655         $result[] = $val;
 656       }
 657       return $result;
 658     }
 659     return false;
 660   }
 661
 662   // The getInactiveGroups is a maintenance function that returns an array of inactive group ids (max 100).
 663   static function getInactiveGroups() {
 664     $inactive_groups = array();
 665     $mdb2 = getConnection();
 666
 667     // Get all group ids for groups created or modified more than 1 year ago.
 668     $ts = $mdb2->quote(date('Y-m-d', strtotime('-1 year')));
 669     $sql =  "select id from tt_groups where created < $ts and (modified is null or modified < $ts) order by id";
 670     $res = $mdb2->query($sql);
 671
 672     $count = 0;
 673     if (!is_a($res, 'PEAR_Error')) {
 674       while ($val = $res->fetchRow()) {
 675         $group_id = $val['id'];
 676         if (ttTeamHelper::isGroupActive($group_id) == false) {
 677           $count++;
 678           $inactive_groups[] = $group_id;
 679           // Limit the array size for perfomance by allowing this operation on small chunks only.
 680           if ($count >= 100) break;
 681         }
 682       }
 683       return $inactive_groups;
 684     }
 685     return false;
 686   }
 687
 688   // The isGroupActive determines if a group is using Time Tracker or abandoned it.
 689   static function isGroupActive($group_id) {
 690     $mdb2 = getConnection();
 691
 692     $count = 0;
 693     $ts = date('Y-m-d', strtotime('-2 years'));
 694     $sql = "select count(*) as cnt from tt_log where group_id = $group_id and created > '$ts'";
 695     $res = $mdb2->query($sql);
 696     if (!is_a($res, 'PEAR_Error')) {
 697       if ($val = $res->fetchRow()) {
 698         $count = $val['cnt'];
 699       }
 700     }
 701
 702     if ($count == 0)
 703       return false;  // No time entries for the last 2 years.
 704
 705     if ($count <= 5) {
 706       // We will consider a group inactive if it has 5 or less time entries made more than 1 year ago.
 707       $count_last_year = 0;
 708       $ts = date('Y-m-d', strtotime('-1 year'));
 709       $sql = "select count(*) as cnt from tt_log where group_id = $group_id and created > '$ts'";
 710       $res = $mdb2->query($sql);
 711       if (!is_a($res, 'PEAR_Error')) {
 712         if ($val = $res->fetchRow()) {
 713           $count_last_year = $val['cnt'];
 714         }
 715         if ($count_last_year == 0)
 716           return false;  // No time entries for the last year and only a few entries before that.
 717       }
 718     }
 719     return true;
 720   }
 721
 722   // The delete function permanently deletes all data for a group.
 723   static function delete($group_id) {
 724     $mdb2 = getConnection();
 725
 726     // Delete users.
 727     $sql = "select id from tt_users where group_id = $group_id";
 728     $res = $mdb2->query($sql);
 729     if (is_a($res, 'PEAR_Error')) return false;
 730     while ($val = $res->fetchRow()) {
 731       $user_id = $val['id'];
 732       if (!ttUserHelper::delete($user_id)) return false;
 733     }
 734
 735     // Delete tasks.
 736     if (!ttTeamHelper::deleteTasks($group_id)) return false;
 737
 738     // Delete client to project binds.
 739     $sql = "delete from tt_client_project_binds where client_id in (select id from tt_clients where group_id = $group_id)";
 740     $affected = $mdb2->exec($sql);
 741     if (is_a($affected, 'PEAR_Error')) return false;
 742
 743     // Delete projects.
 744     $sql = "delete from tt_projects where group_id = $group_id";
 745     $affected = $mdb2->exec($sql);
 746     if (is_a($affected, 'PEAR_Error')) return false;
 747
 748     // Delete clients.
 749     $sql = "delete from tt_clients where group_id = $group_id";
 750     $affected = $mdb2->exec($sql);
 751     if (is_a($affected, 'PEAR_Error')) return false;
 752
 753     // Delete invoices.
 754     $sql = "delete from tt_invoices where group_id = $group_id";
 755     $affected = $mdb2->exec($sql);
 756     if (is_a($affected, 'PEAR_Error')) return false;
 757
 758     // Delete custom fields.
 759     if (!ttTeamHelper::deleteCustomFields($group_id)) return false;
 760
 761     // Delete roles.
 762     $sql = "delete from tt_roles where group_id = $group_id";
 763     $affected = $mdb2->exec($sql);
 764     if (is_a($affected, 'PEAR_Error')) return false;
 765
 766     // Delete group.
 767     $sql = "delete from tt_groups where id = $group_id";
 768     $affected = $mdb2->exec($sql);
 769     if (is_a($affected, 'PEAR_Error')) return false;
 770
 771     return true;
 772   }
 773
 774   // The deleteTasks deletes all tasks and task binds for an inactive group.
 775   static function deleteTasks($group_id) {
 776     $mdb2 = getConnection();
 777     $sql = "select id from tt_tasks where group_id = $group_id";
 778     $res = $mdb2->query($sql);
 779     if (is_a($res, 'PEAR_Error')) return false;
 780
 781     while ($val = $res->fetchRow()) {
 782
 783       // Delete task binds.
 784       $task_id = $val['id'];
 785       $sql = "delete from tt_project_task_binds where task_id = $task_id";
 786       $affected = $mdb2->exec($sql);
 787       if (is_a($affected, 'PEAR_Error')) return false;
 788
 789       // Delete task.
 790       $sql = "delete from tt_tasks where id = $task_id";
 791       $affected = $mdb2->exec($sql);
 792       if (is_a($affected, 'PEAR_Error')) return false;
 793     }
 794
 795     return true;
 796   }
 797
 798   // The deleteCustomFields cleans up tt_custom_field_log, tt_custom_field_options and tt_custom_fields tables for an inactive group.
 799   static function deleteCustomFields($group_id) {
 800     $mdb2 = getConnection();
 801     $sql = "select id from tt_custom_fields where group_id = $group_id";
 802     $res = $mdb2->query($sql);
 803     if (is_a($res, 'PEAR_Error')) return false;
 804
 805     while ($val = $res->fetchRow()) {
 806       $field_id = $val['id'];
 807
 808       // Clean up tt_custom_field_log.
 809       $sql = "delete from tt_custom_field_log where field_id = $field_id";
 810       $affected = $mdb2->exec($sql);
 811       if (is_a($affected, 'PEAR_Error')) return false;
 812
 813       // Clean up tt_custom_field_options.
 814       $sql = "delete from tt_custom_field_options where field_id = $field_id";
 815       $affected = $mdb2->exec($sql);
 816       if (is_a($affected, 'PEAR_Error')) return false;
 817
 818       // Delete custom field.
 819       $sql = "delete from tt_custom_fields where id = $field_id";
 820       $affected = $mdb2->exec($sql);
 821       if (is_a($affected, 'PEAR_Error')) return false;
 822     }
 823
 824     return true;
 825   }
 826 }