mailer project continued:
[mailer.git] / inc / libs / rallye_functions.php
index feffef0f6131f358e92926a4efcc1a1fccb3c6cb..d88550529135925a0f2b1c34c20220e7978217d1 100644 (file)
@@ -16,7 +16,7 @@
  * $Author::                                                          $ *
  * -------------------------------------------------------------------- *
  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
- * Copyright (c) 2009 - 2011 by Mailer Developer Team                   *
+ * Copyright (c) 2009 - 2012 by Mailer Developer Team                   *
  * For more information visit: http://mxchange.org                      *
  *                                                                      *
  * This program is free software; you can redistribute it and/or modify *
@@ -43,7 +43,7 @@ if (!defined('__SECURITY')) {
 // Auto-start referral rallyes
 function autostartReferralRallyes ($result) {
        // Load all rallyes (usally we have only one rallye active per time!
-       list($id, $title, $start, $end, $notify, $min_users, $min_prices) = SQL_FETCHROW($result);
+       $content = SQL_FETCHARRAY($result);
 
        // Free result
        SQL_FREERESULT($result);
@@ -56,22 +56,7 @@ SET
 WHERE
        `id`=%s
 LIMIT 1",
-               array(bigintval($id)), __FUNCTION__, __LINE__);
-
-       // Transfer all neccessary data to the $content array
-       $content['userid_cnt'] = getTotalConfirmedUser();
-       $content['start']      = generateDateTime($start, 2);
-       $content['end']        = generateDateTime($end  , 2);
-       $content['now_t']      = generateDateTime(time(), 2);
-       $content['title']      = $title;
-       $content['id']         = $id;  // id for the rallye details link
-
-       // Determine min_users and min_prices
-       $content['min_users']  = determineReferralRallyeMinimumUsers($min_users);
-       $content['min_prices'] = determineReferralRallyeMinimumPrices($min_prices);
-
-       // Load prices
-       $content['prices'] = addReferralRallyePrices($id);
+               array(bigintval($content['id'])), __FUNCTION__, __LINE__);
 
        // Query all users
        $result_user = SQL_QUERY("SELECT
@@ -80,6 +65,7 @@ FROM
        `{?_MYSQL_PREFIX?}_user_data`
 WHERE
        `status`='CONFIRMED'
+       " . runFilterChain('user_exclusion_sql', ' ') . "
 ORDER BY
        `userid` ASC", __FUNCTION__, __LINE__);
 
@@ -103,12 +89,13 @@ WHERE
        `rallye_id`=%s AND
        `userid`=%s
 LIMIT 1",
-                       array(bigintval($id), bigintval($content['userid'])), __FUNCTION__, __LINE__);
-               if (SQL_HASZERONUMS($result_ref)) {
+                       array(bigintval($content['id']), bigintval($content['userid'])), __FUNCTION__, __LINE__);
 
+               // Do we have an entry?
+               if (SQL_HASZERONUMS($result_ref)) {
                        // Add userid and his ref count to table
                        $result_ref = SQL_QUERY_ESC("SELECT 
-       SUM(p.points) AS `points`
+       SUM(p.`points`) AS `points`
 FROM
        `{?_MYSQL_PREFIX?}_user_points` AS p
 LEFT JOIN
@@ -116,7 +103,8 @@ LEFT JOIN
 ON
        p.userid=d.userid
 WHERE
-       d.`status`='CONFIRMED' AND
+       d.`status`='CONFIRMED'
+       " . runFilterChain('user_exclusion_sql', ' ') . " AND
        d.`max_mails` > 0 AND
        d.`mails_confirmed` >= {?ref_payout?} AND
        p.`ref_depth`=1 AND
@@ -135,11 +123,19 @@ WHERE
                        // Add info line
                        SQL_QUERY_ESC("INSERT INTO
        `{?_MYSQL_PREFIX?}_rallye_users`
-(`rallye_id`,`userid`,`refs`,`curr_points`)
-       VALUES
-(%s, %s, %s, %s)",
+(
+       `rallye_id`,
+       `userid`,
+       `refs`,
+       `curr_points`
+) VALUES (
+       %s,
+       %s,
+       %s,
+       %s
+)",
                                array(
-                                       bigintval($id),
+                                       bigintval($content['id']),
                                        bigintval($content['userid']),
                                        bigintval($count),
                                        $cpoints
@@ -154,19 +150,21 @@ WHERE
                $content['refs']  = $count;
 
                // Shall I notify this member?
-               if (($notify == 'Y') && ($un)) {
+               if (($content['send_notify'] == 'Y') && ($un === true)) {
                        // Load email template and send it to the user
                        $message = loadEmailTemplate('member_rallye_notify', $content, $content['userid']);
-                       sendEmail($content['userid'], '{%message,RALLYE_MEMBER_NOTIFY=' . $title . '%}', $message);
+                       sendEmail($content['userid'], '{%message,MEMBER_RALLYE_NOTIFY_SUBJECT=' . $content['title'] . '%}', $message);
                } // END - if
        } // END - while
 
        // Choose the right admin template
        $templ = 'admin_rallye_no_notify';
-       if ($notify == 'Y') $templ = 'admin_rallye_notify';
+       if ($content['send_notify'] == 'Y') {
+               $templ = 'admin_rallye_notify';
+       } // END - if
 
        // Send email to admin
-       sendAdminNotification('{%message,RALLYE_ADMIN_NOTIFY=' . $title . '%}', $templ, $prices);
+       sendAdminNotification('{%message,ADMIN_RALLYE_NOTIFY_SUBJECT=' . $content['title'] . '%}', $templ, $content);
 
        // Free memory
        SQL_FREERESULT($result_user);
@@ -176,13 +174,15 @@ WHERE
 function addReferralRallyePrices ($rallye, $mode = 'email') {
        // Output mode
        switch($mode) {
-               case 'email': $mode = "\n";     break;
+               case 'email': $mode = chr(10);  break;
                case 'html' : $mode = '<br />'; break;
        } // END - switch
 
        // Load prices
        $result_prices = SQL_QUERY_ESC("SELECT
-       `price_level`,`points`,`info`
+       `price_level`,
+       `points`,
+       `info`
 FROM
        `{?_MYSQL_PREFIX?}_rallye_prices`
 WHERE
@@ -194,15 +194,17 @@ ORDER BY
        // Entries found?
        if (!SQL_HASZERONUMS($result_prices)) {
                // Load prices
-               if ($mode == "\n") $prices = '{--RALLYE_MEMBER_PRICES_ADDED--}:' . $mode . '------------------------------' . $mode;
-
                $prices = '';
+               if ($mode == chr(10)) {
+                       $prices = '{--RALLYE_MEMBER_PRICES_ADDED--}:' . $mode . '------------------------------' . $mode;
+               } // END - if
+
                while ($content = SQL_FETCHARRAY($result_prices)) {
-                       $prices .= $content['price_level']. '{--RALLYE_PRICE--}: ';
+                       $prices .= $content['price_level']. '{--RALLYE_PRICE--}:';
                        if (!empty($content['info'])) {
                                $prices .= $content['info'];
                        } else {
-                               $prices .= $content['points'] . ' {?POINTS?}';
+                               $prices .= '{%pipe,translateComma=' . $content['points'] . '%} {?POINTS?}';
                        }
                        $prices .= '' . $mode;
                } // END - if
@@ -215,7 +217,9 @@ ORDER BY
        }
 
        // Add last line for email mode
-       if ($mode == "\n") $prices .= '------------------------------';
+       if ($mode == chr(10)) {
+               $prices .= '------------------------------';
+       } // END - if
 
        // Return price list
        return $prices;
@@ -224,27 +228,32 @@ ORDER BY
 //
 function addReferralRallyeTopUsers ($mode, $rallye, $default=0) {
        // Init variables
-       $min_users = 0; $min_prices = 0;
+       $min_users = 0;
+       $min_prices = 0;
 
        // First check how many prices are set
-       $prices = countSumTotalData($rallye, 'rallye_prices', 'id', 'rallye_id', true);
+       $prices = getTotalRallyePrices($rallye);
 
        // And load only limited users
-       $result = SQL_QUERY_ESC("SELECT
-       u.userid, u.refs, u.curr_points, rd.min_users, rd.min_prices
+       $result = SQL_QUERY_ESC("SELECT DISTINCT
+       u.`userid`,
+       u.`refs`,
+       u.`curr_points`,
+       rd.`min_users`,
+       rd.`min_prices`
 FROM
        `{?_MYSQL_PREFIX?}_rallye_users` AS u
-LEFT JOIN
+INNER JOIN
        `{?_MYSQL_PREFIX?}_refsystem` AS r
 ON
        u.userid=r.userid
-LEFT JOIN
+INNER JOIN
        `{?_MYSQL_PREFIX?}_rallye_data` AS rd
 ON
-       u.rallye_id=rd.id
+       u.`rallye_id`=rd.`id`
 WHERE
        u.`rallye_id`=%s AND
-       r.counter > 0
+       r.`counter` > 0
 ORDER BY
        u.refs DESC",
                array(bigintval($rallye)), __FUNCTION__, __LINE__);
@@ -257,27 +266,29 @@ ORDER BY
        );
 
        // Load all users
-       while ($content = SQL_FETCHARRAY($result)) {
+       while ($row = SQL_FETCHARRAY($result)) {
+               //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $row['userid'] . ',refs=' . $row['refs']);
                // Get current refs
-               $count = getReferralRallyeRefsCount($content['userid'], $content['refs']);
+               $count = getReferralRallyeRefsCount($row['userid'], $row['refs']);
 
                // Points of ref's
                $result_ref = SQL_QUERY_ESC("SELECT
-       p.points
+       p.`points`
 FROM
        `{?_MYSQL_PREFIX?}_user_points` AS p
 LEFT JOIN
        `{?_MYSQL_PREFIX?}_user_data` AS d
 ON
-       p.userid=d.userid
+       p.`userid`=d.`userid`
 WHERE
-       d.userid=%s AND
-       d.`status`='CONFIRMED' AND
-       p.ref_depth=1 AND
-       d.max_mails > 0 AND
-       d.mails_confirmed >= {?ref_payout?}
+       d.`userid`=%s AND
+       d.`status`='CONFIRMED'
+       " . runFilterChain('user_exclusion_sql', ' ') . " AND
+       p.`ref_depth`=1 AND
+       d.`max_mails` > 0 AND
+       d.`mails_confirmed` >= {?ref_payout?}
 LIMIT 1",
-                       array(bigintval($content['userid'])), __FUNCTION__, __LINE__);
+                       array(bigintval($row['userid'])), __FUNCTION__, __LINE__);
 
                // Get points
                list($refpoints) = SQL_FETCHROW($result_ref);
@@ -285,15 +296,18 @@ LIMIT 1",
                // Free result
                SQL_FREERESULT($result_ref);
 
-               if (empty($refpoints)) $refpoints = '0';
+               // Fix empty values (ugly code again)
+               if (empty($refpoints)) {
+                       $refpoints = '0';
+               } // END - if
 
                // Init userid for list
                $userid = '---';
 
                // List only users with at least one ref!
-               //* DEBUG: */ debugOutput('*'.$count.'/'.$content['userid'].'/'.$content['curr_points'].'/'.$refpoints.'*');
-               if (($count > 0) && ($refpoints > $content['curr_points'])) {
-                       $userid = $content['userid'];
+               //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'count=' . $count . ',userid=' . $userid . ',refpoints=' . $refpoints . ',curr_points=' . $row['curr_points']);
+               if (($count > 0) && ($refpoints > $row['curr_points'])) {
+                       $userid = $row['userid'];
                } else {
                        $count = '';
                }
@@ -301,23 +315,23 @@ LIMIT 1",
                // Save values to array
                $content['userid'][]   = $userid;
                $content['ref'][]      = $count;
-               $content['cpoints'][]  = $content['curr_points'];
-               $min_users  = $content['min_users'];
-               $min_prices = $content['min_prices'];
+               $content['cpoints'][]  = $row['curr_points'];
+               $min_users  = $row['min_users'];
+               $min_prices = $row['min_prices'];
        } // END - while
 
        // Free memory
        SQL_FREERESULT($result);
 
        // Sort whole array
-       array_pk_sort($content, array('ref', 'cpoints'), 0, 1, true);
+       array_pk_sort($content, array('cpoints', 'ref'), 0, 1, true);
 
        // Generate table
        $OUT = '';
-       for ($idx = '0'; $idx < $prices; $idx++) {
+       for ($idx = 0; $idx < $prices; $idx++) {
                // Prepare marking of default (maybe current user's) id
                $start = ''; $end = '';
-               if (($content['userid'][$idx] == $default) && ($default > 0)) {
+               if (($default > 0) && (isset($content['userid'][$idx])) && ($content['userid'][$idx] == $default)) {
                        $start = '<strong>';
                        $end   = '</strong>';
                } // END - if
@@ -327,9 +341,8 @@ LIMIT 1",
                        'idx'    => ($idx + 1),
                        'start'  => $start,
                        'end'    => $end,
-                       'userid' => $content['userid'][$idx],
-                       'ref'    => $content['ref'][$idx],
-                       'infos'  => ''
+                       'userid' => (isset($content['userid'][$idx])) ? $content['userid'][$idx] : '---',
+                       'ref'    => (isset($content['ref'][$idx]))    ? $content['ref'][$idx]    : '---'
                );
 
                // Load row template and switch color
@@ -345,6 +358,20 @@ LIMIT 1",
        return loadTemplate($mode . '_list_rallye', true, $content);
 }
 
+// Sends out a notification about the rallye
+function sendRallyeNotification ($userid, $content) {
+       // Translate more data
+       $content['start_time'] = generateDateTime($content['start_time'], 2);
+       $content['end_time']   = generateDateTime($content['end_time']  , 2);
+       $content['now_time']   = generateDateTime(time(), 2);
+       $content['ref']        = '0';
+       $content['refs']       = getUsersTotalReferrals($userid);
+
+       // Send notification to member
+       $message = loadEmailTemplate('member_rallye_notify', $content, $userid);
+       sendEmail($userid, '{%message,MEMBER_RALLYE_NOTIFY_SUBJECT=' . $content['title'] . '%}', $message);
+}
+
 // Run this function only when a new member has confirmed his email address!
 function addUserToReferralRallye ($userid, $content = array()) {
        $add = '';
@@ -356,7 +383,12 @@ function addUserToReferralRallye ($userid, $content = array()) {
 
        // Check for an auto-add rallye
        $result = SQL_QUERY("SELECT
-       `id`,`title`,`start_time`,`end_time`,`send_notify`".$add."
+       `id`,
+       `title`,
+       `start_time`,
+       `end_time`,
+       `send_notify`
+       ".$add."
 FROM
        `{?_MYSQL_PREFIX?}_rallye_data`
 WHERE
@@ -367,38 +399,19 @@ WHERE
 LIMIT 1", __FUNCTION__, __LINE__);
        if (SQL_NUMROWS($result) == 1) {
                // Init variables
-               $min_users = '0'; $min_prices = '0';
+               $min_users = '0';
+               $min_prices = '0';
 
-               // Load data
-               if (isExtensionInstalledAndNewer('rallye', '0.2.0')) {
-                       list($id, $title, $start, $end, $notify, $min_users, $min_prices) = SQL_FETCHROW($result);
-               } else {
-                       list($id, $title, $start, $end, $notify) = SQL_FETCHROW($result);
-               }
+               // Load and merge data
+               $content = merge_array($content, SQL_FETCHARRAY($result));
 
                // Free result
                SQL_FREERESULT($result);
 
-               if ($notify == 'Y') {
+               // Notify the user?
+               if ($content['send_notify'] == 'Y') {
                        // Transfer all neccessary data to $content array
-                       $content['start'] = generateDateTime($start, 2);
-                       $content['end']   = generateDateTime($end  , 2);
-                       $content['now_t'] = generateDateTime(time(), 2);
-                       $content['title'] = $title;
-                       $content['id']    = $id;  // id for the rallye details link
-                       $content['ref']   = '0';
-                       $content['refs']  = countSumTotalData($userid, 'user_data', 'userid', 'refid', true);
-
-                       // Load prices
-                       $content['prices'] = addReferralRallyePrices($id);
-
-                       // Determine min_users/prices tring
-                       $content['min_users']  = determineReferralRallyeMinimumUsers($min_users);
-                       $content['min_prices'] = determineReferralRallyeMinimumPrices($min_prices);
-
-                       // Send notification to member
-                       $message = loadEmailTemplate('member_rallye_notify', $content, $userid);
-                       sendEmail($userid, '{%message,RALLYE_MEMBER_NOTIFY=' . $title . '%}', $message);
+                       sendRallyeNotification($userid, $content);
                } // END - if
 
                // Check if line is already included...
@@ -411,7 +424,7 @@ WHERE
        `userid`=%s
 LIMIT 1",
                        array(
-                               bigintval($id),
+                               bigintval($content['id']),
                                bigintval($userid)
                        ), __FUNCTION__, __LINE__);
 
@@ -420,11 +433,17 @@ LIMIT 1",
                        // Add userid and his ref count to table
                        SQL_QUERY_ESC("INSERT INTO
        `{?_MYSQL_PREFIX?}_rallye_users`
-(`rallye_id`,`userid`,`refs`)
-       VALUES
-(%s,%s,0)",
+(
+       `rallye_id`,
+       `userid`,
+       `refs`
+) VALUES (
+       %s,
+       %s,
+       0
+)",
                                array(
-                                       bigintval($id),
+                                       bigintval($content['id']),
                                        bigintval($userid)
                                ), __FUNCTION__, __LINE__);
                } // END - if
@@ -434,33 +453,60 @@ LIMIT 1",
        } // END - if
 }
 
-//
-function markReferralRallyesAsExpired ($result) {
+// "Getter" for total rallye winners
+function getTotalRallyeWinners ($rallyeId) {
+       // Is cache set?
+       if (!isset($GLOBALS[__FUNCTION__][$rallyeId])) {
+               // Default total is zero
+               $GLOBALS[__FUNCTION__][$rallyeId] = '0';
+
+               // Get prices
+               $prices = getArrayFromReferralRallyeUsers($rallyeId);
+
+               // "Walk" through all entries
+               foreach ($prices['userid'] as $key => $userid) {
+                       // Check for userid
+                       $active = countSumTotalData($userid, 'user_data', 'userid', 'userid', true, runFilterChain('user_exclusion_sql', " AND `status`='CONFIRMED'"));
+
+                       // Allow valid and active users with at least one ref
+                       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'rallyeId=' . $rallyeId . ',userid=' . $userid . ',ref=' . $prices['ref'][$key] . ',cpoints=' . $prices['cpoints'][$key]);
+                       if ((isValidUserId($userid)) && ($prices['ref'][$key] > 0) && ($active == 1) && ($prices['cpoints'][$key] > 0)) {
+                               $GLOBALS[__FUNCTION__][$rallyeId]++;
+                       } // END - if
+               } // END - foreach
+       } // END - if
+
+       // Return it
+       return $GLOBALS[__FUNCTION__][$rallyeId];
+}
+
+// Stops the given rallye result (from SQL layer) by marking it as expirced
+function stopRallyeByResult ($result) {
        // Load rallye data
-       list($id, $title, $start, $end, $notify, $min_users, $min_prices) = SQL_FETCHROW($result);
+       $content = SQL_FETCHARRAY($result);
 
        // Free result
        SQL_FREERESULT($result);
 
        // Init array
-       $content = array();
        $count = '0';
        $users = array();
-       $content['title']  = $title;
-       $content['start']  = generateDateTime($start, 1);
-       $content['end']    = generateDateTime($end  , 1);
-       $content['now_t']  = generateDateTime(time(), 1);
+       $content['start_time'] = generateDateTime($content['start_time'], 1);
+       $content['end_time']   = generateDateTime($content['end_time']  , 1);
+       $content['now_time']   = generateDateTime(time(), 1);
 
        // Load users array (!) with assigned prices
-       $prices = getArrayFromReferralRallyeUsers($id);
+       $prices = getArrayFromReferralRallyeUsers($content['id']);
 
        // Just count...
        $total = '0';
        foreach ($prices['userid'] as $key => $userid) {
-               // Check status
-               //   active = 1: account is still confirmed
-               //   active = 0: account is deleted or locked
-               $active = countSumTotalData($userid, 'user_data', 'userid', 'userid', true, " AND `status`='CONFIRMED'");
+               /*
+                * Check status
+                *   active = 1: account is still confirmed
+                *   active = 0: account is deleted or locked
+                */
+               $active = countSumTotalData($userid, 'user_data', 'userid', 'userid', true, runFilterChain('user_exclusion_sql', " AND `status`='CONFIRMED'"));
 
                $prices['active'][$key] = $active;
 
@@ -470,15 +516,15 @@ function markReferralRallyesAsExpired ($result) {
                } // END - if
        } // END - foreach
 
-       if (($total < $min_prices) || ($total == '0')) {
+       // Check on 'min_prices' condition
+       if (($total < $content['min_prices']) || (getTotalConfirmedUser() < $content['min_users'])) {
                // Do not end this rallye!
-               unset($content);
                return;
        } // END - if
 
        // Expire rallye
        SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_rallye_data` SET `expired`='Y' WHERE `id`=%s LIMIT 1",
-               array(bigintval($id)), __FUNCTION__, __LINE__);
+               array(bigintval($content['id'])), __FUNCTION__, __LINE__);
 
        // Run array through (by userid is the most important 2nd-level-array)
        foreach ($prices['userid'] as $key => $userid) {
@@ -511,7 +557,7 @@ function markReferralRallyesAsExpired ($result) {
                                addPointsThroughReferralSystem('rallye_winner:' . $winnerLevel, $userid, $content['points']);
                        } // END - if
 
-                       if ($notify == 'Y') {
+                       if ($content['send_notify'] == 'Y') {
                                // Prepare infos for the mail template
                                if (!empty($content['info'])) {
                                        // Take direct infos
@@ -537,7 +583,7 @@ function markReferralRallyesAsExpired ($result) {
        } // END - foreach
 
        // Select template depending on notfication is switch on / off
-       if ($notify == 'Y') {
+       if ($content['send_notify'] == 'Y') {
                $templ = 'admin_rallye_expired';
        } elseif (is_array($users['userid'])) {
                $templ = 'admin_rallye_expired_no';
@@ -548,10 +594,10 @@ function markReferralRallyesAsExpired ($result) {
        $content['count'] = $count;
 
        // Send mail to admin
-       sendAdminNotification('{%message,RALLYE_ADMIN_EXPIRED_SUBJECT=' . $title . '%}', $templ, $content);
+       sendAdminNotification('{%message,ADMIN_RALLYE_EXPIRED_SUBJECT=' . $content['title'] . '%}', $templ, $content);
 
        // Add task (we ignore the task id here)
-       createNewTask('{--RALLYE_ADMIN_EXPIRED--}: ' . $title, '{--RALLYE_ADMIN_EXPIRED_TEXT--}', 'RALLYE_EXPIRED');
+       createNewTask('{--ADMIN_RALLYE_EXPIRED_TASK--}: ' . $content['title'], '{--ADMIN_RALLYE_EXPIRED_TEXT--}', 'RALLYE_EXPIRED');
 }
 
 //
@@ -570,6 +616,7 @@ FROM
 WHERE
        `userid` IN(%s) AND
        `status`='CONFIRMED'
+       " . runFilterChain('user_exclusion_sql', ' ' ) . "
 ORDER BY
        `userid` ASC
 LIMIT %s",
@@ -615,8 +662,8 @@ ORDER BY
        // Transfer elements
        while ($content = SQL_FETCHARRAY($result)) {
                $prices['level'][]  = $content['price_level'];
-               $prices['points'][] = $content['points'];
-               $prices['info'][]   = $content['info'];
+               array_push($prices['points'], $content['points']);
+               array_push($prices['info'], $content['info']);
        } // END - while
 
        // Free memory
@@ -629,7 +676,9 @@ ORDER BY
 //
 function getArrayFromReferralRallyeUsers ($rallye) {
        // Fix zero points to 0.00000
-       if (getConfig('ref_payout') == '0') setConfigEntry('ref_payout', '0.00000');
+       if (getRefPayout() == '0') {
+               setConfigEntry('ref_payout', '0.00000');
+       } // END - if
 
        // Init multi array
        $users = array(
@@ -638,8 +687,22 @@ function getArrayFromReferralRallyeUsers ($rallye) {
                'cpoints' => array(),
        );
 
-       // Load users                          userid    old   points earned
-       $result_user = SQL_QUERY_ESC("SELECT `userid`,`refs`,`curr_points` FROM `{?_MYSQL_PREFIX?}_rallye_users` WHERE `rallye_id`=%s ORDER BY `userid` ASC",
+       /*
+        * Load users:
+        *  - userid      = User's id number
+        *  - refs        = Old amount of referrals (before the rallye has started)
+        *  - curr_points = Current amount of total points
+        */
+       $result_user = SQL_QUERY_ESC("SELECT
+       `userid`,
+       `refs`,
+       `curr_points`
+FROM
+       `{?_MYSQL_PREFIX?}_rallye_users`
+WHERE
+       `rallye_id`=%s
+ORDER BY
+       `userid` ASC",
                array(bigintval($rallye)), __FUNCTION__, __LINE__);
        while ($content = SQL_FETCHARRAY($result_user)) {
                // Load current ref count
@@ -647,20 +710,21 @@ function getArrayFromReferralRallyeUsers ($rallye) {
 
                // Points of ref's
                $result_ref = SQL_QUERY_ESC("SELECT
-       SUM(p.points) AS `points`
+       SUM(p.`points`) AS `points`
 FROM
        `{?_MYSQL_PREFIX?}_user_points` AS p
 LEFT JOIN
        `{?_MYSQL_PREFIX?}_user_data` AS d
 ON
-       p.userid=d.userid
+       p.`userid`=d.`userid`
 WHERE
-       d.`status`='CONFIRMED' AND
-       d.max_mails > 0 AND
-       d.mails_confirmed >= {?ref_payout?} AND
-       p.ref_depth=1 AND
-       p.points > 0 AND
-       d.userid=%s
+       d.`status`='CONFIRMED'
+       " . runFilterChain('user_exclusion_sql', ' ' ) . " AND
+       d.`max_mails` > 0 AND
+       d.`mails_confirmed` >= {?ref_payout?} AND
+       p.`ref_depth`=1 AND
+       p.`points` > 0 AND
+       d.`userid`=%s
 LIMIT 1",
                        array(bigintval($content['userid'])), __FUNCTION__, __LINE__);
 
@@ -674,16 +738,16 @@ LIMIT 1",
                if (empty($refpoints)) $refpoints = '0';
 
                // Store calculated new refs to array
-               $users['userid'][]  = $content['userid'];
-               $users['ref'][]     = abs($count - $content['refs']);
-               $users['cpoints'][] = $refpoints - $content['curr_points'];
+               array_push($users['userid'], $content['userid']);
+               array_push($users['ref'], abs($count - $content['refs']));
+               array_push($users['cpoints'], $refpoints - $content['curr_points']);
        } // END - while
 
        // Free memory
        SQL_FREERESULT($result_user);
 
        // Sort array for refs (descending)
-       array_pk_sort($users, array('ref', 'cpoints'), 0, 1, true);
+       array_pk_sort($users, array('cpoints', 'ref'), 0, 1, true);
 
        // Load prices array (!)
        $prices = getArrayFromReferralRallyePrices($rallye);
@@ -705,23 +769,25 @@ LIMIT 1",
 // @TODO This function does not load min_users, min_prices, please encapsulate loading rallye data with e.g. getRallyeDataFromId()
 function addReferralRallyeWinners ($mode, $rallye, $default=0) {
        // First check how many prices are set
-       $prices = countSumTotalData(bigintval($rallye), 'rallye_prices', 'id', 'rallye_id', true);
+       $prices = getTotalRallyePrices($rallye);
 
        // Load data
        $content = getArrayFromReferralRallyeUsers($rallye);
 
        // Generate table
        $OUT = '';
-       for ($idx = '0'; $idx < $prices; $idx++) {
-               // Check status
-               //   active = 1: account is still confirmed
-               //   active = 0: account is deleted or locked
-               $active = countSumTotalData($content['userid'][$idx], 'user_data', 'userid', 'userid', true, " AND `status`='CONFIRMED'");
+       for ($idx = 0; $idx < $prices; $idx++) {
+               /*
+                * Check status
+                *   active = 1: account is still confirmed
+                *   active = 0: account is deleted or locked
+                */
+               $active = countSumTotalData($content['userid'][$idx], 'user_data', 'userid', 'userid', true, runFilterChain('user_exclusion_sql', " AND `status`='CONFIRMED'"));
 
                if ((empty($content['ref'][$idx])) || ($content['ref'][$idx] == '0') || ($active == '0') || ('' . round($content['cpoints'][$idx]) . '' == '0') || (empty($content['cpoints'][$idx]))) {
                        // Allow valid and active users with at least one ref to get points
-                       $content['ref'][$idx]   = '---';
-                       $content['userid'][$idx]   = '---';
+                       $content['ref'][$idx]    = '---';
+                       $content['userid'][$idx] = '---';
                } // END - if
 
                if (!empty($content['info'][$idx])) {
@@ -769,7 +835,10 @@ function purgeExpiredReferralRallyes () {
        // Check for expired rallyes
        $EXPIRE = 3; // @TODO The hard-coded value...
        $result_rallye = SQL_QUERY_ESC("SELECT
-       `id`,`title`,`start_time`,`end_time`
+       `id`,
+       `title`,
+       `start_time`,
+       `end_time`
 FROM
        `{?_MYSQL_PREFIX?}_rallye_data`
 WHERE
@@ -789,7 +858,7 @@ WHERE
                        $content['now_time']   = generateDateTime(time(), 1);
 
                        // Send mail to admin
-                       sendAdminNotification('{%message,RALLYE_ADMIN_PURGED_SUBJECT=' . $content['title'] . '%}', 'admin_rallye_purged', $content);
+                       sendAdminNotification('{%message,ADMIN_RALLYE_PURGED_SUBJECT=' . $content['title'] . '%}', 'admin_rallye_purged', $content);
 
                        // Purge whole rallye
                        addSql(SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_rallye_data` WHERE `id`=%s LIMIT 1",
@@ -800,7 +869,7 @@ WHERE
                                array(bigintval($content['id'])), __FUNCTION__, __LINE__, false));
 
                        // Add task (we ignore the task id here
-                       createNewTask('{--RALLYE_ADMIN_PURGED--}: ' . $content['title'], '{--RALLYE_ADMIN_PURGED_TEXT--}', 'RALLYE_PURGED');
+                       createNewTask('{--ADMIN_RALLYE_PURGED_TASK--}: ' . $content['title'], '{--ADMIN_RALLYE_PURGED_TEXT--}', 'RALLYE_PURGED');
                } // END - while
 
                // Run all SQLs
@@ -842,11 +911,11 @@ function addReferralRallyeTemplateSelection ($name = 'template', $default = '')
        if (!empty($ral[0])) {
                // Generate selection box for all found templates
                $OUT  = '<select class="form_select" name="' . $name . '" size="1">';
-               $OUT .= generateOptionList('/ARRAY/', array_keys($ral), array_values($ral), $default, '', 'none');
+               $OUT .= generateOptions('/ARRAY/', array_keys($ral), array_values($ral), $default, '', 'none');
                $OUT .= '</select>';
        } else {
                // No rallye templates found
-               $OUT = '{--RALLYE_NO_TEMPLATES_FOUND--}';
+               $OUT = '{--ADMIN_RALLYE_TEMPLATES_404--}';
        }
 
        // Return selection
@@ -882,7 +951,7 @@ function getReferralRallyeRefsCount ($currUserid, $oldReferralCount = '0') {
                } // END - foreach
 
                //* DEBUG: */ debugOutput('<pre>'.print_r($GLOBALS['cache_array']['refsystem'], true).'</pre>');
-               //* DEBUG: */ shutdown();
+               //* DEBUG: */ doShutdown();
 
                if ($count > 0) {
                        // Count cache hits
@@ -954,5 +1023,17 @@ function determineReferralRallyeMinimumPrices ($min_prices) {
        return $return;
 }
 
+// "Getter" for total rallye prices by given id
+function getTotalRallyePrices ($rallyeId) {
+       // Do we have cache?
+       if (!isset($GLOBALS[__FUNCTION__][$rallyeId])) {
+               // Determine it
+               $GLOBALS[__FUNCTION__][$rallyeId] = countSumTotalData($rallyeId, 'rallye_prices', 'id', 'rallye_id', true);
+       } // END - if
+
+       // Return it
+       return $GLOBALS[__FUNCTION__][$rallyeId];
+}
+
 // [EOF]
 ?>