mailer project continued:
[mailer.git] / inc / functions.php
index be6123f558b14507046bc426522461c4c9d3215f..ea660839fa17e6f6242453f88e76ec385482b21f 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 *
@@ -61,7 +61,7 @@ function addFatalMessage ($F, $L, $message, $extra = '') {
        }
 
        // Add message to $GLOBALS['fatal_messages']
-       $GLOBALS['fatal_messages'][] = $message;
+       array_push($GLOBALS['fatal_messages'], $message);
 
        // Log fatal messages away
        logDebugMessage($F, $L, 'Fatal error message: ' . $message);
@@ -82,157 +82,6 @@ function getTotalFatalErrors () {
        return $count;
 }
 
-// Send mail out to an email address
-function sendEmail ($toEmail, $subject, $message, $isHtml = 'N', $mailHeader = '') {
-       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'toEmail=' . $toEmail . ',subject=' . $subject . ',isHtml=' . $isHtml);
-       // Empty parameters should be avoided, so we need to find them
-       if (empty($isHtml)) {
-               // isHtml is empty
-               debug_report_bug(__FUNCTION__, __LINE__, 'isHtml is empty.');
-       } // END - if
-
-       // Set from header
-       if ((!isInString('@', $toEmail)) && ($toEmail > 0)) {
-               // Does the user exist?
-               if ((isExtensionActive('user')) && (fetchUserData($toEmail))) {
-                       // Get the email
-                       $toEmail = getUserData('email');
-               } else {
-                       // Set webmaster
-                       $toEmail = getWebmaster();
-               }
-       } elseif ($toEmail == '0') {
-               // Is the webmaster!
-               $toEmail = getWebmaster();
-       }
-       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'TO=' . $toEmail);
-
-       // Check for PHPMailer or debug-mode
-       if ((!checkPhpMailerUsage()) || (isDebugModeEnabled())) {
-               // Prefix is '' for text mails
-               $prefix = '';
-
-               // Is HTML?
-               if ($isHtml == 'Y') {
-                       // Set prefix
-                       $prefix = 'html_';
-               } // END - if
-
-               // Not in PHPMailer-Mode
-               if (empty($mailHeader)) {
-                       // Load email header template
-                       $mailHeader = loadEmailTemplate($prefix . 'header');
-               } else {
-                       // Append header
-                       $mailHeader .= loadEmailTemplate($prefix . 'header');
-               }
-       } // END - if
-
-       // Debug mode enabled?
-       if (isDebugModeEnabled()) {
-               // In debug mode we want to display the mail instead of sending it away so we can debug this part
-               outputHtml('<pre>
-Headers : ' . htmlentities(utf8_decode(trim($mailHeader))) . '
-To      : ' . htmlentities(utf8_decode($toEmail)) . '
-Subject : ' . htmlentities(utf8_decode($subject)) . '
-Message : ' . htmlentities(utf8_decode($message)) . '
-</pre>');
-
-               // This is always fine
-               return true;
-       } elseif (!empty($toEmail)) {
-               // Send Mail away
-               return sendRawEmail($toEmail, $subject, $message, $mailHeader);
-       } elseif ($isHtml != 'Y') {
-               // Problem detected while sending a mail, forward it to admin
-               return sendRawEmail(getWebmaster(), '[PROBLEM:]' . $subject, $message, $mailHeader);
-       }
-
-       // Why did we end up here? This should not happen
-       debug_report_bug(__FUNCTION__, __LINE__, 'Ending up: template=' . $template);
-}
-
-// Check to use wether legacy mail() command or PHPMailer class
-// @TODO Rewrite this to an extension 'smtp'
-// @private
-function checkPhpMailerUsage() {
-       return ((getConfig('SMTP_HOSTNAME') != '') && (getConfig('SMTP_USER') != ''));
-}
-
-// Send out a raw email with PHPMailer class or legacy mail() command
-function sendRawEmail ($toEmail, $subject, $message, $headers) {
-       // Just compile all to put out all configs, etc.
-       $eval  = '$toEmail = decodeEntities("' . escapeQuotes(doFinalCompilation(compileRawCode($toEmail), false)) . '"); ';
-       $eval .= '$subject = decodeEntities("' . escapeQuotes(doFinalCompilation(compileRawCode($subject), false)) . '"); ';
-       $eval .= '$headers = decodeEntities("' . escapeQuotes(doFinalCompilation(compileRawCode($headers), false)) . '"); ';
-
-       // Do not decode entities in the message because we also send HTML mails through this function
-       $eval .= '$message = "' . escapeQuotes(doFinalCompilation(compileRawCode($message), false)) . '";';
-
-       // Run the final eval() command
-       eval($eval);
-
-       // Shall we use PHPMailer class or legacy mode?
-       if (checkPhpMailerUsage()) {
-               // Use PHPMailer class with SMTP enabled
-               loadIncludeOnce('inc/phpmailer/class.phpmailer.php');
-               loadIncludeOnce('inc/phpmailer/class.smtp.php');
-
-               // get new instance
-               $mail = new PHPMailer();
-
-               // Set charset to UTF-8
-               $mail->CharSet = 'UTF-8';
-
-               // Path for PHPMailer
-               $mail->PluginDir  = sprintf("%sinc/phpmailer/", getPath());
-
-               $mail->IsSMTP();
-               $mail->SMTPAuth   = true;
-               $mail->Host       = getConfig('SMTP_HOSTNAME');
-               $mail->Port       = 25;
-               $mail->Username   = getConfig('SMTP_USER');
-               $mail->Password   = getConfig('SMTP_PASSWORD');
-               if (empty($headers)) {
-                       $mail->From = getWebmaster();
-               } else {
-                       $mail->From = $headers;
-               }
-               $mail->FromName   = getMainTitle();
-               $mail->Subject    = $subject;
-               if ((isExtensionActive('html_mail')) && (secureString($message) != $message)) {
-                       $mail->Body       = $message;
-                       $mail->AltBody    = decodeEntities($message);
-                       $mail->WordWrap   = 70;
-                       $mail->IsHTML(true);
-               } else {
-                       $mail->Body       = decodeEntities(strip_tags($message));
-               }
-
-               $mail->AddAddress($toEmail, '');
-               $mail->AddReplyTo(getWebmaster(), getMainTitle());
-               $mail->AddCustomHeader('Errors-To: ' . getWebmaster());
-               $mail->AddCustomHeader('X-Loop: ' . getWebmaster());
-               $mail->AddCustomHeader('Bounces-To: ' . getWebmaster());
-               $mail->Send();
-
-               // Has an error occured?
-               if (!empty($mail->ErrorInfo)) {
-                       // Log message
-                       logDebugMessage(__FUNCTION__, __LINE__, 'Error while sending mail: ' . $mail->ErrorInfo);
-
-                       // Raise an error
-                       return false;
-               } else {
-                       // All fine!
-                       return true;
-               }
-       } else {
-               // Use legacy mail() command
-               return mail($toEmail, $subject, decodeEntities($message), $headers);
-       }
-}
-
 // Generate a password in a specified length or use default password length
 function generatePassword ($length = '0', $exclude =  array()) {
        // Auto-fix invalid length of zero
@@ -265,6 +114,12 @@ function generatePassword ($length = '0', $exclude =  array()) {
 
 // Generates a human-readable timestamp from the Uni* stamp
 function generateDateTime ($time, $mode = '0') {
+       // Is there cache?
+       if (isset($GLOBALS[__FUNCTION__][$time][$mode])) {
+               // Return it instead
+               return $GLOBALS[__FUNCTION__][$time][$mode];
+       } // END - if
+
        // If the stamp is zero it mostly didn't "happen"
        if (($time == '0') || (is_null($time))) {
                // Never happend
@@ -272,26 +127,20 @@ function generateDateTime ($time, $mode = '0') {
        } // END - if
 
        // Filter out numbers
-       $time = bigintval($time);
-
-       // Is it cached?
-       if (isset($GLOBALS[__FUNCTION__][$time][$mode])) {
-               // Then use it
-               return $GLOBALS[__FUNCTION__][$time][$mode];
-       } // END - if
+       $timeSecured = bigintval($time);
 
        // Detect language
        switch (getLanguage()) {
                case 'de': // German date / time format
                        switch ($mode) {
-                               case '0': $ret = date("d.m.Y \u\m H:i \U\h\\r", $time); break;
-                               case '1': $ret = strtolower(date('d.m.Y - H:i', $time)); break;
-                               case '2': $ret = date('d.m.Y|H:i', $time); break;
-                               case '3': $ret = date('d.m.Y', $time); break;
-                               case '4': $ret = date('d.m.Y|H:i:s', $time); break;
-                               case '5': $ret = date('d-m-Y (l-F-T)', $time); break;
-                               case '6': $ret = date('Ymd', $time); break;
-                               case '7': $ret = date('Y-m-d H:i:s', $time); break; // Compatible with MySQL TIMESTAMP
+                               case '0': $ret = date("d.m.Y \u\m H:i \U\h\\r", $timeSecured); break;
+                               case '1': $ret = strtolower(date('d.m.Y - H:i', $timeSecured)); break;
+                               case '2': $ret = date('d.m.Y|H:i', $timeSecured); break;
+                               case '3': $ret = date('d.m.Y', $timeSecured); break;
+                               case '4': $ret = date('d.m.Y|H:i:s', $timeSecured); break;
+                               case '5': $ret = date('d-m-Y (l-F-T)', $timeSecured); break;
+                               case '6': $ret = date('Ymd', $timeSecured); break;
+                               case '7': $ret = date('Y-m-d H:i:s', $timeSecured); break; // Compatible with MySQL TIMESTAMP
                                default:
                                        logDebugMessage(__FUNCTION__, __LINE__, sprintf("Invalid date mode %s detected.", $mode));
                                        break;
@@ -300,14 +149,14 @@ function generateDateTime ($time, $mode = '0') {
 
                default: // Default is the US date / time format!
                        switch ($mode) {
-                               case '0': $ret = date('r', $time); break;
-                               case '1': $ret = strtolower(date('Y-m-d - g:i A', $time)); break;
-                               case '2': $ret = date('y-m-d|H:i', $time); break;
-                               case '3': $ret = date('y-m-d', $time); break;
-                               case '4': $ret = date('d.m.Y|H:i:s', $time); break;
-                               case '5': $ret = date('d-m-Y (l-F-T)', $time); break;
-                               case '6': $ret = date('Ymd', $time); break;
-                               case '7': $ret = date('Y-m-d H:i:s', $time); break; // Compatible with MySQL TIMESTAMP
+                               case '0': $ret = date('r', $timeSecured); break;
+                               case '1': $ret = strtolower(date('Y-m-d - g:i A', $timeSecured)); break;
+                               case '2': $ret = date('y-m-d|H:i', $timeSecured); break;
+                               case '3': $ret = date('y-m-d', $timeSecured); break;
+                               case '4': $ret = date('d.m.Y|H:i:s', $timeSecured); break;
+                               case '5': $ret = date('d-m-Y (l-F-T)', $timeSecured); break;
+                               case '6': $ret = date('Ymd', $timeSecured); break;
+                               case '7': $ret = date('Y-m-d H:i:s', $timeSecured); break; // Compatible with MySQL TIMESTAMP
                                default:
                                        logDebugMessage(__FUNCTION__, __LINE__, sprintf("Invalid date mode %s detected.", $mode));
                                        break;
@@ -332,7 +181,7 @@ function translateYesNo ($yn) {
                        case 'N': $GLOBALS[__FUNCTION__][$yn] = '{--NO--}'; break;
                        default:
                                // Log unknown value
-                               logDebugMessage(__FUNCTION__, __LINE__, sprintf("Unknown value %s. Expected Y/N!", $yn));
+                               logDebugMessage(__FUNCTION__, __LINE__, sprintf("Unknown value %s. Expected: Y/N", $yn));
                                break;
                } // END - switch
        } // END - if
@@ -342,6 +191,7 @@ function translateYesNo ($yn) {
 }
 
 // Translates the american decimal dot into a german comma
+// OPPOMENT: convertCommaToDot()
 function translateComma ($dotted, $cut = true, $max = '0') {
        // First, cast all to double, due to PHP changes
        $dotted = (double) $dotted;
@@ -398,12 +248,13 @@ function translateGender ($gender) {
                case 'M': // Male
                case 'F': // Female
                case 'C': // Company
-                       $ret = sprintf("{--GENDER_%s--}", $gender);
+                       // Use generic function
+                       $ret = translateGeneric('GENDER', $gender);
                        break;
 
                default:
                        // Please report bugs on unknown genders
-                       debug_report_bug(__FUNCTION__, __LINE__, sprintf("Unknown gender %s detected.", $gender));
+                       reportBug(__FUNCTION__, __LINE__, sprintf("Unknown gender %s detected.", $gender));
                        break;
        } // END - switch
 
@@ -421,17 +272,17 @@ function translateUserStatus ($status) {
                case 'UNCONFIRMED':
                case 'CONFIRMED':
                case 'LOCKED':
-                       $ret = sprintf("{--ACCOUNT_STATUS_%s--}", $status);
+                       // Use generic function for all "normal" cases"
+                       $ret = translateGeneric('ACCOUNT_STATUS', $status);
                        break;
 
-               case '':
-               case null:
+               case '': // Account deleted
+               case NULL: // Account deleted
                        $ret = '{--ACCOUNT_STATUS_DELETED--}';
                        break;
 
-               default:
-                       // Please report all unknown status
-                       debug_report_bug(__FUNCTION__, __LINE__, sprintf("Unknown status %s(%s) detected.", $status, gettype($status)));
+               default: // Please report all unknown status
+                       reportBug(__FUNCTION__, __LINE__, sprintf("Unknown status %s(%s) detected.", $status, gettype($status)));
                        break;
        } // END - switch
 
@@ -446,23 +297,31 @@ function translateMenuVisibleLocked ($content, $prefix = '') {
 
        // Translate 'visible' and keep an eye on the prefix
        switch ($content['visible']) {
-               // Should be visible
-               case 'Y': $content['visible_css'] = $prefix . 'menu_visible'  ; break;
-               case 'N': $content['visible_css'] = $prefix . 'menu_invisible'; break;
-               default:
-                       // Please report this
-                       debug_report_bug(__FUNCTION__, __LINE__, 'Unsupported visible value detected. content=<pre>' . print_r($content, true) . '</pre>');
+               case 'Y': // Should be visible
+                       $content['visible_css'] = $prefix . 'menu_visible';
+                       break;
+
+               case 'N': // Is invisible
+                       $content['visible_css'] = $prefix . 'menu_invisible';
+                       break;
+
+               default: // Please report this
+                       reportBug(__FUNCTION__, __LINE__, 'Unsupported visible value detected. content=<pre>' . print_r($content, true) . '</pre>');
                        break;
        } // END - switch
 
        // Translate 'locked' and keep an eye on the prefix
        switch ($content['locked']) {
-               // Should be locked
-               case 'Y': $content['locked_css'] = $prefix . 'menu_locked'  ; break;
-               case 'N': $content['locked_css'] = $prefix . 'menu_unlocked'; break;
-               default:
-                       // Please report this
-                       debug_report_bug(__FUNCTION__, __LINE__, 'Unsupported locked value detected. content=<pre>' . print_r($content, true) . '</pre>');
+               case 'Y': // Should be locked, only admins can call this
+                       $content['locked_css'] = $prefix . 'menu_locked';
+                       break;
+
+               case 'N': // Is unlocked and visible to members/guests/sponsors
+                       $content['locked_css'] = $prefix . 'menu_unlocked';
+                       break;
+
+               default: // Please report this
+                       reportBug(__FUNCTION__, __LINE__, 'Unsupported locked value detected. content=<pre>' . print_r($content, true) . '</pre>');
                        break;
        } // END - switch
 
@@ -498,7 +357,7 @@ function countSelection ($array) {
        // Integrity check
        if (!is_array($array)) {
                // Not an array!
-               debug_report_bug(__FUNCTION__, __LINE__, 'No array provided.');
+               reportBug(__FUNCTION__, __LINE__, 'No array provided.');
        } // END - if
 
        // Init count
@@ -507,7 +366,10 @@ function countSelection ($array) {
        // Count all entries
        foreach ($array as $key => $selected) {
                // Is it checked?
-               if (!empty($selected)) $ret++;
+               if (!empty($selected)) {
+                       // Yes, then count it
+                       $ret++;
+               } // END - if
        } // END - foreach
 
        // Return counted selections
@@ -535,7 +397,7 @@ function makeTime ($hours, $minutes, $seconds, $stamp) {
 // Redirects to an URL and if neccessarry extends it with own base URL
 function redirectToUrl ($url, $allowSpider = true) {
        // Is the output mode -2?
-       if (getScriptOutputMode() == -2) {
+       if (isAjaxOutputMode()) {
                // This is always (!) an AJAX request and shall not be redirected
                return;
        } // END - if
@@ -558,7 +420,7 @@ function redirectToUrl ($url, $allowSpider = true) {
        } // END - if
 
        // Three different ways to debug...
-       //* DEBUG: */ debug_report_bug(__FUNCTION__, __LINE__, 'URL=' . $url);
+       //* DEBUG: */ reportBug(__FUNCTION__, __LINE__, 'URL=' . $url);
        //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'URL=' . $url);
        //* DEBUG: */ die($url);
 
@@ -574,7 +436,7 @@ function redirectToUrl ($url, $allowSpider = true) {
        }
 
        // Shut the mailer down here
-       shutdown();
+       doShutdown();
 }
 
 /************************************************************************
@@ -584,7 +446,7 @@ function redirectToUrl ($url, $allowSpider = true) {
  *                                                                      *
  * $array - Das 3-dimensionale Array, das paralell sortiert werden soll *
  * $a_sort - Array, das die Sortiereihenfolge der ersten Elementeben    *
- * $primary_key - Prim.rschl.ssel aus $a_sort, nach dem sortiert wird   *
+ * $primary_key - Primaerschl.ssel aus $a_sort, nach dem sortiert wird  *
  * $order - Sortiereihenfolge: -1 = a-Z, 0 = keine, 1 = Z-a             *
  * $nums - true = Als Zahlen sortieren, false = Als Zeichen sortieren   *
  *                                                                      *
@@ -711,7 +573,7 @@ function bigintval ($num, $castValue = true, $abortOnMismatch = true) {
        // Has the whole value changed?
        if (('' . $ret . '' != '' . $num . '') && ($abortOnMismatch === true) && (!is_null($num))) {
                // Log the values
-               debug_report_bug(__FUNCTION__, __LINE__, 'Problem with number found. ret[' . gettype($ret) . ']=' . $ret . ', num[' . gettype($num) . ']='. $num);
+               reportBug(__FUNCTION__, __LINE__, 'Problem with number found. ret[' . gettype($ret) . ']=' . $ret . ', num[' . gettype($num) . ']='. $num);
        } // END - if
 
        // Return result
@@ -787,17 +649,26 @@ function createFancyTime ($stamp) {
 
 // Taken from www.php.net isInStringIgnoreCase() user comments
 function isEmailValid ($email) {
-       // Check first part of email address
-       $first = '[-a-z0-9!#$%&\'*+/=?^_<{|}~]+(\.[-a-zA-Z0-9!#$%&\'*+/=?^_<{|}~]+)*';
+       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'email=' . $email . ' - ENTERED!');
+
+       // Is there cache?
+       if (!isset($GLOBALS[__FUNCTION__][$email])) {
+               // Check first part of email address
+               $first = '[-a-z0-9!#$%&\'*+/=?^_<{|}~]+(\.[-a-zA-Z0-9!#$%&\'*+/=?^_<{|}~]+)*';
 
-       //  Check domain
-       $domain = '[a-z0-9-]+(\.[a-z0-9-]{2,5})+';
+               //  Check domain
+               $domain = '[a-z0-9-]+(\.[a-z0-9-]{2,5})+';
 
-       // Generate pattern
-       $regex = '@^' . $first . '\@' . $domain . '$@iU';
+               // Generate pattern
+               $regex = '@^' . $first . '\@' . $domain . '$@iU';
+
+               // Determine it
+               $GLOBALS[__FUNCTION__][$email] = (($email != getMessage('DEFAULT_WEBMASTER')) && (preg_match($regex, $email)));
+       } // END - if
 
        // Return check result
-       return preg_match($regex, $email);
+       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'email=' . $email . ',isValid=' . intval($GLOBALS[__FUNCTION__][$email]) . ' - EXIT!');
+       return $GLOBALS[__FUNCTION__][$email];;
 }
 
 // Function taken from user comments on www.php.net / function isInStringIgnoreCase()
@@ -818,8 +689,10 @@ function isUrlValid ($url, $compile = true) {
                return FILTER_VALIDATE_URL($url, false);
        } // END - if
 
-       // If not installed, perform a simple test. Just make it sure there is always a http:// or
-       // https:// in front of the URLs
+       /*
+        * If not installed, perform a simple test. Just make it sure there is always a
+        * http:// or https:// in front of the URLs.
+        */
        return isUrlValidSimple($url);
 }
 
@@ -844,7 +717,7 @@ function generateHash ($plainText, $salt = '', $hash = true) {
        // Do we miss an arry element here?
        if (!isConfigEntrySet('file_hash')) {
                // Stop here
-               debug_report_bug(__FUNCTION__, __LINE__, 'Missing file_hash in ' . __FUNCTION__ . '.');
+               reportBug(__FUNCTION__, __LINE__, 'Missing file_hash in ' . __FUNCTION__ . '.');
        } // END - if
 
        // When the salt is empty build a new one, else use the first x configured characters as the salt
@@ -881,7 +754,7 @@ function generateHash ($plainText, $salt = '', $hash = true) {
                // Sanity check on salt
                if (strlen($salt) != getSaltLength()) {
                        // Not the same!
-                       debug_report_bug(__FUNCTION__, __LINE__, 'salt length mismatch! (' . strlen($salt) . '/' . getSaltLength() . ')');
+                       reportBug(__FUNCTION__, __LINE__, 'salt length mismatch! (' . strlen($salt) . '/' . getSaltLength() . ')');
                } // END - if
        }
 
@@ -933,13 +806,17 @@ function scrambleString ($str) {
 // De-scramble a string scrambled by scrambleString()
 function descrambleString ($str) {
        // Scramble only 40 chars long strings
-       if (strlen($str) != 40) return $str;
+       if (strlen($str) != 40) {
+               return $str;
+       } // END - if
 
        // Load numbers from config
        $scrambleNums = explode(':', getPassScramble());
 
        // Validate numbers
-       if (count($scrambleNums) != 40) return $str;
+       if (count($scrambleNums) != 40) {
+               return $str;
+       } // END - if
 
        // Begin descrambling
        $orig = str_repeat(' ', 40);
@@ -1049,15 +926,18 @@ function getCurrentTheme () {
        $ret = 'default';
 
        // Do we have ext-theme installed and active or is 'theme' in URL or POST data?
-       if ((isPostRequestElementSet('theme')) && (isIncludeReadable(sprintf("theme/%s/theme.php", postRequestElement('theme'))))) {
+       if (isExtensionActive('theme')) {
+               // Call inner method
+               $ret = getActualTheme();
+       } elseif ((isPostRequestElementSet('theme')) && (isIncludeReadable(sprintf("theme/%s/theme.php", postRequestElement('theme'))))) {
                // Use value from POST data
                $ret = postRequestElement('theme');
        } elseif ((isGetRequestElementSet('theme')) && (isIncludeReadable(sprintf("theme/%s/theme.php", getRequestElement('theme'))))) {
                // Use value from GET data
                $ret = getRequestElement('theme');
-       } elseif (isExtensionActive('theme')) {
-               // Call inner method
-               $ret = getActualTheme();
+       } elseif ((isMailerThemeSet()) && (isIncludeReadable(sprintf("theme/%s/theme.php", getMailerTheme())))) {
+               // Use value from GET data
+               $ret = getMailerTheme();
        }
 
        // Return theme value
@@ -1137,39 +1017,50 @@ function generateSeed () {
 
 // Converts a message code to a human-readable message
 function getMessageFromErrorCode ($code) {
-       $message = '';
+       // Default is an unknown error code
+       $message = '{%message,UNKNOWN_ERROR_CODE=' . $code . '%}';
+
+       // Which code is provided?
        switch ($code) {
-               case '': break;
-               case getCode('LOGOUT_DONE')        : $message = '{--LOGOUT_DONE--}'; break;
-               case getCode('LOGOUT_FAILED')      : $message = '<span class="bad">{--LOGOUT_FAILED--}</span>'; break;
-               case getCode('DATA_INVALID')       : $message = '{--MAIL_DATA_INVALID--}'; break;
-               case getCode('POSSIBLE_INVALID')   : $message = '{--MAIL_POSSIBLE_INVALID--}'; break;
-               case getCode('USER_404')           : $message = '{--USER_404--}'; break;
-               case getCode('STATS_404')          : $message = '{--MAIL_STATS_404--}'; break;
-               case getCode('ALREADY_CONFIRMED')  : $message = '{--MAIL_ALREADY_CONFIRMED--}'; break;
-               case getCode('WRONG_PASS')         : $message = '{--LOGIN_WRONG_PASS--}'; break;
-               case getCode('WRONG_ID')           : $message = '{--LOGIN_WRONG_ID--}'; break;
-               case getCode('ACCOUNT_LOCKED')     : $message = '{--LOGIN_STATUS_LOCKED--}'; break;
-               case getCode('ACCOUNT_UNCONFIRMED'): $message = '{--LOGIN_STATUS_UNCONFIRMED--}'; break;
-               case getCode('COOKIES_DISABLED')   : $message = '{--LOGIN_COOKIES_DISABLED--}'; break;
-               case getCode('BEG_SAME_AS_OWN')    : $message = '{--BEG_SAME_USERID_AS_OWN--}'; break;
-               case getCode('LOGIN_FAILED')       : $message = '{--GUEST_LOGIN_FAILED_GENERAL--}'; break;
-               case getCode('MODULE_MEMBER_ONLY') : $message = '{%message,MODULE_MEMBER_ONLY=' . getRequestElement('mod') . '%}'; break;
-               case getCode('OVERLENGTH')         : $message = '{--MEMBER_TEXT_OVERLENGTH--}'; break;
-               case getCode('URL_FOUND')          : $message = '{--MEMBER_TEXT_CONTAINS_URL--}'; break;
-               case getCode('SUBJECT_URL')        : $message = '{--MEMBER_SUBJECT_CONTAINS_URL--}'; break;
-               case getCode('BLIST_URL')          : $message = '{--MEMBER_URL_BLACK_LISTED--}<br />{--MEMBER_BLIST_TIME--}: ' . generateDateTime(getRequestElement('blist'), 0); break;
-               case getCode('NO_RECS_LEFT')       : $message = '{--MEMBER_SELECTED_MORE_RECS--}'; break;
-               case getCode('INVALID_TAGS')       : $message = '{--MEMBER_HTML_INVALID_TAGS--}'; break;
-               case getCode('MORE_POINTS')        : $message = '{--MEMBER_MORE_POINTS_NEEDED--}'; break;
-               case getCode('MORE_RECEIVERS1')    : $message = '{--MEMBER_ENTER_MORE_RECEIVERS--}'; break;
-               case getCode('MORE_RECEIVERS2')    : $message = '{--MEMBER_NO_MORE_RECEIVERS_FOUND--}'; break;
-               case getCode('MORE_RECEIVERS3')    : $message = '{--MEMBER_ENTER_MORE_MIN_RECEIVERS--}'; break;
-               case getCode('INVALID_URL')        : $message = '{--MEMBER_ENTER_INVALID_URL--}'; break;
-               case getCode('NO_MAIL_TYPE')       : $message = '{--MEMBER_NO_MAIL_TYPE_SELECTED--}'; break;
-               case getCode('UNKNOWN_ERROR')      : $message = '{--LOGIN_UNKNOWN_ERROR--}'; break;
-               case getCode('UNKNOWN_STATUS')     : $message = '{--LOGIN_UNKNOWN_STATUS--}'; break;
-               case getCode('PROFILE_UPDATED')    : $message = '{--MEMBER_PROFILE_UPDATED--}'; break;
+               case '':
+                       // No error code is bad coding practice
+                       reportBug(__FUNCTION__, __LINE__, 'Empty error code supplied. Please fix your code.');
+                       break;
+
+               // All error messages
+               case getCode('LOGOUT_DONE')         : $message = '{--LOGOUT_DONE--}'; break;
+               case getCode('LOGOUT_FAILED')       : $message = '<span class="bad">{--LOGOUT_FAILED--}</span>'; break;
+               case getCode('DATA_INVALID')        : $message = '{--MAIL_DATA_INVALID--}'; break;
+               case getCode('POSSIBLE_INVALID')    : $message = '{--MAIL_POSSIBLE_INVALID--}'; break;
+               case getCode('USER_404')            : $message = '{--USER_404--}'; break;
+               case getCode('STATS_404')           : $message = '{--MAIL_STATS_404--}'; break;
+               case getCode('ALREADY_CONFIRMED')   : $message = '{--MAIL_ALREADY_CONFIRMED--}'; break;
+               case getCode('BEG_SAME_AS_OWN')     : $message = '{--BEG_SAME_USERID_AS_OWN--}'; break;
+               case getCode('LOGIN_FAILED')        : $message = '{--GUEST_LOGIN_FAILED_GENERAL--}'; break;
+               case getCode('MODULE_MEMBER_ONLY')  : $message = '{%message,MODULE_MEMBER_ONLY=' . getRequestElement('mod') . '%}'; break;
+               case getCode('OVERLENGTH')          : $message = '{--MEMBER_TEXT_OVERLENGTH--}'; break;
+               case getCode('URL_FOUND')           : $message = '{--MEMBER_TEXT_CONTAINS_URL--}'; break;
+               case getCode('SUBJECT_URL')         : $message = '{--MEMBER_SUBJECT_CONTAINS_URL--}'; break;
+               case getCode('BLIST_URL')           : $message = '{--MEMBER_URL_BLACK_LISTED--}<br />{--MEMBER_BLIST_TIME--}: ' . generateDateTime(getRequestElement('blist'), 0); break;
+               case getCode('NO_RECS_LEFT')        : $message = '{--MEMBER_SELECTED_MORE_RECS--}'; break;
+               case getCode('INVALID_TAGS')        : $message = '{--MEMBER_HTML_INVALID_TAGS--}'; break;
+               case getCode('MORE_POINTS')         : $message = '{--MEMBER_MORE_POINTS_NEEDED--}'; break;
+               case getCode('MORE_RECEIVERS1')     : $message = '{--MEMBER_ENTER_MORE_RECEIVERS--}'; break;
+               case getCode('MORE_RECEIVERS2')     : $message = '{--MEMBER_NO_MORE_RECEIVERS_FOUND--}'; break;
+               case getCode('MORE_RECEIVERS3')     : $message = '{--MEMBER_ENTER_MORE_MIN_RECEIVERS--}'; break;
+               case getCode('INVALID_URL')         : $message = '{--MEMBER_ENTER_INVALID_URL--}'; break;
+               case getCode('NO_MAIL_TYPE')        : $message = '{--MEMBER_NO_MAIL_TYPE_SELECTED--}'; break;
+               case getCode('PROFILE_UPDATED')     : $message = '{--MEMBER_PROFILE_UPDATED--}'; break;
+               case getCode('UNKNOWN_REDIRECT')    : $message = '{--UNKNOWN_REDIRECT_VALUE--}'; break;
+               case getCode('WRONG_PASS')          : $message = '{--LOGIN_WRONG_PASS--}'; break;
+               case getCode('WRONG_ID')            : $message = '{--LOGIN_WRONG_ID--}'; break;
+               case getCode('ACCOUNT_LOCKED')      : $message = '{--LOGIN_STATUS_LOCKED--}'; break;
+               case getCode('ACCOUNT_UNCONFIRMED') : $message = '{--LOGIN_STATUS_UNCONFIRMED--}'; break;
+               case getCode('COOKIES_DISABLED')    : $message = '{--LOGIN_COOKIES_DISABLED--}'; break;
+               case getCode('UNKNOWN_ERROR')       : $message = '{--LOGIN_UNKNOWN_ERROR--}'; break;
+               case getCode('UNKNOWN_STATUS')      : $message = '{--LOGIN_UNKNOWN_STATUS--}'; break;
+               case getCode('LOGIN_EMPTY_ID')      : $message = '{--LOGIN_ID_IS_EMPTY--}'; break;
+               case getCode('LOGIN_EMPTY_PASSWORD'): $message = '{--LOGIN_PASSWORD_IS_EMPTY--}'; break;
 
                case getCode('ERROR_MAILID'):
                        if (isExtensionActive('mailid', true)) {
@@ -1215,11 +1106,8 @@ function getMessageFromErrorCode ($code) {
                        break;
 
                default:
-                       // Missing/invalid code
-                       $message = '{%message,UNKNOWN_MAILID_CODE=' . $code . '%}';
-
-                       // Log it
-                       logDebugMessage(__FUNCTION__, __LINE__, $message);
+                       // Log missing/invalid error codes
+                       logDebugMessage(__FUNCTION__, __LINE__, getMessage('UNKNOWN_MAILID_CODE', $code));
                        break;
        } // END - switch
 
@@ -1229,8 +1117,9 @@ function getMessageFromErrorCode ($code) {
 
 // Function taken from user comments on www.php.net / function isInStringIgnoreCase()
 function isUrlValidSimple ($url) {
+       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'url=' . $url . ' - ENTERED!');
        // Prepare URL
-       $url = secureString(str_replace("\\", '', compileRawCode(urldecode($url))));
+       $url = secureString(str_replace(chr(92), '', compileRawCode(urldecode($url))));
 
        // Allows http and https
        $http      = "(http|https)+(:\/\/)";
@@ -1292,6 +1181,7 @@ function isUrlValidSimple ($url) {
        } // END - foreach
 
        // Return true/false
+       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'url=' . $url . ',reg=' . intval($reg) . ' - EXIT!');
        return $reg;
 }
 
@@ -1310,12 +1200,12 @@ function changeDataInFile ($FQFN, $comment, $prefix, $suffix, $inserted, $seek=0
                $tmp = $FQFN . '.tmp';
 
                // Open the source file
-               $fp = fopen($FQFN, 'r') or debug_report_bug(__FUNCTION__, __LINE__, 'Cannot read. file=' . basename($FQFN));
+               $fp = fopen($FQFN, 'r') or reportBug(__FUNCTION__, __LINE__, 'Cannot read. file=' . basename($FQFN));
 
                // Is the resource valid?
                if (is_resource($fp)) {
                        // Open temporary file
-                       $fp_tmp = fopen($tmp, 'w') or debug_report_bug(__FUNCTION__, __LINE__, 'Cannot write. tmp=' . basename($tmp) . ',file=' . $FQFN);
+                       $fp_tmp = fopen($tmp, 'w') or reportBug(__FUNCTION__, __LINE__, 'Cannot write. tmp=' . basename($tmp) . ',file=' . $FQFN);
 
                        // Is the resource again valid?
                        if (is_resource($fp_tmp)) {
@@ -1335,7 +1225,7 @@ function changeDataInFile ($FQFN, $comment, $prefix, $suffix, $inserted, $seek=0
                                        if ($next > -1) {
                                                if ($next === $seek) {
                                                        $next = -1;
-                                                       $line = $prefix . $inserted . $suffix . "\n";
+                                                       $line = $prefix . $inserted . $suffix . chr(10);
                                                } else {
                                                        $next++;
                                                }
@@ -1367,33 +1257,19 @@ function changeDataInFile ($FQFN, $comment, $prefix, $suffix, $inserted, $seek=0
                }
        } else {
                // File not found, not readable or writeable
-               debug_report_bug(__FUNCTION__, __LINE__, 'File not readable/writeable. file=' . basename($FQFN));
+               reportBug(__FUNCTION__, __LINE__, 'File not readable/writeable. file=' . basename($FQFN));
        }
 
        // An error was detected!
        return false;
 }
 
-// Send notification to admin
-function sendAdminNotification ($subject, $templateName, $content = array(), $userid = NULL) {
-       if ((isExtensionInstalledAndNewer('admins', '0.4.1')) && (function_exists('sendAdminsEmails'))) {
-               // Send new way
-               //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'admins=Y,subject=' . $subject . ',templateName=' . $templateName . ' - OKAY!');
-               sendAdminsEmails($subject, $templateName, $content, $userid);
-       } else {
-               // Send out-dated way
-               //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'admins=N,subject=' . $subject . ',templateName=' . $templateName . ' - OUT-DATED!');
-               $message = loadEmailTemplate($templateName, $content, $userid);
-               sendAdminEmails($subject, $message);
-       }
-}
-
 // Debug message logger
 function logDebugMessage ($funcFile, $line, $message, $force=true) {
        // Is debug mode enabled?
        if ((isDebugModeEnabled()) || ($force === true)) {
                // Remove CRLF
-               $message = str_replace("\r", '', str_replace("\n", '', $message));
+               $message = str_replace(array(chr(13), chr(10)), array('', ''), $message);
 
                // Log this message away
                appendLineToFile(getPath() . getCachePath() . 'debug.log', generateDateTime(time(), '4') . '|' . getModule(false) . '|' . basename($funcFile) . '|' . $line . '|' . $message);
@@ -1449,7 +1325,7 @@ function convertSelectionsToEpocheTime (array &$postData, array &$content, &$id,
                if ((isset($postData[$test . '_ye'])) && (isset($postData[$test . '_mo'])) && (isset($postData[$test . '_we'])) && (isset($postData[$test . '_da'])) && (isset($postData[$test . '_ho'])) && (isset($postData[$test . '_mi'])) && (isset($postData[$test . '_se'])) && ($test != $test2)) {
                        // Generate timestamp
                        $postData[$test] = createEpocheTimeFromSelections($test, $postData);
-                       $content[] = sprintf("`%s`='%s'", $test, $postData[$test]);
+                       array_push($content, sprintf("`%s`='%s'", $test, $postData[$test]));
                        $GLOBALS['skip_config'][$test] = true;
 
                        // Remove data from array
@@ -1466,6 +1342,7 @@ function convertSelectionsToEpocheTime (array &$postData, array &$content, &$id,
 }
 
 // Reverts the german decimal comma into Computer decimal dot
+// OPPOMENT: translateComma()
 function convertCommaToDot ($str) {
        // Default float is not a float... ;-)
        $float = false;
@@ -1481,10 +1358,10 @@ function convertCommaToDot ($str) {
                        break;
 
                default: // US and so on
-                       // Remove thousand dots first and cast
+                       // Remove thousand commatas first and cast
                        $float = (float)str_replace(',', '', $str);
                        break;
-       }
+       } // END - switch
 
        // Return float
        return $float;
@@ -1552,6 +1429,9 @@ function rebuildCache ($cache, $inc = '', $force = false) {
 
 // Determines the real remote address
 function determineRealRemoteAddress ($remoteAddr = false) {
+       // Default is 127.0.0.1
+       $address = '127.0.0.1';
+
        // Is a proxy in use?
        if ((isset($_SERVER['HTTP_X_FORWARDED_FOR'])) && (!$remoteAddr)) {
                // Proxy was used
@@ -1559,7 +1439,7 @@ function determineRealRemoteAddress ($remoteAddr = false) {
        } elseif ((isset($_SERVER['HTTP_CLIENT_IP'])) && (!$remoteAddr)) {
                // Yet, another proxy
                $address = $_SERVER['HTTP_CLIENT_IP'];
-       } else {
+       } elseif (isset($_SERVER['REMOTE_ADDR'])) {
                // The regular address when no proxy was used
                $address = $_SERVER['REMOTE_ADDR'];
        }
@@ -1615,6 +1495,12 @@ function addNewBonusMail ($data, $mode = '', $output = true) {
 
 // Determines referral id and sets it
 function determineReferralId () {
+       // Do we have it already detected?
+       if (isReferralIdValid()) {
+               // Do not determine it, just return it
+               return getReferralId();
+       } // END - if
+
        // Skip this in non-html-mode and outside ref.php
        if ((!isHtmlOutputMode()) && (basename($_SERVER['PHP_SELF']) != 'ref.php')) {
                return false;
@@ -1644,7 +1530,7 @@ function determineReferralId () {
                // Set session refid as global
                //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'Using refid from SESSION data (' . getSession('refid') . ')');
                setReferralId(bigintval(getSession('refid')));
-       } elseif (isRandomReferralIdEnabled()) {
+       } elseif ((isExtensionInstalledAndNewer('user', '0.3.4')) && (isRandomReferralIdEnabled())) {
                // Select a random user which has confirmed enougth mails
                //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'Checking random referral id');
                setReferralId(determineRandomReferralId());
@@ -1723,10 +1609,10 @@ function doHourly () {
        runFilterChain('hourly');
 }
 
-// Our shutdown-function
-function shutdown () {
+// Shuts down the mailer (e.g. closing database link, flushing output/filters, etc.)
+function doShutdown () {
        // Call the filter chain 'shutdown'
-       runFilterChain('shutdown', null);
+       runFilterChain('shutdown', NULL);
 
        // Check if not in installation phase and the link is up
        if ((!isInstallationPhase()) && (SQL_IS_LINK_UP())) {
@@ -1734,7 +1620,7 @@ function shutdown () {
                SQL_CLOSE(__FUNCTION__, __LINE__);
        } elseif (!isInstallationPhase()) {
                // No database link
-               debug_report_bug(__FUNCTION__, __LINE__, 'Database link is already down, while shutdown is running.');
+               reportBug(__FUNCTION__, __LINE__, 'Database link is already down, while shutdown is running.');
        }
 
        // Stop executing here
@@ -1750,7 +1636,7 @@ function initMemberId () {
 function setMemberId ($memberid) {
        // We should not set member id to zero
        if ($memberid == '0') {
-               debug_report_bug(__FUNCTION__, __LINE__, 'Userid should not be set zero.');
+               reportBug(__FUNCTION__, __LINE__, 'Userid should not be set zero.');
        } // END - if
 
        // Set it secured
@@ -1787,7 +1673,7 @@ function getExtraTitle () {
        // Is the extra title set?
        if (!isExtraTitleSet()) {
                // No, then abort here
-               debug_report_bug(__FUNCTION__, __LINE__, 'extra_title is not set!');
+               reportBug(__FUNCTION__, __LINE__, 'extra_title is not set!');
        } // END - if
 
        // Return it
@@ -1806,28 +1692,25 @@ function isExtraTitleSet () {
  *
  * @param      $baseDir                        Relative base directory to PATH to scan from
  * @param      $prefix                         Prefix for all positive matches (which files should be found)
- * @param      $fileIncludeDirs        Wether to include directories in the final output array
- * @param      $addBaseDir                     Wether to add $baseDir to all array entries
+ * @param      $fileIncludeDirs        whether to include directories in the final output array
+ * @param      $addBaseDir                     whether to add $baseDir to all array entries
  * @param      $excludeArray           Excluded files and directories, these must be full files names, e.g. 'what-' will exclude all files named 'what-' but won't exclude 'what-foo.php'
  * @param      $extension                      File extension for all positive matches
  * @param      $excludePattern         Regular expression to exclude more files (preg_match())
- * @param      $recursive                      Wether to scan recursively
+ * @param      $recursive                      whether to scan recursively
  * @param      $suffix                         Suffix for positive matches ($extension will be appended, too)
  * @return     $foundMatches           All found positive matches for above criteria
  */
 function getArrayFromDirectory ($baseDir, $prefix, $fileIncludeDirs = false, $addBaseDir = true, $excludeArray = array(), $extension = '.php', $excludePattern = '@(\.|\.\.)$@', $recursive = true, $suffix = '') {
        // Add default entries we should always exclude
-       $excludeArray[] = '.';         // Current directory
-       $excludeArray[] = '..';        // Parent directory
-       $excludeArray[] = '.svn';      // Directories created by Subversion
-       $excludeArray[] = '.htaccess'; // Directory protection files (mostly)
+       array_unshift($excludeArray, '.', '..', '.svn', '.htaccess');
 
        //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'baseDir=' . $baseDir . ',prefix=' . $prefix . ' - Entered!');
        // Init found includes
        $foundMatches = array();
 
        // Open directory
-       $dirPointer = opendir(getPath() . $baseDir) or debug_report_bug(__FUNCTION__, __LINE__, 'Cannot read directory ' . basename($baseDir) . '.');
+       $dirPointer = opendir(getPath() . $baseDir) or reportBug(__FUNCTION__, __LINE__, 'Cannot read directory ' . basename($baseDir) . '.');
 
        // Read all entries
        while ($baseFile = readdir($dirPointer)) {
@@ -1876,6 +1759,10 @@ function getArrayFromDirectory ($baseDir, $prefix, $fileIncludeDirs = false, $ad
                        // Might be deprecated
                        //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'File ' . $FQFN . ' is to small (' . filesize($FQFN) . ')!');
                        continue;
+               } elseif (($extension == '.php') && (filesize($FQFN) < 50)) {
+                       // This PHP script is deprecated
+                       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'File ' . $FQFN . ' is a deprecated PHP script!');
+                       continue;
                }
 
                // Get file' extension (last 4 chars)
@@ -1892,18 +1779,18 @@ function getArrayFromDirectory ($baseDir, $prefix, $fileIncludeDirs = false, $ad
                                // Add file with or without base path
                                if ($addBaseDir === true) {
                                        // With base path
-                                       $foundMatches[] = $fileName;
+                                       array_push($foundMatches, $fileName);
                                } else {
                                        // No base path
-                                       $foundMatches[] = $baseFile;
+                                       array_push($foundMatches, $baseFile);
                                }
                        } else {
                                // We found .php file but should not search for them, why?
-                               debug_report_bug(__FUNCTION__, __LINE__, 'We should find files with extension=' . $extension . ', but we found a PHP script. (baseFile=' . $baseFile . ')');
+                               reportBug(__FUNCTION__, __LINE__, 'We should find files with extension=' . $extension . ', but we found a PHP script. (baseFile=' . $baseFile . ')');
                        }
                } elseif ($fileExtension == $extension) {
                        // Other, generic file found
-                       $foundMatches[] = $fileName;
+                       array_push($foundMatches, $fileName);
                }
        } // END - while
 
@@ -1918,7 +1805,7 @@ function getArrayFromDirectory ($baseDir, $prefix, $fileIncludeDirs = false, $ad
        return $foundMatches;
 }
 
-// Checks wether $prefix is found in $fileName
+// Checks whether $prefix is found in $fileName
 function isFilePrefixFound ($fileName, $prefix) {
        // @TODO Find a way to cache this
        return (substr($fileName, 0, strlen($prefix)) == $prefix);
@@ -1928,10 +1815,14 @@ function isFilePrefixFound ($fileName, $prefix) {
 function mapModuleToTable ($moduleName) {
        // Map only these, still lame code...
        switch ($moduleName) {
-               // 'index' is the guest's menu
-               case 'index': $moduleName = 'guest';  break;
-               // ... and 'login' the member's menu
-               case 'login': $moduleName = 'member'; break;
+               case 'index': // 'index' is the guest's menu
+                       $moduleName = 'guest'; 
+                       break;
+
+               case 'login': // ... and 'login' the member's menu
+                       $moduleName = 'member';
+                       break;
+
                // Anything else will not be mapped, silently.
        } // END - switch
 
@@ -1972,7 +1863,7 @@ function addSqlToDebug ($result, $sqlString, $timing, $F, $L) {
        );
 
        // Add it
-       $GLOBALS['debug_sqls'][] = $record;
+       array_push($GLOBALS['debug_sqls'], $record);
 }
 
 // Initializes the cache instance
@@ -1980,7 +1871,7 @@ function initCacheInstance () {
        // Check for double-initialization
        if (isset($GLOBALS['cache_instance'])) {
                // This should not happen and must be fixed
-               debug_report_bug(__FUNCTION__, __LINE__, 'Double initialization of cache system detected. cache_instance[]=' . gettype($GLOBALS['cache_instance']));
+               reportBug(__FUNCTION__, __LINE__, 'Double initialization of cache system detected. cache_instance[]=' . gettype($GLOBALS['cache_instance']));
        } // END - if
 
        // Load include for CacheSystem class
@@ -1992,7 +1883,7 @@ function initCacheInstance () {
        // Did it work?
        if ($GLOBALS['cache_instance']->getStatusCode() != 'done') {
                // Failed to initialize cache sustem
-               debug_report_bug(__FUNCTION__, __LINE__, 'Cache system returned with unexpected error. getStatusCode()=' . $GLOBALS['cache_instance']->getStatusCode());
+               reportBug(__FUNCTION__, __LINE__, 'Cache system returned with unexpected error. getStatusCode()=' . $GLOBALS['cache_instance']->getStatusCode());
        } // END - if
 }
 
@@ -2034,9 +1925,9 @@ function getModuleFromFileName ($file, $accessLevel) {
                        break;
 
                default: // Unsupported file name / access level
-                       debug_report_bug(__FUNCTION__, __LINE__, 'Unsupported file name=' . basename($file) . '/access level=' . $accessLevel);
+                       reportBug(__FUNCTION__, __LINE__, 'Unsupported file name=' . basename($file) . '/access level=' . $accessLevel);
                        break;
-       }
+       } // END - switch
 
        // Return result
        return $modCheck;
@@ -2052,16 +1943,12 @@ function encodeUrl ($url, $outputMode = '0') {
 
        // Do we have a valid session?
        if (((!isset($GLOBALS['valid_session'])) || ($GLOBALS['valid_session'] === false) || (!isset($_COOKIE[session_name()]))) && (isSpider() === false)) {
-               // Invalid session
                // Determine right separator
                $separator = '&amp;';
                if (!isInString('?', $url)) {
                        // No question mark
                        $separator = '?';
-               } elseif ((!isHtmlOutputMode()) || ($outputMode != '0')) {
-                       // Non-HTML mode (or forced non-HTML mode
-                       $separator = '&';
-               }
+               } // END - if
 
                // Add it to URL
                if (session_id() != '') {
@@ -2075,7 +1962,16 @@ function encodeUrl ($url, $outputMode = '0') {
                $url = '{?URL?}/' . $url;
        } // END - if
 
-       // Return the URL
+       // Do we have to decode entities?
+       if ((!isHtmlOutputMode()) || ($outputMode != '0')) {
+               // Decode them for e.g. JavaScript parts
+               $url = decodeEntities($url);
+       } // END - if
+
+       // Debug log
+       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'url=' . $url . ',outputMode=' . $outputMode);
+
+       // Return the encoded URL
        return $url;
 }
 
@@ -2135,15 +2031,19 @@ function searchDirsRecursive ($dir, &$last_changed, $lookFor = 'Date') {
 function handleFieldWithBraces ($field) {
        // Are there braces [] at the end?
        if (substr($field, -2, 2) == '[]') {
-               // Try to find one and replace it. I do it this way to allow easy
-               // extending of this code.
+               /*
+                * Try to find one and replace it. I do it this way to allow easy
+                * extending of this code.
+                */
                foreach (array('admin_list_builder_id_value') as $key) {
+                       /* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'key=' . $key);
                        // Is the cache entry set?
                        if (isset($GLOBALS[$key])) {
                                // Insert it
                                $field = str_replace('[]', '[' . $GLOBALS[$key] . ']', $field);
 
                                // And abort
+                               /* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'key=' . $key, 'field=' . $field);
                                break;
                        } // END - if
                } // END - foreach
@@ -2292,7 +2192,7 @@ function isHexadecimal ($hex) {
 }
 
 /**
- * Replace "\r" with "[r]" and "\n" with "[n]" and add a final new-line to make
+ * Replace chr(13) with "[r]" and chr(10) with "[n]" and add a final new-line to make
  * them visible to the developer. Use this function to debug e.g. buggy HTTP
  * response handler functions.
  *
@@ -2300,8 +2200,7 @@ function isHexadecimal ($hex) {
  * @return     $str    Overworked string
  */
 function replaceReturnNewLine ($str) {
-       return str_replace("\r", '[r]', str_replace("\n", '[n]
-', $str));
+       return str_replace(array(chr(13), chr(10)), array('[r]', '[n]'), $str);
 }
 
 // Converts a given string by splitting it up with given delimiter similar to
@@ -2313,7 +2212,7 @@ function stringToArray ($delimiter, $string) {
        // "Walk" through all entries
        foreach (explode($delimiter, $string) as $split) {
                //  Append the delimiter and add it to the array
-               $strArray[] = $split . $delimiter;
+               array_push($strArray, $split . $delimiter);
        } // END - foreach
 
        // Return array
@@ -2346,7 +2245,7 @@ function getArrayKeysFromSubStrArray ($heystack, $needles, $offset = 0) {
                //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'heystack='.$heystack.',key='.$key.',needle='.$needle.',offset='.$offset);
                if (strpos($heystack, $needle, $offset) !== false) {
                        // Add the found key
-                       $keys[] = $key;
+                       array_push($keys, $key);
                } // END - if
        } // END - foreach
 
@@ -2383,21 +2282,6 @@ function determinePointsColumnFromSubjectLocked ($subject, $locked) {
        return $pointsColumn;
 }
 
-// Setter for referral id (no bigintval, or nicknames will fail!)
-function setReferralId ($refid) {
-       $GLOBALS['refid'] = $refid;
-}
-
-// Checks if 'refid' is valid
-function isReferralIdValid () {
-       return ((isset($GLOBALS['refid'])) && (getReferralId() !== NULL) && (getReferralId() > 0));
-}
-
-// Getter for referral id
-function getReferralId () {
-       return $GLOBALS['refid'];
-}
-
 // Converts a boolean variable into 'Y' for true and 'N' for false
 function convertBooleanToYesNo ($boolean) {
        // Default is 'N'
@@ -2411,55 +2295,28 @@ function convertBooleanToYesNo ($boolean) {
        return $converted;
 }
 
-// Translates task type to a human-readable version
-function translateTaskType ($taskType) {
-       // Construct message id
-       $messageId = 'ADMIN_TASK_TYPE_' . strtoupper($taskType) . '';
-
-       // Is the message id there?
-       if (isMessageIdValid($messageId)) {
-               // Then construct message
-               $message = '{--' . $messageId . '--}';
-       } else {
-               // Else it is an unknown task type
-               $message = '{%message,ADMIN_TASK_TYPE_UNKNOWN=' . $taskType . '%}';
-       } // END - if
-
-       // Return message
-       return $message;
-}
-
-// Translates points subject to human-readable
-function translatePointsSubject ($subject) {
-       // Construct message id
-       $messageId = 'POINTS_SUBJECT_' . strtoupper($subject) . '';
-
-       // Is the message id there?
-       if (isMessageIdValid($messageId)) {
-               // Then construct message
-               $message = '{--' . $messageId . '--}';
-       } else {
-               // Else it is an unknown task type
-               $message = '{%message,POINTS_SUBJECT_UNKNOWN=' . $subject . '%}';
-       } // END - if
-
-       // Return message
-       return $message;
-}
-
 // "Translates" 'true' to true and 'false' to false
 function convertStringToBoolean ($str) {
-       // Trim it lower-case for validation
-       $str = trim(strtolower($str));
+       // Debug message (to measure how often this function is called)
+       //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'str=' . $str);
 
-       // Is it valid?
-       if (!in_array($str, array('true', 'false'))) {
-               // Not valid!
-               debug_report_bug(__FUNCTION__, __LINE__, 'str=' . $str . ' is not true/false');
+       // Do we have cache?
+       if (!isset($GLOBALS[__FUNCTION__][$str])) {
+               // Trim it lower-case for validation
+               $strTrimmed = trim(strtolower($str));
+
+               // Is it valid?
+               if (!in_array($strTrimmed, array('true', 'false'))) {
+                       // Not valid!
+                       reportBug(__FUNCTION__, __LINE__, 'str=' . $str . '(' . $strTrimmed . ') is not true/false');
+               } // END - if
+
+               // Determine it
+               $GLOBALS[__FUNCTION__][$str] = (($strTrimmed == 'true') ? true : false);
        } // END - if
 
-       // Return it
-       return (($str == 'true') ? true : false);
+       // Return cache
+       return $GLOBALS[__FUNCTION__][$str];
 }
 
 /**
@@ -2473,19 +2330,112 @@ function makeParseableVariable ($varString) {
        // The first character must be a dollar sign
        if (substr($varString, 0, 1) != '$') {
                // Please report this
-               debug_report_bug(__FUNCTION__, __LINE__, 'varString=' . $varString . ' - No dollar sign detected, will not parse it.');
+               reportBug(__FUNCTION__, __LINE__, 'varString=' . $varString . ' - No dollar sign detected, will not parse it.');
        } // END - if
 
        // Do we have cache?
        if (!isset($GLOBALS[__FUNCTION__][$varString])) {
                // Snap them in, if [,] are there
-               $GLOBALS[__FUNCTION__][$varString] = str_replace('[', "['", str_replace(']', "']", $varString));
+               $GLOBALS[__FUNCTION__][$varString] = str_replace(array('[', ']'), array("['", "']"), $varString);
        } // END - if
 
        // Return cache
        return $GLOBALS[__FUNCTION__][$varString];
 }
 
+// "Getter" for random TAN
+function getRandomTan () {
+       // Generate one
+       return mt_rand(0, 99999);
+}
+
+// Removes any : from subject
+function removeDoubleDotFromSubject ($subject) {
+       // Remove it
+       $subjectArray = explode(':', $subject);
+       $subject = $subjectArray[0];
+       unset($subjectArray);
+
+       // Return it
+       return $subject;
+}
+
+// Translates generically some data into a target string
+function translateGeneric ($messagePrefix, $data) {
+       // Is the method null or empty?
+       if (is_null($data)) {
+               // Is NULL
+               $data = 'NULL';
+       } elseif (empty($data)) {
+               // Is empty (string)
+               $data = 'EMPTY';
+       } // END - if
+
+       // Default column name is unknown
+       $return = '{%message,' . $messagePrefix . '_UNKNOWN=' . strtoupper($data) . '%}';
+
+       // Construct message id
+       $messageId = $messagePrefix . '_' . strtoupper($data);
+
+       // Is it there?
+       if (isMessageIdValid($messageId)) {
+               // Then use it as message string
+               $return = '{--' . $messageId . '--}';
+       } // END - if
+
+       // Return the column name
+       return $return;
+}
+
+// Translates task type to a human-readable version
+function translateTaskType ($taskType) {
+       // Return it
+       return translateGeneric('ADMIN_TASK_TYPE', $taskType);
+}
+
+// ----------------------------------------------------------------------------
+//              "Translatation" functions for points_data table
+// ----------------------------------------------------------------------------
+
+// Translates points subject to human-readable
+function translatePointsSubject ($subject) {
+       // Remove any :x
+       $subject = removeDoubleDotFromSubject($subject);
+
+       // Return it
+       return translateGeneric('POINTS_SUBJECT', $subject);
+}
+
+// "Translates" the given points account type
+function translatePointsAccountType ($accountType) {
+       // Return it
+       return translateGeneric('POINTS_ACCOUNT_TYPE', $accountType);
+}
+
+// "Translates" the given points "locked mode"
+function translatePointsLockedMode ($lockedMode) {
+       // Return it
+       return translateGeneric('POINTS_LOCKED_MODE', $lockedMode);
+}
+
+// "Translates" the given points payment method
+function translatePointsPaymentMethod ($paymentMethod) {
+       // Return it
+       return translateGeneric('POINTS_PAYMENT_METHOD', $paymentMethod);
+}
+
+// "Translates" the given points account provider
+function translatePointsAccountProvider ($accountProvider) {
+       // Return it
+       return translateGeneric('POINTS_ACCOUNT_PROVIDER', $accountProvider);
+}
+
+// "Translates" the given points notify recipient
+function translatePointsNotifyRecipient ($notifyRecipient) {
+       // Return it
+       return translateGeneric('POINTS_NOTIFY_RECIPIENT', $notifyRecipient);
+}
+
 //-----------------------------------------------------------------------------
 // Automatically re-created functions, all taken from user comments on www.php.net
 //-----------------------------------------------------------------------------