CRM-15988 - Cleanup internal use of entity names
[civicrm-core.git] / CRM / Core / Selector / Controller.php
index ac14da90970074aa6d4831493c11cbfea2f61776..6a1577fba0aca53744d2004b462b1dba8cf7084f 100644 (file)
@@ -23,7 +23,7 @@
  | GNU Affero General Public License or the licensing of CiviCRM,     |
  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  +--------------------------------------------------------------------+
-*/
+ */
 
 /**
  *
@@ -48,10 +48,10 @@ class CRM_Core_Selector_Controller {
    */
   // move the values from the session to the template
   const SESSION = 1, TEMPLATE = 2,
-  TRANSFER = 4, EXPORT = 8, SCREEN = 16, PDF = 32;
+    TRANSFER = 4, EXPORT = 8, SCREEN = 16, PDF = 32;
 
   /**
-   * A CRM Object that implements CRM_Core_Selector_API
+   * A CRM Object that implements CRM_Core_Selector_API.
    * @var object
    */
   protected $_object;
@@ -119,7 +119,7 @@ class CRM_Core_Selector_Controller {
    * so the display routine needs to not do any work. (The
    * parent object takes care of the display)
    *
-   * @var boolean
+   * @var bool
    */
   protected $_embedded = FALSE;
 
@@ -127,7 +127,7 @@ class CRM_Core_Selector_Controller {
    * Are we in print mode? if so we need to modify the display
    * functionality to do a minimal display :)
    *
-   * @var boolean
+   * @var bool
    */
   protected $_print = FALSE;
 
@@ -163,32 +163,35 @@ class CRM_Core_Selector_Controller {
    * Array of properties that the controller dumps into the output object
    *
    * @var array
-   * @static
    */
   public static $_properties = array('columnHeaders', 'rows', 'rowsEmpty');
 
   /**
    * Should we compute actions dynamically (since they are quite verbose)
    *
-   * @var boolean
+   * @var bool
    */
   protected $_dynamicAction = FALSE;
 
   /**
-   * Class constructor
+   * Class constructor.
    *
-   * @param CRM_Core_Selector_API $object an object that implements the selector API
-   * @param int $pageID default pageID
-   * @param int $sortID default sortID
-   * @param int $action the actions to potentially support
+   * @param CRM_Core_Selector_API $object
+   *   An object that implements the selector API.
+   * @param int $pageID
+   *   Default pageID.
+   * @param int $sortID
+   *   Default sortID.
+   * @param int $action
+   *   The actions to potentially support.
    * @param CRM_Core_Page|CRM_Core_Form $store place in session to store some values
-   * @param int $output what do we so with the output, session/template//both
+   * @param int $output
+   *   What do we so with the output, session/template//both.
    *
    * @param null $prefix
    * @param null $case
    *
    * @return \CRM_Core_Selector_Controller
-  @access public
    */
   public function __construct($object, $pageID, $sortID, $action, $store = NULL, $output = self::TEMPLATE, $prefix = NULL, $case = NULL) {
 
@@ -196,10 +199,10 @@ class CRM_Core_Selector_Controller {
     $this->_pageID = $pageID ? $pageID : 1;
     $this->_sortID = $sortID ? $sortID : NULL;
     $this->_action = $action;
-    $this->_store  = $store;
+    $this->_store = $store;
     $this->_output = $output;
     $this->_prefix = $prefix;
-    $this->_case   = $case;
+    $this->_case = $case;
 
     // fix sortID
     if ($this->_sortID && strpos($this->_sortID, '_') === FALSE) {
@@ -252,9 +255,11 @@ class CRM_Core_Selector_Controller {
   /**
    * Have the GET vars changed, i.e. pageId or sortId that forces us to recompute the search values
    *
-   * @param int $reset are we being reset
+   * @param int $reset
+   *   Are we being reset.
    *
-   * @return boolean   if the GET params are different from the session params
+   * @return bool
+   *   if the GET params are different from the session params
    */
   public function hasChanged($reset) {
 
@@ -293,7 +298,6 @@ class CRM_Core_Selector_Controller {
    *
    *
    * @return void
-   *
    */
   public function run() {
 
@@ -336,8 +340,8 @@ class CRM_Core_Selector_Controller {
       $rows = self::getRows($this);
       CRM_Utils_Hook::searchColumns($contextName, $columnHeaders, $rows, $this);
       $rowsEmpty = count($rows) ? FALSE : TRUE;
-      $qill      = $this->getQill();
-      $summary   = $this->getSummary();
+      $qill = $this->getQill();
+      $summary = $this->getSummary();
       // if we need to store in session, lets update session
       if ($this->_output & self::SESSION) {
         $this->_store->set("{$this->_prefix}columnHeaders", $columnHeaders);
@@ -361,7 +365,6 @@ class CRM_Core_Selector_Controller {
         self::$_template->assign("{$this->_prefix}summary", $summary);
       }
 
-
       // always store the current pageID and sortID
       $this->_store->set($this->_prefix . CRM_Utils_Pager::PAGE_ID,
         $this->_pager->getCurrentPageID()
@@ -386,7 +389,8 @@ class CRM_Core_Selector_Controller {
    *
    * @param CRM_Core_Form $form
    *
-   * @return array of rows
+   * @return array
+   *   Array of rows
    */
   public function getRows($form) {
     if ($form->_output == self::EXPORT || $form->_output == self::SCREEN) {
@@ -404,7 +408,8 @@ class CRM_Core_Selector_Controller {
    * Default function for qill, if needed to be implemented, we
    * expect the subclass to do it
    *
-   * @return string the status message
+   * @return string
+   *   the status message
    */
   public function getQill() {
     return $this->_object->getQill();
@@ -418,7 +423,7 @@ class CRM_Core_Selector_Controller {
   }
 
   /**
-   * Getter for pager
+   * Getter for pager.
    *
    * @return CRM_Utils_Pager
    */
@@ -427,7 +432,7 @@ class CRM_Core_Selector_Controller {
   }
 
   /**
-   * Getter for sort
+   * Getter for sort.
    *
    * @return CRM_Utils_Sort
    */
@@ -436,7 +441,7 @@ class CRM_Core_Selector_Controller {
   }
 
   /**
-   * Move the variables from the session to the template
+   * Move the variables from the session to the template.
    *
    * @return void
    */
@@ -478,9 +483,9 @@ class CRM_Core_Selector_Controller {
   }
 
   /**
-   * Setter for embedded
+   * Setter for embedded.
    *
-   * @param boolean $embedded
+   * @param bool $embedded
    *
    * @return void
    */
@@ -489,18 +494,19 @@ class CRM_Core_Selector_Controller {
   }
 
   /**
-   * Getter for embedded
+   * Getter for embedded.
    *
-   * @return boolean return the embedded value
+   * @return bool
+   *   return the embedded value
    */
   public function getEmbedded() {
     return $this->_embedded;
   }
 
   /**
-   * Setter for print
+   * Setter for print.
    *
-   * @param boolean $print
+   * @param bool $print
    *
    * @return void
    */
@@ -509,9 +515,10 @@ class CRM_Core_Selector_Controller {
   }
 
   /**
-   * Getter for print
+   * Getter for print.
    *
-   * @return boolean return the print value
+   * @return bool
+   *   return the print value
    */
   public function getPrint() {
     return $this->_print;
@@ -530,4 +537,5 @@ class CRM_Core_Selector_Controller {
   public function getDynamicAction() {
     return $this->_dynamicAction;
   }
+
 }