CRM/Utils/Recent.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.6                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2014                                |
   7  +--------------------------------------------------------------------+
   8  | This file is a part of CiviCRM.                                    |
   9  |                                                                    |
  10  | CiviCRM is free software; you can copy, modify, and distribute it  |
  11  | under the terms of the GNU Affero General Public License           |
  12  | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
  13  |                                                                    |
  14  | CiviCRM is distributed in the hope that it will be useful, but     |
  15  | WITHOUT ANY WARRANTY; without even the implied warranty of         |
  16  | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
  17  | See the GNU Affero General Public License for more details.        |
  18  |                                                                    |
  19  | You should have received a copy of the GNU Affero General Public   |
  20  | License and the CiviCRM Licensing Exception along                  |
  21  | with this program; if not, contact CiviCRM LLC                     |
  22  | at info[AT]civicrm[DOT]org. If you have questions about the        |
  23  | GNU Affero General Public License or the licensing of CiviCRM,     |
  24  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  25  +--------------------------------------------------------------------+
  26  */
  27
  28 /**
  29  *
  30  * @package CRM
  31  * @copyright CiviCRM LLC (c) 2004-2014
  32  * $Id$
  33  *
  34  */
  35
  36 /**
  37  *
  38  */
  39 class CRM_Utils_Recent {
  40
  41   /**
  42    * Max number of items in queue.
  43    *
  44    * @int
  45    */
  46   const MAX_ITEMS = 10, STORE_NAME = 'CRM_Utils_Recent';
  47
  48   /**
  49    * The list of recently viewed items.
  50    *
  51    * @var array
  52    */
  53   static private $_recent = NULL;
  54
  55   /**
  56    * Initialize this class and set the static variables.
  57    *
  58    * @return void
  59    */
  60   public static function initialize() {
  61     if (!self::$_recent) {
  62       $session = CRM_Core_Session::singleton();
  63       self::$_recent = $session->get(self::STORE_NAME);
  64       if (!self::$_recent) {
  65         self::$_recent = array();
  66       }
  67     }
  68   }
  69
  70   /**
  71    * Return the recently viewed array.
  72    *
  73    * @return array
  74    *   the recently viewed array
  75    */
  76   public static function &get() {
  77     self::initialize();
  78     return self::$_recent;
  79   }
  80
  81   /**
  82    * Add an item to the recent stack.
  83    *
  84    * @param string $title
  85    *   The title to display.
  86    * @param string $url
  87    *   The link for the above title.
  88    * @param string $id
  89    *   Object id.
  90    * @param $type
  91    * @param int $contactId
  92    * @param string $contactName
  93    * @param array $others
  94    *
  95    * @return void
  96    */
  97   public static function add(
  98     $title,
  99     $url,
 100     $id,
 101     $type,
 102     $contactId,
 103     $contactName,
 104     $others = array()
 105   ) {
 106     self::initialize();
 107     $session = CRM_Core_Session::singleton();
 108
 109     // make sure item is not already present in list
 110     for ($i = 0; $i < count(self::$_recent); $i++) {
 111       if (self::$_recent[$i]['url'] == $url) {
 112         // delete item from array
 113         array_splice(self::$_recent, $i, 1);
 114         break;
 115       }
 116     }
 117
 118     if (!is_array($others)) {
 119       $others = array();
 120     }
 121
 122     array_unshift(self::$_recent,
 123       array(
 124         'title' => $title,
 125         'url' => $url,
 126         'id' => $id,
 127         'type' => $type,
 128         'contact_id' => $contactId,
 129         'contactName' => $contactName,
 130         'subtype' => CRM_Utils_Array::value('subtype', $others),
 131         'isDeleted' => CRM_Utils_Array::value('isDeleted', $others, FALSE),
 132         'image_url' => CRM_Utils_Array::value('imageUrl', $others),
 133         'edit_url' => CRM_Utils_Array::value('editUrl', $others),
 134         'delete_url' => CRM_Utils_Array::value('deleteUrl', $others),
 135       )
 136     );
 137     if (count(self::$_recent) > self::MAX_ITEMS) {
 138       array_pop(self::$_recent);
 139     }
 140
 141     CRM_Utils_Hook::recent(self::$_recent);
 142
 143     $session->set(self::STORE_NAME, self::$_recent);
 144   }
 145
 146   /**
 147    * Delete an item from the recent stack.
 148    *
 149    * @param array $recentItem
 150    *   Array of the recent Item to be removed.
 151    *
 152    * @return void
 153    */
 154   public static function del($recentItem) {
 155     self::initialize();
 156     $tempRecent = self::$_recent;
 157
 158     self::$_recent = '';
 159
 160     // make sure item is not already present in list
 161     for ($i = 0; $i < count($tempRecent); $i++) {
 162       if (!($tempRecent[$i]['id'] == $recentItem['id'] &&
 163         $tempRecent[$i]['type'] == $recentItem['type']
 164       )
 165       ) {
 166         self::$_recent[] = $tempRecent[$i];
 167       }
 168     }
 169
 170     $session = CRM_Core_Session::singleton();
 171     $session->set(self::STORE_NAME, self::$_recent);
 172   }
 173
 174   /**
 175    * Delete an item from the recent stack.
 176    *
 177    * @param string $id
 178    *   Contact id that had to be removed.
 179    *
 180    * @return void
 181    */
 182   public static function delContact($id) {
 183     self::initialize();
 184
 185     $tempRecent = self::$_recent;
 186
 187     self::$_recent = '';
 188
 189     // rebuild recent.
 190     for ($i = 0; $i < count($tempRecent); $i++) {
 191       // don't include deleted contact in recent.
 192       if (CRM_Utils_Array::value('contact_id', $tempRecent[$i]) == $id) {
 193         continue;
 194       }
 195       self::$_recent[] = $tempRecent[$i];
 196     }
 197
 198     $session = CRM_Core_Session::singleton();
 199     $session->set(self::STORE_NAME, self::$_recent);
 200   }
 201
 202 }