35b8b1d199558fef113ce2c836885da85b983b21
[mailer.git] / 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  * $Revision::                                                        $ *
14  * $Date::                                                            $ *
15  * $Tag:: 0.2.1-FINAL                                                 $ *
16  * $Author::                                                          $ *
17  * Needs to be in all Files and every File needs "svn propset           *
18  * svn:keywords Date Revision" (autoprobset!) at least!!!!!!            *
19  * -------------------------------------------------------------------- *
20  * Copyright (c) 2003 - 2008 by Roland Haeder                           *
21  * For more information visit: http://www.mxchange.org                  *
22  *                                                                      *
23  * This program is free software; you can redistribute it and/or modify *
24  * it under the terms of the GNU General Public License as published by *
25  * the Free Software Foundation; either version 2 of the License, or    *
26  * (at your option) any later version.                                  *
27  *                                                                      *
28  * This program is distributed in the hope that it will be useful,      *
29  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
30  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
31  * GNU General Public License for more details.                         *
32  *                                                                      *
33  * You should have received a copy of the GNU General Public License    *
34  * along with this program; if not, write to the Free Software          *
35  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
36  * MA  02110-1301  USA                                                  *
37  ************************************************************************/
38
39 // Some security stuff...
40 if (!defined('__SECURITY')) {
41         $INC = substr(dirname(__FILE__), 0, strpos(dirname(__FILE__), '/inc') + 4) . '/security.php';
42         require($INC);
43 }
44
45 // -----------------------------------------------------------------------------
46 //                               Admin functions
47 // -----------------------------------------------------------------------------
48 //
49 // Admin has added an URL with given user id and so on
50 function SURFBAR_ADMIN_ADD_URL ($url, $limit, $reload) {
51         // Do some pre-checks
52         if (!IS_ADMIN()) {
53                 // Not an admin
54                 DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Cannot add URL=%s,limit=%s,reload=%s : Not admin.", $url, $limit, $reload));
55                 return false;
56         } elseif (!isUrlValid($url)) {
57                 // URL invalid
58                 DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Cannot add URL=%s,limit=%s,reload=%s : Invalid URL.", $url, $limit, $reload));
59                 return false;
60         } elseif (SURFBAR_LOOKUP_BY_URL($url, '0')) {
61                 // URL already found in surfbar!
62                 DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Cannot add URL=%s,limit=%s,reload=%s : Already added.", $url, $limit, $reload));
63                 return false;
64         } elseif (!SURFBAR_IF_USER_BOOK_MORE_URLS()) {
65                 // No more allowed!
66                 DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Cannot add URL=%s,limit=%s,reload=%s : No more URLs allowed.", $url, $limit, $reload));
67                 return false;
68         } elseif ('' . ($limit + 0) . '' != '' . $limit . '') {
69                 // Invalid limit entered
70                 DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Cannot add URL=%s,limit=%s,reload=%s : Invalid limit entered.", $url, $limit, $reload));
71                 return false;
72         } elseif ('' . ($reload + 0) . '' != '' . $reload . '') {
73                 // Invalid amount entered
74                 DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Cannot add URL=%s,limit=%s,reload=%s : Invalid reload entered.", $url, $limit, $reload));
75                 return false;
76         }
77
78         // Register the new URL
79         return SURFBAR_REGISTER_URL($url, '0', 'ACTIVE', 'unlock', array('limit' => $limit, 'reload' => $reload));
80 }
81
82 // Admin unlocked an email so we can migrate the URL
83 function SURFBAR_ADMIN_MIGRATE_URL ($url, $uid) {
84         // Do some pre-checks
85         if (!IS_ADMIN()) {
86                 // Not an admin
87                 return false;
88         } elseif (!isUrlValid($url)) {
89                 // URL invalid
90                 return false;
91         } elseif (SURFBAR_LOOKUP_BY_URL($url, $uid)) {
92                 // URL already found in surfbar!
93                 return false;
94         } elseif (!SURFBAR_IF_USER_BOOK_MORE_URLS($uid)) {
95                 // No more allowed!
96                 return false;
97         }
98
99         // Register the new URL
100         return SURFBAR_REGISTER_URL($url, $uid, 'MIGRATED', 'migrate');
101 }
102
103 // Admin function for unlocking URLs
104 function SURFBAR_ADMIN_UNLOCK_URL_IDS ($IDs) {
105         // Is this an admin or invalid array?
106         if (!IS_ADMIN()) {
107                 // Not admin or invalid IDs array
108                 return false;
109         } elseif (!is_array($IDs)) {
110                 // No array
111                 return false;
112         } elseif (count($IDs) == 0) {
113                 // Empty array
114                 return false;
115         }
116
117         // Set to true to make AND expression valid if first URL got unlocked
118         $done = true;
119
120         // Update the status for all ids
121         foreach ($IDs as $id => $dummy) {
122                 // Test all ids through (ignores failed)
123                 $done = (($done) && (SURFBAR_CHANGE_STATUS($id, 'PENDING', 'ACTIVE')));
124         } // END - if
125
126         // Return total status
127         return $done;
128 }
129
130 // Admin function for rejecting URLs
131 function SURFBAR_ADMIN_REJECT_URL_IDS ($IDs) {
132         // Is this an admin or invalid array?
133         if (!IS_ADMIN()) {
134                 // Not admin or invalid IDs array
135                 return false;
136         } elseif (!is_array($IDs)) {
137                 // No array
138                 return false;
139         } elseif (count($IDs) == 0) {
140                 // Empty array
141                 return false;
142         }
143
144         // Set to true to make AND expression valid if first URL got unlocked
145         $done = true;
146
147         // Update the status for all ids
148         foreach ($IDs as $id => $dummy) {
149                 // Test all ids through (ignores failed)
150                 $done = (($done) && (SURFBAR_CHANGE_STATUS($id, 'PENDING', 'REJECTED')));
151         } // END - if
152
153         // Return total status
154         return $done;
155 }
156
157 //
158 // -----------------------------------------------------------------------------
159 //                               Member functions
160 // -----------------------------------------------------------------------------
161 //
162 // Member has added an URL
163 function SURFBAR_MEMBER_ADD_URL ($url, $limit) {
164         // Do some pre-checks
165         if (!IS_MEMBER()) {
166                 // Not a member
167                 return false;
168         } elseif ((!isUrlValid($url)) && (!IS_ADMIN())) {
169                 // URL invalid
170                 return false;
171         } elseif (SURFBAR_LOOKUP_BY_URL($url, getUserId())) {
172                 // URL already found in surfbar!
173                 return false;
174         } elseif (!SURFBAR_IF_USER_BOOK_MORE_URLS(getUserId())) {
175                 // No more allowed!
176                 return false;
177         } elseif (''.($limit + 0).'' != ''.$limit.'') {
178                 // Invalid amount entered
179                 return false;
180         }
181
182         // Register the new URL
183         return SURFBAR_REGISTER_URL($url, getUserId(), 'PENDING', 'reg', array('limit' => $limit));
184 }
185
186 // Create list of actions depending on status for the user
187 function SURFBAR_MEMBER_ACTIONS ($urlId, $status) {
188         // Load all actions in an array for given status
189         $actionArray = SURFBAR_getModeAction_ARRAY($status);
190
191         // Init HTML code
192         $OUT = "<table border=\"0\" cellspacing=\"0\" cellpadding=\"1\" width=\"100%\">
193 <tr>\n";
194
195         // Calculate width
196         $width = round(100 / count($actionArray));
197
198         // "Walk" through all actions and create forms
199         foreach ($actionArray as $actionId => $action) {
200                 // Add form for this action
201                 $OUT .= LOAD_TEMPLATE('member_surfbar_list_form', true, array(
202                         'width'    => $width,
203                         'id'       => bigintval($urlId),
204                         'action'   => strtolower($action),
205                         'title'    => '{--MEMBER_SURFBAR_ACTION_' . strtoupper($action) . '_TITLE--}',
206                         'submit'   => '{--MEMBER_SURFBAR_ACTION_' . strtoupper($action) . '_SUBMIT--}',
207                 ));
208         } // END - foreach
209
210         // Close table
211         $OUT .= "</tr>
212 </table>\n";
213
214         // Return code
215         return $OUT;
216 }
217
218 // Do the member form request
219 function SURFBAR_MEMBER_DO_FORM ($formData, $URLs) {
220         // By default no action is performed
221         $performed = false;
222
223         // Is this a member?
224         if (!IS_MEMBER()) {
225                 // No member!
226                 return false;
227         } elseif ((!isset($formData['id'])) || (!isset($formData['action']))) {
228                 // Important form elements are missing!
229                 return false;
230         } elseif (!isset($URLs[$formData['id']])) {
231                 // ID not found in cache
232                 return false;
233         } elseif (!SURFBAR_VALIDATE_MEMBER_ACTION_STATUS($formData['action'], $URLs[$formData['id']]['status'])) {
234                 // Action not allowed for current URL status
235                 return false;
236         }
237
238         // Secure action
239         $action = SQL_ESCAPE(htmlentities(strip_tags($formData['action']), ENT_QUOTES));
240
241         // Has it changed?
242         if ($action != $formData['action']) {
243                 // Invalid data in action found
244                 return false;
245         } // END - if
246
247         // Create the function name for selected action
248         $functionName = sprintf("SURFBAR_MEMBER_%s_ACTION", strtoupper($action));
249
250         // Is the function there?
251         if (function_exists($functionName)) {
252                 // Add new status
253                 $URLs[$formData['id']]['new_status'] = SURFBAR_GET_NEW_STATUS('new_status');
254
255                 // Extract URL data for call-back
256                 $urlData = array(merge_array($URLs[$formData['id']], array($action => $formData)));
257
258                 // Action found so execute it
259                 $performed = call_user_func_array($functionName, $urlData);
260         } else {
261                 // Log invalid request
262                 DEBUG_LOG(__FUNCTION__, __LINE__, "action={$formData['action']},id={$formData['id']},function={$functionName}");
263                 addFatalMessage(__FUNCTION__, __LINE__, "Invalid member action! action=%s,id=%s,function=%s", array($formData['action'], $formData['id'], $functionName));
264         }
265
266         // Return status
267         return $performed;
268 }
269
270 // Validate if the requested action can be performed on current URL status
271 function SURFBAR_VALIDATE_MEMBER_ACTION_STATUS ($action, $status) {
272         // Search for the requested action/status combination in database
273         $result = SQL_QUERY_ESC("SELECT new_status FROM `{!_MYSQL_PREFIX!}_surfbar_actions` WHERE `action`='%s' AND `status`='%s' LIMIT 1",
274         array($action, $status), __FUNCTION__, __LINE__);
275
276         // Is the entry there?
277         $isValid = (SQL_NUMROWS($result) == 1);
278
279         // Fetch the new status if found
280         if ($isValid) {
281                 // Load new status
282                 list($GLOBALS['surfbar_cache']['new_status']) = SQL_FETCHROW($result);
283         } // END - if
284
285         // Free result
286         SQL_FREERESULT($result);
287
288         // Return status
289         return $isValid;
290 }
291
292 //
293 // -----------------------------------------------------------------------------
294 //                               Member actions
295 // -----------------------------------------------------------------------------
296 //
297 // Retreat a booked URL
298 function SURFBAR_MEMBER_RETREAT_ACTION ($urlData) {
299         // Create the data array for next function call
300         $data = array(
301         $urlData['id'] => $urlData
302         );
303
304         // Simply change the status here
305         return SURFBAR_CHANGE_STATUS ($urlData['id'], $urlData['status'], $urlData['new_status'], $data);
306 }
307
308 // Book an URL now (from migration)
309 function SURFBAR_MEMBER_BOOKNOW_ACTION ($urlData) {
310         // Create the data array for next function call
311         $data = array(
312         $urlData['id'] => $urlData
313         );
314
315         // Simply change the status here
316         return SURFBAR_CHANGE_STATUS ($urlData['id'], $urlData['status'], $urlData['new_status'], $data);
317 }
318
319 // Show edit form or do the changes
320 function SURFBAR_MEMBER_EDIT_ACTION ($urlData) {
321         // Is the "execute" flag there?
322         if (isset($urlData['edit']['execute'])) {
323                 // Execute the changes
324                 return SURFBAR_MEMBER_EXECUTE_ACTION('edit', $urlData);
325         } // END - if
326
327         // Display form
328         return SURFBAR_MEMBER_DISPLAY_ACTION_FORM('edit', $urlData);
329 }
330
331 // Show delete form or do the changes
332 function SURFBAR_MEMBER_DELETE_ACTION ($urlData) {
333         // Is the "execute" flag there?
334         if (isset($urlData['delete']['execute'])) {
335                 // Execute the changes
336                 return SURFBAR_MEMBER_EXECUTE_ACTION('delete', $urlData);
337         } // END - if
338
339         // Display form
340         return SURFBAR_MEMBER_DISPLAY_ACTION_FORM('delete', $urlData);
341 }
342
343 // Pause active banner
344 function SURFBAR_MEMBER_PAUSE_ACTION ($urlData) {
345         return SURFBAR_CHANGE_STATUS($urlData['id'], $urlData['status'], $urlData['new_status'], array($urlData['id'] => $urlData));
346 }
347
348 // Unpause stopped banner
349 function SURFBAR_MEMBER_UNPAUSE_ACTION ($urlData) {
350         // Fix missing entry for template
351         $urlData['edit'] = $urlData['unpause'];
352         $urlData['edit']['url'] = $urlData['url'];
353         $urlData['edit']['limit'] = $urlData['views_max'];
354
355         // Return status change
356         return SURFBAR_CHANGE_STATUS($urlData['id'], $urlData['status'], $urlData['new_status'], array($urlData['id'] => $urlData));
357 }
358
359 // Resubmit locked URL
360 function SURFBAR_MEMBER_RESUBMIT_ACTION ($urlData) {
361         return SURFBAR_CHANGE_STATUS($urlData['id'], $urlData['status'], $urlData['new_status'], array($urlData['id'] => $urlData));
362 }
363
364 // Display selected "action form"
365 function SURFBAR_MEMBER_DISPLAY_ACTION_FORM ($action, $urlData) {
366         // Translate some data
367         $urlData['registered']    = generateDateTime($urlData['registered'], '2');
368         $urlData['views_total']   = translateComma($urlData['views_total']);
369         $urlData['views_max']     = translateComma($urlData['views_max']);
370         $urlData['views_allowed'] = translateComma($urlData['views_allowed']);
371         $urlData['last_locked']   = generateDateTime($urlData['last_locked'], '2');
372
373         // Is the lock reason empty?
374         if (empty($urlData['lock_reason'])) {
375                 // Fix it to three dashes
376                 $urlData['lock_reason'] = '---';
377         } // END - if
378
379         // Include fields only for action 'edit'
380         if ($action == 'edit') {
381                 // Default is not limited
382                 $urlData['limited_yes'] = '';
383                 $urlData['limited_no']  = ' checked="checked"';
384                 $urlData['limited']     = 'false';
385
386                 // Is this URL limited?
387                 if ($urlData['views_max'] > 0) {
388                         // Then rewrite form data
389                         $urlData['limited_yes'] = ' checked="checked"';
390                         $urlData['limited_no']  = '';
391                         $urlData['limited']     = 'true';
392                 } // END - if
393         } // END - if
394
395         // Load the form and display it
396         LOAD_TEMPLATE(sprintf("member_surfbar_%s_action_form", $action), false, $urlData);
397
398         // All fine by default ... ;-)
399         return true;
400 }
401
402 // Execute choosen action
403 function SURFBAR_MEMBER_EXECUTE_ACTION ($action, $urlData) {
404         // By default nothing is executed
405         $executed = false;
406
407         // Is limitation "no" and "limit" is > 0?
408         if ((isset($urlData[$action]['limited'])) && ($urlData[$action]['limited'] == 'N') && ((isset($urlData[$action]['limit'])) && ($urlData[$action]['limit'] > 0)) || (!isset($urlData[$action]['limit']))) {
409                 // Set it to unlimited
410                 $urlData[$action]['limit'] = 0;
411         } // END - if
412
413         // Construct function name
414         $functionName = sprintf("SURFBAR_MEMBER_EXECUTE_%s_ACTION", strtoupper($action));
415
416         // Is 'userid' set and not 'uid' ?
417         if ((!isset($urlData['uid'])) && (isset($urlData['userid']))) {
418                 // Auto-fix this
419                 $urlData['uid'] = $urlData['userid'];
420         } // END - if
421
422         // Is that function there?
423         if (function_exists($functionName)) {
424                 // Execute the function
425                 if (call_user_func_array($functionName, array($urlData)) == true) {
426                         // Update status as well
427                         $executed = SURFBAR_CHANGE_STATUS($urlData['id'], $urlData['status'], $urlData['new_status'], array($urlData['id'] => $urlData));
428                 } // END - if
429         } else {
430                 // Not found!
431                 addFatalMessage(__FUNCTION__, __LINE__, getMessage('MEMBER_SURFBAR_EXECUTE_ACTION_404'), $functionName);
432         }
433
434         // Return status
435         return $executed;
436 }
437 // "Execute edit" function: Update changed data
438 function SURFBAR_MEMBER_EXECUTE_EDIT_ACTION ($urlData) {
439         // Default is nothing done
440         $status = false;
441
442         // Translate URLs for testing
443         $url1 = COMPILE_CODE($urlData['url']);
444         $url2 = COMPILE_CODE($urlData['edit']['url']);
445
446         // Has the URL or limit changed?
447         if (true) {
448                 //if (($urlData['views_allowed'] != $urlData['edit']['limit']) || ($url1 != $url2)) {
449                 // Run the query
450                 SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_surfbar_urls` SET url='%s', views_allowed=%s, views_max=%s WHERE `id`=%s AND `status`='%s' LIMIT 1",
451                 array($urlData['url'], $urlData['edit']['limit'], $urlData['edit']['limit'], $urlData['id'], $urlData['status']), __FUNCTION__, __LINE__);
452
453                 // All fine
454                 $status = true;
455         }
456
457         // Return status
458         return $status;
459 }
460 // "Execute delete" function: Does nothing...
461 function SURFBAR_MEMBER_EXECUTE_DELETE_ACTION ($urlData) {
462         // Nothing special to do (see above function for such "special actions" to perform)
463         return true;
464 }
465 //
466 // -----------------------------------------------------------------------------
467 //                           Self-maintenance functions
468 // -----------------------------------------------------------------------------
469 //
470 // Main function
471 function SURFBAR_HANDLE_SELF_MAINTENANCE () {
472         // Handle URLs which limit has depleted so we can stop them
473         SURFBAR_HANDLE_DEPLETED_VIEWS();
474
475         // Handle low-points amounts
476         SURFBAR_HANDLE_LOW_POINTS();
477 }
478 // Handle URLs which limit has depleted
479 function SURFBAR_HANDLE_DEPLETED_VIEWS () {
480         // Get all URLs
481         $urlArray = SURFBAR_GET_URL_DATA('0', 'views_max', 'id', 'ASC', 'id', " AND views_allowed>0 AND `status`='ACTIVE'");
482
483         // Do we have some entries?
484         if (count($urlArray) > 0) {
485                 // Then handle all!
486                 foreach ($urlArray as $id => $urlData) {
487                         // Backup data
488                         $data = $urlData;
489
490                         // Rewrite array for next call
491                         $urlData[$id] = $data;
492
493                         // Handle the status
494                         SURFBAR_CHANGE_STATUS($id, 'ACTIVE', 'DEPLETED', $urlData);
495                 } // END - foreach
496         } // END - if
497 }
498
499 // Alert users which have URLs booked and are low on points amount
500 function SURFBAR_HANDLE_LOW_POINTS () {
501         // Get all userids
502         $UIDs = SURFBAR_DETERMINE_DEPLETED_USERIDS(getConfig('surfbar_warn_low_points'));
503
504         // "Walk" through all URLs
505         foreach ($UIDs['uid'] as $uid => $dummy) {
506                 // Is the last notification far enougth away to notify again?
507                 if ((time() - $UIDs['notified'][$uid]) >= getConfig('surfbar_low_interval')) {
508                         // Prepare content
509                         $content = array(
510                                 'uid'      => $uid,
511                                 'low'      => translateComma(getConfig('surfbar_warn_low_points')),
512                                 'points'   => translateComma($UIDs['points'][$uid]),
513                                 'notified' => generateDateTime($UIDs['notified'][$uid]),
514                                 'interval' => createFancyTime(getConfig('surfbar_low_interval'))
515                         );
516
517                         // Notify this user
518                         SURFBAR_NOTIFY_USER('low_points', $content);
519
520                         // Update last notified
521                         SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_user_data` SET surfbar_low_notified=NOW() WHERE userid=%s LIMIT 1",
522                         array($uid), __FUNCTION__, __LINE__);
523                 } // END - if
524         } // END - foreach
525 }
526
527 //
528 // -----------------------------------------------------------------------------
529 //                               Generic functions
530 // -----------------------------------------------------------------------------
531 //
532
533 // Looks up by an URL
534 function SURFBAR_LOOKUP_BY_URL ($url, $uid) {
535         // Now lookup that given URL by itself
536         $urlArray = SURFBAR_GET_URL_DATA($url, 'url', 'id', 'ASC', 'id', sprintf(" AND `userid`=%s", bigintval($uid)));
537
538         // Was it found?
539         return (count($urlArray) > 0);
540 }
541
542 // Load URL data by given search term and column
543 function SURFBAR_GET_URL_DATA ($searchTerm, $column = 'id', $order = 'id', $sort = 'ASC', $group = 'id', $add = '') {
544         // By default nothing is found
545         $GLOBALS['last_url_data'] = array();
546
547         // Is the column an id number?
548         if (($column == 'id') || ($column == 'userid')) {
549                 // Extra secure input
550                 $searchTerm = bigintval($searchTerm);
551         } // END - if
552
553         // If the column is 'id' there can be only one entry
554         $limit = '';
555         if ($column == 'id') {
556                 $limit = "LIMIT 1";
557         } // END - if
558
559         // Look up the record
560         $result = SQL_QUERY_ESC("SELECT id, userid, url, views_total, views_max, views_allowed, status, registered, last_locked, lock_reason, views_max, views_allowed, fixed_reload
561 FROM `{!_MYSQL_PREFIX!}_surfbar_urls`
562 WHERE %s='%s'".$add."
563 ORDER BY %s %s
564 %s",
565         array($column, $searchTerm, $order, $sort, $limit), __FUNCTION__, __LINE__);
566
567         // Is there at least one record?
568         if (SQL_NUMROWS($result) > 0) {
569                 // Then load all!
570                 while ($dataRow = SQL_FETCHARRAY($result)) {
571                         // Shall we group these results?
572                         if ($group == 'id') {
573                                 // Add the row by id as index
574                                 $GLOBALS['last_url_data'][$dataRow['id']] = $dataRow;
575                         } else {
576                                 // Group entries
577                                 $GLOBALS['last_url_data'][$dataRow[$group]][$dataRow['id']] = $dataRow;
578                         }
579                 } // END - while
580         } // END - if
581
582         // Free the result
583         SQL_FREERESULT($result);
584
585         // Return the result
586         return $GLOBALS['last_url_data'];
587 }
588
589 // Registers an URL with the surfbar. You should have called SURFBAR_LOOKUP_BY_URL() first!
590 function SURFBAR_REGISTER_URL ($url, $uid, $status = 'PENDING', $addMode = 'reg', $extraFields = array()) {
591         // Make sure by the user registered URLs are always pending
592         if ($addMode == 'reg') {
593                 $status = 'PENDING';
594         } // END - if
595
596         // Prepare content
597         $content = merge_array($extraFields, array(
598                 'url'         => $url,
599                 'frametester' => FRAMETESTER($url),
600                 'uid'         => $uid,
601                 'status'      => $status,
602         ));
603
604         // Is limit/reload set?
605         if (!isset($config['limit'])) {
606                 $content['limit']  = 0;
607         } // END - if
608         if (!isset($config['reload'])) {
609                 $content['reload'] = 0;
610         } // END - if
611
612         // Insert the URL into database
613         $content['insert_id'] = SURFBAR_INSERT_URL_BY_ARRAY($content);
614
615         // Is this ID valid?
616         if ($content['insert_id'] == 0) {
617                 // INSERT did not insert any data!
618                 return false;
619         } // END - if
620
621         // Translate status and limit
622         $content['limit'] = surfbarTranslateLimit($content['limit']);
623
624         // If in reg-mode we notify admin
625         if (($addMode == 'reg') || (getConfig('surfbar_notify_admin_unlock') == 'Y')) {
626                 // Notify admin even when he as unlocked an email
627                 SURFBAR_NOTIFY_ADMIN("url_{$addMode}", $content);
628         } // END - if
629
630         // Send mail to user
631         SURFBAR_NOTIFY_USER("url_{$addMode}", $content);
632
633         // Return the insert id
634         return $content['insert_id'];
635 }
636
637 // Inserts an url by given data array and return the insert id
638 function SURFBAR_INSERT_URL_BY_ARRAY ($urlData) {
639         // Get userid
640         $uid = bigintval($urlData['uid']);
641
642         // Is the id set?
643         if (empty($uid)) $uid = 0;
644
645         // Just run the insert query for now
646         SQL_QUERY_ESC("INSERT INTO `{!_MYSQL_PREFIX!}_surfbar_urls` (userid,url,status,views_max,views_allowed,fixed_reload) VALUES (%s,'%s','%s',%s,%s,%s)",
647         array(
648         $uid,
649         $urlData['url'],
650         $urlData['status'],
651         $urlData['limit'],
652         $urlData['limit'],
653         $urlData['reload']
654         ), __FUNCTION__, __LINE__
655         );
656
657         // Return insert id
658         return SQL_INSERTID();
659 }
660
661 // Notify admin(s) with a selected message and content
662 function SURFBAR_NOTIFY_ADMIN ($messageType, $content) {
663         // Prepare template name
664         $templateName = sprintf("admin_surfbar_%s", $messageType);
665
666         // Prepare subject
667         $subject = getMessage(sprintf("ADMIN_SURFBAR_NOTIFY_%s_SUBJECT",
668         strtoupper($messageType)
669         ));
670
671         // Is the subject line there?
672         if ((substr($subject, 0, 1) == '!') && (substr($subject, -1, 1) == '!')) {
673                 // Set default subject if following eval() wents wrong
674                 $subject = getMessage('ADMIN_SURFBAR_NOTIFY_DEFAULT_SUBJECT');
675         } // END - if
676
677         // Translate some data if present
678         if (isset($content['status']))        $content['status']        = surfbarTranslateUserStatus($content['status']);
679         if (isset($content['registered']))    $content['registered']    = generateDateTime($content['registered'], '2');
680         if (isset($content['last_locked']))   $content['last_locked']   = generateDateTime($content['last_locked'], '2');
681         if (isset($content['views_total']))   $content['views_total']   = translateComma($content['views_total']);
682         if (isset($content['views_allowed'])) $content['views_allowed'] = translateComma($content['views_allowed']);
683         if (isset($content['views_max']))     $content['views_max']     = translateComma($content['views_max']);
684
685         // Send the notification out
686         return sendAdminNotification($subject, $templateName, $content, $content['uid']);
687 }
688
689 // Notify the user about the performed action
690 function SURFBAR_NOTIFY_USER ($messageType, $content) {
691         // Skip notification if userid is zero
692         if ($content['uid'] == 0) {
693                 return false;
694         } // END - if
695
696         // Prepare template name
697         $templateName = sprintf("member_surfbar_%s", $messageType);
698
699         // Prepare subject
700         $subject = getMessage(sprintf("MEMBER_SURFBAR_NOTIFY_%s_SUBJECT",
701         strtoupper($messageType)
702         ));
703
704         // Is the subject line there?
705         if ((substr($subject, 0, 1) == '!') && (substr($subject, -1, 1) == '!')) {
706                 // Set default subject if following eval() wents wrong
707                 $subject = getMessage('MEMBER_SURFBAR_NOTIFY_DEFAULT_SUBJECT');
708         } // END - if
709
710         // Translate some data if present
711         if (isset($content['status']))        $content['status']        = surfbarTranslateUserStatus($content['status']);
712         if (isset($content['registered']))    $content['registered']    = generateDateTime($content['registered'], '2');
713         if (isset($content['last_locked']))   $content['last_locked']   = generateDateTime($content['last_locked'], '2');
714         if (isset($content['views_total']))   $content['views_total']   = translateComma($content['views_total']);
715         if (isset($content['views_allowed'])) $content['views_allowed'] = translateComma($content['views_allowed']);
716         if (isset($content['views_max']))     $content['views_max']     = translateComma($content['views_max']);
717
718         // Load template
719         $mailText = LOAD_EMAIL_TEMPLATE($templateName, $content, $content['uid']);
720
721         // Send the email
722         return sendEmail($content['uid'], $subject, $mailText);
723 }
724
725 // Translates the limit
726 function surfbarTranslateLimit ($limit) {
727         // Is this zero?
728         if ($limit == 0) {
729                 // Unlimited!
730                 $return = getMessage('MEMBER_SURFBAR_UNLIMITED_VIEWS');
731         } else {
732                 // Translate comma
733                 $return = translateComma($limit);
734         }
735
736         // Return value
737         return $return;
738 }
739
740 // Translate the URL status
741 function surfbarTranslateUserStatus ($status) {
742         // Create constant name
743         $constantName = sprintf("SURFBAR_URL_STATUS_%s", strtoupper($status));
744
745         // Set default translated status
746         $statusTranslated = '!'.$constantName.'!';
747
748         // Is the constant there?
749         if (defined($constantName)) {
750                 // Then get it's value
751                 $statusTranslated = constant($constantName);
752         } // END - if
753
754         // Return result
755         return $statusTranslated;
756 }
757
758 // Determine reward
759 function SURFBAR_DETERMINE_REWARD ($onlyMin=false) {
760         // Static values are default
761         $reward = getConfig('surfbar_static_reward');
762
763         // Do we have static or dynamic?
764         if (getConfig('surfbar_pay_model') == 'DYNAMIC') {
765                 // "Calculate" dynamic reward
766                 if ($onlyMin) {
767                         $reward += SURFBAR_CALCULATE_DYNAMIC_MIN_VALUE();
768                 } else {
769                         $reward += SURFBAR_CALCULATE_DYNAMIC_ADD();
770                 }
771         } // END - if
772
773         // Return reward
774         return $reward;
775 }
776
777 // Determine costs
778 function SURFBAR_DETERMINE_COSTS ($onlyMin=false) {
779         // Static costs is default
780         $costs  = getConfig('surfbar_static_costs');
781
782         // Do we have static or dynamic?
783         if (getConfig('surfbar_pay_model') == 'DYNAMIC') {
784                 // "Calculate" dynamic costs
785                 if ($onlyMin) {
786                         $costs += SURFBAR_CALCULATE_DYNAMIC_MIN_VALUE();
787                 } else {
788                         $costs += SURFBAR_CALCULATE_DYNAMIC_ADD();
789                 }
790         } // END - if
791
792         // Return costs
793         return $costs;
794 }
795
796 // "Calculate" dynamic add
797 function SURFBAR_CALCULATE_DYNAMIC_ADD () {
798         // Get min/max values
799         $min = SURFBAR_CALCULATE_DYNAMIC_MIN_VALUE();
800         $max = SURFBAR_CALCULATE_DYNAMIC_MAX_VALUE();
801
802         // "Calculate" dynamic part and return it
803         return mt_rand($min, $max);
804 }
805
806 // Determine right template name
807 function SURFBAR_DETERMINE_TEMPLATE_NAME() {
808         // Default is the frameset
809         $templateName = "surfbar_frameset";
810
811         // Any frame set? ;-)
812         if (REQUEST_ISSET_GET('frame')) {
813                 // Use the frame as a template name part... ;-)
814                 $templateName = sprintf("surfbar_frame_%s",
815                 REQUEST_GET('frame')
816                 );
817         } // END - if
818
819         // Return result
820         return $templateName;
821 }
822
823 // Check if the "reload lock" of the current user is full, call this function
824 // before you call SURFBAR_CHECK_RELOAD_LOCK().
825 function SURFBAR_CHECK_RELOAD_FULL() {
826         // Default is full!
827         $isFull = true;
828
829         // Cache static reload lock
830         $GLOBALS['surfbar_cache']['surf_lock'] = getConfig('surfbar_static_lock');
831         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "Fixed surf lock is ".getConfig('surfbar_static_lock')."", false);
832
833         // Do we have dynamic model?
834         if (getConfig('surfbar_pay_model') == 'DYNAMIC') {
835                 // "Calculate" dynamic lock
836                 $GLOBALS['surfbar_cache']['surf_lock'] += SURFBAR_CALCULATE_DYNAMIC_ADD();
837         } // END - if
838
839         // Ask the database
840         $result = SQL_QUERY_ESC("SELECT COUNT(l.id) AS cnt FROM `{!_MYSQL_PREFIX!}_surfbar_locks` AS l
841 INNER JOIN `{!_MYSQL_PREFIX!}_surfbar_urls` AS u
842 ON u.id=l.url_id
843 WHERE l.userid=%s AND (UNIX_TIMESTAMP() - ".SURFBAR_GET_SURF_LOCK().") < UNIX_TIMESTAMP(l.last_surfed) AND (((UNIX_TIMESTAMP(l.last_surfed) - u.fixed_reload) < 0 AND u.fixed_reload > 0) OR u.fixed_reload = 0)
844 LIMIT 1",
845         array(getUserId()), __FUNCTION__, __LINE__
846         );
847
848         // Fetch row
849         list($GLOBALS['surfbar_cache']['user_locks']) = SQL_FETCHROW($result);
850
851         // Is it null?
852         if (is_null($GLOBALS['surfbar_cache']['user_locks'])) {
853                 // Then fix it to zero!
854                 $GLOBALS['surfbar_cache']['user_locks'] = 0;
855         } // END - if
856
857         // Free result
858         SQL_FREERESULT($result);
859
860         // Get total URLs
861         $total = SURFBAR_GET_TOTAL_URLS();
862
863         // Do we have some URLs in lock?¬†Admins can always surf on own URLs!
864         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "userLocks=".SURFBAR_GET_USER_LOCKS().",total={$total}", false);
865         $isFull = ((SURFBAR_GET_USER_LOCKS() == $total) && ($total > 0));
866
867         // Return result
868         return $isFull;
869 }
870
871 // Get total amount of URLs of given status for current user or of ACTIVE URLs by default
872 function SURFBAR_GET_TOTAL_URLS ($status = 'ACTIVE', $excludeUserId = 0) {
873         // Determine depleted user account
874         $UIDs = SURFBAR_DETERMINE_DEPLETED_USERIDS();
875
876         // Is the exlude userid set?
877         if ($excludeUserId > 0) {
878                 // Then add it
879                 $UIDs['uid'][$excludeUserId] = $excludeUserId;
880         } // END - if
881
882         // Get amount from database
883         $result = SQL_QUERY_ESC("SELECT COUNT(id) AS cnt
884 FROM `{!_MYSQL_PREFIX!}_surfbar_urls`
885 WHERE userid NOT IN (".implode(',', $UIDs['uid']).") AND `status`='%s'",
886         array($status), __FUNCTION__, __LINE__
887         );
888
889         // Fetch row
890         list($cnt) = SQL_FETCHROW($result);
891
892         // Free result
893         SQL_FREERESULT($result);
894
895         // Return result
896         return $cnt;
897 }
898
899 // Check wether the user is allowed to book more URLs
900 function SURFBAR_IF_USER_BOOK_MORE_URLS ($uid=0) {
901         // Is this admin and userid is zero or does the user has some URLs left to book?
902         return ((($uid == 0) && (IS_ADMIN())) || (SURFBAR_GET_TOTAL_USER_URLS($uid, '', array("REJECTED")) < getConfig('surfbar_max_order')));
903 }
904
905 // Get total amount of URLs of given status for current user
906 function SURFBAR_GET_TOTAL_USER_URLS ($uid=0, $status = '',$exclude = '') {
907         // Is the user 0 and user is logged in?
908         if (($uid == 0) && (IS_MEMBER())) {
909                 // Then use this userid
910                 $uid = getUserId();
911         } elseif ($uid == 0) {
912                 // Error!
913                 return (getConfig('surfbar_max_order') + 1);
914         }
915
916         // Default is all URLs
917         $add = '';
918
919         // Is the status set?
920         if (is_array($status)) {
921                 // Only URLs with these status
922                 $add = sprintf(" AND status IN('%s')", implode("','", $status));
923         } elseif (!empty($status)) {
924                 // Only URLs with this status
925                 $add = sprintf(" AND `status`='%s'", $status);
926         } elseif (is_array($exclude)) {
927                 // Exclude URLs with these status
928                 $add = sprintf(" AND status NOT IN('%s')", implode("','", $exclude));
929         } elseif (!empty($exclude)) {
930                 // Exclude URLs with this status
931                 $add = sprintf(" AND status != '%s'", $exclude);
932         }
933
934         // Get amount from database
935         $result = SQL_QUERY_ESC("SELECT COUNT(id) AS cnt
936 FROM `{!_MYSQL_PREFIX!}_surfbar_urls`
937 WHERE `userid`=%s".$add."
938 LIMIT %s",
939                 array($uid, getConfig('surfbar_max_order')), __FUNCTION__, __LINE__
940         );
941
942         // Fetch row
943         list($cnt) = SQL_FETCHROW($result);
944
945         // Free result
946         SQL_FREERESULT($result);
947
948         // Return result
949         return $cnt;
950 }
951
952 // Generate a validation code for the given id number
953 function SURFBAR_GENERATE_VALIDATION_CODE ($urlId, $salt = '') {
954         // @TODO Invalid salt should be refused
955         $GLOBALS['surfbar_cache']['salt'] = 'INVALID';
956
957         // Get code length from config
958         $length = getConfig('code_length');
959
960         // Fix length to 10
961         if ($length == 0) $length = 10;
962
963         // Generate a code until the length matches
964         $valCode = '';
965         while (strlen($valCode) != $length) {
966                 // Is the salt set?
967                 if (empty($salt)) {
968                         // Generate random hashed string
969                         $GLOBALS['surfbar_cache']['salt'] = sha1(generatePassword(mt_rand(200, 255)));
970                         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "newSalt=".SURFBAR_GET_SALT()."", false);
971                 } else {
972                         // Use this as salt!
973                         $GLOBALS['surfbar_cache']['salt'] = $salt;
974                         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "oldSalt=".SURFBAR_GET_SALT()."", false);
975                 }
976
977                 // ... and now the validation code
978                 $valCode = generateRandomCode($length, sha1(SURFBAR_GET_SALT().':'.$urlId), getUserId());
979                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "valCode={$valCode}", false);
980         } // END - while
981
982         // Hash it with md5() and salt it with the random string
983         $hashedCode = generateHash(md5($valCode), SURFBAR_GET_SALT());
984
985         // Finally encrypt it PGP-like and return it
986         $valHashedCode = generatePassString($hashedCode);
987
988         // Return hashed value
989         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "finalValCode={$valHashedCode}", false);
990         return $valHashedCode;
991 }
992
993 // Check validation code
994 function SURFBAR_CHECK_VALIDATION_CODE ($urlId, $check, $salt) {
995         // Secure id number
996         $urlId = bigintval($urlId);
997
998         // Now generate the code again
999         $code = SURFBAR_GENERATE_VALIDATION_CODE($urlId, $salt);
1000
1001         // Return result of checking hashes and salts
1002         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, '---'.$code.'|'.$check.'---', false);
1003         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "+++".$salt.'|'.SURFBAR_GET_DATA('last_salt')."+++", false);
1004         return (($code == $check) && ($salt == SURFBAR_GET_DATA('last_salt')));
1005 }
1006
1007 // Lockdown the userid/id combination (reload lock)
1008 function SURFBAR_LOCKDOWN_ID ($urlId) {
1009         //* DEBUG: */ print "LOCK!";
1010         ///* DEBUG: */ return;
1011         // Just add it to the database
1012         SQL_QUERY_ESC("INSERT INTO `{!_MYSQL_PREFIX!}_surfbar_locks` (`userid`, `url_id`) VALUES (%s, %s)",
1013                 array(getUserId(), bigintval($urlId)), __FUNCTION__, __LINE__);
1014
1015         // Remove the salt from database
1016         SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{!_MYSQL_PREFIX!}_surfbar_salts` WHERE `url_id`=%s AND `userid`=%s LIMIT 1",
1017                 array(bigintval($urlId), getUserId()), __FUNCTION__, __LINE__);
1018 }
1019
1020 // Pay points to the user and remove it from the sender if userid is given else it is a "sponsored surf"
1021 function SURFBAR_PAY_POINTS () {
1022         // Remove it from the URL owner
1023         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "uid=".SURFBAR_GET_USERID().",costs=".SURFBAR_GET_COSTS()."", false);
1024         if (SURFBAR_GET_USERID() > 0) {
1025                 SUB_POINTS(sprintf("surfbar_%s", getConfig('surfbar_pay_model')), SURFBAR_GET_USERID(), SURFBAR_GET_COSTS());
1026         } // END - if
1027
1028         // Book it to the user
1029         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "uid=".getUserId().",reward=".SURFBAR_GET_REWARD()."", false);
1030         ADD_POINTS_REFSYSTEM(sprintf("surfbar_%s", getConfig('surfbar_pay_model')), getUserId(), SURFBAR_GET_DATA('reward'));
1031 }
1032
1033 // Updates the statistics of current URL/userid
1034 function SURFBAR_UPDATE_INSERT_STATS_RECORD () {
1035         // Init add
1036         $add = '';
1037
1038         // Get allowed views
1039         $allowed = SURFBAR_GET_VIEWS_ALLOWED();
1040
1041         // Do we have a limit?
1042         if ($allowed > 0) {
1043                 // Then count views_max down!
1044                 $add .= ", `views_max`=`views_max`-1";
1045         } // END - if
1046
1047         // Update URL stats
1048         SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_surfbar_urls` SET `views_total`=`views_total`+1".$add." WHERE `id`=%s LIMIT 1",
1049                 array(SURFBAR_GET_ID()), __FUNCTION__, __LINE__);
1050
1051         // Update the stats entry
1052         SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_surfbar_stats` SET `count`=`count`+1 WHERE `userid`=%s AND `url_id`=%s LIMIT 1",
1053                 array(getUserId(), SURFBAR_GET_ID()), __FUNCTION__, __LINE__);
1054
1055         // Was that update okay?
1056         if (SQL_AFFECTEDROWS() < 1) {
1057                 // No, then insert entry
1058                 SQL_QUERY_ESC("INSERT INTO `{!_MYSQL_PREFIX!}_surfbar_stats` (userid,url_id,count) VALUES (%s,%s,1)",
1059                 array(getUserId(), SURFBAR_GET_ID()), __FUNCTION__, __LINE__);
1060         } // END - if
1061
1062         // Update total/daily/weekly/monthly counter
1063         incrementConfigEntry('surfbar_total_counter');
1064         incrementConfigEntry('surfbar_daily_counter');
1065         incrementConfigEntry('surfbar_weekly_counter');
1066         incrementConfigEntry('surfbar_monthly_counter');
1067
1068         // Update config as well
1069         updateConfiguration(array('surfbar_total_counter', 'surfbar_daily_counter', 'surfbar_weekly_counter', 'surfbar_monthly_counter'), array(1,1,1,1), '+');
1070 }
1071
1072 // Update the salt for validation and statistics
1073 function SURFBAR_UPDATE_SALT_STATS () {
1074         // Update statistics record
1075         SURFBAR_UPDATE_INSERT_STATS_RECORD();
1076
1077         // Simply store the salt from cache away in database...
1078         SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_surfbar_salts` SET `last_salt`='%s' WHERE `url_id`=%s AND `userid`=%s LIMIT 1",
1079                 array(SURFBAR_GET_SALT(), SURFBAR_GET_ID(), getUserId()), __FUNCTION__, __LINE__);
1080
1081         // Debug message
1082         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "salt=".SURFBAR_GET_SALT().",id=".SURFBAR_GET_ID().",uid=".getUserId()."", false);
1083
1084         // Was that okay?
1085         if (SQL_AFFECTEDROWS() < 1) {
1086                 // Insert missing entry!
1087                 SQL_QUERY_ESC("INSERT INTO `{!_MYSQL_PREFIX!}_surfbar_salts` (`url_id`, `userid`, `last_salt`) VALUES (%s, %s, '%s')",
1088                         array(SURFBAR_GET_ID(), getUserId(), SURFBAR_GET_SALT()), __FUNCTION__, __LINE__);
1089         } // END - if
1090
1091         // Debug message
1092         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "affectedRows=".SQL_AFFECTEDROWS()."", false);
1093
1094         // Return if the update was okay
1095         return (SQL_AFFECTEDROWS() == 1);
1096 }
1097
1098 // Check if the reload lock is active for given id
1099 function SURFBAR_CHECK_RELOAD_LOCK ($urlId) {
1100         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "id={$urlId}", false);
1101         // Ask the database
1102         $result = SQL_QUERY_ESC("SELECT COUNT(id) AS cnt
1103 FROM `{!_MYSQL_PREFIX!}_surfbar_locks`
1104 WHERE userid=%s AND url_id=%s AND (UNIX_TIMESTAMP() - ".SURFBAR_GET_SURF_LOCK().") < UNIX_TIMESTAMP(last_surfed)
1105 ORDER BY last_surfed ASC
1106 LIMIT 1",
1107         array(getUserId(), bigintval($urlId)), __FUNCTION__, __LINE__
1108         );
1109
1110         // Fetch counter
1111         list($cnt) = SQL_FETCHROW($result);
1112
1113         // Free result
1114         SQL_FREERESULT($result);
1115
1116         // Return check
1117         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "cnt={$cnt},".SURFBAR_GET_SURF_LOCK()."", false);
1118         return ($cnt == 1);
1119 }
1120
1121 // Determine which user hash no more points left
1122 function SURFBAR_DETERMINE_DEPLETED_USERIDS ($limit=0) {
1123         // Init array
1124         $UIDs = array(
1125                 'uid'      => array(),
1126                 'points'   => array(),
1127                 'notified' => array(),
1128         );
1129
1130         // Do we have a current user id?
1131         if ((IS_MEMBER()) && ($limit == 0)) {
1132                 // Then add this as well
1133                 $UIDs['uid'][getUserId()]      = getUserId();
1134                 $UIDs['points'][getUserId()]   = GET_TOTAL_DATA(getUserId(), 'user_points', 'points') - GET_TOTAL_DATA(getUserId(), 'user_data', 'used_points');
1135                 $UIDs['notified'][getUserId()] = 0;
1136
1137                 // Get all userid except logged in one
1138                 $result = SQL_QUERY_ESC("SELECT
1139         u.userid, UNIX_TIMESTAMP(d.surfbar_low_notified) AS notified
1140 FROM
1141         `{!_MYSQL_PREFIX!}_surfbar_urls` AS u
1142 INNER JOIN
1143         `{!_MYSQL_PREFIX!}_user_data` AS d
1144 ON
1145         u.userid=d.userid
1146 WHERE
1147         u.userid NOT IN (%s,0) AND u.`status`='ACTIVE'
1148 GROUP BY
1149         u.userid
1150 ORDER BY
1151         u.userid ASC",
1152                         array(getUserId()), __FUNCTION__, __LINE__);
1153         } else {
1154                 // Get all userid
1155                 $result = SQL_QUERY("SELECT
1156         u.userid, UNIX_TIMESTAMP(d.surfbar_low_notified) AS notified
1157 FROM
1158         `{!_MYSQL_PREFIX!}_surfbar_urls` AS u
1159 INNER JOIN
1160         `{!_MYSQL_PREFIX!}_user_data` AS d
1161 ON
1162         u.userid=d.userid
1163 WHERE
1164         u.`status`='ACTIVE'
1165 GROUP BY
1166         u.userid
1167 ORDER BY
1168         u.userid ASC", __FUNCTION__, __LINE__);
1169         }
1170
1171         // Load all userid
1172         while ($content = SQL_FETCHARRAY($result)) {
1173                 // Get total points
1174                 $points = GET_TOTAL_DATA($content['userid'], 'user_points', 'points') - GET_TOTAL_DATA($content['userid'], 'user_data', 'used_points');
1175                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "uid={$content['userid']},points={$points}", false);
1176
1177                 // Shall we add this to ignore?
1178                 if ($points <= $limit) {
1179                         // Ignore this one!
1180                         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "uid={$content['userid']} has depleted points amount!", false);
1181                         $UIDs['uid'][$content['userid']]      = $content['userid'];
1182                         $UIDs['points'][$content['userid']]   = $points;
1183                         $UIDs['notified'][$content['userid']] = $content['notified'];
1184                 } // END - if
1185         } // END - while
1186
1187         // Free result
1188         SQL_FREERESULT($result);
1189
1190         // Debug message
1191         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "UIDs::count=".count($UIDs)." (with own userid=".getUserId().')', false);
1192
1193         // Return result
1194         return $UIDs;
1195 }
1196
1197 // Determine how many users are Online in surfbar
1198 function SURFBAR_DETERMINE_TOTAL_ONLINE () {
1199         // Count all users in surfbar modue and return the value
1200         $result = SQL_QUERY_ESC("SELECT id
1201 FROM `{!_MYSQL_PREFIX!}_surfbar_stats`
1202 WHERE (UNIX_TIMESTAMP() - UNIX_TIMESTAMP(last_online)) <= %s
1203 GROUP BY userid",
1204         array(getConfig('online_timeout')), __FUNCTION__, __LINE__);
1205
1206         // Fetch count
1207         $cnt = SQL_NUMROWS($result);
1208
1209         // Free result
1210         SQL_FREERESULT($result);
1211
1212         // Return result
1213         return $cnt;
1214 }
1215
1216 // Determine waiting time for one URL
1217 function SURFBAR_DETERMINE_WAIT_TIME () {
1218         // Get fixed reload lock
1219         $fixed = SURFBAR_GET_FIXED_RELOAD();
1220
1221         // Is the fixed reload time set?
1222         if ($fixed > 0) {
1223                 // Return it
1224                 return $fixed;
1225         } // END - if
1226
1227         // Static time is default
1228         $time = getConfig('surfbar_static_time');
1229
1230         // Which payment model do we have?
1231         if (getConfig('surfbar_pay_model') == 'DYNAMIC') {
1232                 // "Calculate" dynamic time
1233                 $time += SURFBAR_CALCULATE_DYNAMIC_ADD();
1234         } // END - if
1235
1236         // Return value
1237         return $time;
1238 }
1239
1240 // Changes the status of an URL from given to other
1241 function SURFBAR_CHANGE_STATUS ($urlId, $prevStatus, $newStatus, $data=array()) {
1242         // Make new status always lower-case
1243         $newStatus = strtolower($newStatus);
1244
1245         // Get URL data for status comparison if missing
1246         if ((!is_array($data)) || (count($data) == 0)) {
1247                 // Fetch missing URL data
1248                 $data = SURFBAR_GET_URL_DATA($urlId);
1249         } // END - if
1250
1251         // Is the new status set?
1252         if ((!is_string($newStatus)) || (empty($newStatus))) {
1253                 // Abort here, but fine!
1254                 return true;
1255         } // END - if
1256
1257         // Is the status like prevStatus is saying?
1258         if ($data[$urlId]['status'] != $prevStatus) {
1259                 // No, then abort here
1260                 return false;
1261         } // END - if
1262
1263
1264         // Update the status now
1265         // ---------- Comment out for debugging/developing member actions! ---------
1266         //SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_surfbar_urls` SET `status`='%s' WHERE `id`=%s LIMIT 1",
1267         //      array($newStatus, bigintval($urlId)), __FUNCTION__, __LINE__);
1268         // ---------- Comment out for debugging/developing member actions! ---------
1269
1270         // Was that fine?
1271         // ---------- Comment out for debugging/developing member actions! ---------
1272         //if (SQL_AFFECTEDROWS() != 1) {
1273         //      // No, something went wrong
1274         //      return false;
1275         //} // END - if
1276         // ---------- Comment out for debugging/developing member actions! ---------
1277
1278         // Prepare content for notification routines
1279         $data[$urlId]['uid']         = $data[$urlId]['userid'];
1280         $data[$urlId]['frametester'] = FRAMETESTER($data[$urlId]['url']);
1281         $data[$urlId]['reward']      = translateComma(getConfig('surfbar_static_reward'));
1282         $data[$urlId]['costs']       = translateComma(getConfig('surfbar_static_costs'));
1283
1284         // Do some dirty fixing here:
1285         if (($data[$urlId]['status'] == 'STOPPED') && ($newStatus == 'pending')) {
1286                 // Fix for template change
1287                 $newStatus = 'continued';
1288         } // END - if
1289
1290         // Send admin notification
1291         SURFBAR_NOTIFY_ADMIN("url_{$data[$urlId]['status']}_{$newStatus}", $data[$urlId]);
1292
1293         // Send user notification
1294         SURFBAR_NOTIFY_USER("url_{$data[$urlId]['status']}_{$newStatus}", $data[$urlId]);
1295
1296         // All done!
1297         return true;
1298 }
1299
1300 // Calculate minimum value for dynamic payment model
1301 function SURFBAR_CALCULATE_DYNAMIC_MIN_VALUE () {
1302         // Addon is zero by default
1303         $addon = 0;
1304
1305         // Percentage part
1306         $percent = abs(log(getConfig('surfbar_dynamic_percent') / 100 + 1));
1307
1308         // Get total users
1309         $totalUsers = GET_TOTAL_DATA('CONFIRMED', 'user_data', 'userid', 'status', true);
1310
1311         // Get online users
1312         $onlineUsers = SURFBAR_DETERMINE_TOTAL_ONLINE();
1313
1314         // Calculate addon
1315         $addon += abs(log($onlineUsers / $totalUsers + 1) * $percent * $totalUsers);
1316
1317         // Get total URLs
1318         $totalUrls = SURFBAR_GET_TOTAL_URLS('ACTIVE', '0');
1319
1320         // Get user's total URLs
1321         $userUrls = SURFBAR_GET_TOTAL_USER_URLS(0, 'ACTIVE');
1322
1323         // Calculate addon
1324         if ($totalUrls > 0) {
1325                 $addon += abs(log($userUrls / $totalUrls + 1) * $percent * $totalUrls);
1326         } else {
1327                 $addon += abs(log($userUrls / 1 + 1) * $percent * $totalUrls);
1328         }
1329
1330         // Return addon
1331         return $addon;
1332 }
1333
1334 // Calculate maximum value for dynamic payment model
1335 function SURFBAR_CALCULATE_DYNAMIC_MAX_VALUE () {
1336         // Addon is zero by default
1337         $addon = 0;
1338
1339         // Maximum value
1340         $max = log(2);
1341
1342         // Percentage part
1343         $percent = abs(log(getConfig('surfbar_dynamic_percent') / 100 + 1));
1344
1345         // Get total users
1346         $totalUsers = GET_TOTAL_DATA('CONFIRMED', 'user_data', 'userid', 'status', true);
1347
1348         // Calculate addon
1349         $addon += abs($max * $percent * $totalUsers);
1350
1351         // Get total URLs
1352         $totalUrls = SURFBAR_GET_TOTAL_URLS('ACTIVE', '0');
1353
1354         // Calculate addon
1355         $addon += abs($max * $percent * $totalUrls);
1356
1357         // Return addon
1358         return $addon;
1359 }
1360
1361 // Calculate dynamic lock
1362 function SURFBAR_CALCULATE_DYNAMIC_LOCK () {
1363         // Default lock is 30 seconds
1364         $addon = 30;
1365
1366         // Get online users
1367         $onlineUsers = SURFBAR_DETERMINE_TOTAL_ONLINE();
1368
1369         // Calculate lock
1370         $addon = abs(log($onlineUsers / $addon + 1));
1371
1372         // Return value
1373         return $addon;
1374 }
1375
1376 // "Getter" for lock ids array
1377 function SURFBAR_GET_LOCK_IDS () {
1378         // Prepare some arrays
1379         $IDs = array();
1380         $USE = array();
1381         $ignored = array();
1382
1383         // Get all id from locks within the timestamp
1384         $result = SQL_QUERY_ESC("SELECT id, url_id, UNIX_TIMESTAMP(last_surfed) AS last
1385 FROM
1386         {!_MYSQL_PREFIX!}_surfbar_locks
1387 WHERE
1388         userid=%s
1389 ORDER BY
1390         id ASC", array(getUserId()),
1391         __FUNCTION__, __LINE__);
1392
1393         // Load all entries
1394         while ($content = SQL_FETCHARRAY($result)) {
1395                 // Debug message
1396                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "next - lid={$content['id']},url={$content['url_id']},rest=".(time() - $last).'/'.SURFBAR_GET_SURF_LOCK()."", false);
1397
1398                 // Skip entries that are too old
1399                 if (($last > (time() - SURFBAR_GET_SURF_LOCK())) && (!in_array($content['url_id'], $ignored))) {
1400                         // Debug message
1401                         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "okay - lid={$content['id']},url={$content['url_id']},last={$last}", false);
1402
1403                         // Add only if missing or bigger
1404                         if ((!isset($IDs[$content['url_id']])) || ($IDs[$content['url_id']] > $last)) {
1405                                 // Debug message
1406                                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "ADD - lid={$content['id']},url={$content['url_id']},last={$last}", false);
1407
1408                                 // Add this ID
1409                                 $IDs[$content['url_id']] = $last;
1410                                 $USE[$content['url_id']] = $content['id'];
1411                         } // END - if
1412                 } else {
1413                         // Debug message
1414                         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "ignore - lid={$content['id']},url={$content['url_id']},last={$last}", false);
1415
1416                         // Ignore these old entries!
1417                         $ignored[] = $content['url_id'];
1418                         unset($IDs[$content['url_id']]);
1419                         unset($USE[$content['url_id']]);
1420                 }
1421         } // END - while
1422
1423         // Free result
1424         SQL_FREERESULT($result);
1425
1426         // Return array
1427         return $USE;
1428 }
1429
1430 // "Getter" for maximum random number
1431 function SURFBAR_GET_MAX_RANDOM ($UIDs, $add) {
1432         // Count max availabe entries
1433         $result = SQL_QUERY("SELECT sbu.id AS cnt
1434 FROM `{!_MYSQL_PREFIX!}_surfbar_urls` AS sbu
1435 LEFT JOIN `{!_MYSQL_PREFIX!}_surfbar_salts` AS sbs
1436 ON sbu.id=sbs.url_id
1437 LEFT JOIN `{!_MYSQL_PREFIX!}_surfbar_locks` AS l
1438 ON sbu.id=l.url_id
1439 WHERE sbu.userid NOT IN (".implode(',', $UIDs).") AND (sbu.views_allowed=0 OR (sbu.views_allowed > 0 AND sbu.views_max > 0)) AND sbu.`status`='ACTIVE'".$add."
1440 GROUP BY sbu.id", __FUNCTION__, __LINE__);
1441
1442         // Log last query
1443         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "lastQuery=".getConfig('db_last_query')."|numRows=".SQL_NUMROWS($result)."|Affected=".SQL_AFFECTEDROWS()."", false);
1444
1445         // Fetch max rand
1446         $maxRand = SQL_NUMROWS($result);
1447
1448         // Free result
1449         SQL_FREERESULT($result);
1450
1451         // Return value
1452         return $maxRand;
1453 }
1454
1455 // Load all URLs of the current user and return it as an array
1456 function SURFBAR_GET_USER_URLS () {
1457         // Init array
1458         $URLs = array();
1459
1460         // Begin the query
1461         $result = SQL_QUERY_ESC("SELECT u.id, u.userid, u.url, u.views_total, u.views_max, u.views_allowed, u.status, UNIX_TIMESTAMP(u.registered) AS registered, UNIX_TIMESTAMP(u.last_locked) AS last_locked, u.lock_reason AS lock_reason
1462 FROM `{!_MYSQL_PREFIX!}_surfbar_urls` AS u
1463 WHERE u.userid=%s AND u.status != 'DELETED'
1464 ORDER BY u.id ASC",
1465         array(getUserId()), __FUNCTION__, __LINE__);
1466
1467         // Are there entries?
1468         if (SQL_NUMROWS($result) > 0) {
1469                 // Load all rows
1470                 while ($row = SQL_FETCHARRAY($result)) {
1471                         // Add the row
1472                         $URLs[$row['id']] = $row;
1473                 } // END - while
1474         } // END - if
1475
1476         // Free result
1477         SQL_FREERESULT($result);
1478
1479         // Return the array
1480         return $URLs;
1481 }
1482
1483 // "Getter" for member action array for given status
1484 function SURFBAR_getModeAction_ARRAY ($status) {
1485         // Init array
1486         $returnArray = array();
1487
1488         // Get all assigned actions
1489         $result = SQL_QUERY_ESC("SELECT action FROM `{!_MYSQL_PREFIX!}_surfbar_actions` WHERE `status`='%s' ORDER BY `id` ASC",
1490         array($status), __FUNCTION__, __LINE__);
1491
1492         // Some entries there?
1493         if (SQL_NUMROWS($result) > 0) {
1494                 // Load all actions
1495                 // @TODO This can be somehow rewritten
1496                 while ($content = SQL_FETCHARRAY($result)) {
1497                         $returnArray[] = $content['action'];
1498                 } // END - if
1499         } // END - if
1500
1501         // Free result
1502         SQL_FREERESULT($result);
1503
1504         // Return result
1505         return $returnArray;
1506 }
1507
1508 // Reload to configured stop page
1509 function SURFBAR_RELOAD_TO_STOP_PAGE ($page="stop") {
1510         // Internal or external?
1511         if ((getConfig('surfbar_pause_mode') == 'INTERNAL') || (getConfig('surfbar_pause_url') == '')) {
1512                 // Reload to internal page
1513                 redirectToUrl('surfbar.php?frame=' . $page);
1514         } else {
1515                 // Reload to external page
1516                 redirectToConfiguredUrl('surfbar_pause_url');
1517         }
1518 }
1519
1520 // Determine next id for surfbar or get data for given id, always call this before you call other
1521 // getters below this function!!!
1522 function SURFBAR_DETERMINE_NEXT_ID ($urlId = 0) {
1523         // Default is no id and no random number
1524         $nextId = 0;
1525         $randNum = 0;
1526
1527         // Is the ID set?
1528         if ($urlId == 0) {
1529                 // Get array with lock ids
1530                 $USE = SURFBAR_GET_LOCK_IDS();
1531
1532                 // Shall we add some URL ids to ignore?
1533                 $add = '';
1534                 if (count($USE) > 0) {
1535                         // Ignore some!
1536                         $add = " AND sbu.id NOT IN (";
1537                         foreach ($USE as $url_id => $lid) {
1538                                 // Add URL id
1539                                 $add .= $url_id.',';
1540                         } // END - foreach
1541
1542                         // Add closing bracket
1543                         $add = substr($add, 0, -1) . ')';
1544                 } // END - if
1545
1546                 // Determine depleted user account
1547                 $UIDs = SURFBAR_DETERMINE_DEPLETED_USERIDS();
1548
1549                 // Get maximum randomness factor
1550                 $maxRand = SURFBAR_GET_MAX_RANDOM($UIDs['uid'], $add);
1551
1552                 // If more than one URL can be called generate the random number!
1553                 if ($maxRand > 1) {
1554                         // Generate random number
1555                         $randNum = mt_rand(0, ($maxRand - 1));
1556                 } // END - if
1557
1558                 // And query the database
1559                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "randNum={$randNum},maxRand={$maxRand},surfLock=".SURFBAR_GET_SURF_LOCK()."", false);
1560                 $result = SQL_QUERY_ESC("SELECT sbu.id, sbu.userid, sbu.url, sbs.last_salt, sbu.views_total, sbu.views_max, sbu.views_allowed, UNIX_TIMESTAMP(l.last_surfed) AS last_surfed, sbu.fixed_reload
1561 FROM `{!_MYSQL_PREFIX!}_surfbar_urls` AS sbu
1562 LEFT JOIN `{!_MYSQL_PREFIX!}_surfbar_salts` AS sbs
1563 ON sbu.id=sbs.url_id
1564 LEFT JOIN `{!_MYSQL_PREFIX!}_surfbar_locks` AS l
1565 ON sbu.id=l.url_id
1566 WHERE sbu.userid NOT IN (".implode(',', $UIDs['uid']).") AND sbu.`status`='ACTIVE' AND (sbu.views_allowed=0 OR (sbu.views_allowed > 0 AND sbu.views_max > 0))".$add."
1567 GROUP BY sbu.id
1568 ORDER BY l.last_surfed ASC, sbu.id ASC
1569 LIMIT %s,1",
1570                 array($randNum), __FUNCTION__, __LINE__
1571                 );
1572         } else {
1573                 // Get data from specified id number
1574                 $result = SQL_QUERY_ESC("SELECT sbu.id, sbu.userid, sbu.url, sbs.last_salt, sbu.views_total, sbu.views_max, sbu.views_allowed, UNIX_TIMESTAMP(l.last_surfed) AS last_surfed, sbu.fixed_reload
1575 FROM `{!_MYSQL_PREFIX!}_surfbar_urls` AS sbu
1576 LEFT JOIN `{!_MYSQL_PREFIX!}_surfbar_salts` AS sbs
1577 ON sbu.id=sbs.url_id
1578 LEFT JOIN `{!_MYSQL_PREFIX!}_surfbar_locks` AS l
1579 ON sbu.id=l.url_id
1580 WHERE sbu.userid != %s AND sbu.`status`='ACTIVE' AND sbu.id=%s AND (sbu.views_allowed=0 OR (sbu.views_allowed > 0 AND sbu.views_max > 0))
1581 LIMIT 1",
1582                 array(getUserId(), bigintval($urlId)), __FUNCTION__, __LINE__
1583                 );
1584         }
1585
1586         // Is there an id number?
1587         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "lastQuery=".getConfig('db_last_query')."|numRows=".SQL_NUMROWS($result)."|Affected=".SQL_AFFECTEDROWS()."", false);
1588         if (SQL_NUMROWS($result) == 1) {
1589                 // Load/cache data
1590                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "count(".count($GLOBALS['surfbar_cache']).") - BEFORE", false);
1591                 $GLOBALS['surfbar_cache'] = merge_array($GLOBALS['surfbar_cache'], SQL_FETCHARRAY($result));
1592                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "count(".count($GLOBALS['surfbar_cache']).") - AFTER", false);
1593
1594                 // Determine waiting time
1595                 $GLOBALS['surfbar_cache']['time'] = SURFBAR_DETERMINE_WAIT_TIME();
1596
1597                 // Is the last salt there?
1598                 if (is_null($GLOBALS['surfbar_cache']['last_salt'])) {
1599                         // Then repair it wit the static!
1600                         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "last_salt - FIXED!", false);
1601                         $GLOBALS['surfbar_cache']['last_salt'] = '';
1602                 } // END - if
1603
1604                 // Fix missing last_surfed
1605                 if ((!isset($GLOBALS['surfbar_cache']['last_surfed'])) || (is_null($GLOBALS['surfbar_cache']['last_surfed']))) {
1606                         // Fix it here
1607                         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "last_surfed - FIXED!", false);
1608                         $GLOBALS['surfbar_cache']['last_surfed'] = 0;
1609                 } // END - if
1610
1611                 // Get base/fixed reward and costs
1612                 $GLOBALS['surfbar_cache']['reward'] = SURFBAR_DETERMINE_REWARD();
1613                 $GLOBALS['surfbar_cache']['costs']  = SURFBAR_DETERMINE_COSTS();
1614                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "BASE/STATIC - reward=".SURFBAR_GET_REWARD()."|costs=".SURFBAR_GET_COSTS()."", false);
1615
1616                 // Only in dynamic model add the dynamic bonus!
1617                 if (getConfig('surfbar_pay_model') == 'DYNAMIC') {
1618                         // Calculate dynamic reward/costs and add it
1619                         $GLOBALS['surfbar_cache']['reward'] += SURFBAR_CALCULATE_DYNAMIC_ADD();
1620                         $GLOBALS['surfbar_cache']['costs']  += SURFBAR_CALCULATE_DYNAMIC_ADD();
1621                         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "DYNAMIC+ - reward=".SURFBAR_GET_REWARD()."|costs=".SURFBAR_GET_COSTS()."", false);
1622                 } // END - if
1623
1624                 // Now get the id
1625                 $nextId = SURFBAR_GET_ID();
1626         } // END - if
1627
1628         // Free result
1629         SQL_FREERESULT($result);
1630
1631         // Return result
1632         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "nextId={$nextId}", false);
1633         return $nextId;
1634 }
1635
1636 // -----------------------------------------------------------------------------
1637 // PLEASE DO NOT ADD ANY OTHER FUNCTIONS BELOW THIS LINE IF THEY DON'T "WRAP"
1638 // THE $GLOBALS['surfbar_cache'] ARRAY!
1639 // -----------------------------------------------------------------------------
1640
1641 // Initializes the surfbar
1642 function SURFBAR_INIT () {
1643         // Init cache array
1644         $GLOBALS['surfbar_cache'] = array();
1645 }
1646
1647 // Private getter for data elements
1648 function SURFBAR_GET_DATA ($element) {
1649         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "element={$element}", false);
1650
1651         // Default is null
1652         $data = null;
1653
1654         // Is the entry there?
1655         if (isset($GLOBALS['surfbar_cache'][$element])) {
1656                 // Then take it
1657                 $data = $GLOBALS['surfbar_cache'][$element];
1658         } else { // END - if
1659                 print("<pre>");
1660                 print_r($GLOBALS['surfbar_cache']);
1661                 print("</pre>");
1662                 debug_report_bug();
1663         }
1664
1665         // Return result
1666         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "element[$element]={$data}", false);
1667         return $data;
1668 }
1669
1670 // Getter for reward from cache
1671 function SURFBAR_GET_REWARD () {
1672         // Get data element and return its contents
1673         return SURFBAR_GET_DATA('reward');
1674 }
1675
1676 // Getter for costs from cache
1677 function SURFBAR_GET_COSTS () {
1678         // Get data element and return its contents
1679         return SURFBAR_GET_DATA('costs');
1680 }
1681
1682 // Getter for URL from cache
1683 function SURFBAR_GET_URL () {
1684         // Get data element and return its contents
1685         return SURFBAR_GET_DATA('url');
1686 }
1687
1688 // Getter for salt from cache
1689 function SURFBAR_GET_SALT () {
1690         // Get data element and return its contents
1691         return SURFBAR_GET_DATA('salt');
1692 }
1693
1694 // Getter for id from cache
1695 function SURFBAR_GET_ID () {
1696         // Get data element and return its contents
1697         return SURFBAR_GET_DATA('id');
1698 }
1699
1700 // Getter for userid from cache
1701 function SURFBAR_GET_USERID () {
1702         // Get data element and return its contents
1703         return SURFBAR_GET_DATA('userid');
1704 }
1705
1706 // Getter for user reload locks
1707 function SURFBAR_GET_USER_LOCKS () {
1708         // Get data element and return its contents
1709         return SURFBAR_GET_DATA('user_locks');
1710 }
1711
1712 // Getter for reload time
1713 function SURFBAR_GET_RELOAD_TIME () {
1714         // Get data element and return its contents
1715         return SURFBAR_GET_DATA('time');
1716 }
1717
1718 // Getter for allowed views
1719 function SURFBAR_GET_VIEWS_ALLOWED () {
1720         // Get data element and return its contents
1721         return SURFBAR_GET_DATA('views_allowed');
1722 }
1723
1724 // Getter for fixed reload
1725 function SURFBAR_GET_FIXED_RELOAD () {
1726         // Get data element and return its contents
1727         return SURFBAR_GET_DATA('fixed_reload');
1728 }
1729
1730 // Getter for surf lock
1731 function SURFBAR_GET_SURF_LOCK () {
1732         // Get data element and return its contents
1733         return SURFBAR_GET_DATA('surf_lock');
1734 }
1735
1736 // Getter for new status
1737 function SURFBAR_GET_NEW_STATUS () {
1738         // Get data element and return its contents
1739         return SURFBAR_GET_DATA('new_status');
1740 }
1741
1742 // [EOF]
1743 ?>