Source for file reset.php

Documentation is available at reset.php

  1. <?php
  2. /**
  3.  * @package     Joomla.Site
  4.  * @subpackage  com_users
  5.  *
  6.  * @copyright   Copyright (C) 2005 - 2013 Open Source Matters, Inc. All rights reserved.
  7.  * @license     GNU General Public License version 2 or later; see LICENSE.txt
  8.  */
  9.  
  10. defined('_JEXEC') or die;
  11.  
  12. require_once JPATH_COMPONENT.'/controller.php';
  13.  
  14. /**
  15.  * Reset controller class for Users.
  16.  *
  17.  * @package     Joomla.Site
  18.  * @subpackage  com_users
  19.  * @since       1.6
  20.  */
  21. class UsersControllerReset extends UsersController
  22. {
  23.     /**
  24.      * Method to request a password reset.
  25.      *
  26.      * @since   1.6
  27.      */
  28.     public function request()
  29.     {
  30.         // Check the request token.
  31.         JSession::checkToken('post') or jexit(JText::_('JINVALID_TOKEN'));
  32.  
  33.         $app   = JFactory::getApplication();
  34.         $model = $this->getModel('Reset', 'UsersModel');
  35.         $data  = $this->input->post->get('jform', array(), 'array');
  36.  
  37.         // Submit the password reset request.
  38.         $return    = $model->processResetRequest($data);
  39.  
  40.         // Check for a hard error.
  41.         if ($return instanceof Exception)
  42.         {
  43.             // Get the error message to display.
  44.             if ($app->getCfg('error_reporting'))
  45.             {
  46.                 $message = $return->getMessage();
  47.             } else {
  48.                 $message = JText::_('COM_USERS_RESET_REQUEST_ERROR');
  49.             }
  50.  
  51.             // Get the route to the next page.
  52.             $itemid = UsersHelperRoute::getResetRoute();
  53.             $itemid = $itemid !== null ? '&Itemid='.$itemid : '';
  54.             $route    = 'index.php?option=com_users&view=reset'.$itemid;
  55.  
  56.             // Go back to the request form.
  57.             $this->setRedirect(JRoute::_($route, false), $message, 'error');
  58.             return false;
  59.         } elseif ($return === false)
  60.         {
  61.             // The request failed.
  62.             // Get the route to the next page.
  63.             $itemid = UsersHelperRoute::getResetRoute();
  64.             $itemid = $itemid !== null ? '&Itemid='.$itemid : '';
  65.             $route    = 'index.php?option=com_users&view=reset'.$itemid;
  66.  
  67.             // Go back to the request form.
  68.             $message = JText::sprintf('COM_USERS_RESET_REQUEST_FAILED', $model->getError());
  69.             $this->setRedirect(JRoute::_($route, false), $message, 'notice');
  70.             return false;
  71.         }
  72.         else
  73.         {
  74.             // The request succeeded.
  75.             // Get the route to the next page.
  76.             $itemid = UsersHelperRoute::getResetRoute();
  77.             $itemid = $itemid !== null ? '&Itemid='.$itemid : '';
  78.             $route    = 'index.php?option=com_users&view=reset&layout=confirm'.$itemid;
  79.  
  80.             // Proceed to step two.
  81.             $this->setRedirect(JRoute::_($route, false));
  82.             return true;
  83.         }
  84.     }
  85.  
  86.     /**
  87.      * Method to confirm the password request.
  88.      *
  89.      * @access    public
  90.      * @since   1.6
  91.      */
  92.     public function confirm()
  93.     {
  94.         // Check the request token.
  95.         JSession::checkToken('request') or jexit(JText::_('JINVALID_TOKEN'));
  96.  
  97.         $app   = JFactory::getApplication();
  98.         $model = $this->getModel('Reset', 'UsersModel');
  99.         $data  = $this->input->get('jform', array(), 'array');
  100.  
  101.         // Confirm the password reset request.
  102.         $return    = $model->processResetConfirm($data);
  103.  
  104.         // Check for a hard error.
  105.         if ($return instanceof Exception)
  106.         {
  107.             // Get the error message to display.
  108.             if ($app->getCfg('error_reporting'))
  109.             {
  110.                 $message = $return->getMessage();
  111.             } else {
  112.                 $message = JText::_('COM_USERS_RESET_CONFIRM_ERROR');
  113.             }
  114.  
  115.             // Get the route to the next page.
  116.             $itemid = UsersHelperRoute::getResetRoute();
  117.             $itemid = $itemid !== null ? '&Itemid='.$itemid : '';
  118.             $route    = 'index.php?option=com_users&view=reset&layout=confirm'.$itemid;
  119.  
  120.             // Go back to the confirm form.
  121.             $this->setRedirect(JRoute::_($route, false), $message, 'error');
  122.             return false;
  123.         } elseif ($return === false)
  124.         {
  125.             // Confirm failed.
  126.             // Get the route to the next page.
  127.             $itemid = UsersHelperRoute::getResetRoute();
  128.             $itemid = $itemid !== null ? '&Itemid='.$itemid : '';
  129.             $route    = 'index.php?option=com_users&view=reset&layout=confirm'.$itemid;
  130.  
  131.             // Go back to the confirm form.
  132.             $message = JText::sprintf('COM_USERS_RESET_CONFIRM_FAILED', $model->getError());
  133.             $this->setRedirect(JRoute::_($route, false), $message, 'notice');
  134.             return false;
  135.         }
  136.         else
  137.         {
  138.             // Confirm succeeded.
  139.             // Get the route to the next page.
  140.             $itemid = UsersHelperRoute::getResetRoute();
  141.             $itemid = $itemid !== null ? '&Itemid='.$itemid : '';
  142.             $route    = 'index.php?option=com_users&view=reset&layout=complete'.$itemid;
  143.  
  144.             // Proceed to step three.
  145.             $this->setRedirect(JRoute::_($route, false));
  146.             return true;
  147.         }
  148.     }
  149.  
  150.     /**
  151.      * Method to complete the password reset process.
  152.      *
  153.      * @since   1.6
  154.      */
  155.     public function complete()
  156.     {
  157.         // Check for request forgeries
  158.         JSession::checkToken('post') or jexit(JText::_('JINVALID_TOKEN'));
  159.  
  160.         $app   = JFactory::getApplication();
  161.         $model = $this->getModel('Reset', 'UsersModel');
  162.         $data  = $this->input->post->get('jform', array(), 'array');
  163.  
  164.         // Complete the password reset request.
  165.         $return    = $model->processResetComplete($data);
  166.  
  167.         // Check for a hard error.
  168.         if ($return instanceof Exception)
  169.         {
  170.             // Get the error message to display.
  171.             if ($app->getCfg('error_reporting'))
  172.             {
  173.                 $message = $return->getMessage();
  174.             } else {
  175.                 $message = JText::_('COM_USERS_RESET_COMPLETE_ERROR');
  176.             }
  177.  
  178.             // Get the route to the next page.
  179.             $itemid = UsersHelperRoute::getResetRoute();
  180.             $itemid = $itemid !== null ? '&Itemid='.$itemid : '';
  181.             $route    = 'index.php?option=com_users&view=reset&layout=complete'.$itemid;
  182.  
  183.             // Go back to the complete form.
  184.             $this->setRedirect(JRoute::_($route, false), $message, 'error');
  185.             return false;
  186.         } elseif ($return === false)
  187.         {
  188.             // Complete failed.
  189.             // Get the route to the next page.
  190.             $itemid = UsersHelperRoute::getResetRoute();
  191.             $itemid = $itemid !== null ? '&Itemid='.$itemid : '';
  192.             $route    = 'index.php?option=com_users&view=reset&layout=complete'.$itemid;
  193.  
  194.             // Go back to the complete form.
  195.             $message = JText::sprintf('COM_USERS_RESET_COMPLETE_FAILED', $model->getError());
  196.             $this->setRedirect(JRoute::_($route, false), $message, 'notice');
  197.             return false;
  198.         }
  199.         else
  200.         {
  201.             // Complete succeeded.
  202.             // Get the route to the next page.
  203.             $itemid = UsersHelperRoute::getLoginRoute();
  204.             $itemid = $itemid !== null ? '&Itemid='.$itemid : '';
  205.             $route    = 'index.php?option=com_users&view=login'.$itemid;
  206.  
  207.             // Proceed to the login form.
  208.             $message = JText::_('COM_USERS_RESET_COMPLETE_SUCCESS');
  209.             $this->setRedirect(JRoute::_($route, false), $message);
  210.             return true;
  211.         }
  212.     }
  213. }

Documentation generated on Tue, 19 Nov 2013 15:11:53 +0100 by phpDocumentor 1.4.3