]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - actions/makeadmin.php
Translator documentation updated/added.
[quix0rs-gnu-social.git] / actions / makeadmin.php
1 <?php
2 /**
3  * Make another user an admin of a group
4  *
5  * PHP version 5
6  *
7  * @category Action
8  * @package  StatusNet
9  * @author   Evan Prodromou <evan@status.net>
10  * @license  http://www.fsf.org/licensing/licenses/agpl.html AGPLv3
11  * @link     http://status.net/
12  *
13  * StatusNet - the distributed open-source microblogging tool
14  * Copyright (C) 2008, 2009, StatusNet, Inc.
15  *
16  * This program is free software: you can redistribute it and/or modify
17  * it under the terms of the GNU Affero General Public License as published by
18  * the Free Software Foundation, either version 3 of the License, or
19  * (at your option) any later version.
20  *
21  * This program is distributed in the hope that it will be useful,
22  * but WITHOUT ANY WARRANTY; without even the implied warranty of
23  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
24  * GNU Affero General Public License for more details.
25  *
26  * You should have received a copy of the GNU Affero General Public License
27  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
28  */
29
30 if (!defined('STATUSNET') && !defined('LACONICA')) {
31     exit(1);
32 }
33
34 /**
35  * Make another user an admin of a group
36  *
37  * @category Action
38  * @package  StatusNet
39  * @author   Evan Prodromou <evan@status.net>
40  * @license  http://www.fsf.org/licensing/licenses/agpl.html AGPLv3
41  * @link     http://status.net/
42  */
43
44 class MakeadminAction extends RedirectingAction
45 {
46     var $profile = null;
47     var $group = null;
48
49     /**
50      * Take arguments for running
51      *
52      * @param array $args $_REQUEST args
53      *
54      * @return boolean success flag
55      */
56
57     function prepare($args)
58     {
59         parent::prepare($args);
60         if (!common_logged_in()) {
61             // TRANS: Error message displayed when trying to perform an action that requires a logged in user.
62             $this->clientError(_('Not logged in.'));
63             return false;
64         }
65         $token = $this->trimmed('token');
66         if (empty($token) || $token != common_session_token()) {
67             // TRANS: Client error displayed when the session token does not match or is not given.
68             $this->clientError(_('There was a problem with your session token. Try again, please.'));
69             return;
70         }
71         $id = $this->trimmed('profileid');
72         if (empty($id)) {
73             // TRANS: Client error displayed when not providing a profile ID on the Make Admin page.
74             $this->clientError(_('No profile specified.'));
75             return false;
76         }
77         $this->profile = Profile::staticGet('id', $id);
78         if (empty($this->profile)) {
79             // TRANS: Client error displayed when specifying an invalid profile ID on the Make Admin page.
80             $this->clientError(_('No profile with that ID.'));
81             return false;
82         }
83         $group_id = $this->trimmed('groupid');
84         if (empty($group_id)) {
85             // TRANS: Client error displayed when not providing a group ID on the Make Admin page.
86             $this->clientError(_('No group specified.'));
87             return false;
88         }
89         $this->group = User_group::staticGet('id', $group_id);
90         if (empty($this->group)) {
91             // TRANS: Client error displayed when providing an invalid group ID on the Make Admin page.
92             $this->clientError(_('No such group.'));
93             return false;
94         }
95         $user = common_current_user();
96         if (!$user->isAdmin($this->group) &&
97             !$user->hasRight(Right::MAKEGROUPADMIN)) {
98             // TRANS: Client error displayed when trying to make another user admin on the Make Admin page while not an admin.
99             $this->clientError(_('Only an admin can make another user an admin.'), 401);
100             return false;
101         }
102         if ($this->profile->isAdmin($this->group)) {
103             // TRANS: Client error displayed when trying to make another user admin on the Make Admin page who already is admin.
104             // TRANS: %1$s is the user that is already admin, %2$s is the group user is already admin for.
105             $this->clientError(sprintf(_('%1$s is already an admin for group "%2$s".'),
106                                        $this->profile->getBestName(),
107                                        $this->group->getBestName()),
108                                401);
109             return false;
110         }
111         return true;
112     }
113
114     /**
115      * Handle request
116      *
117      * @param array $args $_REQUEST args; handled in prepare()
118      *
119      * @return void
120      */
121
122     function handle($args)
123     {
124         parent::handle($args);
125         if ($_SERVER['REQUEST_METHOD'] == 'POST') {
126             $this->makeAdmin();
127         }
128     }
129
130     /**
131      * Make user an admin
132      *
133      * @return void
134      */
135
136     function makeAdmin()
137     {
138         $member = Group_member::pkeyGet(array('group_id' => $this->group->id,
139                                               'profile_id' => $this->profile->id));
140
141         if (empty($member)) {
142             // TRANS: Server error displayed when trying to make another user admin on the Make Admin page fails
143             // TRANS: because the group membership record could not be gotten.
144             // TRANS: %1$s is the to be admin user, %2$s is the group user should be admin for.
145             $this->serverError(_('Can\'t get membership record for %1$s in group %2$s.'),
146                                $this->profile->getBestName(),
147                                $this->group->getBestName());
148         }
149
150         $orig = clone($member);
151
152         $member->is_admin = 1;
153
154         $result = $member->update($orig);
155
156         if (!$result) {
157             common_log_db_error($member, 'UPDATE', __FILE__);
158             // TRANS: Server error displayed when trying to make another user admin on the Make Admin page fails
159             // TRANS: because the group adminship record coud not be saved properly.
160             // TRANS: %1$s is the to be admin user, %2$s is the group user is already admin for.
161             $this->serverError(_('Can\'t make %1$s an admin for group %2$s.'),
162                                $this->profile->getBestName(),
163                                $this->group->getBestName());
164         }
165
166         $this->returnToPrevious();
167     }
168
169     /**
170      * If we reached this form without returnto arguments, default to
171      * the top of the group's member list.
172      * 
173      * @return string URL
174      */
175     function defaultReturnTo()
176     {
177         return common_local_url('groupmembers',
178                                 array('nickname' => $this->group->nickname));
179     }
180
181 }