77 lines
2.2 KiB
PHP
77 lines
2.2 KiB
PHP
<?php
|
|
/**
|
|
* EGgroupware admin - admin command: change the password of a given user
|
|
*
|
|
* @link http://www.egroupware.org
|
|
* @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
|
|
* @package admin
|
|
* @copyright (c) 2007-16 by Ralf Becker <RalfBecker-AT-outdoor-training.de>
|
|
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
|
|
* @version $Id$
|
|
*/
|
|
|
|
use EGroupware\Api;
|
|
|
|
/**
|
|
* admin command: change the password of a given user
|
|
*
|
|
* @property int $account Account ID
|
|
*/
|
|
class admin_cmd_change_pw extends admin_cmd
|
|
{
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @param string|int|array $account account name or id, or array with all parameters
|
|
* @param string $password =null password
|
|
*/
|
|
function __construct($account,$password=null)
|
|
{
|
|
if (!is_array($account))
|
|
{
|
|
$account = array(
|
|
'account' => $account,
|
|
'password' => $password,
|
|
);
|
|
}
|
|
admin_cmd::__construct($account);
|
|
}
|
|
|
|
/**
|
|
* change the password of a given user
|
|
*
|
|
* @param boolean $check_only =false only run the checks (and throw the exceptions), but not the command itself
|
|
* @return string success message
|
|
* @throws Api\Exception\NoPermission\Admin
|
|
* @throws Api\Exception\WrongUserinput(lang("Unknown account: %1 !!!",$this->account),15);
|
|
* @throws Api\Exception\WrongUserinput(lang('Error changing the password for %1 !!!',$this->account),99);
|
|
*/
|
|
protected function exec($check_only=false)
|
|
{
|
|
$this->account = admin_cmd::parse_account($this->account,true); // true = user, no group
|
|
// check creator is still admin and not explicitly forbidden to edit Api\Accounts
|
|
if ($this->creator) $this->_check_admin('account_access',16);
|
|
|
|
if ($check_only) return true;
|
|
|
|
$auth = new Api\Auth;
|
|
|
|
if (!$auth->change_password(null, $this->password, $this->account))
|
|
{
|
|
// as long as the Api\Auth class is not throwing itself ...
|
|
throw new Exception(lang('Error changing the password for %1 !!!',$this->account),99);
|
|
}
|
|
return lang('Password updated');
|
|
}
|
|
|
|
/**
|
|
* Return a title / string representation for a given command, eg. to display it
|
|
*
|
|
* @return string
|
|
*/
|
|
function __tostring()
|
|
{
|
|
return lang('change password for %1',admin_cmd::display_account($this->account));
|
|
}
|
|
}
|