X-Git-Url: https://git.mxchange.org/?p=mailer.git;a=blobdiff_plain;f=inc%2Fwrapper-functions.php;h=5195c0c1e7c716abe6bffe17f24367b875cb2994;hp=ab5a1b975b5af071d8711f83e865499e35d83530;hb=f0e095401c24cf94f760de965c39f7ae35d32d25;hpb=e54d3ae5331f50db6811510ff8e22227c09e4c77

diff --git a/inc/wrapper-functions.php b/inc/wrapper-functions.php
index ab5a1b975b..5195c0c1e7 100644
--- a/inc/wrapper-functions.php
+++ b/inc/wrapper-functions.php
@@ -17,7 +17,7 @@
  * -------------------------------------------------------------------- *
  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
  * Copyright (c) 2009 - 2011 by Mailer Developer Team                   *
- * For more information visit: http://www.mxchange.org                  *
+ * For more information visit: http://mxchange.org                      *
  *                                                                      *
  * This program is free software; you can redistribute it and/or modify *
  * it under the terms of the GNU General Public License as published by *
@@ -127,15 +127,13 @@ function clearOutputBuffer () {
 }
 
 // Encode strings
-// @TODO Implement $compress
-function encodeString ($str, $compress = true) {
+function encodeString ($str) {
 	$str = urlencode(base64_encode(compileUriCode($str)));
 	return $str;
 }
 
 // Decode strings encoded with encodeString()
-// @TODO Implement $decompress
-function decodeString ($str, $decompress = true) {
+function decodeString ($str) {
 	$str = compileUriCode(base64_decode(urldecode(compileUriCode($str))));
 	return $str;
 }
@@ -172,7 +170,7 @@ function isFileReadable ($FQFN) {
 	// Do we have cache?
 	if (!isset($GLOBALS['file_readable'][$FQFN])) {
 		// Check all...
-		$GLOBALS['file_readable'][$FQFN] = ((file_exists($FQFN)) && (is_file($FQFN)) && (is_readable($FQFN)));
+		$GLOBALS['file_readable'][$FQFN] = ((is_file($FQFN)) && (file_exists($FQFN)) && (is_readable($FQFN)));
 	} // END - if
 
 	// Return result
@@ -313,7 +311,7 @@ function isInstalling () {
 	// Determine wether we are installing
 	if (!isset($GLOBALS['mailer_installing'])) {
 		// Check URL (css.php/js.php need this)
-		$GLOBALS['mailer_installing'] = isGetRequestParameterSet('installing');
+		$GLOBALS['mailer_installing'] = isGetRequestElementSet('installing');
 	} // END - if
 
 	// Return result
@@ -483,33 +481,6 @@ function copyFileVerified ($source, $dest, $chmod = '') {
 	return $status;
 }
 
-// Wrapper function for header()
-// Send a header but checks before if we can do so
-function sendHeader ($header) {
-	// Send the header
-	//* DEBUG: */ logDebugMessage(__FUNCTION__ . ': header=' . $header);
-	$GLOBALS['header'][] = trim($header);
-}
-
-// Flushes all headers
-function flushHeaders () {
-	// Is the header already sent?
-	if (headers_sent()) {
-		// Then abort here
-		debug_report_bug(__FUNCTION__, __LINE__, 'Headers already sent!');
-	} // END - if
-
-	// Flush all headers if found
-	if ((isset($GLOBALS['header'])) && (is_array($GLOBALS['header']))) {
-		foreach ($GLOBALS['header'] as $header) {
-			header($header);
-		} // END - foreach
-	} // END - if
-
-	// Mark them as flushed
-	$GLOBALS['header'] = array();
-}
-
 // Wrapper function for chmod()
 // @TODO Do some more sanity check here
 function changeMode ($FQFN, $mode) {
@@ -542,9 +513,9 @@ function removeFile ($FQFN) {
 // Wrapper for $_POST['sel']
 function countPostSelection ($element = 'sel') {
 	// Is it set?
-	if (isPostRequestParameterSet($element)) {
+	if (isPostRequestElementSet($element)) {
 		// Return counted elements
-		return countSelection(postRequestParameter($element));
+		return countSelection(postRequestElement($element));
 	} else {
 		// Return zero if not found
 		return 0;
@@ -561,7 +532,7 @@ function isNicknameUsed ($userid) {
 	// Is the cache there
 	if (!isset($GLOBALS[__FUNCTION__][$userid])) {
 		// Determine it
-		$GLOBALS[__FUNCTION__][$userid] = ((!empty($userid)) && (('' . round($userid) . '') != $userid));
+		$GLOBALS[__FUNCTION__][$userid] = ((!empty($userid)) && (('' . round($userid) . '') != $userid) && ($userid != 'NULL'));
 	} // END - if
 
 	// Return the result
@@ -569,14 +540,14 @@ function isNicknameUsed ($userid) {
 }
 
 // Getter for 'what' value
-function getWhat () {
+function getWhat ($strict = true) {
 	// Default is null
 	$what = NULL;
 
 	// Is the value set?
-	if (isWhatSet(true)) {
+	if (isWhatSet($strict)) {
 		// Then use it
-		$what = $GLOBALS['what'];
+		$what = $GLOBALS['__what'];
 	} // END - if
 
 	// Return it
@@ -585,7 +556,7 @@ function getWhat () {
 
 // Setter for 'what' value
 function setWhat ($newWhat) {
-	$GLOBALS['what'] = SQL_ESCAPE($newWhat);
+	$GLOBALS['__what'] = $newWhat;
 }
 
 // Setter for 'what' from configuration
@@ -600,7 +571,7 @@ function setWhatFromConfig ($configEntry) {
 // Checks wether what is set and optionally aborts on miss
 function isWhatSet ($strict =  false) {
 	// Check for it
-	$isset = isset($GLOBALS['what']);
+	$isset = (isset($GLOBALS['__what']) && (!empty($GLOBALS['__what'])));
 
 	// Should we abort here?
 	if (($strict === true) && ($isset === false)) {
@@ -620,7 +591,7 @@ function getAction ($strict = true) {
 	// Is the value set?
 	if (isActionSet(($strict) && (isHtmlOutputMode()))) {
 		// Then use it
-		$action = $GLOBALS['action'];
+		$action = $GLOBALS['__action'];
 	} // END - if
 
 	// Return it
@@ -629,13 +600,13 @@ function getAction ($strict = true) {
 
 // Setter for 'action' value
 function setAction ($newAction) {
-	$GLOBALS['action'] = SQL_ESCAPE($newAction);
+	$GLOBALS['__action'] = $newAction;
 }
 
 // Checks wether action is set and optionally aborts on miss
 function isActionSet ($strict =  false) {
 	// Check for it
-	$isset = ((isset($GLOBALS['action'])) && (!empty($GLOBALS['action'])));
+	$isset = ((isset($GLOBALS['__action'])) && (!empty($GLOBALS['__action'])));
 
 	// Should we abort here?
 	if (($strict === true) && ($isset === false)) {
@@ -655,7 +626,7 @@ function getModule ($strict = true) {
 	// Is the value set?
 	if (isModuleSet($strict)) {
 		// Then use it
-		$module = $GLOBALS['module'];
+		$module = $GLOBALS['__module'];
 	} // END - if
 
 	// Return it
@@ -665,22 +636,22 @@ function getModule ($strict = true) {
 // Setter for 'module' value
 function setModule ($newModule) {
 	// Secure it and make all modules lower-case
-	$GLOBALS['module'] = SQL_ESCAPE(strtolower($newModule));
+	$GLOBALS['__module'] = strtolower($newModule);
 }
 
 // Checks wether module is set and optionally aborts on miss
 function isModuleSet ($strict =  false) {
 	// Check for it
-	$isset = (!empty($GLOBALS['module']));
+	$isset = ((isset($GLOBALS['__module'])) && (!empty($GLOBALS['__module'])));
 
 	// Should we abort here?
 	if (($strict === true) && ($isset === false)) {
 		// Output backtrace
-		debug_report_bug(__FUNCTION__, __LINE__, 'module is empty.');
+		debug_report_bug(__FUNCTION__, __LINE__, 'Module is empty.');
 	} // END - if
 
 	// Return it
-	return (($isset === true) && ($GLOBALS['module'] != 'unknown')) ;
+	return (($isset === true) && ($GLOBALS['__module'] != 'unknown')) ;
 }
 
 // Getter for 'output_mode' value
@@ -706,7 +677,9 @@ function getScriptOutputMode () {
 
 // Setter for 'output_mode' value
 function setOutputMode ($newOutputMode) {
-	$GLOBALS['output_mode'] = (int) $newOutputMode;
+	//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'output_mode=' . $newOutputMode);
+	$GLOBALS['output_mode']         = (int) $newOutputMode;
+	$GLOBALS['getScriptOutputMode'] = (int) $newOutputMode;
 }
 
 // Checks wether output_mode is set and optionally aborts on miss
@@ -742,8 +715,8 @@ function isBlockModeEnabled () {
 }
 
 /**
- * Wrapper function for addPointsThroughReferalSystem(), you should generally
- * avoid this function and use addPointsThroughReferalSystem() directly and add
+ * Wrapper function for addPointsThroughReferralSystem(), you should generally
+ * avoid this function and use addPointsThroughReferralSystem() directly and add
  * your special payment method entry to points_data instead.
  *
  * @param	$subject	A string-encoded subject for this add
@@ -753,10 +726,10 @@ function isBlockModeEnabled () {
  */
 function addPointsDirectly ($subject, $userid, $points) {
 	// Reset level here
-	initReferalSystem();
+	initReferralSystem();
 
 	// Call more complicated method (due to more parameters)
-	return addPointsThroughReferalSystem($subject, $userid, $points, false, 0, 'DIRECT');
+	return addPointsThroughReferralSystem($subject, $userid, $points, false, 0, 'DIRECT');
 }
 
 // Wrapper for redirectToUrl but URL comes from a configuration entry
@@ -1135,6 +1108,15 @@ function getHttpStatus () {
  * @access  private
  */
 function sendRawRedirect ($url) {
+	// Clear output buffer
+	clearOutputBuffer();
+
+	// Clear own output buffer
+	$GLOBALS['output'] = '';
+
+	// To make redirects working (no content type), output mode must be raw
+	setOutputMode(-1);
+
 	// Send helping header
 	setHttpStatus('302 Found');
 
@@ -1146,14 +1128,14 @@ function sendRawRedirect ($url) {
 
 	// check if running on IIS < 6 with CGI-PHP
 	if ((isset($_SERVER['SERVER_SOFTWARE'])) && (isset($_SERVER['GATEWAY_INTERFACE'])) &&
-		(strpos($_SERVER['GATEWAY_INTERFACE'], 'CGI') !== false) &&
+		(isInString('CGI', $_SERVER['GATEWAY_INTERFACE'])) &&
 		(preg_match('|^Microsoft-IIS/(\d)\.\d$|', trim($_SERVER['SERVER_SOFTWARE']), $matches)) &&
 		($matches[1] < 6)) {
 		// Send the IIS header
-		sendHeader('Refresh: 0;url=' . $url);
+		addHttpHeader('Refresh: 0;url=' . $url);
 	} else {
 		// Send generic header
-		sendHeader('Location: ' . $url);
+		addHttpHeader('Location: ' . $url);
 	}
 
 	// Shutdown here
@@ -1250,6 +1232,12 @@ function getTotalRandomRefidUser () {
 
 // Is given userid valid?
 function isValidUserId ($userid) {
+	// Handle NULL
+	if (is_null($userid)) {
+		// Do not handle this as of below isset() will always return false
+		return false;
+	} // END - if
+
 	// Do we have cache?
 	if (!isset($GLOBALS[__FUNCTION__][$userid])) {
 		// Check it out
@@ -1525,11 +1513,11 @@ function isWhatTitleEnabled () {
 }
 
 // Checks wether stats are enabled
-function ifStatsAreEnabled () {
+function ifInternalStatsEnabled () {
 	// Do we have cache?
 	if (!isset($GLOBALS[__FUNCTION__])) {
 		// Then determine it
-		$GLOBALS[__FUNCTION__] = (getConfig('stats_enabled') == 'Y');
+		$GLOBALS[__FUNCTION__] = (getConfig('internal_stats') == 'Y');
 	} // END - if
 
 	// Return cached value
@@ -1548,8 +1536,8 @@ function isAdminNotificationEnabled () {
 	return $GLOBALS[__FUNCTION__];
 }
 
-// Checks wether random referal id selection is enabled
-function isRandomReferalIdEnabled () {
+// Checks wether random referral id selection is enabled
+function isRandomReferralIdEnabled () {
 	// Do we have cache?
 	if (!isset($GLOBALS[__FUNCTION__])) {
 		// Determine it
@@ -1572,7 +1560,7 @@ function getDefaultLanguage () {
 	return $GLOBALS[__FUNCTION__];
 }
 
-// "Getter" for default referal id
+// "Getter" for default referral id
 function getDefRefid () {
 	// Do we have cache?
 	if (!isset($GLOBALS[__FUNCTION__])) {
@@ -1680,12 +1668,12 @@ function getPrime () {
 	return $GLOBALS[__FUNCTION__];
 }
 
-// "Getter" for encrypt_seperator
-function getEncryptSeperator () {
+// "Getter" for encrypt_separator
+function getEncryptSeparator () {
 	// Do we have cache?
 	if (!isset($GLOBALS[__FUNCTION__])) {
 		// Determine it
-		$GLOBALS[__FUNCTION__] = getConfig('ENCRYPT_SEPERATOR');
+		$GLOBALS[__FUNCTION__] = getConfig('ENCRYPT_SEPARATOR');
 	} // END - if
 
 	// Return cache
@@ -2376,6 +2364,42 @@ function getUrlTlock () {
 	return $GLOBALS[__FUNCTION__];
 }
 
+// "Getter" for title_left
+function getTitleLeft () {
+	// Do we have cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('title_left');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// "Getter" for title_right
+function getTitleRight () {
+	// Do we have cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('title_right');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// "Getter" for title_middle
+function getTitleMiddle () {
+	// Do we have cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('title_middle');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
 // Getter for 'check_double_email'
 function getCheckDoubleEmail () {
 	// Is the cache entry set?
@@ -2424,6 +2448,18 @@ function isDisplayHomeInIndexEnabled () {
 	return $GLOBALS[__FUNCTION__];
 }
 
+// Getter for 'admin_menu_javascript'
+function getAdminMenuJavascript () {
+	// Is the cache entry set?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// No, so determine it
+		$GLOBALS[__FUNCTION__] = getConfig('admin_menu_javascript');
+	} // END - if
+
+	// Return cached entry
+	return $GLOBALS[__FUNCTION__];
+}
+
 // Checks wether proxy configuration is used
 function isProxyUsed () {
 	// Do we have cache?
@@ -2441,7 +2477,7 @@ function ifPostContainsSelections ($element = 'sel') {
 	// Do we have cache?
 	if (!isset($GLOBALS[__FUNCTION__][$element])) {
 		// Determine it
-		$GLOBALS[__FUNCTION__][$element] = ((isPostRequestParameterSet($element)) && (countPostSelection($element) > 0));
+		$GLOBALS[__FUNCTION__][$element] = ((isPostRequestElementSet($element)) && (countPostSelection($element) > 0));
 	} // END - if
 
 	// Return cache
@@ -2505,6 +2541,18 @@ function isDirectPaymentEnabled () {
 	return $GLOBALS[__FUNCTION__];
 }
 
+// Checks wether JavaScript-based admin menu is enabled
+function isAdminMenuJavascriptEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = ((isExtensionInstalledAndNewer('sql_patches', '0.8.7')) && (getConfig('admin_menu_javascript') == 'Y'));
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
 // Wrapper to check if current task is for extension (not update)
 function isExtensionTask ($content) {
 	// Do we have cache?
@@ -2535,6 +2583,18 @@ function isRawOutputMode () {
 	return (getScriptOutputMode() == -1);
 }
 
+// Wrapper to check if output mode is AJAX
+function isAjaxOutputMode () {
+	// Determine it
+	return (getScriptOutputMode() == -2);
+}
+
+// Wrapper to check if output mode is image
+function isImageOutputMode () {
+	// Determine it
+	return (getScriptOutputMode() == -3);
+}
+
 // Wrapper to generate a user email link
 function generateWrappedUserEmailLink ($email) {
 	// Just call the inner function
@@ -2595,10 +2655,10 @@ function createConfigurationTimeSelections ($configEntry, $stamps, $align = 'cen
 // Shortens converting of German comma to Computer's version in POST data
 function convertCommaToDotInPostData ($postEntry) {
 	// Read and convert given entry
-	$postValue = convertCommaToDot(postRequestParameter($postEntry));
+	$postValue = convertCommaToDot(postRequestElement($postEntry));
 
 	// ... and set it again
-	setPostRequestParameter($postEntry, $postValue);
+	setPostRequestElement($postEntry, $postValue);
 }
 
 // Converts German commas to Computer's version in all entries
@@ -2606,7 +2666,7 @@ function convertCommaToDotInPostDataArray ($postEntries) {
 	// Replace german decimal comma with computer decimal dot
 	foreach ($postEntries as $entry) {
 		// Is the entry there?
-		if (isPostRequestParameterSet($entry)) {
+		if (isPostRequestElementSet($entry)) {
 			// Then convert it
 			convertCommaToDotInPostData($entry);
 		} // END - if
@@ -2623,16 +2683,23 @@ function convertCommaToDotInPostDataArray ($postEntries) {
  * @link	http://de.php.net/manual/en/function.floatval.php#92563
  */
 function parseFloat ($floatString){
-    $LocaleInfo = localeconv();
-    $floatString = str_replace($LocaleInfo['mon_thousands_sep'] , '', $floatString);
-    $floatString = str_replace($LocaleInfo['mon_decimal_point'] , '.', $floatString);
-    return floatval($floatString);
+	// Load locale info
+	$LocaleInfo = localeconv();
+
+	// Remove thousand separators
+	$floatString = str_replace($LocaleInfo['mon_thousands_sep'] , '' , $floatString);
+
+	// Convert decimal point
+	$floatString = str_replace($LocaleInfo['mon_decimal_point'] , '.', $floatString);
+
+	// Return float value of converted string
+	return floatval($floatString);
 }
 
 // Generates a YES/NO option list from given default
-function generateYesNoOptionList ($configValue = '') {
+function generateYesNoOptionList ($defaultValue = '') {
 	// Generate it
-	return generateOptionList('/ARRAY/', array('Y', 'N'), array('{--YES--}', '{--NO--}'), $configValue);
+	return generateOptionList('/ARRAY/', array('Y', 'N'), array('{--YES--}', '{--NO--}'), $defaultValue);
 }
 
 // "Getter" for total available receivers
@@ -2656,5 +2723,35 @@ function getTotalUnconfirmedMails ($userid) {
 	return $GLOBALS[__FUNCTION__][$userid];
 }
 
+// Checks wether 'mailer_theme' was found in session
+function isMailerThemeSet () {
+	// Check session
+	return isSessionVariableSet('mailer_theme');
+}
+
+/**
+ * Setter for theme in session (This setter does return the success of
+ * setSession() which is required e.g. for destroySponsorSession().
+ */
+function setMailerTheme ($newTheme) {
+	// Set it in session
+	return setSession('mailer_theme', $newTheme);
+}
+
+/**
+ * Getter for theme from session (This getter does return 'mailer_theme' from
+ * session data or throws an error if not possible
+ */
+function getMailerTheme () {
+	// Is 'mailer_theme' set?
+	if (!isMailerThemeSet()) {
+		// No, then abort here
+		debug_report_bug(__FUNCTION__, __LINE__, 'mailer_theme not set in session. Please fix your code.');
+	} // END - if
+
+	// Return the theme from session
+	return getSession('mailer_theme');
+}
+
 // [EOF]
 ?>