library/user.inc

   1 <?php
   2 // Copyright (C) 2010 Brady Miller <brady.g.miller@gmail.com>
   3 //
   4 // This program is free software; you can redistribute it and/or
   5 // modify it under the terms of the GNU General Public License
   6 // as published by the Free Software Foundation; either version 2
   7 // of the License, or (at your option) any later version.
   8
   9
  10 // Set effective user - If no user id is provided, then use the currently logged in user
  11 function effectiveUser($user)
  12 {
  13     return (is_null($user) ? $_SESSION['authUserID'] : $user);
  14 }
  15
  16 /**
  17  * Return user setting(s) from the 'users' table
  18  *
  19  * @param string $label - Setting key
  20  * @param int $user - user id number from users table
  21  * @param int $defaultUser - user id to check as alternative/default
  22  * @return Effective user setting for $label (NULL if does not exist)
  23  */
  24 function getUserSetting($label, $user = null, $defaultUser = 0)
  25 {
  26
  27     $user = effectiveUser($user);
  28
  29   // Collect entry for specified user or 0 (global default user)
  30     $res = sqlQuery("SELECT setting_value FROM user_settings
  31       WHERE (setting_user=? OR setting_user=?) AND setting_label=?
  32       ORDER BY setting_user DESC", array($user, $defaultUser, $label));
  33
  34   // If no entries exist, then return NULL.
  35     return (isset($res['setting_value']) ? $res['setting_value'] : null);
  36 }
  37
  38 /**
  39  * Check if effective user setting matches given value
  40  *
  41  * @param string $label - Setting key
  42  * @param string $value - Setting value
  43  * @param int $user - user id number from users table
  44  * @return boolean - true if setting exist and false if does not exist
  45  */
  46 function checkUserSetting($label, $value, $user = null)
  47 {
  48
  49     $user = effectiveUser($user);
  50
  51     $curval = getUserSetting($label, $user);
  52     if (is_null($curval)) {
  53         return false;
  54     } else {
  55         return ($curval === $value);
  56     }
  57 }
  58
  59 /**
  60  * Set a user setting
  61  *
  62  * @param string $label - Setting key
  63  * @param string $value - Setting value
  64  * @param int $user - user id number from users table
  65  * @param boolean $createDefault - If no current global default value, create one.
  66  * @param boolean $overwrite - If this is set to true, then overwrite the current setting
  67  */
  68 function setUserSetting($label, $value, $user = null, $createDefault = true, $overwrite = true)
  69 {
  70
  71     $user = effectiveUser($user);
  72
  73     $cur_value = getUserSetting($label, $user, $user);
  74
  75   // Check for a custom settings
  76     if (is_null($cur_value)) {
  77         sqlStatement("INSERT INTO user_settings(setting_user, setting_label, setting_value) " .
  78         "VALUES (?,?,?)", array($user, $label, $value));
  79     } elseif (($cur_value !== $value) && $overwrite) {
  80         sqlStatement("UPDATE user_settings SET setting_value=? " .
  81         "WHERE setting_user=? AND setting_label=?", array($value, $user, $label));
  82     }
  83
  84   // Call self to create default token
  85   // (Note this is only done if a default token does not yet exist, thus set overwrite to FALSE))
  86     if ($createDefault) {
  87         setUserSetting($label, $value, 0, false, false);
  88     }
  89 }
  90
  91 //This will remove the selected user setting from the 'user_settings' table.
  92 // $label is used to determine which setting to remove
  93 // $user is the user id number from users table
  94 function removeUserSetting($label, $user = null)
  95 {
  96
  97     $user = effectiveUser($user);
  98
  99   // mdsupport - DELETE has implicit select, no need to check and delete
 100     sqlQuery("DELETE FROM user_settings " .
 101       "WHERE setting_user=? AND setting_label=?", array($user, $label));
 102 }
 103
 104 function getUserIDInfo($id)
 105 {
 106     return sqlQuery("SELECT fname, lname, username FROM users where id=?", array($id));
 107 }
 108
 109 /**
 110  * Function to retain current user's choices from prior sessions
 111  * @param string $uspfx - Caller specified prefix to be used in settings key, typically script name
 112  * @param string $postvar - $_POST variable name containing current value
 113  * @param string $label - Caller specified constant added to $uspfx to create settings key
 114  * @param string $initval - Initial value to be saved in case user setting does not exist
 115  * @return Prior setting (if found) or initial value to be used in script
 116  */
 117 function prevSetting($uspfx, $postvar, $label, $initval)
 118 {
 119
 120     $setting_key = $uspfx.$label;
 121
 122     if (isset($_POST[$postvar])) {
 123         // If script provides current value, store it for future use.
 124         $pset = $_POST[$postvar];
 125         if ($pset != getUserSetting($setting_key)) {
 126             setUserSetting($setting_key, $_POST[$postvar]);
 127         }
 128     } else {
 129         // Script requires prior value
 130         $pset = getUserSetting($setting_key);
 131         if (is_null($pset)) {
 132             setUserSetting($setting_key, $initval);
 133             $pset = getUserSetting($setting_key);
 134         }
 135     }
 136
 137     return $pset;
 138 }