Commit ab68f53348c9149c917087a77063ffed6a6b8c2d

Authored by rob
1 parent 6a12010c

Replaced by classes in /lib/groups/ directory


git-svn-id: https://kt-dms.svn.sourceforge.net/svnroot/kt-dms/trunk@417 c91229c3-7414-0410-bfa2-8a42b809f60b
lib/administration/GroupManager.inc deleted
1   -<?php
2   -/**
3   - * $Id: GroupManager.inc
4   - *
5   - * Performs group administration tasks- this includes create, remove, update
6   - * as well as addGroupToUnit and removeGroupFromUnit ..etc
7   - *
8   - * @version $Revision: 1.0
9   - * @author Mukhtar Dharsey
10   - * @package lib.administration
11   - */
12   -
13   -// group management
14   - class GroupManager
15   - {
16   -
17   - /**
18   - *
19   - * Adds a new group
20   - *
21   - * @param name
22   - * name of new group
23   - * @return boolean
24   - * true if the addition was successful, else false.
25   - */
26   -
27   - function createGroup($name) {
28   - global $default;
29   -
30   - $sql = new Owl_DB;
31   -
32   -
33   - // check that the group name is unique
34   - $query = "SELECT name FROM $default->owl_groups_table WHERE name = '" . $name . "'";
35   - $sql->query($query);
36   - $rows = $sql->num_rows($sql);
37   -
38   - if ($rows > 0)
39   - {
40   - // duplicate username
41   - $default->errorMessage = "GroupManager::The Group name " . $name . " is already in use, please choose another one";
42   - $default->log->debug($default->errorMessage);
43   - return false;
44   - }
45   - // insert the user
46   - $query = "INSERT INTO $default->owl_groups_table (name) VALUES ('" . $name . "')";
47   -
48   - $result = $sql->query($query);
49   -
50   - if(!'result')
51   - {
52   - $default->log->debug( "GroupManager::New Group Addition Unsuccessful!<br>");
53   - return false;
54   - }
55   - else
56   - {
57   - $default->log->debug ("GroupManager::New Group added Successfully!<br>");
58   - return true;
59   - }
60   -
61   -
62   -
63   -}
64   -
65   - /**
66   - * Removes a group from the groups table as well as from the groups_units_link table
67   - *
68   - * @param groupID
69   - * The id of the group to be deleted
70   - * @return boolean
71   - * True if the deletion was successful, else false if not or nonexistant.
72   - */
73   - function removeGroup($groupID)
74   - {
75   - global $default;
76   - // create a connection
77   - $sql = new Owl_DB;
78   -
79   - //do validation that userid exists
80   - $query = "SELECT * FROM $default->owl_groups_table WHERE id = '" . $groupID ."'";
81   - $result = $sql->query($query);
82   - $row = $sql->num_rows($result);
83   -
84   - // check if result was found..0 if not
85   - if($row == 0)
86   - {
87   - $default->log->debug("GroupManager::Group does not exist in the database<br>");
88   - return false;
89   - }
90   -
91   - //if user id exists delete it from the users table
92   - $query = "DELETE FROM $default->owl_groups_table WHERE id = $groupID";
93   - $result = $sql->query($query);
94   -
95   - if(!'result')
96   - {
97   - $default->log->debug("GroupManager::Deletion unsuccessful<br>");
98   - return false;
99   - }
100   - else
101   - {
102   - $default->log->debug ("GroupManager::Deletion from user table Successful<br>");
103   - //check if belongs to group
104   -
105   - $result= $this->removeGroupFromUnit($groupID);
106   - return true;
107   - }
108   -
109   -
110   -
111   - }
112   -
113   - /**
114   - * Updates groups details ..ie rename the group
115   - *
116   - * @param groupID
117   - * the group which is to be renamed
118   - * @param name
119   - * new name of the group
120   - * @return boolean
121   - * true if the addition was successful, else false.
122   - */
123   - function updateGroup($groupID, $name)
124   - {
125   - global $default;
126   - // create a connection
127   - $sql = new Owl_DB;
128   -
129   - //do validation that userid exists
130   - $query = "SELECT * FROM $default->owl_groups_table WHERE id = $groupID";
131   - $result = $sql->query($query);
132   - $row = $sql->num_rows($result);
133   -
134   - //if row = 0 ...then no entry was found..so return false
135   - if($row == 0)
136   - {
137   - $default->log->debug("GroupManager::Group does not exist in the database<br>");
138   - return false;
139   - }
140   -
141   - //if user id exists update all info into the users table
142   - $query = "UPDATE $default->owl_groups_table SET name = '" . $name . "' WHERE id = $groupID " ;
143   -
144   - $result = $sql->query($query);
145   -
146   -
147   - // error checking to see if success
148   - if(!'result')
149   - {
150   - $default->log->debug("GroupManager::Not Updated");
151   - return false;
152   - }
153   - else
154   - {
155   - $default->log->debug("GroupManager::Update Successful<br>");
156   - return true;
157   - }
158   - }
159   -
160   - /**
161   - * Returns an array of all the groups
162   - *
163   - * @return array
164   - * An array of groups
165   - */
166   - function listGroups()
167   - {
168   -
169   - global $default;
170   - $groups = array ();
171   - $i = 0;
172   - // create a connection
173   - $sql = new Owl_DB;
174   -
175   - //Get list of all the usernames
176   - $query = "SELECT name FROM $default->owl_groups_table";
177   - $result = $sql->query($query);
178   - $row = $sql->num_rows($result);
179   -
180   - //error checking
181   - if($row == 0)
182   - {
183   - $default->log->debug("GroupManager::No users in table");
184   - return false;
185   - }
186   -
187   - //store in array
188   - while($sql->next_record())
189   - {
190   - $groups["$i"] = array("name" => $sql->f("name"));
191   - $i++;
192   - }
193   -
194   - //return an array of the groups
195   - return $groups;
196   -
197   - }
198   -
199   - /**
200   - *
201   - * Adds a group to a unit NB: Group belongs to 1 unit only
202   - *
203   - * @param groupID
204   - * The ID of the group to add the user to
205   - * @param unitID
206   - * The Id of the unit to add to
207   - * @return boolean
208   - * True if the addition was successful, else false if not or nonexistant.
209   - */
210   - function addGroupToUnit($groupID,$unitID)
211   - {
212   - global $default;
213   - // create a connection
214   - $sql = new Owl_DB;
215   -
216   - //do validation that groupid exists
217   - $query = "SELECT * FROM $default->owl_groups_units_table WHERE group_id = $groupID";
218   - $result = $sql->query($query);
219   - $row = $sql->num_rows($result);
220   -
221   - // if it does exist return false..already there
222   - if($row >= 1)
223   - {
224   - $default->log->debug("GroupManager::Group already belongs to a unit<br>");
225   - return false;
226   - }
227   -
228   - //add user to the table
229   - $query = "INSERT INTO $default->owl_groups_units_table (group_id,unit_id) VALUES($groupID,$unitID)";
230   - $result = $sql->query($query);
231   -
232   - if(!'result')
233   - {
234   - $default->log->debug("GroupManager::Insertion into groups_units table unsuccessful<br>");
235   - return false;
236   - }
237   - else
238   - {
239   - $default->log->debug("GroupManager::Insertion into groups_units table Successful<br>");
240   - return true;
241   - }
242   -
243   - }
244   -
245   -
246   - /**
247   - * Removes a group from a unit NB: Group can only belong to 1 unit
248   - *
249   - * @param groupID
250   - * The ID of the group be removed from a unit
251   -
252   - * @return boolean
253   - * True if the deletion was successful, else false if not or nonexistant.
254   - */
255   - function removeGroupFromUnit($groupID)
256   - {
257   - global $default;
258   - // create a connection
259   - $sql = new Owl_DB;
260   -
261   - //do validation that groupid exists
262   - $query = "SELECT * FROM $default->owl_groups_units_table WHERE group_id = $groupID";
263   - $result = $sql->query($query);
264   - $row = $sql->num_rows($result);
265   -
266   - // check if result was found..0 if not
267   - if($row == 0)
268   - {
269   - $default->log->debug("GroupManager::Group does not exist in the database<br>");
270   - return false;
271   - }
272   -
273   - //if group id exists delete it from the users table
274   - $query = "DELETE FROM $default->owl_groups_units_table WHERE group_id = $groupID";
275   - $result = $sql->query($query);
276   -
277   - if(!'result')
278   - {
279   - $default->log->debug ("GroupManager::Deletion unsuccessful<br>");
280   - return false;
281   - }
282   - else
283   - {
284   - $default->log->debug("GroupManager::Deletion from user_group_link table Successful<br>");
285   - return true;
286   - }
287   -
288   - }
289   - /*
290   - *
291   - * gets the id of a group using its name
292   - *
293   - * @param $groupName
294   - * The GroupName for which we want its ID
295   - * @return Integer
296   - * The groupname's Id
297   - */
298   -
299   - function getGroupID($groupName)
300   - {
301   - global $default;
302   -
303   - $id = lookupID($default->owl_groups_table, "name", $groupName);
304   -
305   - return $id;
306   - }
307   -
308   - /*
309   - * Function getGroupName($groupID)
310   - *
311   - * gets the id of a user using their username
312   - *
313   - * @param $username
314   - * The username for which we want its ID
315   - * @return char
316   - * name of group
317   - */
318   -
319   - function getGroupName($groupID)
320   - {
321   - global $default;
322   -
323   - //call lookup function
324   - $name = lookupField($default->owl_groups_table, "name" , "id", $groupID);
325   -
326   - return $name;
327   - }
328   -
329   - /*
330   - *
331   - * Gets the unit that the group belongs to
332   - *
333   - * @param $groupID
334   - * The ID of the group
335   - * @return Array
336   - * array of unitID and name of the unit
337   - */
338   - function getUnit($groupID)
339   - {
340   - global $default;
341   - $unitinfo = array();
342   -
343   - // call lookup functions
344   - $unitID = lookupField($default->owl_groups_units_table, "unit_id" , "group_id", $groupID);
345   - $unitName = lookupField($default->owl_units_table, "name" , "id", $unitID);
346   -
347   - $unitinfo[1] = array("id" => $unitID, "name" => $unitName);
348   -
349   - // return an array
350   - return $unitinfo;
351   -
352   - }
353   -
354   -
355   -
356   - /*
357   - *
358   - * gets the org details of the org a unit belongs to TODO: move into System/Or Management
359   - *
360   - * @param orgID
361   - * The id of the org who's name we want based on the unit who belongs to it
362   - * @return array
363   - * if and name of org
364   - */
365   -
366   - function getOrg($unitID)
367   - {
368   -
369   - global $default;
370   - $orginfo = array();
371   -
372   - // call lookup functions
373   - $orgID = lookupField($default->owl_units_table, "organisation_id" , "id", $unitID);
374   - $orgName = lookupField($default->owl_organisations_table, "name" , "id", $orgID);
375   -
376   - $orginfo[1] = array("id" => $orgID, "name" => $orgName);
377   -
378   - // return an array
379   - return $orginfo;
380   -
381   -
382   - }
383   -
384   - }
385   -
386   -?>
387 0 \ No newline at end of file
lib/administration/UnitManager.inc deleted
1   -<?php
2   -
3   -require_once("$default->owl_fs_root/lib/class.AuthLdap.php");
4   -
5   -/**
6   - * $Id$
7   - *
8   - * Performs unit administration tasks- this includes user, group and category management,
9   - *
10   - * @version $Revision$
11   - * @author Mukhtar Dharsey
12   - * @package lib.administration
13   - */
14   -/*-----------------------------------------------------------------*/
15   -/**
16   - * Class Unit Manager
17   - *
18   - * Performs unit administration tasks- this includes user, group and category management,
19   - *
20   - *
21   - */
22   -/*-----------------------------------------------------------------*/
23   -
24   -class UnitManager {
25   -
26   - /**
27   - * Handle to the ldap util class
28   - */
29   - var $ldap;
30   -
31   - // user management
32   -
33   - /*-----------------------------------------------------------------*/
34   - /*
35   - * Function ListLdapUsers($userNameSearch)
36   - *
37   - * Searches the LDAP directory for users matching the supplied search string.
38   - *
39   - * @param $userNameSearch
40   - * the username to search for
41   - * @return
42   - * returns an array containing the users found
43   - */
44   - /*-----------------------------------------------------------------*/
45   - function listLdapUsers($userNameSearch) {
46   - global $default;
47   -
48   - // user attributes to search for
49   - $attributes = array ("dn", "uid", "givenname", "sn", "mail", "mobile");
50   - // initialise the ldap connection
51   - $ldap = new AuthLdap();
52   - $server[0] = $default->ldapServer;
53   - $ldap->server = $server;
54   - $ldap->dn = $default->ldapRootDn;
55   -
56   - if ( $ldap->connect()) {
57   - // search for the users
58   - // append and prepend wildcards
59   - $userArray = $ldap->getUsers("*" . $userNameSearch . "*", $attributes);
60   - if ($userArray) {
61   - // return the array
62   - return $userArray;
63   - } else {
64   - // the search failed, bail
65   - return false;
66   - }
67   - } else {
68   - // ldap connection failed, bail
69   - // TODO: error handling
70   - return false;
71   - /*
72   - echo "There was a problem.<br>";
73   - echo "Error code : " . $ldap->ldapErrorCode . "<br>";
74   - echo "Error text : " . $ldap->ldapErrorText . "<br>";
75   - */
76   - }
77   - }
78   -
79   -
80   - //-----------------------------------------------------------------
81   - /*
82   - * Function addUser($unitID, $userDetails)
83   - *
84   - * Adds a user to the unit.
85   - *
86   - * @param unitID
87   - * the ID of the unit to add the user to
88   - * @param userDetails
89   - * an array containing the details of the user
90   - * @return
91   - * true if the addition was successful, else false.
92   - */
93   - //-----------------------------------------------------------------
94   - function addUser($unitID, $userDetails) {
95   - global $default;
96   -
97   - $sql = new Owl_DB;
98   -
99   - // TODO: userDetails validation
100   -
101   - // check that the username is unique
102   - $query = "select username from $default->owl_users_table where username = '" . $userDetails['username'] . "'";
103   - $sql->query($query);
104   - $numrows = $sql->num_rows($sql);
105   -
106   - if ($numrows > 0) {
107   - // duplicate username
108   - $default->errorMessage = "The username " . $userDetails['username'] . " is already in use, please choose another one";
109   - return false;
110   - }
111   - // insert the user
112   - $query = "insert into $default->owl_users_table (username, name, password, email, mobile, ldap_dn) " .
113   - "values ( '" . $userDetails['username'] . "', " .
114   - "'" . $userDetails['name'] . "', " .
115   - "'', " .
116   - "'" . $userDetails['email'] . "', " .
117   - "'" . $userDetails['mobile'] . "', " .
118   - "'" . $userDetails['ldap_dn'] . "')";
119   - $result = $sql->query($query);
120   - if(!'result') {
121   - return false;
122   - } else {
123   - echo "insert into user table worked!<br>";
124   - }
125   -
126   - // TODO: insert into group table
127   -
128   - // TODO: must check that username is unique!
129   - // retrieve the generated id for insert into the user unit mapping table
130   - $query = "select * from $default->owl_users_table where username = '" . $userDetails['username'] . "'";
131   - $sql->query($query);
132   - $numrows = $sql->num_rows($sql);
133   -
134   - if ($numrows == "1") {
135   - while($sql->next_record()) {
136   - $userID = $sql->f("id");
137   - echo "read userID=$userID from db<br>";
138   - }
139   - } else {
140   - // select failed, bail
141   - // FIXME: need a rollback here
142   - echo "id select failed<br>";
143   - return false;
144   - }
145   -
146   - // now insert into the user-unit mapping table
147   - $query = "insert into $default->owl_user_unit_table (user_id, unit_id) values ($userID, $unitID)";
148   - $result = $sql->query($query);
149   - if (!'result') {
150   - // FIXME: rollback!
151   - echo "insert into user-unit table failed<br>";
152   - return false;
153   - } else {
154   - echo "insert into user-unit table worked!<br>";
155   - }
156   -
157   - return true;
158   - }
159   -
160   - //-----------------------------------------------------------------
161   - /*
162   - * Function RemoveUser($unitID, $userID)
163   - *
164   - * Adds a user to the unit.
165   - *
166   - * @param unitID
167   - * The ID of the unit to add the user to
168   - * @param userID
169   - * The Id of the User that must be deleted
170   - * @return
171   - * True if the deletion was successful, else false if not or nonexistant.
172   - */
173   - //-----------------------------------------------------------------
174   - function removeUser($unitID, $userID)
175   - {
176   - global $default;
177   - // create a connection
178   - $db = new Owl_DB;
179   -
180   - //do validation that userid exists
181   - $sql = "SELECT * FROM $default->owl_users_table WHERE $id = $userID";
182   - $result = $db->query($sql)
183   - if(!'result')
184   - {
185   - printf"User does not exist in the database")
186   - return false
187   - }
188   -
189   - //if user id exists delete it from the users table
190   - $sql = "DELETE FROM $default->owl_users_table WHERE id = $userID";
191   - $result = $db->query($sql)
192   - if(!'result')
193   - {
194   - return false;
195   - }
196   - else
197   - {
198   - echo "Deletion from user table Successful<br>";
199   - return true;
200   - }
201   -
202   - }
203   -
204   - //-----------------------------------------------------------------
205   - /*
206   - * Function updateUser($userID, $userDetails)
207   - *
208   - * Adds a user to the unit.
209   - *
210   - * @param userID
211   - * the ID of the unit to add the user to
212   - * @param userDetails
213   - * an array containing the details of the user
214   - * @return
215   - * true if the addition was successful, else false.
216   - */
217   - //-----------------------------------------------------------------
218   - function updateUser($userID, $userDetails)
219   - {
220   - global $default;
221   - // create a connection
222   - $db = new Owl_DB;
223   -
224   - //do validation that userid exists
225   - $sql = "SELECT * FROM $default->owl_users_table WHERE $id = $userID";
226   - $result = $db->query($sql)
227   - if(!'result')
228   - {
229   - printf"User does not exist in the database")
230   - return false
231   - }
232   -
233   - //if user id exists update all info into the users table
234   - //TODO group id change??????
235   - $sql = "UPDATE $default->owl_users_table SET " .
236   - " username = " . $userDetails['username'] . "," .
237   - " name = " . $userDetails['name'] . "," .
238   - " password = " . $userDetails['password'] . "," .
239   - " quota_max = " . $userDetails['quota_max'] ."," .
240   - " quota_current = " . $userDetails['quota_current'] ."," .
241   - " name = " . $userDetails['name'] . "," .
242   - " email = " . $userDetails['email'] . "," .
243   - " mobile = " . $userDetails['mobile'] . "," .
244   - " email_notification = " . $userDetails['email_notification'] ."," .
245   - " sms_notification = " . $userDetails['sms_notification'] . "
246   - " WHERE id = ". $userID ."" ;
247   -
248   -
249   - $result = $db->query($sql)
250   - if(!'result')
251   - {
252   - printf("Not Updated)
253   - return false;
254   - }
255   - else
256   - {
257   - echo "Deletion from user table Successful<br>";
258   - return true;
259   - }
260   - }
261   - //-----------------------------------------------------------------
262   - /*
263   - * Function listUser()
264   - *
265   - * returns an array of all the usernames
266   - *
267   - * @return
268   - * an array of usernames
269   - */
270   - //-----------------------------------------------------------------
271   - function listUser(){
272   -
273   - global $default;
274   - // create a connection
275   - $db = new Owl_DB;
276   -
277   - //Get list of all the usernames
278   - $sql = "SELECT username FROM $default->owl_users_table";
279   - $result = $db->query($sql)
280   -
281   - //return an array of the usernames
282   - return $result;
283   -
284   - }
285   -
286   - //-----------------------------------------------------------------
287   - /*
288   - * Function GetUserDetails($userID)
289   - *
290   - * Returns an array of all the details for a specified user.
291   - *
292   - * @return
293   - * an array of usernames
294   - */
295   - //-----------------------------------------------------------------
296   - function GetUserDetails($userID){
297   -
298   - global $default;
299   - // create a connection
300   - $db = new Owl_DB;
301   -
302   - //do validation that userid exists
303   - $sql = "SELECT * FROM $default->owl_users_table WHERE $id = $userID";
304   - $result = $db->query($sql)
305   - if(!'result')
306   - {
307   - printf"User does not exist in the database")
308   - return false
309   - }
310   -
311   - //return an array of the usernames
312   - return $result;
313   -
314   - }
315   -
316   - // group management
317   -
318   - //-----------------------------------------------------------------
319   - /*
320   - * Function addUser($unitID, $userDetails)
321   - *
322   - * Adds a user to the unit.
323   - *
324   - * @param unitID
325   - * the ID of the unit to add the user to
326   - * @param userDetails
327   - * an array containing the details of the user
328   - * @return
329   - * true if the addition was successful, else false.
330   - */
331   - //-----------------------------------------------------------------
332   - function createGroup($name){
333   - return false;
334   - }
335   -
336   - //-----------------------------------------------------------------
337   - /*
338   - * Function addUser($unitID, $userDetails)
339   - *
340   - * Adds a user to the unit.
341   - *
342   - * @param unitID
343   - * the ID of the unit to add the user to
344   - * @param userDetails
345   - * an array containing the details of the user
346   - * @return
347   - * true if the addition was successful, else false.
348   - */
349   - //-----------------------------------------------------------------
350   - function removeGroup($groupID){
351   - return false;
352   - }
353   -
354   - //-----------------------------------------------------------------
355   - /*
356   - * Function addUser($unitID, $userDetails)
357   - *
358   - * Adds a user to the unit.
359   - *
360   - * @param unitID
361   - * the ID of the unit to add the user to
362   - * @param userDetails
363   - * an array containing the details of the user
364   - * @return
365   - * true if the addition was successful, else false.
366   - */
367   - //-----------------------------------------------------------------
368   - function updateGroup($groupID, $name){
369   - return false;
370   - }
371   -//-----------------------------------------------------------------
372   - /*
373   - * Function addUser($unitID, $userDetails)
374   - *
375   - * Adds a user to the unit.
376   - *
377   - * @param unitID
378   - * the ID of the unit to add the user to
379   - * @param userDetails
380   - * an array containing the details of the user
381   - * @return
382   - * true if the addition was successful, else false.
383   - */
384   - //-----------------------------------------------------------------
385   - function listGroup(){
386   - //return null;
387   - }
388   - //-----------------------------------------------------------------
389   - /*
390   - * Function addUser($unitID, $userDetails)
391   - *
392   - * Adds a user to the unit.
393   - *
394   - * @param unitID
395   - * the ID of the unit to add the user to
396   - * @param userDetails
397   - * an array containing the details of the user
398   - * @return
399   - * true if the addition was successful, else false.
400   - */
401   - //-----------------------------------------------------------------
402   - /**
403   - * @param groupID
404   - * @param userID
405   - */
406   - function addUserToGroup($groupID, $userID){
407   - return false;
408   - }
409   -//-----------------------------------------------------------------
410   - /*
411   - * Function addUser($unitID, $userDetails)
412   - *
413   - * Adds a user to the unit.
414   - *
415   - * @param unitID
416   - * the ID of the unit to add the user to
417   - * @param userDetails
418   - * an array containing the details of the user
419   - * @return
420   - * true if the addition was successful, else false.
421   - */
422   - //-----------------------------------------------------------------
423   - /**
424   - * @param groupID
425   - * @param userID
426   - */
427   - function removeUserFromGroup($groupID, $userID){
428   - return false;
429   - }
430   - //-----------------------------------------------------------------
431   - /*
432   - * Function addUser($unitID, $userDetails)
433   - *
434   - * Adds a user to the unit.
435   - *
436   - * @param unitID
437   - * the ID of the unit to add the user to
438   - * @param userDetails
439   - * an array containing the details of the user
440   - * @return
441   - * true if the addition was successful, else false.
442   - */
443   - //-----------------------------------------------------------------
444   - // category management
445   -
446   - /**
447   - * @param name
448   - */
449   - function createCategory($name){
450   - return false;
451   - }
452   -//-----------------------------------------------------------------
453   - /*
454   - * Function addUser($unitID, $userDetails)
455   - *
456   - * Adds a user to the unit.
457   - *
458   - * @param unitID
459   - * the ID of the unit to add the user to
460   - * @param userDetails
461   - * an array containing the details of the user
462   - * @return
463   - * true if the addition was successful, else false.
464   - */
465   - //-----------------------------------------------------------------
466   - /**
467   - * @param categoryID
468   - */
469   - function removeCategory($categoryID){
470   - return false;
471   - }
472   -//-----------------------------------------------------------------
473   - /*
474   - * Function addUser($unitID, $userDetails)
475   - *
476   - * Adds a user to the unit.
477   - *
478   - * @param unitID
479   - * the ID of the unit to add the user to
480   - * @param userDetails
481   - * an array containing the details of the user
482   - * @return
483   - * true if the addition was successful, else false.
484   - */
485   - //-----------------------------------------------------------------
486   - /**
487   - * @param name
488   - * @param categoryID
489   - */
490   - function updateCategory($name, $categoryID){
491   - return false;
492   - }
493   -//-----------------------------------------------------------------
494   - /*
495   - * Function addUser($unitID, $userDetails)
496   - *
497   - * Adds a user to the unit.
498   - *
499   - * @param unitID
500   - * the ID of the unit to add the user to
501   - * @param userDetails
502   - * an array containing the details of the user
503   - * @return
504   - * true if the addition was successful, else false.
505   - */
506   - //-----------------------------------------------------------------
507   - function listCategories(){
508   - //return null;
509   - }
510   -
511   -}
512   -?>