class CRM_Core_Controller extends HTML_QuickForm_Controller {
/**
- * the title associated with this controller
+ * The title 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 $_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
*/
/**
* All CRM single or multi page pages should inherit from this class.
*
- * @param null $title
- * @param bool $modal
+ * @param string $title descriptive title of the controller
+ * @param bool $modal whether controller is modal
* @param null $mode
- * @param null $scope
- * @param bool $addSequence
- * @param bool $ignoreKey
- *
- * @internal param \title $string descriptive title of the controller
- * @internal param \whether $boolean controller is modal
- * @internal param \scope $string name of session if we want unique scope, used only by Controller_Simple
- * @internal param \addSequence $boolean should we add a unique sequence number to the end of the key
- * @internal param \ignoreKey $boolean should we not set a qfKey for this controller (for standalone forms)
+ * @param string $scope name of session if we want unique scope, used only by Controller_Simple
+ * @param bool $addSequence 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)
*
* @access public
*
- * @return \CRM_Core_Controller
+ * @return CRM_Core_Controller
*/
function __construct(
$title = NULL,
}
/**
- * @param $name
+ * @param string $name
* @param bool $addSequence
* @param bool $ignoreKey
*
}
/**
- * getter method for stateMachine
+ * Getter method for stateMachine
*
- * @return object
+ * @return CRM_Core_StateMachine
* @access public
*/
function getStateMachine() {
}
/**
- * setter method for stateMachine
+ * Setter method for stateMachine
*
- * @param object a stateMachineObject
+ * @param CRM_Core_StateMachine $stateMachine
*
* @return void
* @access public
}
/**
- * add pages to the controller. Note that the controller does not really care
+ * Add pages to the controller. Note that the controller does not really care
* the order in which the pages are added
*
- * @param object $stateMachine the state machine object
+ * @param CRM_Core_StateMachine $stateMachine
* @param \const|int $action the mode in which the state machine is operating
* typicaly this will be add/view/edit
*
}
/**
- * function to destroy all the session state of the controller.
+ * Destroy all the session state of the controller.
*
* @access public
*
}
/**
- * virtual function to do any processing of data.
+ * Virtual function to do any processing of data.
* Sometimes it is useful for the controller to actually process data.
* This is typically used when we need the controller to figure out
* what pages are potentially involved in this wizard. (this is dynamic
/**
* Get the variable from the form scope
*
- * @param string name : name of the variable
+ * @param string $name : name of the variable
*
* @access public
}
/**
- * @param $wizard
+ * @param array $wizard
*/
function addWizardStyle(&$wizard) {
$wizard['style'] = array(
}
/**
- * assign value to name in template
+ * Assign value to name in template
*
- * @param $var
+ * @param string $var
* @param mixed $value value of varaible
*
- * @internal param array|string $name name of variable
* @return void
* @access public
*/
}
/**
- * assign value to name in template by reference
+ * Assign value to name in template by reference
*
- * @param $var
+ * @param string $var
* @param mixed $value (reference) value of varaible
*
- * @internal param array|string $name name of variable
* @return void
* @access public
*/
}
/**
- * appends values to template variables
+ * Appends values to template variables
*
* @param array|string $tpl_var the template variable name(s)
* @param mixed $value the value to append
*
* @param string $name
*
- * @internal param string $type
* @return array
*/
function get_template_vars($name=null) {
}
/**
- * setter for embedded
+ * Setter for embedded
*
* @param boolean $embedded
*
}
/**
- * getter for embedded
+ * Getter for embedded
*
* @return boolean return the embedded value
* @access public
}
/**
- * setter for skipRedirection
+ * Setter for skipRedirection
*
* @param boolean $skipRedirection
*
}
/**
- * getter for skipRedirection
+ * Getter for skipRedirection
*
* @return boolean return the skipRedirection value
* @access public
}
/**
- * setter for print
+ * Setter for print
*
* @param boolean $print
*
}
/**
- * getter for print
+ * Getter for print
*
* @return boolean return the print value
* @access public