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. defined('_JEXEC') or die;
  10.  
  11. /**
  12.  * Save Controller for global configuration
  13.  *
  14.  * @package     Joomla.Administrator
  15.  * @subpackage  com_config
  16.  * @since       3.2
  17. */
  18. class ConfigControllerApplicationSave extends JControllerBase
  19. {
  20.     /**
  21.      * Application object - Redeclared for proper typehinting
  22.      *
  23.      * @var    JApplicationCms 
  24.      * @since  3.2
  25.      */
  26.     protected $app;
  27.  
  28.     /**
  29.      * Method to save global configuration.
  30.      *
  31.      * @return  mixed  Calls $app->redirect() for all cases except JSON
  32.      *
  33.      * @since   3.2
  34.      */
  35.     public function execute()
  36.     {
  37.         // Check for request forgeries.
  38.         if (!JSession::checkToken())
  39.         {
  40.             $this->app->enqueueMessage(JText::_('JINVALID_TOKEN'));
  41.             $this->app->redirect('index.php');
  42.         }
  43.  
  44.         // Check if the user is authorized to do this.
  45.         if (!JFactory::getUser()->authorise('core.admin'))
  46.         {
  47.             $this->app->enqueueMessage(JText::_('JERROR_ALERTNOAUTHOR'));
  48.             $this->app->redirect('index.php');
  49.         }
  50.  
  51.         // Set FTP credentials, if given.
  52.         JClientHelper::setCredentialsFromRequest('ftp');
  53.  
  54.         $model = new ConfigModelApplication;
  55.         $data  = $this->input->post->get('jform', array(), 'array');
  56.  
  57.         // Complete data array if needed
  58.         $oldData = $model->getData();
  59.         $data = array_replace($oldData, $data);
  60.  
  61.         // Get request type
  62.         $saveFormat = JFactory::getDocument()->getType();
  63.  
  64.         // Handle service requests
  65.         if ($saveFormat == 'json')
  66.         {
  67.             return $model->save($data);
  68.         }
  69.  
  70.         // Must load after serving service-requests
  71.         $form = $model->getForm();
  72.  
  73.         // Validate the posted data.
  74.         $return = $model->validate($form, $data);
  75.  
  76.         // Check for validation errors.
  77.         if ($return === false)
  78.         {
  79.             /*
  80.              * The validate method enqueued all messages for us, so we just need to redirect back.
  81.              */
  82.  
  83.             // Save the data in the session.
  84.             $this->app->setUserState('com_config.config.global.data', $data);
  85.  
  86.             // Redirect back to the edit screen.
  87.             $this->app->redirect(JRoute::_('index.php?option=com_config&controller=config.display.application', false));
  88.         }
  89.  
  90.         // Attempt to save the configuration.
  91.         $data    = $return;
  92.         $return = $model->save($data);
  93.  
  94.         // Check the return value.
  95.         if ($return === false)
  96.         {
  97.             /*
  98.              * The save method enqueued all messages for us, so we just need to redirect back.
  99.              */
  100.  
  101.             // Save the data in the session.
  102.             $this->app->setUserState('com_config.config.global.data', $data);
  103.  
  104.             // Save failed, go back to the screen and display a notice.
  105.             $this->app->redirect(JRoute::_('index.php?option=com_config&controller=config.display.application', false));
  106.         }
  107.  
  108.         // Set the success message.
  109.         $this->app->enqueueMessage(JText::_('COM_CONFIG_SAVE_SUCCESS'));
  110.  
  111.         // Set the redirect based on the task.
  112.         switch ($this->options[3])
  113.         {
  114.             case 'apply':
  115.                 $this->app->redirect(JRoute::_('index.php?option=com_config', false));
  116.                 break;
  117.  
  118.             case 'save':
  119.             default:
  120.                 $this->app->redirect(JRoute::_('index.php', false));
  121.                 break;
  122.         }
  123.     }
  124. }

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