Source for file save.php

Documentation is available at save.php

  1. <?php
  2. /**
  3.  * @package     Joomla.Administrator
  4.  * @subpackage  com_config
  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. /**
  13.  * Save Controller for global configuration
  14.  *
  15.  * @package     Joomla.Administrator
  16.  * @subpackage  com_config
  17.  * @since       3.2
  18. */
  19. class ConfigControllerComponentSave extends JControllerBase
  20. {
  21.     /**
  22.      * Application object - Redeclared for proper typehinting
  23.      *
  24.      * @var    JApplicationCms 
  25.      * @since  3.2
  26.      */
  27.     protected $app;
  28.  
  29.     /**
  30.      * Method to save global configuration.
  31.      *
  32.      * @return  mixed  Calls $app->redirect()
  33.      *
  34.      * @since   3.2
  35.      */
  36.     public function execute()
  37.     {
  38.         // Check for request forgeries.
  39.         if (!JSession::checkToken())
  40.         {
  41.             $this->app->enqueueMessage(JText::_('JINVALID_TOKEN'));
  42.             $this->app->redirect('index.php');
  43.         }
  44.  
  45.         // Set FTP credentials, if given.
  46.         JClientHelper::setCredentialsFromRequest('ftp');
  47.  
  48.         $model  = new ConfigModelComponent;
  49.         $form   = $model->getForm();
  50.         $data   = $this->input->get('jform', array(), 'array');
  51.         $id     = $this->input->getInt('id');
  52.         $option = $this->input->get('component');
  53.  
  54.         // Check if the user is authorized to do this.
  55.         if (!JFactory::getUser()->authorise('core.admin', $option))
  56.         {
  57.             $this->app->enqueueMessage(JText::_('JERROR_ALERTNOAUTHOR'));
  58.             $this->app->redirect('index.php');
  59.         }
  60.  
  61.         $returnUri = $this->input->post->get('return', null, 'base64');
  62.  
  63.         if (!empty($returnUri))
  64.         {
  65.             $redirect = '&return=' . urlencode($returnUri);
  66.         }
  67.  
  68.         // Validate the posted data.
  69.         $return = $model->validate($form, $data);
  70.  
  71.         // Check for validation errors.
  72.         if ($return === false)
  73.         {
  74.             /*
  75.              * The validate method enqueued all messages for us, so we just need to redirect back.
  76.              */
  77.  
  78.             // Save the data in the session.
  79.             $this->app->setUserState('com_config.config.global.data', $data);
  80.  
  81.             // Redirect back to the edit screen.
  82.             $this->app->redirect(JRoute::_('index.php?option=com_config&view=component&component=' . $option . $redirect, false));
  83.         }
  84.  
  85.         // Attempt to save the configuration.
  86.         $data = array(
  87.             'params' => $return,
  88.             'id'     => $id,
  89.             'option' => $option
  90.         );
  91.  
  92.         try
  93.         {
  94.             $model->save($data);
  95.         }
  96.         catch (RuntimeException $e)
  97.         {
  98.             // Save the data in the session.
  99.             $this->app->setUserState('com_config.config.global.data', $data);
  100.  
  101.             // Save failed, go back to the screen and display a notice.
  102.             $this->app->enqueueMessage(JText::sprintf('JERROR_SAVE_FAILED', $e->getMessage()), 'error');
  103.             $this->app->redirect(JRoute::_('index.php?option=com_config&view=component&component=' . $option . $redirect, false));
  104.         }
  105.  
  106.         // Set the redirect based on the task.
  107.         switch ($this->options[3])
  108.         {
  109.             case 'apply':
  110.                 $this->app->enqueueMessage(JText::_('COM_CONFIG_SAVE_SUCCESS'));
  111.                 $this->app->redirect(JRoute::_('index.php?option=com_config&view=component&component=' . $option . $redirect, false));
  112.  
  113.                 break;
  114.  
  115.             case 'save':
  116.             default:
  117.                 $redirect = 'index.php?option=' . $option;
  118.  
  119.                 if (!empty($returnUri))
  120.                 {
  121.                     $redirect = base64_decode($returnUri);
  122.                 }
  123.  
  124.                 $this->app->redirect(JRoute::_($redirect, false));
  125.  
  126.                 break;
  127.         }
  128.  
  129.         return true;
  130.     }
  131. }

Documentation generated on Tue, 19 Nov 2013 15:12:36 +0100 by phpDocumentor 1.4.3