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
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
<?php defined("SYSPATH") or die("No direct script access.");
/**
* Gallery - a web based photo album viewer and editor
* Copyright (C) 2000-2009 Bharat Mediratta
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or (at
* your option) any later version.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**
* This is the API for handling groups.
*
* Note: by design, this class does not do any permission checking.
*/
class group_Core {
/**
* Create a new group.
*
* @param string $name
* @return Group_Model
*/
static function create($name) {
$group = ORM::factory("group")->where("name", $name)->find();
if ($group->loaded) {
throw new Exception("@todo GROUP_ALREADY_EXISTS $name");
}
$group->name = $name;
$group->save();
return $group;
}
/**
* The group of all possible visitors. This includes the guest user.
*
* @return Group_Model
*/
static function everybody() {
return model_cache::get("group", 1);
}
/**
* The group of all logged-in visitors. This does not include guest users.
*
* @return Group_Model
*/
static function registered_users() {
return model_cache::get("group", 2);
}
/**
* Look up a user by id.
* @param integer $id the user id
* @return User_Model the user object, or null if the id was invalid.
*/
static function lookup($id) {
return self::_lookup_group_by_field("id", $id);
}
/**
* Look up a group by name.
* @param integer $id the group name
* @return Group_Model the group object, or null if the name was invalid.
*/
static function lookup_by_name($name) {
return self::_lookup_group_by_field("name", $name);
}
/**
* Look up a user by field value.
* @param string search field
* @param string search value
* @return Group_Model the user object, or null if the name was invalid.
*/
private static function _lookup_group_by_field($field_name, $value) {
try {
$user = model_cache::get("group", $value, $field_name);
if ($user->loaded) {
return $user;
}
} catch (Exception $e) {
if (strpos($e->getMessage(), "MISSING_MODEL") === false) {
throw $e;
}
}
return null;
}
/**
* List the users
* @param mixed filters (@see Database.php
* @return array the group list.
*/
static function get_group_list($filter=array()) {
$group = ORM::factory("group");
foreach($filter as $method => $args) {
switch ($method) {
case "in":
$group->in($args[0], $args[1]);
break;
default:
$group->$method($args);
}
}
return $group->find_all();
}
static function get_edit_form_admin($group) {
$form = new Forge("admin/users/edit_group/$group->id", "", "post", array("id" => "g-edit-group-form"));
$form_group = $form->group("edit_group")->label(t("Edit Group"));
$form_group->input("name")->label(t("Name"))->id("g-name")->value($group->name);
$form_group->inputs["name"]->error_messages(
"in_use", t("There is already a group with that name"));
$form_group->submit("")->value(t("Save"));
$form->add_rules_from(self::get_edit_rules());
return $form;
}
static function get_add_form_admin() {
$form = new Forge("admin/users/add_group", "", "post", array("id" => "g-add-group-form"));
$form->set_attr('class', "g-narrow");
$form_group = $form->group("add_group")->label(t("Add Group"));
$form_group->input("name")->label(t("Name"))->id("g-name");
$form_group->inputs["name"]->error_messages(
"in_use", t("There is already a group with that name"));
$form_group->submit("")->value(t("Add Group"));
$group = ORM::factory("group");
$form->add_rules_from(self::get_edit_rules());
return $form;
}
static function get_delete_form_admin($group) {
$form = new Forge("admin/users/delete_group/$group->id", "", "post",
array("id" => "g-delete-group-form"));
$form_group = $form->group("delete_group")->label(
t("Are you sure you want to delete group %group_name?", array("group_name" => $group->name)));
$form_group->submit("")->value(t("Delete"));
return $form;
}
/**
* @see Identity_Driver::create.
*/
static function create($name) {
return Identity::instance()->create_group($name);
}
/**
* @see Identity_Driver::everbody.
*/
static function everybody() {
return Identity::instance()->everybody();
}
/**
* @see Identity_Driver::registered_users.
*/
static function registered_users() {
return Identity::instance()->everybody();
}
/**
* Look up a group by id.
* @param integer $id the user id
* @return Group_Definition the group object, or null if the id was invalid.
*/
static function lookup($id) {
return Identity::instance()->lookup_group_by_field("id", $id);
}
/**
* Look up a group by name.
* @param integer $id the group name
* @return Group_Definition the group object, or null if the name was invalid.
*/
static function lookup_by_name($name) {
return Identity::instance()->lookup_group_by_field("name", $name);
}
/**
* @see Identity_Driver::get_group_list.
*/
static function get_group_list($filter=array()) {
return Identity::instance()->get_group_list($filter);
}
/**
* @see Identity_Driver::get_edit_rules.
*/
static function get_edit_rules() {
return Identity::instance()->get_edit_rules("group");
}
}
|
