3 * Implements Special:ChangePassword
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
21 * @ingroup SpecialPage
25 * Let users recover their password.
27 * @ingroup SpecialPage
29 class SpecialChangePassword
extends FormSpecialPage
{
33 // Optional Wikitext Message to show above the password change form
34 protected $mPreTextMessage = null;
36 // label for old password input
37 protected $mOldPassMsg = null;
39 public function __construct() {
40 parent
::__construct( 'ChangePassword', 'editmyprivateinfo' );
41 $this->listed( false );
45 * Main execution point
46 * @param string|null $par
48 function execute( $par ) {
49 $this->getOutput()->disallowUserJs();
51 parent
::execute( $par );
54 protected function checkExecutePermissions( User
$user ) {
55 parent
::checkExecutePermissions( $user );
57 if ( !$this->getRequest()->wasPosted() ) {
58 $this->requireLogin( 'resetpass-no-info' );
63 * Set a message at the top of the Change Password form
65 * @param Message $msg Message to parse and add to the form header
67 public function setChangeMessage( Message
$msg ) {
68 $this->mPreTextMessage
= $msg;
72 * Set a message at the top of the Change Password form
74 * @param string $msg Message label for old/temp password field
76 public function setOldPasswordMessage( $msg ) {
77 $this->mOldPassMsg
= $msg;
80 protected function getFormFields() {
81 $user = $this->getUser();
82 $request = $this->getRequest();
84 $oldpassMsg = $this->mOldPassMsg
;
85 if ( $oldpassMsg === null ) {
86 $oldpassMsg = $user->isLoggedIn() ?
'oldpassword' : 'resetpass-temp-password';
92 'label-message' => 'username',
93 'default' => $request->getVal( 'wpName', $user->getName() ),
97 'label-message' => $oldpassMsg,
99 'NewPassword' => array(
100 'type' => 'password',
101 'label-message' => 'newpassword',
104 'type' => 'password',
105 'label-message' => 'retypenew',
109 if ( !$this->getUser()->isLoggedIn() ) {
110 if ( !LoginForm
::getLoginToken() ) {
111 LoginForm
::setLoginToken();
113 $fields['LoginOnChangeToken'] = array(
115 'label' => 'Change Password Token',
116 'default' => LoginForm
::getLoginToken(),
120 $extraFields = array();
121 Hooks
::run( 'ChangePasswordForm', array( &$extraFields ) );
122 foreach ( $extraFields as $extra ) {
123 list( $name, $label, $type, $default ) = $extra;
124 $fields[$name] = array(
127 'label-message' => $label,
128 'default' => $default,
132 if ( !$user->isLoggedIn() ) {
133 $fields['Remember'] = array(
135 'label' => $this->msg( 'remembermypassword' )
137 ceil( $this->getConfig()->get( 'CookieExpiration' ) / ( 3600 * 24 ) )
139 'default' => $request->getVal( 'wpRemember' ),
146 protected function alterForm( HTMLForm
$form ) {
147 $form->setId( 'mw-resetpass-form' );
148 $form->setTableId( 'mw-resetpass-table' );
149 $form->setWrapperLegendMsg( 'resetpass_header' );
150 $form->setSubmitTextMsg(
151 $this->getUser()->isLoggedIn()
152 ?
'resetpass-submit-loggedin'
155 $form->addButton( 'wpCancel', $this->msg( 'resetpass-submit-cancel' )->text() );
156 $form->setHeaderText( $this->msg( 'resetpass_text' )->parseAsBlock() );
157 if ( $this->mPreTextMessage
instanceof Message
) {
158 $form->addPreText( $this->mPreTextMessage
->parseAsBlock() );
160 $form->addHiddenFields(
161 $this->getRequest()->getValues( 'wpName', 'wpDomain', 'returnto', 'returntoquery' ) );
164 public function onSubmit( array $data ) {
167 $request = $this->getRequest();
169 if ( $request->getCheck( 'wpLoginToken' ) ) {
170 // This comes from Special:Userlogin when logging in with a temporary password
174 if ( !$this->getUser()->isLoggedIn()
175 && $request->getVal( 'wpLoginOnChangeToken' ) !== LoginForm
::getLoginToken()
177 // Potential CSRF (bug 62497)
181 if ( $request->getCheck( 'wpCancel' ) ) {
182 $returnto = $request->getVal( 'returnto' );
183 $titleObj = $returnto !== null ? Title
::newFromText( $returnto ) : null;
184 if ( !$titleObj instanceof Title
) {
185 $titleObj = Title
::newMainPage();
187 $query = $request->getVal( 'returntoquery' );
188 $this->getOutput()->redirect( $titleObj->getFullURL( $query ) );
194 $this->mUserName
= $request->getVal( 'wpName', $this->getUser()->getName() );
195 $this->mDomain
= $wgAuth->getDomain();
197 if ( !$wgAuth->allowPasswordChange() ) {
198 throw new ErrorPageError( 'changepassword', 'resetpass_forbidden' );
201 $this->attemptReset( $data['Password'], $data['NewPassword'], $data['Retype'] );
204 } catch ( PasswordError
$e ) {
205 return $e->getMessage();
209 public function onSuccess() {
210 if ( $this->getUser()->isLoggedIn() ) {
211 $this->getOutput()->wrapWikiMsg(
212 "<div class=\"successbox\">\n$1\n</div>",
213 'changepassword-success'
215 $this->getOutput()->returnToMain();
217 $request = $this->getRequest();
218 LoginForm
::setLoginToken();
219 $token = LoginForm
::getLoginToken();
221 'action' => 'submitlogin',
222 'wpName' => $this->mUserName
,
223 'wpDomain' => $this->mDomain
,
224 'wpLoginToken' => $token,
225 'wpPassword' => $request->getVal( 'wpNewPassword' ),
226 ) +
$request->getValues( 'wpRemember', 'returnto', 'returntoquery' );
227 $login = new LoginForm( new DerivativeRequest( $request, $data, true ) );
228 $login->setContext( $this->getContext() );
229 $login->execute( null );
234 * @param string $oldpass
235 * @param string $newpass
236 * @param string $retype
237 * @throws PasswordError When cannot set the new password because requirements not met.
239 protected function attemptReset( $oldpass, $newpass, $retype ) {
240 $isSelf = ( $this->mUserName
=== $this->getUser()->getName() );
242 $user = $this->getUser();
244 $user = User
::newFromName( $this->mUserName
);
247 if ( !$user ||
$user->isAnon() ) {
248 throw new PasswordError( $this->msg( 'nosuchusershort', $this->mUserName
)->text() );
251 if ( $newpass !== $retype ) {
252 Hooks
::run( 'PrefsPasswordAudit', array( $user, $newpass, 'badretype' ) );
253 throw new PasswordError( $this->msg( 'badretype' )->text() );
256 $throttleCount = LoginForm
::incLoginThrottle( $this->mUserName
);
257 if ( $throttleCount === true ) {
258 $lang = $this->getLanguage();
259 $throttleInfo = $this->getConfig()->get( 'PasswordAttemptThrottle' );
260 throw new PasswordError( $this->msg( 'changepassword-throttled' )
261 ->params( $lang->formatDuration( $throttleInfo['seconds'] ) )
266 // @todo Make these separate messages, since the message is written for both cases
267 if ( !$user->checkTemporaryPassword( $oldpass ) && !$user->checkPassword( $oldpass ) ) {
268 Hooks
::run( 'PrefsPasswordAudit', array( $user, $newpass, 'wrongpassword' ) );
269 throw new PasswordError( $this->msg( 'resetpass-wrong-oldpass' )->text() );
272 // User is resetting their password to their old password
273 if ( $oldpass === $newpass ) {
274 throw new PasswordError( $this->msg( 'resetpass-recycled' )->text() );
277 // Do AbortChangePassword after checking mOldpass, so we don't leak information
278 // by possibly aborting a new password before verifying the old password.
279 $abortMsg = 'resetpass-abort-generic';
280 if ( !Hooks
::run( 'AbortChangePassword', array( $user, $oldpass, $newpass, &$abortMsg ) ) ) {
281 Hooks
::run( 'PrefsPasswordAudit', array( $user, $newpass, 'abortreset' ) );
282 throw new PasswordError( $this->msg( $abortMsg )->text() );
285 // Please reset throttle for successful logins, thanks!
286 if ( $throttleCount ) {
287 LoginForm
::clearLoginThrottle( $this->mUserName
);
291 $user->setPassword( $newpass );
292 Hooks
::run( 'PrefsPasswordAudit', array( $user, $newpass, 'success' ) );
293 } catch ( PasswordError
$e ) {
294 Hooks
::run( 'PrefsPasswordAudit', array( $user, $newpass, 'error' ) );
295 throw new PasswordError( $e->getMessage() );
299 // This is needed to keep the user connected since
300 // changing the password also modifies the user's token.
301 $remember = $this->getRequest()->getCookie( 'Token' ) !== null;
302 $user->setCookies( null, null, $remember );
304 $user->resetPasswordExpiration();
305 $user->saveSettings();
308 public function requiresUnblock() {
312 protected function getGroupName() {