| GNU Affero General Public License or the licensing of CiviCRM, |
| see the CiviCRM license FAQ at http://civicrm.org/licensing |
+--------------------------------------------------------------------+
-*/
+ */
/**
* This class acts as our base controller class and adds additional
class CRM_Core_Controller extends HTML_QuickForm_Controller {
/**
- * The title associated with this controller
+ * The title associated with this controller.
*
* @var string
*/
protected $_title;
/**
- * The key associated with this controller
+ * The key associated with this controller.
*
* @var string
*/
public $_key;
/**
- * The name of the session scope where values are stored
+ * The name of the session scope where values are stored.
*
* @var object
*/
protected $_scope;
/**
- * The state machine associated with this controller
+ * The state machine associated with this controller.
*
* @var object
*/
public $_generateQFKey = TRUE;
/**
- * QF response type
+ * QF response type.
*
* @var string
*/
public $_QFResponseType = 'html';
/**
- * Cache the smarty template for efficiency reasons
+ * Cache the smarty template for efficiency reasons.
*
* @var CRM_Core_Smarty
*/
static protected $_template;
/**
- * Cache the session for efficiency reasons
+ * Cache the session for efficiency reasons.
*
* @var CRM_Core_Session
*/
static protected $_session;
/**
- * The parent of this form if embedded
+ * The parent of this form if embedded.
*
* @var object
*/
protected $_parent = NULL;
/**
- * The destination if set will override the destination the code wants to send it to
+ * The destination if set will override the destination the code wants to send it to.
*
* @var string;
*/
* Should we add a unique sequence number to the end of the key.
* @param bool $ignoreKey
* Should we not set a qfKey for this controller (for standalone forms).
- *
- * @internal param bool $whether controller is modal
*/
- function __construct(
+ public function __construct(
$title = NULL,
$modal = TRUE,
$mode = NULL,
// lets try to get it from the session and/or the request vars
// we do this early on in case there is a fatal error in retrieving the
// key and/or session
- $this->_entryURL =
- CRM_Utils_Request::retrieve('entryURL', 'String', $this);
+ $this->_entryURL
+ = CRM_Utils_Request::retrieve('entryURL', 'String', $this);
// add a unique validable key to the name
$name = CRM_Utils_System::getClassName($this);
// definitely different for different forms
$name = $scope;
}
- $name = $name . '_' . $this->key($name, $addSequence, $ignoreKey);
+ $name = $name . '_' . $this->key($name, $addSequence, $ignoreKey);
$this->_title = $title;
if ($scope) {
$this->_scope = $scope;
if (!empty($this->_key)) {
CRM_Core_Session::registerAndRetrieveSessionObjects(array(
"_{$name}_container",
- array('CiviCRM', $this->_scope),
- ));
+ array('CiviCRM', $this->_scope),
+ ));
}
$this->HTML_QuickForm_Controller($name, $modal);
public function fini() {
CRM_Core_BAO_Cache::storeSessionToCache(array(
- "_{$this->_name}_container",
+ "_{$this->_name}_container",
array('CiviCRM', $this->_scope),
),
TRUE
* Helper function to add all the needed default actions. Note that the framework
* redefines all of the default QFC actions
*
- * @param string directory to store all the uploaded files
- * @param array names for the various upload buttons (note u can have more than 1 upload)
+ * @param string $uploadDirectory to store all the uploaded files
+ * @param array $uploadNames for the various upload buttons (note u can have more than 1 upload)
*
*
* @return void
}
/**
- * Getter method for stateMachine
+ * Getter method for stateMachine.
*
* @return CRM_Core_StateMachine
*/
}
/**
- * Setter method for stateMachine
+ * Setter method for stateMachine.
*
* @param CRM_Core_StateMachine $stateMachine
*
$pages = $stateMachine->getPages();
foreach ($pages as $name => $value) {
$className = CRM_Utils_Array::value('className', $value, $name);
- $title = CRM_Utils_Array::value('title', $value);
- $options = CRM_Utils_Array::value('options', $value);
+ $title = CRM_Utils_Array::value('title', $value);
+ $options = CRM_Utils_Array::value('options', $value);
$stateName = CRM_Utils_String::getClassName($className);
if (!empty($value['className'])) {
$formName = $name;
}
/**
- * Store the variable with the value in the form scope
+ * Store the variable with the value in the form scope.
*
* @param string|array $name name of the variable or an assoc array of name/value pairs
* @param mixed $value
}
/**
- * Get the variable from the form scope
+ * Get the variable from the form scope.
*
* @param string $name
- * : name of the variable.
+ * name of the variable.
*
-
*
* @return mixed
*/
}
/**
- * Create the header for the wizard from the list of pages
+ * Create the header for the wizard from the list of pages.
* Store the created header in smarty
*
* @param string $currentPageName
* @return array
*/
public function wizardHeader($currentPageName) {
- $wizard = array();
+ $wizard = array();
$wizard['steps'] = array();
- $count = 0;
+ $count = 0;
foreach ($this->_pages as $name => $page) {
$count++;
$wizard['steps'][] = array(
}
/**
- * Assign value to name in template
+ * Assign value to name in template.
*
* @param string $var
* @param mixed $value
}
/**
- * Assign value to name in template by reference
+ * Assign value to name in template by reference.
*
* @param string $var
* @param mixed $value
}
/**
- * Appends values to template variables
+ * Appends values to template variables.
*
* @param array|string $tpl_var the template variable name(s)
* @param mixed $value
}
/**
- * Returns an array containing template variables
+ * Returns an array containing template variables.
*
* @param string $name
*
}
/**
- * Setter for embedded
+ * Setter for embedded.
*
* @param bool $embedded
*
}
/**
- * Getter for embedded
+ * Getter for embedded.
*
- * @return boolean
+ * @return bool
* return the embedded value
*/
public function getEmbedded() {
}
/**
- * Setter for skipRedirection
+ * Setter for skipRedirection.
*
* @param bool $skipRedirection
*
}
/**
- * Getter for skipRedirection
+ * Getter for skipRedirection.
*
- * @return boolean
+ * @return bool
* return the skipRedirection value
*/
public function getSkipRedirection() {
}
/**
- * Setter for print
+ * Setter for print.
*
* @param bool $print
*
}
/**
- * Getter for print
+ * Getter for print.
*
- * @return boolean
+ * @return bool
* return the print value
*/
public function getPrint() {
projects / civicrm-core.git / blobdiff