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         }
  64         $token = $this->trimmed('token');
  65         if (empty($token) || $token != common_session_token()) {
  66             // TRANS: Client error displayed when the session token does not match or is not given.
  67             $this->clientError(_('There was a problem with your session token. Try again, please.'));
  68         }
  69         $id = $this->trimmed('profileid');
  70         if (empty($id)) {
  71             // TRANS: Client error displayed when not providing a profile ID on the Make Admin page.
  72             $this->clientError(_('No profile specified.'));
  73         }
  74         $this->profile = Profile::getKV('id', $id);
  75         if (empty($this->profile)) {
  76             // TRANS: Client error displayed when specifying an invalid profile ID on the Make Admin page.
  77             $this->clientError(_('No profile with that ID.'));
  78         }
  79         $group_id = $this->trimmed('groupid');
  80         if (empty($group_id)) {
  81             // TRANS: Client error displayed when not providing a group ID on the Make Admin page.
  82             $this->clientError(_('No group specified.'));
  83         }
  84         $this->group = User_group::getKV('id', $group_id);
  85         if (empty($this->group)) {
  86             // TRANS: Client error displayed when providing an invalid group ID on the Make Admin page.
  87             $this->clientError(_('No such group.'));
  88         }
  89         $user = common_current_user();
  90         if (!$user->isAdmin($this->group) &&
  91             !$user->hasRight(Right::MAKEGROUPADMIN)) {
  92             // TRANS: Client error displayed when trying to make another user admin on the Make Admin page while not an admin.
  93             $this->clientError(_('Only an admin can make another user an admin.'), 401);
  94         }
  95         if ($this->profile->isAdmin($this->group)) {
  96             // TRANS: Client error displayed when trying to make another user admin on the Make Admin page who already is admin.
  97             // TRANS: %1$s is the user that is already admin, %2$s is the group user is already admin for.
  98             $this->clientError(sprintf(_('%1$s is already an admin for group "%2$s".'),
  99                                        $this->profile->getBestName(),
 100                                        $this->group->getBestName()),
 101                                401);
 102         }
 103         return true;
 104     }
 105
 106     /**
 107      * Handle request
 108      *
 109      * @param array $args $_REQUEST args; handled in prepare()
 110      *
 111      * @return void
 112      */
 113
 114     function handle($args)
 115     {
 116         parent::handle($args);
 117         if ($_SERVER['REQUEST_METHOD'] == 'POST') {
 118             $this->makeAdmin();
 119         }
 120     }
 121
 122     /**
 123      * Make user an admin
 124      *
 125      * @return void
 126      */
 127
 128     function makeAdmin()
 129     {
 130         $member = Group_member::pkeyGet(array('group_id' => $this->group->id,
 131                                               'profile_id' => $this->profile->id));
 132
 133         if (empty($member)) {
 134             // TRANS: Server error displayed when trying to make another user admin on the Make Admin page fails
 135             // TRANS: because the group membership record could not be gotten.
 136             // TRANS: %1$s is the to be admin user, %2$s is the group user should be admin for.
 137             $this->serverError(_('Can\'t get membership record for %1$s in group %2$s.'),
 138                                $this->profile->getBestName(),
 139                                $this->group->getBestName());
 140         }
 141
 142         $orig = clone($member);
 143
 144         $member->is_admin = 1;
 145
 146         $result = $member->update($orig);
 147
 148         if (!$result) {
 149             common_log_db_error($member, 'UPDATE', __FILE__);
 150             // TRANS: Server error displayed when trying to make another user admin on the Make Admin page fails
 151             // TRANS: because the group adminship record coud not be saved properly.
 152             // TRANS: %1$s is the to be admin user, %2$s is the group user is already admin for.
 153             $this->serverError(_('Can\'t make %1$s an admin for group %2$s.'),
 154                                $this->profile->getBestName(),
 155                                $this->group->getBestName());
 156         }
 157
 158         $this->returnToPrevious();
 159     }
 160
 161     /**
 162      * If we reached this form without returnto arguments, default to
 163      * the top of the group's member list.
 164      *
 165      * @return string URL
 166      */
 167     function defaultReturnTo()
 168     {
 169         return common_local_url('groupmembers',
 170                                 array('nickname' => $this->group->nickname));
 171     }
 172
 173 }