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.
11 // | There are only two ways to violate the license:
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).
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).
21 // | This license applies to this document only, not any other software
22 // | that it may be combined with.
24 // +----------------------------------------------------------------------+
26 // | https://www.anuko.com/time_tracker/credits.htm
27 // +----------------------------------------------------------------------+
29 // Class ttGroupHelper - contains helper functions that operate with groups.
30 // This is a planned replacement for ttTeamHelper as we move forward with subgroups.
33 // The getGroupName function returns group name.
34 static function getGroupName($group_id) {
35 $mdb2 = getConnection();
37 $sql = "select name from tt_groups where id = $group_id and (status = 1 or status = 0)";
38 $res = $mdb2->query($sql);
40 if (!is_a($res, 'PEAR_Error')) {
41 $val = $res->fetchRow();
47 // The getParentGroup determines a parent group for a given group.
48 static function getParentGroup($group_id) {
51 $mdb2 = getConnection();
53 $sql = "select parent_id from tt_groups where id = $group_id and org_id = $user->org_id and status = 1";
54 $res = $mdb2->query($sql);
56 if (!is_a($res, 'PEAR_Error')) {
57 $val = $res->fetchRow();
58 return $val['parent_id'];
63 // The getSubgroupByName obtain an immediate subgroup by name if one exists.
64 static function getSubgroupByName($name) {
67 $mdb2 = getConnection();
68 $parent_id = $user->getActiveGroup();
69 $org_id = $user->org_id;
71 $sql = "select id from tt_groups where parent_id = $parent_id and org_id = $org_id".
72 " and name = ".$mdb2->quote($name)." and status is not null";
73 $res = $mdb2->query($sql);
74 if (!is_a($res, 'PEAR_Error')) {
75 $val = $res->fetchRow();
76 if ($val && $val['id'])
82 // The insertSubgroup inserts a new subgroup in database.
83 static function insertSubgroup($fields) {
86 $mdb2 = getConnection();
87 $parent_id = $user->getActiveGroup();
88 $org_id = $user->org_id;
90 // TODO: inherit all attributes from the parent group, if not supplied.
91 $name = $fields['name'];
92 $description = $fields['description'];
95 $created_ip = $mdb2->quote($_SERVER['REMOTE_ADDR']);
97 $sql = "insert into tt_groups (parent_id, org_id, name, description, created, created_ip)".
98 " values($parent_id, $org_id, ".$mdb2->quote($name).", ".$mdb2->quote($description).", $created, $created_ip)";
99 $affected = $mdb2->exec($sql);
100 return (!is_a($affected, 'PEAR_Error'));
101 // TODO: design subgroup roles carefully. Perhaps roles are not to be touched in subgroups at all.