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