1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
<?php
require_once TURBA_BASE . '/lib/Object.php';
/**
* The Turba_Group:: class provides a set of methods for dealing with
* contact groups.
*
* $Horde: turba/lib/Group.php,v 1.23.10.3 2006/04/11 20:04:19 chuck Exp $
*
* @author Chuck Hagenbuch <chuck@horde.org>
* @author jon Parise <jon@csh.rit.edu>
* @since Turba 0.0.1
* @package Turba
*/
class Turba_Group extends Turba_Object {
/**
* Constructs a new Turba_Group object.
*
* @param Turba_Driver $driver The driver object that this group comes
* from.
* @param array $attributes Hash of attributes for this group.
*/
function Turba_Group(&$driver, $attributes = array())
{
parent::Turba_Object($driver, $attributes);
$this->attributes['__type'] = 'Group';
}
/**
* Returns true if this object is a group of multiple contacts.
*
* @return boolean True.
*/
function isGroup()
{
return true;
}
/**
* Adds a new contact entry to this group.
*
* @param string $contactId The id of the contact to add.
*
* @since Turba 1.2
*/
function addMember($contactId)
{
// Can't add itself.
if ($contactId != $this->attributes['__key']) {
$contact = $this->driver->getObject($contactId);
if (is_a($contact, 'PEAR_Error')) {
return $contact;
}
$members = @unserialize($this->attributes['__members']);
if (!is_array($members)) {
$members = array();
}
$members[] = $contact->getValue('__key');
// Remove duplicates
$members = array_unique($members);
$this->attributes['__members'] = serialize($members);
}
}
/**
* Deletes a contact from this group.
*
* @param string $contactId The id of the contact to remove.
*
* @since Turba 1.2
*/
function removeMember($contactId)
{
$members = unserialize($this->attributes['__members']);
if (($i = array_search($contactId, $members)) !== false) {
unset($members[$i]);
}
$this->attributes['__members'] = serialize($members);
$this->store();
return true;
}
/**
* Retrieve the Objects in this group
*
* @param $sort_criteria The requested sort order which is passed to
* Turba_List::sort().
*
* @param $sort_direction The requested sort direction which is passed to
* Turba_List::sort().
*
* @return Turba_List List containing the members of this group
*
* @since Turba 1.2
*/
function listMembers($sort_criteria = 'lastname', $sort_direction = 0)
{
require_once TURBA_BASE . '/lib/List.php';
$list = &new Turba_List();
$children = unserialize($this->attributes['__members']);
if (!is_array($children)) {
$children = array();
}
reset($children);
foreach ($children as $member) {
$newMember = $this->driver->getObject($member);
if (is_object($newMember)) {
$list->insert($newMember);
}
}
$list->sort($sort_criteria, $sort_direction);
return $list;
}
/**
* Searches the group based on the provided criteria.
*
* TODO: Allow $criteria to contain the comparison operator (<, =, >,
* 'like') and modify the drivers accordingly.
*
* @param $search_criteria Hash containing the search criteria.
* @param $sort_criteria The requested sort order which is passed to
* Turba_List::sort().
*
* @return Turba_List The sorted, filtered list of search results.
*
* @since Turba 1.2
*/
function search($search_criteria, $sort_criteria = 'lastname')
{
require_once TURBA_BASE . '/lib/List.php';
$results = &new Turba_List();
/* Get all members. */
$members = $this->listMembers($sort_criteria);
$members->reset();
while ($member = $members->next()) {
$match = true;
foreach ($search_criteria as $key => $value) {
if ($member->hasValue($key)) {
if ($member->getValue($key) == $value) {
$match = false;
}
}
}
if ($match) {
$results->insert($member);
}
}
/* Return the filtered (sorted) results. */
return $results;
}
}
|
