inc/libs/surfbar_functions.php

   1 <?php
   2 /************************************************************************
   3  * MXChange v0.2.1                                    Start: 08/31/2008 *
   4  * ===============                              Last change: 08/31/2008 *
   5  *                                                                      *
   6  * -------------------------------------------------------------------- *
   7  * File              : surfbar_functions.php                            *
   8  * -------------------------------------------------------------------- *
   9  * Short description : Functions for surfbar                            *
  10  * -------------------------------------------------------------------- *
  11  * Kurzbeschreibung  : Funktionen fuer die Surfbar                      *
  12  * -------------------------------------------------------------------- *
  13  *                                                                      *
  14  * -------------------------------------------------------------------- *
  15  * Copyright (c) 2003 - 2008 by Roland Haeder                           *
  16  * For more information visit: http://www.mxchange.org                  *
  17  *                                                                      *
  18  * This program is free software; you can redistribute it and/or modify *
  19  * it under the terms of the GNU General Public License as published by *
  20  * the Free Software Foundation; either version 2 of the License, or    *
  21  * (at your option) any later version.                                  *
  22  *                                                                      *
  23  * This program is distributed in the hope that it will be useful,      *
  24  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
  25  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
  26  * GNU General Public License for more details.                         *
  27  *                                                                      *
  28  * You should have received a copy of the GNU General Public License    *
  29  * along with this program; if not, write to the Free Software          *
  30  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
  31  * MA  02110-1301  USA                                                  *
  32  ************************************************************************/
  33
  34 // Some security stuff...
  35 if (ereg(basename(__FILE__), $_SERVER['PHP_SELF'])) {
  36         $INC = substr(dirname(__FILE__), 0, strpos(dirname(__FILE__), "/inc") + 4) . "/security.php";
  37         require($INC);
  38 }
  39
  40 // Admin has added an URL with given user id
  41 function SURFBAR_ADMIN_ADD_URL ($url, $uid, $reward, $costs, $paymentId) {
  42         // Is this really an admin?
  43         if (!IS_ADMIN()) {
  44                 // Then leave here
  45                 return false;
  46         } // END - if
  47
  48         // Check if that URL does not exist
  49         if (SURFBAR_LOOKUP_BY_URL($url, $uid)) {
  50                 // Already found!
  51                 return false;
  52         } // END - if
  53
  54         // Register the new URL
  55         return SURFBAR_REGISTER_URL($url, $uid, $reward, $costs, $paymentId, "CONFIRMED", "unlock");
  56 }
  57 // Looks up by an URL
  58 function SURFBAR_LOOKUP_BY_URL ($url) {
  59         // Now lookup that given URL by itself
  60         $urlArray = SURFBAR_GET_URL_DATA($url, "url");
  61
  62         // Was it found?
  63         return (count($urlArray) > 0);
  64 }
  65 // Load URL data by given search term and column
  66 function SURFBAR_GET_URL_DATA ($searchTerm, $column="id", $order="id", $sort="ASC", $group="id") {
  67         global $lastUrlData;
  68
  69         // By default nothing is found
  70         $lastUrlData = array();
  71
  72         // Is the column an id number?
  73         if (($column == "id") || ($column == "userid")) {
  74                 // Extra secure input
  75                 $searchTerm = bigintval($searchTerm);
  76         } // END - if
  77
  78         // Look up the record
  79         $result = SQL_QUERY_ESC("SELECT id, userid, url, reward, costs, views_total, status, registered, last_locked, lock_reason
  80 FROM "._MYSQL_PREFIX."_surfbar_urls
  81 WHERE %s='%s'
  82 ORDER BY %s %s",
  83                 array($column, $searchTerm, $order, $sort), __FILE__, __LINE__);
  84
  85         // Is there at least one record?
  86         if (SQL_NUMROWS($result) > 0) {
  87                 // Then load all!
  88                 while ($dataRow = SQL_FETCHARRAY($result)) {
  89                         // Shall we group these results?
  90                         if ($group == "id") {
  91                                 // Add the row by id as index
  92                                 $lastUrlData[$dataRow['id']] = $dataRow;
  93                         } else {
  94                                 // Group entries
  95                                 $lastUrlData[$dataRow[$group]][$dataRow['id']] = $dataRow;
  96                         }
  97                 } // END - while
  98         } // END - if
  99
 100         // Free the result
 101         SQL_FREERESULT($result);
 102
 103         // Return the result
 104         return $lastUrlData;
 105 }
 106 // Registers an URL with the surfbar. You should have called SURFBAR_LOOKUP_BY_URL() first!
 107 function SURFBAR_REGISTER_URL ($url, $uid, $reward, $paymentId, $costs, $status="PENDING", $addMode="reg") {
 108         global $_CONFIG;
 109
 110         // Make sure by the user registered URLs are always pending
 111         if ($addMode == "reg") $status = "PENDING";
 112
 113         // Prepare content
 114         $content = array(
 115                 'url'         => $url,
 116                 'frametester' => FRAMETESTER($url),
 117                 'uid'         => $uid,
 118                 'reward'      => $reward,
 119                 'costs'       => $costs,
 120                 'payment_id'  => $paymentId,
 121                 'status'      => $status
 122         );
 123
 124         // Insert the URL into database
 125         $content['insert_id'] = SURFBAR_INSERT_URL_BY_ARRAY($content);
 126
 127         // Translate status, reward and costs
 128         $content['status'] = SURFBAR_TRANSLATE_STATUS($content['status']);
 129         $content['reward'] = TRANSLATE_COMMA($content['reward']);
 130         $content['costs']  = TRANSLATE_COMMA($content['costs']);
 131
 132         // If in reg-mode we notify admin
 133         if (($addMode == "reg") || ($_CONFIG['surfbar_notify_admin_unlock'] == "Y")) {
 134                 // Notify admin even when he as unlocked an email
 135                 SURFBAR_NOTIFY_ADMIN("url_{$addMode}", $content);
 136         } // END - if
 137
 138         // Send mail to user
 139         SURFBAR_NOTIFY_USER("url_{$addMode}", $content);
 140
 141         // Return the insert id
 142         return $content['insert_id'];
 143 }
 144 // Inserts an url by given data array and return the insert id
 145 function SURFBAR_INSERT_URL_BY_ARRAY ($urlData) {
 146         // Just run the insert query for now
 147         SQL_QUERY_ESC("INSERT INTO "._MYSQL_PREFIX."_surfbar_urls (userid, url, reward, costs, payment_id, status) VALUES(%s, '%s', %s, %s, %s, '%s')",
 148                 array(
 149                         bigintval($urlData['uid']),
 150                         $urlData['url'],
 151                         (float)$urlData['reward'],
 152                         (float)$urlData['costs'],
 153                         bigintval($urlData['payment_id']),
 154                         $urlData['status']
 155                 ), __FILE__, __LINE__
 156         );
 157
 158         // Return insert id
 159         return SQL_INSERTID();
 160 }
 161 // Notify admin(s) with a selected message and content
 162 function SURFBAR_NOTIFY_ADMIN ($messageType, $content) {
 163         // Prepare template name
 164         $templateName = sprintf("admin_surfbar_%s", $messageType);
 165
 166         // Prepare subject
 167         $eval = sprintf("\$subject = ADMIN_SURFBAR_NOTIFY_%s_SUBJECT;",
 168                 strtoupper($messageType)
 169         );
 170         eval($eval);
 171
 172         // Send the notification out
 173         SEND_ADMIN_NOTIFICATION($subject, $templateName, $content, $content['uid']);
 174 }
 175 // Notify the user about the performed action
 176 function SURFBAR_NOTIFY_USER ($messageType, $content) {
 177         // Prepare template name
 178         $templateName = sprintf("member_surfbar_%s", $messageType);
 179
 180         // Prepare subject
 181         $eval = sprintf("\$subject = MEMBER_SURFBAR_NOTIFY_%s_SUBJECT;",
 182                 strtoupper($messageType)
 183         );
 184         eval($eval);
 185
 186         // Load template
 187         $mailText = LOAD_EMAIL_TEMPLATE($templateName, $content);
 188
 189         // Send the email
 190         SEND_EMAIL($content['uid'], $subject, $mailText);
 191 }
 192 // Translate the URL status
 193 function SURFBAR_TRANSLATE_STATUS ($status) {
 194         // Create constant name
 195         $constantName = sprintf("SURFBAR_URL_STATUS_%s", strtoupper($status));
 196
 197         // Set default translated status
 198         $statusTranslated = "!".$constantName."!";
 199
 200         // Generate eval() command
 201         if (defined($constantName)) {
 202                 $eval = "\$statusTranslated = ".$constantName.";";
 203                 eval($eval);
 204         } // END - if
 205
 206         // Return result
 207         return $statusTranslated;
 208 }
 209 // Determine right template name
 210 function SURFBAR_DETERMINE_TEMPLATE_NAME() {
 211         // Default is the frameset
 212         $templateName = "surfbar_frameset";
 213
 214         // Any frame set? ;-)
 215         if (isset($_GET['frame'])) {
 216                 // Use the frame as a template name part... ;-)
 217                 $templateName = sprintf("surfbar_frame_%s",
 218                         SQL_ESCAPE($_GET['frame'])
 219                 );
 220         } // END - if
 221
 222         // Return result
 223         return $templateName;
 224 }
 225 // Check if the "reload lock" of the current user is full, call this function
 226 // before you call SURFBAR_CHECK_RELOAD_LOCK().
 227 function SURFBAR_CHECK_RELOAD_FULL() {
 228         global $SURFBAR_CACHE, $_CONFIG;
 229
 230         // Default is full!
 231         $isFull = true;
 232
 233         // Do we have static or dynamic mode?
 234         if ($_CONFIG['surfbar_pay_model'] == "STATIC") {
 235                 // Cache static reload lock
 236                 $SURFBAR_CACHE['surf_lock'] = $_CONFIG['surfbar_static_lock'];
 237
 238                 // Ask the database
 239                 $result = SQL_QUERY_ESC("SELECT COUNT(id) AS cnt FROM "._MYSQL_PREFIX."_surfbar_locks
 240 WHERE userid=%s AND (UNIX_TIMESTAMP() - ".SURFBAR_GET_DATA('surf_lock').") < UNIX_TIMESTAMP(last_surfed)
 241 LIMIT 1",
 242                         array($GLOBALS['userid']), __FILE__, __LINE__
 243                 );
 244
 245                 // Fetch row
 246                 list($SURFBAR_CACHE['user_locks']) = SQL_FETCHROW($result);
 247
 248                 // Is it null?
 249                 if (is_null($SURFBAR_CACHE['user_locks'])) {
 250                         // Then fix it to zero!
 251                         $SURFBAR_CACHE['user_locks'] = 0;
 252                 } // END - if
 253
 254                 // Free result
 255                 SQL_FREERESULT($result);
 256
 257                 // Get total URLs
 258                 $total = SURFBAR_GET_TOTAL_URLS();
 259
 260                 // Do we have some URLs in lock? Admins can always surf on own URLs!
 261                 //* DEBUG: */ echo __FUNCTION__.":userLocks=".SURFBAR_GET_DATA('user_locks').",total={$total}<br />\n";
 262                 $isFull = ((SURFBAR_GET_DATA('user_locks') == $total) && ($total > 0));
 263         } else {
 264                 // Dynamic model...
 265                 die("DYNAMIC not yet implemented!");
 266         }
 267
 268         // Return result
 269         return $isFull;
 270 }
 271 // Get total amount of URLs of given status for current user or of CONFIRMED URLs by default
 272 function SURFBAR_GET_TOTAL_URLS ($status="CONFIRMED") {
 273         // Get amount from database
 274         $result = SQL_QUERY_ESC("SELECT COUNT(id) AS cnt
 275 FROM "._MYSQL_PREFIX."_surfbar_urls
 276 WHERE userid != %d AND status='%s'",
 277                 array($GLOBALS['userid'], $status), __FILE__, __LINE__
 278         );
 279
 280         // Fetch row
 281         list($cnt) = SQL_FETCHROW($result);
 282
 283         // Free result
 284         SQL_FREERESULT($result);
 285
 286         // Return result
 287         return $cnt;
 288 }
 289 // Generate a validation code for the given id number
 290 function SURFBAR_GENERATE_VALIDATION_CODE ($id, $salt="") {
 291         global $_CONFIG, $SURFBAR_CACHE;
 292
 293         // Generate a code until the length matches
 294         $valCode = "";
 295         while (strlen($valCode) != $_CONFIG['code_length']) {
 296                 // Is the salt set?
 297                 if (empty($salt)) {
 298                         // Generate random hashed string
 299                         $SURFBAR_CACHE['salt'] = sha1(GEN_PASS(255));
 300                 } else {
 301                         // Use this as salt!
 302                         $SURFBAR_CACHE['salt'] = $salt;
 303                 }
 304                 //* DEBUG: */ echo __FUNCTION__.":".SURFBAR_GET_SALT()."*<br />\n";
 305
 306                 // ... and now the validation code
 307                 $valCode = GEN_RANDOM_CODE($_CONFIG['code_length'], sha1(SURFBAR_GET_SALT().":".$id), $GLOBALS['userid']);
 308                 //* DEBUG: */ echo __FUNCTION__.":valCode={$valCode}<br />\n";
 309         } // END - while
 310
 311         // Hash it with md5() and salt it with the random string
 312         $hashedCode = generateHash(md5($valCode), SURFBAR_GET_SALT());
 313
 314         // Finally encrypt it PGP-like and return it
 315         return generatePassString($hashedCode);
 316 }
 317 // Check validation code
 318 function SURFBAR_CHECK_VALIDATION_CODE ($id, $check, $salt) {
 319         global $SURFBAR_CACHE;
 320
 321         // Secure id number
 322         $id = bigintval($id);
 323
 324         // Now generate the code again
 325         $code = SURFBAR_GENERATE_VALIDATION_CODE($id, $salt);
 326
 327         // Return result of checking hashes and salts
 328         //* DEBUG: */ echo __FUNCTION__.":---".$code."---<br />\n---".$check."---<br />\n";
 329         //* DEBUG: */ echo __FUNCTION__.":+++".$salt."+++<br />\n+++".SURFBAR_GET_DATA('last_salt')."+++<br />\n";
 330         return (($code == $check) && ($salt == SURFBAR_GET_DATA('last_salt')));
 331 }
 332 // Lockdown the userid/id combination (reload lock)
 333 function SURFBAR_LOCKDOWN_ID ($id) {
 334         //* DEBUG: */ print "LOCK!<br />\n";
 335         //* DEBUG: */ return;
 336         // Just add it to the database
 337         SQL_QUERY_ESC("INSERT INTO "._MYSQL_PREFIX."_surfbar_locks (userid, url_id) VALUES(%s, %s)",
 338                 array($GLOBALS['userid'], bigintval($id)), __FILE__, __LINE__);
 339
 340         // Remove the salt from database
 341         SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM "._MYSQL_PREFIX."_surfbar_salts WHERE url_id=%s AND userid=%s LIMIT 1",
 342                 array(bigintval($id), $GLOBALS['userid']), __FILE__, __LINE__);
 343 }
 344 // Pay points to the user and remove it from the sender
 345 function SURFBAR_PAY_POINTS ($id) {
 346         global $SURFBAR_CACHE, $_CONFIG;
 347
 348         // Re-configure ref-system to surfbar levels
 349         $_CONFIG['db_percents'] = "percent";
 350         $_CONFIG['db_table']    = "surfbar_reflevels";
 351
 352         // Book it to the user
 353         ADD_POINTS_REFSYSTEM($GLOBALS['userid'], SURFBAR_GET_DATA('reward'));
 354
 355         // Remove it from the URL owner
 356         SUB_POINTS($SURFBAR_CACHE['userid'], SURFBAR_GET_DATA('costs'));
 357 }
 358 // Update the salt for validation
 359 function SURFBAR_UPDATE_SALT() {
 360         // Update views_total
 361         SQL_QUERY_ESC("UPDATE "._MYSQL_PREFIX."_surfbar_urls SET views_total=views_total+1 WHERE id=%s LIMIT 1",
 362                 array(SURFBAR_GET_ID()), __FILE__, __LINE__);
 363
 364         // Simply store the salt from cache away in database...
 365         SQL_QUERY_ESC("UPDATE "._MYSQL_PREFIX."_surfbar_salts SET last_salt='%s' WHERE url_id=%s AND userid=%s LIMIT 1",
 366                 array(SURFBAR_GET_SALT(), SURFBAR_GET_ID(), $GLOBALS['userid']), __FILE__, __LINE__);
 367
 368         // Was that okay?
 369         if (SQL_AFFECTEDROWS() == 0) {
 370                 // Insert missing entry!
 371                 SQL_QUERY_ESC("INSERT INTO "._MYSQL_PREFIX."_surfbar_salts (url_id,userid,last_salt) VALUES(%s, %s, '%s')",
 372                         array(SURFBAR_GET_ID(), $GLOBALS['userid'], SURFBAR_GET_SALT()), __FILE__, __LINE__);
 373         } // END - if
 374
 375         // Return if the update was okay
 376         return (SQL_AFFECTEDROWS() == 1);
 377 }
 378 // Check if the reload lock is active for given id
 379 function SURFBAR_CHECK_RELOAD_LOCK ($id) {
 380         //* DEBUG: */ echo __FUNCTION__.":id={$id}<br />\n";
 381         // Ask the database
 382         $result = SQL_QUERY_ESC("SELECT COUNT(id) AS cnt
 383 FROM "._MYSQL_PREFIX."_surfbar_locks
 384 WHERE userid=%s AND url_id=%s AND (UNIX_TIMESTAMP() - ".SURFBAR_GET_DATA('surf_lock').") < UNIX_TIMESTAMP(last_surfed)
 385 ORDER BY last_surfed ASC
 386 LIMIT 1",
 387                 array($GLOBALS['userid'], bigintval($id)), __FILE__, __LINE__
 388         );
 389
 390         // Fetch counter
 391         list($cnt) = SQL_FETCHROW($result);
 392
 393         // Free result
 394         SQL_FREERESULT($result);
 395
 396         // Return check
 397         //* DEBUG: */ echo __FUNCTION__.":cnt={$cnt}<br />\n";
 398         return ($cnt == 1);
 399 }
 400 // Determine next id for surfbar view, always call this before you call other
 401 // getters below this function!!!
 402 function SURFBAR_GET_NEXT_ID ($id = 0) {
 403         global $SURFBAR_CACHE, $_CONFIG;
 404
 405         // Default is no id!
 406         $nextId = 0; $randNum = 0;
 407
 408         // Is the ID set?
 409         if ($id == 0) {
 410                 // Set max random factor to total URLs minus 1
 411                 $maxRand = SURFBAR_GET_TOTAL_URLS() - 1;
 412
 413                 // If more than one URL can be called generate the random number!
 414                 if ($maxRand > 1) {
 415                         // Generate random number
 416                         $randNum = mt_rand(0, $maxRand);
 417                 } // END - if
 418
 419                 // And query the database
 420                 //* DEBUG: */ echo __FUNCTION__.":randNum={$randNum},maxRand={$maxRand}<br />\n";
 421                 $result = SQL_QUERY_ESC("SELECT sbu.id, sbu.userid, sbu.url, sbs.last_salt, sbu.reward, sbu.costs, sbu.views_total, p.time, UNIX_TIMESTAMP(l.last_surfed) AS last_surfed
 422 FROM "._MYSQL_PREFIX."_surfbar_urls AS sbu
 423 LEFT JOIN "._MYSQL_PREFIX."_payments AS p
 424 ON sbu.payment_id=p.id
 425 LEFT JOIN "._MYSQL_PREFIX."_surfbar_salts AS sbs
 426 ON sbu.id=sbs.url_id
 427 LEFT JOIN "._MYSQL_PREFIX."_surfbar_locks AS l
 428 ON sbu.id=l.url_id
 429 WHERE sbu.userid != %d AND sbu.status='CONFIRMED' AND (l.last_surfed IS NULL OR (UNIX_TIMESTAMP() - ".SURFBAR_GET_DATA('surf_lock').") >= UNIX_TIMESTAMP(l.last_surfed))
 430 ORDER BY l.last_surfed DESC, sbs.last_salt ASC, sbu.id ASC
 431 LIMIT %d,1",
 432                         array($GLOBALS['userid'], $randNum), __FILE__, __LINE__
 433                 );
 434         } else {
 435                 // Get data from specified id number
 436                 $result = SQL_QUERY_ESC("SELECT sbu.id, sbu.userid, sbu.url, sbs.last_salt, sbu.reward, sbu.costs, sbu.views_total, p.time
 437 FROM "._MYSQL_PREFIX."_surfbar_urls AS sbu
 438 LEFT JOIN "._MYSQL_PREFIX."_payments AS p
 439 ON sbu.payment_id=p.id
 440 LEFT JOIN "._MYSQL_PREFIX."_surfbar_salts AS sbs
 441 ON sbu.id=sbs.url_id
 442 WHERE sbu.userid != %s AND sbu.status='CONFIRMED' AND sbu.id=%s
 443 LIMIT 1",
 444                         array($GLOBALS['userid'], bigintval($id)), __FILE__, __LINE__
 445                 );
 446         }
 447
 448         // Is there an id number?
 449         if (SQL_NUMROWS($result) == 1) {
 450                 // Load/cache data
 451                 //* DEBUG: */ echo __FUNCTION__.":".count($SURFBAR_CACHE)."*<br />\n";
 452                 $SURFBAR_CACHE = merge_array($SURFBAR_CACHE, SQL_FETCHARRAY($result));
 453                 //* DEBUG: */ echo __FUNCTION__.":".count($SURFBAR_CACHE)."*<br />\n";
 454
 455                 // Is the time there?
 456                 if (is_null($SURFBAR_CACHE['time'])) {
 457                         // Then repair it wit the static!
 458                         $SURFBAR_CACHE['time'] = $_CONFIG['surfbar_static_time'];
 459                 } // END - if
 460
 461                 // Is the last salt there?
 462                 if (is_null($SURFBAR_CACHE['last_salt'])) {
 463                         // Then repair it wit the static!
 464                         $SURFBAR_CACHE['last_salt'] = "";
 465                 } // END - if
 466
 467                 // Fix missing last_surfed
 468                 if ((!isset($SURFBAR_CACHE['last_surfed'])) || (is_null($SURFBAR_CACHE['last_surfed']))) {
 469                         // Fix it here
 470                         $SURFBAR_CACHE['last_surfed'] = "0";
 471                 } // END - if
 472
 473                 // Are we in static mode?
 474                 if ($_CONFIG['surfbar_pay_model'] == "STATIC") {
 475                         // Then use static reward/costs!
 476                         $SURFBAR_CACHE['reward'] = $_CONFIG['surfbar_static_reward'];
 477                         $SURFBAR_CACHE['costs']  = $_CONFIG['surfbar_static_costs'];
 478                 } else {
 479                         // Calculate dynamic reward/costs and add it
 480                         $SURFBAR_CACHE['reward'] += SURFBAR_CALCULATE_DYNAMIC_REWARD_ADD();
 481                         $SURFBAR_CACHE['costs']  += SURFBAR_CALCULATE_DYNAMIC_COSTS_ADD();
 482                 }
 483
 484                 // Now get the id
 485                 $nextId = SURFBAR_GET_ID();
 486         } // END - if
 487
 488         // Free result
 489         SQL_FREERESULT($result);
 490
 491         // Return result
 492         //* DEBUG: */ echo __FUNCTION__.":nextId={$nextId}<br />\n";
 493         return $nextId;
 494 }
 495 // ----------------------------------------------------------------------------
 496 // PLEASE DO NOT ADD ANY OTHER FUNCTIONS BELOW THIS LINE ELSE THEY "WRAP" THE
 497 // $SURFBAR_CACHE ARRAY!
 498 // ----------------------------------------------------------------------------
 499 // Private getter for data elements
 500 function SURFBAR_GET_DATA ($element) {
 501         global $SURFBAR_CACHE;
 502
 503         // Default is null
 504         $data = null;
 505
 506         // Is the entry there?
 507         if (isset($SURFBAR_CACHE[$element])) {
 508                 // Then take it
 509                 $data = $SURFBAR_CACHE[$element];
 510         } else { // END - if
 511                 print("<pre>");
 512                 print_r($SURFBAR_CACHE);
 513                 debug_print_backtrace();
 514                 die("</pre>");
 515         }
 516
 517         // Return result
 518         return $data;
 519 }
 520 // Getter for reward from cache
 521 function SURFBAR_GET_REWARD () {
 522         // Get data element and return its contents
 523         return SURFBAR_GET_DATA('reward');
 524 }
 525 // Getter for costs from cache
 526 function SURFBAR_GET_COSTS () {
 527         // Get data element and return its contents
 528         return SURFBAR_GET_DATA('costs');
 529 }
 530 // Getter for URL from cache
 531 function SURFBAR_GET_URL () {
 532         // Get data element and return its contents
 533         return SURFBAR_GET_DATA('url');
 534 }
 535 // Getter for salt from cache
 536 function SURFBAR_GET_SALT () {
 537         // Get data element and return its contents
 538         return SURFBAR_GET_DATA('salt');
 539 }
 540 // Getter for id from cache
 541 function SURFBAR_GET_ID () {
 542         // Get data element and return its contents
 543         return SURFBAR_GET_DATA('id');
 544 }
 545 // Getter for user reload locks
 546 function SURFBAR_GET_USER_RELOAD_LOCK () {
 547         // Get data element and return its contents
 548         return SURFBAR_GET_DATA('user_locks');
 549 }
 550 // Getter for reload time
 551 function SURFBAR_GET_RELOAD_TIME () {
 552         // Get data element and return its contents
 553         return SURFBAR_GET_DATA('time');
 554 }
 555 //
 556 ?>