modules/UserPreferences/UserPreference.php

   1 <?php
   2 if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
   3 /*********************************************************************************
   4  * SugarCRM Community Edition is a customer relationship management program developed by
   5  * SugarCRM, Inc. Copyright (C) 2004-2011 SugarCRM Inc.
   6  *
   7  * This program is free software; you can redistribute it and/or modify it under
   8  * the terms of the GNU Affero General Public License version 3 as published by the
   9  * Free Software Foundation with the addition of the following permission added
  10  * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
  11  * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
  12  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
  13  *
  14  * This program is distributed in the hope that it will be useful, but WITHOUT
  15  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  16  * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
  17  * details.
  18  *
  19  * You should have received a copy of the GNU Affero General Public License along with
  20  * this program; if not, see http://www.gnu.org/licenses or write to the Free
  21  * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  22  * 02110-1301 USA.
  23  *
  24  * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
  25  * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
  26  *
  27  * The interactive user interfaces in modified source and object code versions
  28  * of this program must display Appropriate Legal Notices, as required under
  29  * Section 5 of the GNU Affero General Public License version 3.
  30  *
  31  * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
  32  * these Appropriate Legal Notices must retain the display of the "Powered by
  33  * SugarCRM" logo. If the display of the logo is not reasonably feasible for
  34  * technical reasons, the Appropriate Legal Notices must display the words
  35  * "Powered by SugarCRM".
  36  ********************************************************************************/
  37
  38 /*********************************************************************************
  39
  40  * Description: Handles the User Preferences and stores them in a seperate table.
  41  * Portions created by SugarCRM are Copyright (C) SugarCRM, Inc.
  42  * All Rights Reserved.
  43  * Contributor(s): ______________________________________..
  44  ********************************************************************************/
  45
  46 class UserPreference extends SugarBean
  47 {
  48     public $db;
  49     public $field_name_map;
  50
  51     // Stored fields
  52     public $id;
  53     public $date_entered;
  54     public $date_modified;
  55     public $assigned_user_id;
  56     public $assigned_user_name;
  57     public $name;
  58     public $category;
  59     public $contents;
  60     public $deleted;
  61
  62     public $object_name = 'UserPreference';
  63     public $table_name = 'user_preferences';
  64
  65     public $disable_row_level_security = true;
  66     public $module_dir = 'UserPreferences';
  67     public $field_defs = array();
  68     public $field_defs_map = array();
  69     public $new_schema = true;
  70
  71     protected $_userFocus;
  72
  73     // Do not actually declare, use the functions statically
  74     public function __construct(
  75         User $user = null
  76         )
  77     {
  78         parent::SugarBean();
  79
  80         $this->_userFocus = $user;
  81     }
  82
  83     /**
  84      * Get preference by name and category. Lazy loads preferences from the database per category
  85      *
  86      * @param string $name name of the preference to retreive
  87      * @param string $category name of the category to retreive, defaults to global scope
  88      * @return mixed the value of the preference (string, array, int etc)
  89      */
  90     public function getPreference(
  91         $name,
  92         $category = 'global'
  93         )
  94     {
  95         global $sugar_config;
  96
  97         $user = $this->_userFocus;
  98
  99         // if the unique key in session doesn't match the app or prefereces are empty
 100         if(!isset($_SESSION[$user->user_name.'_PREFERENCES'][$category]) || (!empty($_SESSION['unique_key']) && $_SESSION['unique_key'] != $sugar_config['unique_key'])) {
 101             $this->loadPreferences($category);
 102         }
 103         if(isset($_SESSION[$user->user_name.'_PREFERENCES'][$category][$name])) {
 104             return $_SESSION[$user->user_name.'_PREFERENCES'][$category][$name];
 105         }
 106
 107         // check to see if a default preference ( i.e. $sugar_config setting ) exists for this value )
 108         // if so, return it
 109         $value = $this->getDefaultPreference($name,$category);
 110         if ( !is_null($value) ) {
 111             return $value;
 112         }
 113         return null;
 114     }
 115
 116     /**
 117      * Get preference by name and category from the system settings.
 118      *
 119      * @param string $name name of the preference to retreive
 120      * @param string $category name of the category to retreive, defaults to global scope
 121      * @return mixed the value of the preference (string, array, int etc)
 122      */
 123     public function getDefaultPreference(
 124         $name,
 125         $category = 'global'
 126         )
 127     {
 128         global $sugar_config;
 129
 130         // Doesn't support any prefs but global ones
 131         if ( $category != 'global' )
 132             return null;
 133
 134         // First check for name matching $sugar_config variable
 135         if ( isset($sugar_config[$name]) )
 136             return $sugar_config[$name];
 137
 138         // Next, check to see if it's one of the common problem ones
 139         if ( isset($sugar_config['default_'.$name]) )
 140             return $sugar_config['default_'.$name];
 141         if ( $name == 'datef' )
 142             return $sugar_config['default_date_format'];
 143         if ( $name == 'timef' )
 144             return $sugar_config['default_time_format'];
 145         if ( $name == 'email_link_type' )
 146             return $sugar_config['email_default_client'];
 147     }
 148
 149     /**
 150      * Set preference by name and category. Saving will be done in utils.php -> sugar_cleanup
 151      *
 152      * @param string $name name of the preference to retreive
 153      * @param mixed $value value of the preference to set
 154      * @param string $category name of the category to retreive, defaults to global scope
 155      */
 156     public function setPreference(
 157         $name,
 158         $value,
 159         $category = 'global'
 160         )
 161     {
 162         $user = $this->_userFocus;
 163
 164         if ( empty($user->user_name) )
 165             return;
 166
 167         if(!isset($_SESSION[$user->user_name.'_PREFERENCES'][$category])) {
 168             if(!$user->loadPreferences($category))
 169                 $_SESSION[$user->user_name.'_PREFERENCES'][$category] = array();
 170         }
 171
 172         // preferences changed or a new preference, save it to DB
 173         if(!isset($_SESSION[$user->user_name.'_PREFERENCES'][$category][$name])
 174             || (isset($_SESSION[$user->user_name.'_PREFERENCES'][$category][$name]) && $_SESSION[$user->user_name.'_PREFERENCES'][$category][$name] != $value)) {
 175                 $GLOBALS['savePreferencesToDB'] = true;
 176                 if(!isset($GLOBALS['savePreferencesToDBCats'])) $GLOBALS['savePreferencesToDBCats'] = array();
 177                 $GLOBALS['savePreferencesToDBCats'][$category] = true;
 178         }
 179
 180         $_SESSION[$user->user_name.'_PREFERENCES'][$category][$name] = $value;
 181     }
 182
 183     /**
 184      * Loads preference by category from database. Saving will be done in utils.php -> sugar_cleanup
 185      *
 186      * @param string $category name of the category to retreive, defaults to global scope
 187      * @return bool successful?
 188      */
 189     public function loadPreferences(
 190         $category = 'global'
 191         )
 192     {
 193         global $sugar_config;
 194
 195         $user = $this->_userFocus;
 196
 197         if($user->object_name != 'User')
 198             return;
 199         if(!empty($user->id) && (!isset($_SESSION[$user->user_name . '_PREFERENCES'][$category]) || (!empty($_SESSION['unique_key']) && $_SESSION['unique_key'] != $sugar_config['unique_key']))) {
 200             // cn: moving this to only log when valid - throwing errors on install
 201             return $this->reloadPreferences($category);
 202         }
 203         return false;
 204     }
 205
 206     /**
 207      * Unconditionally reloads user preferences from the DB and updates the session
 208      * @param string $category name of the category to retreive, defaults to global scope
 209      * @return bool successful?
 210      */
 211     public function reloadPreferences($category = 'global')
 212     {
 213         $user = $this->_userFocus;
 214
 215         if($user->object_name != 'User' || empty($user->id) || empty($user->user_name)) {
 216             return false;
 217         }
 218         $GLOBALS['log']->debug('Loading Preferences DB ' . $user->user_name);
 219         if(!isset($_SESSION[$user->user_name . '_PREFERENCES'])) $_SESSION[$user->user_name . '_PREFERENCES'] = array();
 220         if(!isset($user->user_preferences) || !is_array($user->user_preferences)) $user->user_preferences = array();
 221         $result = $GLOBALS['db']->query("SELECT contents FROM user_preferences WHERE assigned_user_id='$user->id' AND category = '" . $category . "' AND deleted = 0", false, 'Failed to load user preferences');
 222         $row = $GLOBALS['db']->fetchByAssoc($result);
 223         if ($row) {
 224             $_SESSION[$user->user_name . '_PREFERENCES'][$category] = unserialize(base64_decode($row['contents']));
 225             $user->user_preferences[$category] = unserialize(base64_decode($row['contents']));
 226             return true;
 227         } else {
 228             $_SESSION[$user->user_name . '_PREFERENCES'][$category] = array();
 229             $user->user_preferences[$category] = array();
 230         }
 231         return false;
 232     }
 233
 234     /**
 235      * Loads users timedate preferences
 236      *
 237      * @return array 'date' - date format for user ; 'time' - time format for user
 238      */
 239     public function getUserDateTimePreferences()
 240     {
 241         global $sugar_config, $db, $timezones, $timedate, $current_user;
 242
 243                 require_once('include/timezone/timezones.php');
 244
 245         $user = $this->_userFocus;
 246
 247         $prefDate = array();
 248
 249         if(!empty($user) && $this->loadPreferences('global')) {
 250             // forced to set this to a variable to compare b/c empty() wasn't working
 251             $timeZone = $user->getPreference("timezone");
 252             $timeFormat = $user->getPreference("timef");
 253             $dateFormat = $user->getPreference("datef");
 254
 255             // cn: bug xxxx cron.php fails because of missing preference when admin hasn't logged in yet
 256             $timeZone = empty($timeZone) ? 'America/Los_Angeles' : $timeZone;
 257
 258             if(empty($timeZone)) $timeZone = '';
 259             if(empty($timeFormat)) $timeFormat = $sugar_config['default_time_format'];
 260             if(empty($dateFormat)) $dateFormat = $sugar_config['default_date_format'];
 261
 262             $equinox = date('I');
 263
 264             $serverHourGmt = date('Z') / 60 / 60;
 265
 266             $userOffsetFromServerHour = $user->getPreference("timez");
 267
 268             $userHourGmt = $serverHourGmt + $userOffsetFromServerHour;
 269
 270             $prefDate['date'] = $dateFormat;
 271             $prefDate['time'] = $timeFormat;
 272             $prefDate['userGmt'] = "(GMT".($timezones[$timeZone]['gmtOffset'] / 60).")";
 273             $prefDate['userGmtOffset'] = $timezones[$timeZone]['gmtOffset'] / 60;
 274
 275             return $prefDate;
 276         } else {
 277             $prefDate['date'] = $timedate->get_date_format();
 278             $prefDate['time'] = $timedate->get_time_format();
 279
 280             if(!empty($user) && $user->object_name == 'User') {
 281                 $timeZone = $user->getPreference("timezone");
 282                 // cn: bug 9171 - if user has no time zone, cron.php fails for InboundEmail
 283                 if(!empty($timeZone)) {
 284                     $prefDate['userGmt'] = "(GMT".($timezones[$timeZone]['gmtOffset'] / 60).")";
 285                     $prefDate['userGmtOffset'] = $timezones[$timeZone]['gmtOffset'] / 60;
 286                 }
 287             } else {
 288                 $timeZone = $current_user->getPreference("timezone");
 289                 if(!empty($timeZone)) {
 290                     $prefDate['userGmt'] = "(GMT".($timezones[$timeZone]['gmtOffset'] / 60).")";
 291                     $prefDate['userGmtOffset'] = $timezones[$timeZone]['gmtOffset'] / 60;
 292                 }
 293             }
 294
 295             return $prefDate;
 296         }
 297     }
 298
 299     /**
 300      * Saves all preferences into the database that are in the session. Expensive, this is called by default in
 301      * sugar_cleanup if a setPreference has been called during one round trip.
 302      *
 303      * @global user will use current_user if no user specificed in $user param
 304      * @param user $user User object to retrieve, otherwise user current_user
 305      * @param bool $all save all of the preferences? (Dangerous)
 306      *
 307      */
 308     public function savePreferencesToDB(
 309         $all = false
 310         )
 311     {
 312         global $sugar_config;
 313         $GLOBALS['savePreferencesToDB'] = false;
 314
 315         $user = $this->_userFocus;
 316
 317         // these are not the preferences you are looking for [ hand waving ]
 318         if(!empty($_SESSION['unique_key']) && $_SESSION['unique_key'] != $sugar_config['unique_key']) return;
 319
 320         $GLOBALS['log']->debug('Saving Preferences to DB ' . $user->user_name);
 321         if(isset($_SESSION[$user->user_name. '_PREFERENCES']) && is_array($_SESSION[$user->user_name. '_PREFERENCES'])) {
 322              $GLOBALS['log']->debug("Saving Preferences to DB: {$user->user_name}");
 323             // only save the categories that have been modified or all?
 324             if(!$all && isset($GLOBALS['savePreferencesToDBCats']) && is_array($GLOBALS['savePreferencesToDBCats'])) {
 325                 $catsToSave = array();
 326                 foreach($GLOBALS['savePreferencesToDBCats'] as $category => $value) {
 327                     if ( isset($_SESSION[$user->user_name. '_PREFERENCES'][$category]) )
 328                         $catsToSave[$category] = $_SESSION[$user->user_name. '_PREFERENCES'][$category];
 329                 }
 330             }
 331             else {
 332                 $catsToSave = $_SESSION[$user->user_name. '_PREFERENCES'];
 333             }
 334
 335             foreach ($catsToSave as $category => $contents) {
 336                 $focus = new UserPreference($this->_userFocus);
 337                 $result = $focus->retrieve_by_string_fields(array(
 338                     'assigned_user_id' => $user->id,
 339                     'category' => $category,
 340                     ));
 341                 $focus->assigned_user_id = $user->id; // MFH Bug #13862
 342                 $focus->deleted = 0;
 343                 $focus->contents = base64_encode(serialize($contents));
 344                 $focus->category = $category;
 345                 $focus->save();
 346             }
 347         }
 348     }
 349
 350     /**
 351      * Resets preferences for a particular user. If $category is null all user preferences will be reset
 352      *
 353      * @param string $category category to reset
 354      */
 355     public function resetPreferences(
 356         $category = null
 357         )
 358     {
 359         $user = $this->_userFocus;
 360
 361         $GLOBALS['log']->debug('Reseting Preferences for user ' . $user->user_name);
 362
 363         $remove_tabs = $this->getPreference('remove_tabs');
 364         $favorite_reports = $this->getPreference('favorites', 'Reports');
 365         $home_pages = $this->getPreference('pages', 'home');
 366         $home_dashlets = $this->getPreference('dashlets', 'home');
 367         $ut = $this->getPreference('ut');
 368         $timezone = $this->getPreference('timezone');
 369
 370         $query = "UPDATE user_preferences SET deleted = 1 WHERE assigned_user_id = '" . $user->id . "'";
 371         if($category)
 372             $query .= " AND category = '" . $category . "'";
 373         $this->db->query($query);
 374
 375
 376         if($category) {
 377             unset($_SESSION[$user->user_name."_PREFERENCES"][$category]);
 378         }
 379         else {
 380                 if(!empty($_COOKIE['sugar_user_theme']) && !headers_sent()){
 381                 setcookie('sugar_user_theme', '', time() - 3600); // expire the sugar_user_theme cookie
 382             }
 383             unset($_SESSION[$user->user_name."_PREFERENCES"]);
 384             if($user->id == $GLOBALS['current_user']->id) {
 385                 session_destroy();
 386             }
 387             $this->setPreference('remove_tabs', $remove_tabs);
 388             $this->setPreference('favorites', $favorite_reports, 'Reports');
 389             $this->setPreference('pages', $home_pages, 'home');
 390             $this->setPreference('dashlets', $home_dashlets, 'home');
 391             $this->setPreference('ut', $ut);
 392             $this->setPreference('timezone', $timezone);
 393             $this->savePreferencesToDB();
 394             if($user->id == $GLOBALS['current_user']->id) {
 395                 SugarApplication::redirect('index.php');
 396             }
 397         }
 398     }
 399
 400     /**
 401      * Updates every user pref with a new key value supports 2 levels deep, use append to
 402      * array if you want to append the value to an array
 403      */
 404     public static function updateAllUserPrefs(
 405         $key,
 406         $new_value,
 407         $sub_key = '',
 408         $is_value_array = false,
 409         $unset_value = false )
 410     {
 411         global $current_user, $db;
 412
 413         // Admin-only function; die if calling as a non-admin
 414         if(!is_admin($current_user)){
 415             sugar_die('only admins may call this function');
 416         }
 417
 418         // we can skip this if we've already upgraded to the user_preferences format.
 419         if ( !array_key_exists('user_preferences',$db->getHelper()->get_columns('users')) )
 420             return;
 421
 422         $result = $db->query("SELECT id, user_preferences, user_name FROM users");
 423         while ($row = $db->fetchByAssoc($result)) {
 424             $prefs = array();
 425             $newprefs = array();
 426
 427             $prefs = unserialize(base64_decode($row['user_preferences']));
 428
 429             if(!empty($sub_key)){
 430                 if($is_value_array ){
 431                     if(!isset($prefs[$key][$sub_key])){
 432                         continue;
 433                     }
 434
 435                     if(empty($prefs[$key][$sub_key])){
 436                         $prefs[$key][$sub_key] = array();
 437                     }
 438                     $already_exists = false;
 439                     foreach($prefs[$key][$sub_key] as $k=>$value){
 440                         if($value == $new_value){
 441
 442                             $already_exists = true;
 443                             if($unset_value){
 444                                 unset($prefs[$key][$sub_key][$k]);
 445                             }
 446                         }
 447                     }
 448                     if(!$already_exists && !$unset_value){
 449                         $prefs[$key][$sub_key][] = $new_value;
 450                     }
 451                 }
 452                 else{
 453                     if(!$unset_value)$prefs[$key][$sub_key] = $new_value;
 454                 }
 455             }
 456             else{
 457                 if($is_value_array ){
 458                     if(!isset($prefs[$key])){
 459                         continue;
 460                     }
 461
 462                     if(empty($prefs[$key])){
 463                         $prefs[$key] = array();
 464                     }
 465                     $already_exists = false;
 466                     foreach($prefs[$key] as $k=>$value){
 467                         if($value == $new_value){
 468                             $already_exists = true;
 469
 470                             if($unset_value){
 471                                 unset($prefs[$key][$k]);
 472                             }
 473                         }
 474                     }
 475                     if(!$already_exists && !$unset_value){
 476
 477                         $prefs[$key][] = $new_value;
 478                     }
 479                 }else{
 480                     if(!$unset_value)$prefs[$key] = $new_value;
 481                 }
 482             }
 483
 484             $newstr = $GLOBALS['db']->quote(base64_encode(serialize($prefs)));
 485             $db->query("UPDATE users SET user_preferences = '{$newstr}' WHERE id = '{$row['id']}'");
 486         }
 487
 488         unset($prefs);
 489         unset($newprefs);
 490         unset($newstr);
 491     }
 492 }