X-Git-Url: https://git.mxchange.org/?p=mailer.git;a=blobdiff_plain;f=inc%2Ffunctions.php;h=b9decbaac6d40711fb02e40b93b2ed486c0f5837;hp=e202db15d3e7750537b78684bf6b0ae533f3c5be;hb=0437f06b273f885db05736449a952c6eb72086ca;hpb=ee0625c4882bb462985c504abf65a3ef0e7bf1eb diff --git a/inc/functions.php b/inc/functions.php index e202db15d3..b9decbaac6 100644 --- a/inc/functions.php +++ b/inc/functions.php @@ -37,11 +37,11 @@ ************************************************************************/ // Some security stuff... if (!defined('__SECURITY')) { - $INC = substr(dirname(__FILE__), 0, strpos(dirname(__FILE__), "/inc") + 4)."/security.php"; + $INC = substr(dirname(__FILE__), 0, strpos(dirname(__FILE__), '/inc') + 4) . '/security.php'; require($INC); } -// Output HTML code directly or "render" it. You addionally switch the new-line character off +// Output HTML code directly or 'render' it. You addionally switch the new-line character off function OUTPUT_HTML ($HTML, $newLine = true) { // Some global variables global $OUTPUT; @@ -49,13 +49,13 @@ function OUTPUT_HTML ($HTML, $newLine = true) { // Do we have HTML-Code here? if (!empty($HTML)) { // Yes, so we handle it as you have configured - switch (constant('OUTPUT_MODE')) + switch (getConfig('OUTPUT_MODE')) { - case "render": + case 'render': // That's why you don't need any \n at the end of your HTML code... :-) - if (constant('_OB_CACHING') == "on") { + if (constant('_OB_CACHING') == 'on') { // Output into PHP's internal buffer - OUTPUT_RAW($HTML); + outputRawCode($HTML); // That's why you don't need any \n at the end of your HTML code... :-) if ($newLine) echo "\n"; @@ -68,22 +68,21 @@ function OUTPUT_HTML ($HTML, $newLine = true) { } break; - case "direct": + case 'direct': // If we are switching from render to direct output rendered code - if ((!empty($OUTPUT)) && (constant('_OB_CACHING') != "on")) { OUTPUT_RAW($OUTPUT); $OUTPUT = ""; } + if ((!empty($OUTPUT)) && (constant('_OB_CACHING') != 'on')) { outputRawCode($OUTPUT); $OUTPUT = ''; } // The same as above... ^ - OUTPUT_RAW($HTML); + outputRawCode($HTML); if ($newLine) echo "\n"; break; default: // Huh, something goes wrong or maybe you have edited config.php ??? - DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Invalid renderer %s detected.", constant('OUTPUT_MODE'))); app_die(__FUNCTION__, __LINE__, "{--FATAL_ERROR--}: {--LANG_NO_RENDER_DIRECT--}"); break; } - } elseif ((constant('_OB_CACHING') == "on") && (isset($GLOBALS['footer_sent'])) && ($GLOBALS['footer_sent'] == 1)) { + } elseif ((constant('_OB_CACHING') == 'on') && (isset($GLOBALS['footer_sent'])) && ($GLOBALS['footer_sent'] == 1)) { // Headers already sent? if (headers_sent()) { // Log this error @@ -102,27 +101,27 @@ function OUTPUT_HTML ($HTML, $newLine = true) { } // END - if // Send HTTP header - header("HTTP/1.1 200"); + sendHeader('HTTP/1.1 200'); // Used later $now = gmdate('D, d M Y H:i:s') . ' GMT'; // General headers for no caching - header("Expired: " . $now); // RFC2616 - Section 14.21 - header("Last-Modified: " . $now); - header("Cache-Control: no-store, no-cache, must-revalidate, pre-check=0, post-check=0, max-age=0"); // HTTP/1.1 - header("Pragma: no-cache"); // HTTP/1.0 - header("Connection: Close"); - - // Extension "rewrite" installed? - if ((EXT_IS_ACTIVE("rewrite")) && ($GLOBALS['output_mode'] != "1") && ($GLOBALS['output_mode'] != "-1")) { - $OUTPUT = REWRITE_LINKS($OUTPUT); + sendHeader('Expired: ' . $now); // RFC2616 - Section 14.21 + sendHeader('Last-Modified: ' . $now); + sendHeader('Cache-Control: no-store, no-cache, must-revalidate, pre-check=0, post-check=0, max-age=0'); // HTTP/1.1 + sendHeader('Pragma: no-cache'); // HTTP/1.0 + sendHeader('Connection: Close'); + + // Extension 'rewrite' installed? + if ((EXT_IS_ACTIVE('rewrite')) && ($GLOBALS['output_mode'] != '1') && ($GLOBALS['output_mode'] != '-1')) { + $OUTPUT = rewriteLinksInCode($OUTPUT); } // END - if // Compile and run finished rendered HTML code while (strpos($OUTPUT, '{!') > 0) { // Prepare the content and eval() it... - $newContent = ""; + $newContent = ''; $eval = "\$newContent = \"".COMPILE_CODE(smartAddSlashes($OUTPUT))."\";"; eval($eval); @@ -135,11 +134,11 @@ function OUTPUT_HTML ($HTML, $newLine = true) { } // END - while // Output code here, DO NOT REMOVE! ;-) - OUTPUT_RAW($OUTPUT); - } elseif ((constant('OUTPUT_MODE') == "render") && (!empty($OUTPUT))) { + outputRawCode($OUTPUT); + } elseif ((getConfig('OUTPUT_MODE') == 'render') && (!empty($OUTPUT))) { // Rewrite links when rewrite extension is active - if ((EXT_IS_ACTIVE("rewrite")) && ($GLOBALS['output_mode'] != "1") && ($GLOBALS['output_mode'] != "-1")) { - $OUTPUT = REWRITE_LINKS($OUTPUT); + if ((EXT_IS_ACTIVE('rewrite')) && ($GLOBALS['output_mode'] != '1') && ($GLOBALS['output_mode'] != '-1')) { + $OUTPUT = rewriteLinksInCode($OUTPUT); } // END - if // Compile and run finished rendered HTML code @@ -149,17 +148,17 @@ function OUTPUT_HTML ($HTML, $newLine = true) { } // END - while // Output code here, DO NOT REMOVE! ;-) - OUTPUT_RAW($OUTPUT); + outputRawCode($OUTPUT); } } // Output the raw HTML code -function OUTPUT_RAW ($HTML) { +function outputRawCode ($HTML) { // Output stripped HTML code to avoid broken JavaScript code, etc. echo stripslashes(stripslashes($HTML)); - // Flush the output if only constant('_OB_CACHING') is not "on" - if (constant('_OB_CACHING') != "on") { + // Flush the output if only constant('_OB_CACHING') is not 'on' + if (constant('_OB_CACHING') != 'on') { // Flush it flush(); } // END - if @@ -176,8 +175,7 @@ function getFatalArray () { } // Add a fatal error message to the queue array -function addFatalMessage ($F, $L, $message, $extra="") { - debug_report_bug($message); +function addFatalMessage ($F, $L, $message, $extra='') { if (is_array($extra)) { // Multiple extras for a message with masks $message = call_user_func_array('sprintf', $extra); @@ -211,7 +209,10 @@ function getTotalFatalErrors () { // Load a template file and return it's content (only it's name; do not use ' or ") function LOAD_TEMPLATE ($template, $return=false, $content=array()) { // Add more variables which you want to use in your template files - global $DATA, $_CONFIG, $username; + global $DATA, $username; + + // Get whole config array + $_CONFIG = getConfigArray(); // Make all template names lowercase $template = strtolower($template); @@ -220,12 +221,12 @@ function LOAD_TEMPLATE ($template, $return=false, $content=array()) { incrementConfigEntry('num_templates'); // Prepare IP number and User Agent - $REMOTE_ADDR = GET_REMOTE_ADDR(); + $REMOTE_ADDR = detectRemoteAddr(); if (!defined('REMOTE_ADDR')) define('REMOTE_ADDR', $REMOTE_ADDR); - $HTTP_USER_AGENT = GET_USER_AGENT(); + $HTTP_USER_AGENT = detectUserAgent(); // Init some data - $ret = ""; + $ret = ''; if (empty($GLOBALS['refid'])) $GLOBALS['refid'] = 0; // @DEPRECATED Try to rewrite the if() condition @@ -240,7 +241,7 @@ function LOAD_TEMPLATE ($template, $return=false, $content=array()) { $content = merge_array($content, SQL_FETCHARRAY($result)); // Translate gender - $content['gender'] = TRANSLATE_GENDER($content['gender']); + $content['gender'] = translateGender($content['gender']); } else { // @DEPRECATED // @TODO Fine all templates which are using these direct variables and rewrite them. @@ -248,7 +249,7 @@ function LOAD_TEMPLATE ($template, $return=false, $content=array()) { list($gender, $surname, $family, $email) = SQL_FETCHROW($result); // Translate gender - $gender = TRANSLATE_GENDER($gender); + $gender = translateGender($gender); DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("DEPRECATION-WARNING: content is not array (%s).", gettype($content))); } @@ -257,77 +258,77 @@ function LOAD_TEMPLATE ($template, $return=false, $content=array()) { } // END - if // Generate date/time string - $date_time = MAKE_DATETIME(time(), "1"); + $date_time = generateDateTime(time(), '1'); // Base directory - $BASE = sprintf("%stemplates/%s/html/", constant('PATH'), GET_LANGUAGE()); - $MODE = ""; + $basePath = sprintf("%stemplates/%s/html/", constant('PATH'), getLanguage()); + $mode = ''; // Check for admin/guest/member templates if (strpos($template, "admin_") > -1) { // Admin template found - $MODE = "admin/"; + $mode = "admin/"; } elseif (strpos($template, "guest_") > -1) { // Guest template found - $MODE = "guest/"; + $mode = "guest/"; } elseif (strpos($template, "member_") > -1) { // Member template found - $MODE = "member/"; + $mode = "member/"; } elseif (strpos($template, "install_") > -1) { // Installation template found - $MODE = "install/"; + $mode = "install/"; } elseif (strpos($template, "ext_") > -1) { // Extension template found - $MODE = "ext/"; + $mode = "ext/"; } elseif (strpos($template, "la_") > -1) { // "Logical-area" template found - $MODE = "la/"; + $mode = "la/"; } else { // Test for extension $test = substr($template, 0, strpos($template, "_")); if (EXT_IS_ACTIVE($test)) { // Set extra path to extension's name - $MODE = $test."/"; + $mode = $test.'/'; } } //////////////////////// // Generate file name // //////////////////////// - $FQFN = $BASE.$MODE.$template.".tpl"; + $FQFN = $basePath.$mode.$template.".tpl"; - if ((!empty($GLOBALS['what'])) && ((strpos($template, "_header") > 0) || (strpos($template, "_footer") > 0)) && (($MODE == "guest/") || ($MODE == "member/") || ($MODE == "admin/"))) { + if ((!empty($GLOBALS['what'])) && ((strpos($template, "_header") > 0) || (strpos($template, "_footer") > 0)) && (($mode == "guest/") || ($mode == "member/") || ($mode == "admin/"))) { // Select what depended header/footer template file for admin/guest/member area $file2 = sprintf("%s%s%s_%s.tpl", - $BASE, - $MODE, + $basePath, + $mode, $template, SQL_ESCAPE($GLOBALS['what']) ); // Probe for it... - if (FILE_READABLE($file2)) $FQFN = $file2; + if (isFileReadable($file2)) $FQFN = $file2; // Remove variable from memory unset($file2); } // Does the special template exists? - if (!FILE_READABLE($FQFN)) { + if (!isFileReadable($FQFN)) { // Reset to default template - $FQFN = $BASE.$template.".tpl"; + $FQFN = $basePath.$template.".tpl"; } // END - if // Now does the final template exists? - if (FILE_READABLE($FQFN)) { + if (isFileReadable($FQFN)) { // The local file does exists so we load it. :) - $tmpl_file = READ_FILE($FQFN); + $tmpl_file = readFromFile($FQFN); // Replace ' to our own chars to preventing them being quoted while (strpos($tmpl_file, "'") !== false) { $tmpl_file = str_replace("'", '{QUOT}', $tmpl_file); } // Do we have to compile the code? - $ret = ""; + $ret = ''; if ((strpos($tmpl_file, "\$") !== false) || (strpos($tmpl_file, '{--') !== false) || (strpos($tmpl_file, '--}') > 0)) { // Okay, compile it! $tmpl_file = "\$ret=\"".COMPILE_CODE(smartAddSlashes($tmpl_file))."\";"; @@ -341,12 +342,12 @@ function LOAD_TEMPLATE ($template, $return=false, $content=array()) { $ret = "\n".$ret."\n"; } elseif ((IS_ADMIN()) || ((isInstalling()) && (!isInstalled()))) { // Only admins shall see this warning or when installation mode is active - $ret = "
".TEMPLATE_404."
+ $ret = "
{--TEMPLATE_404--}
(".basename($FQFN).")

-".TEMPLATE_CONTENT." +{--TEMPLATE_CONTENT--}
".print_r($content, true)."
-".TEMPLATE_DATA." +{--TEMPLATE_DATA--}
".print_r($DATA, true)."


"; } @@ -372,7 +373,7 @@ function LOAD_TEMPLATE ($template, $return=false, $content=array()) { } // Send mail out to an email address -function SEND_EMAIL($toEmail, $subject, $message, $HTML = "N", $mailHeader = "") { +function sendEmail($toEmail, $subject, $message, $HTML = 'N', $mailHeader = '') { //* DEBUG: */ print __FUNCTION__."(".__LINE__."):TO={$toEmail},SUBJECT={$subject}
\n"; // Compile subject line (for POINTS constant etc.) @@ -402,14 +403,14 @@ function SEND_EMAIL($toEmail, $subject, $message, $HTML = "N", $mailHeader = "") // Free result SQL_FREERESULT($result_email); } - } elseif ("$toEmail" == "0") { + } elseif ("$toEmail" == '0') { // Is the webmaster! $toEmail = constant('WEBMASTER'); } //* DEBUG: */ print __FUNCTION__."(".__LINE__."):TO={$toEmail}
\n"; // Check for PHPMailer or debug-mode - if (!CHECK_PHPMAILER_USAGE()) { + if (!checkPhpMailerUsage()) { // Not in PHPMailer-Mode if (empty($mailHeader)) { // Load email header template @@ -437,7 +438,7 @@ function SEND_EMAIL($toEmail, $subject, $message, $HTML = "N", $mailHeader = "") eval($eval); // Fix HTML parameter (default is no!) - if (empty($HTML)) $HTML = "N"; + if (empty($HTML)) $HTML = 'N'; if (isDebugModeEnabled()) { // In debug mode we want to display the mail instead of sending it away so we can debug this part print("
@@ -446,34 +447,32 @@ To      : ".$toEmail."
 Subject : ".$subject."
 Message : ".$message."
 
\n"); - } elseif (($HTML == "Y") && (EXT_IS_ACTIVE("html_mail"))) { + } elseif (($HTML == 'Y') && (EXT_IS_ACTIVE('html_mail'))) { // Send mail as HTML away - SEND_HTML_EMAIL($toEmail, $subject, $message, $mailHeader); + sendHtmlEmail($toEmail, $subject, $message, $mailHeader); } elseif (!empty($toEmail)) { // Send Mail away - SEND_RAW_EMAIL($toEmail, $subject, $message, $mailHeader); - } elseif ($HTML == "N") { + sendRawEmail($toEmail, $subject, $message, $mailHeader); + } elseif ($HTML == 'N') { // Problem found! - SEND_RAW_EMAIL(constant('WEBMASTER'), "[PROBLEM:]".$subject, $message, $mailHeader); + sendRawEmail(constant('WEBMASTER'), '[PROBLEM:]' . $subject, $message, $mailHeader); } } // Check if legacy or PHPMailer command // @TODO Rewrite this to an extension 'smtp' // @private -function CHECK_PHPMAILER_USAGE() { - return ((defined('SMTP_HOSTNAME')) && (defined('SMTP_USER')) && (defined('SMTP_PASSWORD')) && (constant('SMTP_HOSTNAME') != "") && (constant('SMTP_USER') != "")); +function checkPhpMailerUsage() { + return ((getConfig('SMTP_HOSTNAME') != '') && (getConfig('SMTP_USER') != '')); } -/* - * Send out a raw email with PHPMailer class or legacy mail() command - */ -function SEND_RAW_EMAIL ($toEmail, $subject, $msg, $from) { +// Send out a raw email with PHPMailer class or legacy mail() command +function sendRawEmail ($toEmail, $subject, $msg, $from) { // Shall we use PHPMailer class or legacy mode? - if (CHECK_PHPMAILER_USAGE()) { + if (checkPhpMailerUsage()) { // Use PHPMailer class with SMTP enabled - LOAD_INC_ONCE("inc/phpmailer/class.phpmailer.php"); - LOAD_INC_ONCE("inc/phpmailer/class.smtp.php"); + loadIncludeOnce('inc/phpmailer/class.phpmailer.php'); + loadIncludeOnce('inc/phpmailer/class.smtp.php'); // get new instance $mail = new PHPMailer(); @@ -481,10 +480,10 @@ function SEND_RAW_EMAIL ($toEmail, $subject, $msg, $from) { $mail->IsSMTP(); $mail->SMTPAuth = true; - $mail->Host = constant('SMTP_HOSTNAME'); + $mail->Host = getConfig('SMTP_HOSTNAME'); $mail->Port = 25; - $mail->Username = constant('SMTP_USER'); - $mail->Password = constant('SMTP_PASSWORD'); + $mail->Username = getConfig('SMTP_USER'); + $mail->Password = getConfig('SMTP_PASSWORD'); if (empty($from)) { $mail->From = constant('WEBMASTER'); } else { @@ -492,41 +491,41 @@ function SEND_RAW_EMAIL ($toEmail, $subject, $msg, $from) { } $mail->FromName = constant('MAIN_TITLE'); $mail->Subject = $subject; - if ((EXT_IS_ACTIVE("html_mail")) && (strip_tags($msg) != $msg)) { + if ((EXT_IS_ACTIVE('html_mail')) && (strip_tags($msg) != $msg)) { $mail->Body = $msg; - $mail->AltBody = "Your mail program required HTML support to read this mail!"; + $mail->AltBody = 'Your mail program required HTML support to read this mail!'; $mail->WordWrap = 70; $mail->IsHTML(true); } else { $mail->Body = decodeEntities($msg); } - $mail->AddAddress($toEmail, ""); + $mail->AddAddress($toEmail, ''); $mail->AddReplyTo(constant('WEBMASTER'), constant('MAIN_TITLE')); - $mail->AddCustomHeader("Errors-To:".constant('WEBMASTER')); - $mail->AddCustomHeader("X-Loop:".constant('WEBMASTER')); + $mail->AddCustomHeader('Errors-To:' . constant('WEBMASTER')); + $mail->AddCustomHeader('X-Loop:' . constant('WEBMASTER')); $mail->Send(); } else { // Use legacy mail() command @mail($toEmail, $subject, decodeEntities($msg), $from); } } -// // Generate a password in a specified length or use default password length -function GEN_PASS ($LEN = 0) { +function generatePassword ($LEN = 0) { // Auto-fix invalid length of zero if ($LEN == 0) $LEN = getConfig('pass_len'); // Initialize array with all allowed chars - $ABC = explode(",", "a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z,A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z,0,1,2,3,4,5,6,7,8,9,-,+,_,/"); + $ABC = explode(',', 'a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z,A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z,0,1,2,3,4,5,6,7,8,9,-,+,_,/'); // Start creating password - $PASS = ""; + $PASS = ''; for ($i = 0; $i < $LEN; $i++) { $PASS .= $ABC[mt_rand(0, count($ABC) -1)]; } // END - for - // When the size is below 40 we can also add additional security by scrambling it + // When the size is below 40 we can also add additional security by scrambling + // it. Otherwise we may corrupt hashes if (strlen($PASS) <= 40) { // Also scramble the password $PASS = scrambleString($PASS); @@ -535,37 +534,38 @@ function GEN_PASS ($LEN = 0) { // Return the password return $PASS; } -// -function MAKE_DATETIME ($time, $mode="0") -{ + +// Generates a human-readable timestamp from the Uni* stamp +function generateDateTime ($time, $mode = '0') { + // Filter out numbers + $time = bigintval($time); + + // If the stamp is zero it mostly didn't "happen" if ($time == 0) { // Never happend - return NEVER_HAPPENED; - } else { - // Filter out numbers - $time = bigintval($time); - } + return getMessage('NEVER_HAPPENED'); + } // END - if - switch (GET_LANGUAGE()) + switch (getLanguage()) { - case "de": // German date / time format + 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 '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; default: DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Invalid date mode %s detected.", $mode)); break; } break; - default: // Default is the US date / time format! + default: // Default is the US date / time format! switch ($mode) { - case "0": $ret = date("r", $time); break; - case "1": $ret = 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 '0': $ret = date("r", $time); break; + case '1': $ret = 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; default: DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Invalid date mode %s detected.", $mode)); break; @@ -574,10 +574,45 @@ function MAKE_DATETIME ($time, $mode="0") return $ret; } +// Translates Y/N to yes/no +function translateYesNo ($yn) { + // Default + $translated = "??? (".$yn.')'; + switch ($yn) { + case 'Y': $translated = getMessage('YES'); break; + case 'N': $translated = getMessage('NO'); break; + default: + // Log unknown value + DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Unknown value %s. Expected Y/N!", $yn)); + break; + } + + // Return it + return $translated; +} + +// Translates the "pool type" into human-readable +function translatePoolType ($type) { + // Default?type is unknown + $translated = sprintf(getMessage('POOL_TYPE_UNKNOWN'), $type); + + // Generate constant + $constName = sprintf("POOL_TYPE_%s", $type); + + // Does it exist? + if (defined($constName)) { + // Then use it + $translated = getMessage($constName); + } // END - if + + // Return "translation" + return $translated; +} + // Translates the american decimal dot into a german comma -function TRANSLATE_COMMA ($dotted, $cut=true, $max=0) { +function translateComma ($dotted, $cut = true, $max = 0) { // Default is 3 you can change this in admin area "Misc -> Misc Options" - if (!isConfigEntrySet('max_comma')) setConfigEntry('max_comma', "3"); + if (!isConfigEntrySet('max_comma')) setConfigEntry('max_comma', '3'); // Use from config is default $maxComma = getConfig('max_comma'); @@ -588,7 +623,7 @@ function TRANSLATE_COMMA ($dotted, $cut=true, $max=0) { // Cut zeros off? if (($cut) && ($max == 0)) { // Test for commata if in cut-mode - $com = explode(".", $dotted); + $com = explode('.', $dotted); if (count($com) < 2) { // Don't display commatas even if there are none... ;-) $maxComma = 0; @@ -599,13 +634,13 @@ function TRANSLATE_COMMA ($dotted, $cut=true, $max=0) { //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "dotted={$dotted},maxComma={$maxComma}"); // Translate it now - switch (GET_LANGUAGE()) { - case "de": - $dotted = number_format($dotted, $maxComma, ",", "."); + switch (getLanguage()) { + case 'de': + $dotted = number_format($dotted, $maxComma, ',', '.'); break; default: - $dotted = number_format($dotted, $maxComma, ".", ","); + $dotted = number_format($dotted, $maxComma, '.', ','); break; } @@ -613,28 +648,16 @@ function TRANSLATE_COMMA ($dotted, $cut=true, $max=0) { return $dotted; } -// -function DEREFERER ($URL) { - // Don't de-refer our own links! - if (substr($URL, 0, strlen(URL)) != URL) { - // De-refer this link - $URL = "modules.php?module=loader&url=".encodeString(compileUriCode($URL)); - } // END - if - - // Return link - return $URL; -} - // Translate Uni*-like gender to human-readable -function TRANSLATE_GENDER ($gender) { +function translateGender ($gender) { // Default - $ret = "!{$gender}!"; + $ret = '!' . $gender . '!'; // Male/female or company? switch ($gender) { - case "M": $ret = getMessage('GENDER_M'); break; - case "F": $ret = getMessage('GENDER_F'); break; - case "C": $ret = getMessage('GENDER_C'); break; + case 'M': $ret = getMessage('GENDER_M'); break; + case 'F': $ret = getMessage('GENDER_F'); break; + case 'C': $ret = getMessage('GENDER_C'); break; default: // Log unknown gender DEBUG_LOG(__FUNCTION__, __LINE__, sprintf("Unknown gender %s detected.", $gender)); @@ -645,40 +668,17 @@ function TRANSLATE_GENDER ($gender) { return $ret; } -// -function FRAMETESTER ($URL) { - // Prepare frametester URL - $frametesterUrl = sprintf("{!URL!}/modules.php?module=frametester&url=%s", - encodeString(compileUriCode($URL)) - ); - return $frametesterUrl; -} - -// -function SELECTION_COUNT ($array) { - $ret = 0; - if (is_array($array)) { - foreach ($array as $key => $selected) { - if (!empty($selected)) $ret++; - } - } - return $ret; -} -// -function IMG_CODE ($code, $type, $DATA, $uid) { - return "\"Code\""; -} -// -function TRANSLATE_STATUS ($status) { +// "Translates" the user status +function translateUserStatus ($status) { switch ($status) { - case "UNCONFIRMED": - case "CONFIRMED": - case "LOCKED": + case 'UNCONFIRMED': + case 'CONFIRMED': + case 'LOCKED': $ret = getMessage(sprintf("ACCOUNT_%s", $status)); break; - case "": + case '': case null: $ret = getMessage('ACCOUNT_DELETED'); break; @@ -692,16 +692,54 @@ function TRANSLATE_STATUS ($status) { // Return it return $ret; } -// -function GET_LANGUAGE() { + +// Generates an URL for the dereferer +function DEREFERER ($URL) { + // Don't de-refer our own links! + if (substr($URL, 0, strlen(constant('URL'))) != constant('URL')) { + // De-refer this link + $URL = 'modules.php?module=loader&url=' . encodeString(compileUriCode($URL)); + } // END - if + + // Return link + return $URL; +} + +// Generates an URL for the frametester +function FRAMETESTER ($URL) { + // Prepare frametester URL + $frametesterUrl = sprintf("{!URL!}/modules.php?module=frametester&url=%s", + encodeString(compileUriCode($URL)) + ); + return $frametesterUrl; +} + +// Count entries from e.g. a selection box +function countSelection ($array) { + $ret = 0; + if (is_array($array)) { + foreach ($array as $key => $selected) { + if (!empty($selected)) $ret++; + } + } + return $ret; +} + +// Generate XHTML code for the CAPTCHA +function generateCaptchaCode ($code, $type, $DATA, $uid) { + return 'Code'; +} + +// "Getter" for language +function getLanguage () { // Set default return value to default language from config - $ret = constant('DEFAULT_LANG'); + $ret = getConfig('DEFAULT_LANG'); // Init variable - $lang = ""; + $lang = ''; // Is the variable set - if (REQUEST_ISSET_GET(('mx_lang'))) { + if (REQUEST_ISSET_GET('mx_lang')) { // Accept only first 2 chars $lang = substr(REQUEST_GET('mx_lang'), 0, 2); } elseif (isset($GLOBALS['cache_array']['language'])) { @@ -709,16 +747,16 @@ function GET_LANGUAGE() { $ret = $GLOBALS['cache_array']['language']; } elseif (!empty($lang)) { // Check if main language file does exist - if (FILE_READABLE(constant('PATH')."inc/language/".$lang.".php")) { + if (isFileReadable(constant('PATH') . 'inc/language/'.$lang.'.php')) { // Okay found, so let's update cookies - SET_LANGUAGE($lang); - } - } elseif (!isSessionVariableSet('mx_lang')) { + setLanguage($lang); + } // END - if + } elseif (isSessionVariableSet('mx_lang')) { // Return stored value from cookie - $ret = get_session('mx_lang'); + $ret = getSession('mx_lang'); // Fixes a warning before the session has the mx_lang constant - if (empty($ret)) $ret = constant('DEFAULT_LANG'); + if (empty($ret)) $ret = getConfig('DEFAULT_LANG'); } // Cache entry @@ -727,27 +765,29 @@ function GET_LANGUAGE() { // Return value return $ret; } -// -function SET_LANGUAGE ($lang) { + +// "Setter" for language +function setLanguage ($lang) { // Accept only first 2 chars! $lang = substr(SQL_ESCAPE(strip_tags($lang)), 0, 2); // Set cookie - set_session('mx_lang', $lang); + setSession('mx_lang', $lang); } -// -function LOAD_EMAIL_TEMPLATE($template, $content=array(), $UID="0") { + +// Loads an email template and compiles it +function LOAD_EMAIL_TEMPLATE ($template, $content = array(), $UID = '0') { global $DATA, $_CONFIG; // Make sure all template names are lowercase! $template = strtolower($template); - // Default "nickname" if extension is not installed - $nick = "---"; + // Default 'nickname' if extension is not installed + $nick = '---'; // Prepare IP number and User Agent - $REMOTE_ADDR = GET_REMOTE_ADDR(); - $HTTP_USER_AGENT = GET_USER_AGENT(); + $REMOTE_ADDR = detectRemoteAddr(); + $HTTP_USER_AGENT = detectUserAgent(); // Default admin $ADMIN = constant('MAIN_TITLE'); @@ -755,22 +795,23 @@ function LOAD_EMAIL_TEMPLATE($template, $content=array(), $UID="0") { // Is the admin logged in? if (IS_ADMIN()) { // Get admin id - $aid = GET_CURRENT_ADMIN_ID(); + $aid = getCurrentAdminId(); // Load Admin data - $ADMIN = GET_ADMIN_EMAIL($aid); + $ADMIN = getAdminEmail($aid); } // END - if // Neutral email address is default $email = constant('WEBMASTER'); // Expiration in a nice output format + // NOTE: Use $content[expiration] in your templates instead of $EXPIRATION if (getConfig('auto_purge') == 0) { // Will never expire! $EXPIRATION = getMessage('MAIL_WILL_NEVER_EXPIRE'); } else { // Create nice date string - $EXPIRATION = CREATE_FANCY_TIME(getConfig('auto_purge')); + $EXPIRATION = createFancyTime(getConfig('auto_purge')); } // Is content an array? @@ -783,7 +824,7 @@ function LOAD_EMAIL_TEMPLATE($template, $content=array(), $UID="0") { //* DEBUG: */ print __FUNCTION__."(".__LINE__."):UID={$UID},template={$template},content[]=".gettype($content)."
\n"; if (($UID > 0) && (is_array($content))) { // If nickname extension is installed, fetch nickname as well - if (EXT_IS_ACTIVE("nickname")) { + if (EXT_IS_ACTIVE('nickname')) { //* DEBUG: */ print __FUNCTION__."(".__LINE__."):NICKNAME!
\n"; // Load nickname $result = SQL_QUERY_ESC("SELECT surname, family, gender, email, nickname FROM `{!_MYSQL_PREFIX!}_user_data` WHERE userid=%s LIMIT 1", @@ -805,7 +846,7 @@ function LOAD_EMAIL_TEMPLATE($template, $content=array(), $UID="0") { } // END - if // Translate M to male or F to female if present - if (isset($content['gender'])) $content['gender'] = TRANSLATE_GENDER($content['gender']); + if (isset($content['gender'])) $content['gender'] = translateGender($content['gender']); // Overwrite email from data if present if (isset($content['email'])) $email = $content['email']; @@ -814,41 +855,41 @@ function LOAD_EMAIL_TEMPLATE($template, $content=array(), $UID="0") { $DATA['email'] = $email; // Base directory - $BASE = sprintf("%stemplates/%s/emails/", constant('PATH'), GET_LANGUAGE()); + $basePath = sprintf("%stemplates/%s/emails/", constant('PATH'), getLanguage()); // Check for admin/guest/member templates - if (strpos($template, "admin_") > -1) { + if (strpos($template, 'admin_') > -1) { // Admin template found - $FQFN = $BASE."admin/".$template.".tpl"; - } elseif (strpos($template, "guest_") > -1) { + $FQFN = $basePath.'admin/'.$template.'.tpl'; + } elseif (strpos($template, 'guest_') > -1) { // Guest template found - $FQFN = $BASE."guest/".$template.".tpl"; - } elseif (strpos($template, "member_") > -1) { + $FQFN = $basePath.'guest/'.$template.'.tpl'; + } elseif (strpos($template, 'member_') > -1) { // Member template found - $FQFN = $BASE."member/".$template.".tpl"; + $FQFN = $basePath.'member/'.$template.'.tpl'; } else { // Test for extension - $test = substr($template, 0, strpos($template, "_")); + $test = substr($template, 0, strpos($template, '_')); if (EXT_IS_ACTIVE($test)) { // Set extra path to extension's name - $FQFN = $BASE.$test."/".$template.".tpl"; + $FQFN = $basePath.$test.'/'.$template.'.tpl'; } else { // No special filename - $FQFN = $BASE.$template.".tpl"; + $FQFN = $basePath.$template.'.tpl'; } } // Does the special template exists? - if (!FILE_READABLE($FQFN)) { + if (!isFileReadable($FQFN)) { // Reset to default template - $FQFN = $BASE.$template.".tpl"; + $FQFN = $basePath.$template.'.tpl'; } // END - if // Now does the final template exists? - $newContent = ""; - if (FILE_READABLE($FQFN)) { + $newContent = ''; + if (isFileReadable($FQFN)) { // The local file does exists so we load it. :) - $tmpl_file = READ_FILE($FQFN); + $tmpl_file = readFromFile($FQFN); $tmpl_file = SQL_ESCAPE($tmpl_file); // Run code @@ -885,30 +926,44 @@ function LOAD_EMAIL_TEMPLATE($template, $content=array(), $UID="0") { // Return compiled content return COMPILE_CODE($newContent); } -// -function MAKE_TIME ($H, $M, $S, $stamp) { + +// Generates a timestamp (some wrapper for mktime()) +function makeTime ($H, $M, $S, $stamp) { // Extract day, month and year from given timestamp - $DAY = date("d", $stamp); - $MONTH = date("m", $stamp); - $YEAR = date('Y', $stamp); + $day = date('d', $stamp); + $month = date('m', $stamp); + $year = date('Y', $stamp); // Create timestamp for wished time which depends on extracted date - return mktime($H, $M, $S, $MONTH, $DAY, $YEAR); + return mktime($H, $M, $S, $month, $day, $year); } -// -function LOAD_URL ($URL, $addUrlData=true) { + +// Redirects to an URL and if neccessarry extends it with own base URL +function redirectToUrl ($URL) { // Compile out URI codes $URL = compileUriCode($URL); // Check if http(s):// is there - if ((substr($URL, 0, 7) != "http://") && (substr($URL, 0, 8) != "https://")) { + if ((substr($URL, 0, 7) != 'http://') && (substr($URL, 0, 8) != 'https://')) { // Make all URLs full-qualified - $URL = "".$URL; - } + $URL = constant('URL') . '/' . $URL; + } // END - if - // Get output buffer - //* DEBUG: */ debug_report_bug(sprintf("%s[%s:] URL=%s", __FUNCTION__, __LINE__, $URL)); + // Three different debug ways... + /* DEBUG: */ debug_report_bug(sprintf("%s[%s:] URL=%s", __FUNCTION__, __LINE__, $URL)); //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, $URL); + //* DEBUG: */ die($URL); + + // Default 'rel' value is external, nofollow is evil from Google and hurts the Internet + $rel = ' rel="external"'; + + // Do we have internal or external URL? + if (substr($URL, 0, strlen(constant('URL'))) == constant('URL')) { + // Own (=internal) URL + $rel = ''; + } // END - if + + // Get output buffer $OUTPUT = ob_get_contents(); // Clear it only if there is content @@ -916,31 +971,30 @@ function LOAD_URL ($URL, $addUrlData=true) { clearOutputBuffer(); } // END - if - // Add some data to URL if cookies are not accepted - if (((!defined('__COOKIES')) || (!constant('__COOKIES'))) && ($addUrlData)) $URL = ADD_URL_DATA($URL); - - // Probe for bot from search engine - if ((eregi("spider", GET_USER_AGENT())) || (eregi("bot", GET_USER_AGENT()))) { - // Search engine bot detected so let's rewrite many chars for the link - $URL = htmlentities(strip_tags($URL), ENT_QUOTES); + // Secure the URL against bad things such als HTML insertions and so on... + $URL = htmlentities(strip_tags($URL), ENT_QUOTES); + // Simple probe for bots/spiders from search engines + if ((strpos(detectUserAgent(), 'spider') !== false) || (strpos(detectUserAgent(), 'bot') !== false)) { // Output new location link as anchor - OUTPUT_HTML("".$URL.""); + OUTPUT_HTML('' . $URL . ''); } elseif (!headers_sent()) { // Load URL when headers are not sent //* DEBUG: */ debug_report_bug("URL={$URL}"); - header ("Location: ".str_replace("&", "&", $URL)); + sendHeader('Location: '.str_replace('&', '&', $URL)); } else { // Output error message - LOAD_INC("inc/header.php"); - LOAD_TEMPLATE("redirect_url", false, str_replace("&", "&", $URL)); - LOAD_INC("inc/footer.php"); + loadInclude('inc/header.php'); + LOAD_TEMPLATE('redirect_url', false, str_replace('&', '&', $URL)); + loadInclude('inc/footer.php'); } + + // Shut the mailer down here shutdown(); } -// Wrapper for LOAD_URL but URL comes from a configuration entry -function LOAD_CONFIGURED_URL ($configEntry) { +// Wrapper for redirectToUrl but URL comes from a configuration entry +function redirectToConfiguredUrl ($configEntry) { // Get the URL $URL = getConfig($configEntry); @@ -951,7 +1005,7 @@ function LOAD_CONFIGURED_URL ($configEntry) { } // END - if // Load the URL - LOAD_URL($URL); + redirectToUrl($URL); } // @@ -1037,7 +1091,7 @@ function COMPILE_CODE ($code, $simple = false, $constants = true, $full = true) // Return compiled code return $code; } -// + /************************************************************************ * * * Gaenderter Sortier-Algorythmus, $array wird nach dem Array (!) * @@ -1090,10 +1144,10 @@ function array_pk_sort (&$array, $a_sort, $primary_key = 0, $order = -1, $nums = } // -function ADD_SELECTION ($type, $DEFAULT, $prefix="", $id="0") { - $OUT = ""; +function ADD_SELECTION ($type, $default, $prefix = '', $id = '0') { + $OUT = ''; - if ($type == "yn") { + if ($type == 'yn') { // This is a yes/no selection only! if ($id > 0) $prefix .= "[".$id."]"; $OUT .= " \n"; for ($idx = 0; $idx <= 10; $idx++) { $OUT .= "