X-Git-Url: https://git.mxchange.org/?p=mailer.git;a=blobdiff_plain;f=inc%2Fwrapper-functions.php;h=2a64684ed44874018d4272f62782baee48a25d5e;hp=f7ef134affe92ecda299c3aa06a43b80a3180055;hb=ffe213c8e3f85119ddd5544214d0de9ecb833d98;hpb=64c8349613addc3da2242c5cd6b99d64e3fb5f8e diff --git a/inc/wrapper-functions.php b/inc/wrapper-functions.php index f7ef134aff..2a64684ed4 100644 --- a/inc/wrapper-functions.php +++ b/inc/wrapper-functions.php @@ -1,7 +1,7 @@ 0) && (!ob_end_clean())) { // Failed! debug_report_bug(__FUNCTION__.': Failed to clean output buffer.'); } // END - if @@ -137,25 +137,10 @@ function decodeString ($str, $decompress = true) { return $str; } -// Smartly adds slashes -function smartAddSlashes ($unquoted) { - // Do we have cache? - if (!isset($GLOBALS['smart_addslashes'][$unquoted])) { - // Remove slashe - $unquoted = str_replace("\\", '', $unquoted); - - // Put it in cache and add slashes - $GLOBALS['smart_addslashes'][$unquoted] = addslashes($unquoted); - } // END - if - - // Return result - return $GLOBALS['smart_addslashes'][$unquoted]; -} - // Decode entities in a nicer way -function decodeEntities ($str) { +function decodeEntities ($str, $quote = ENT_NOQUOTES) { // Decode the entities to UTF-8 now - $decodedString = html_entity_decode($str, ENT_NOQUOTES, 'UTF-8'); + $decodedString = html_entity_decode($str, $quote, 'UTF-8'); // Return decoded string return $decodedString; @@ -166,13 +151,13 @@ function merge_array ($array1, $array2) { // Are both an array? if ((!is_array($array1)) && (!is_array($array2))) { // Both are not arrays - debug_report_bug(__FUNCTION__ . ': No arrays provided!'); + debug_report_bug(__FUNCTION__, __LINE__, 'No arrays provided!'); } elseif (!is_array($array1)) { // Left one is not an array - debug_report_bug(sprintf("[%s:%s] array1 is not an array. array != %s", __FUNCTION__, __LINE__, gettype($array1))); + debug_report_bug(__FILE__, __LINE__, sprintf("array1 is not an array. array != %s", gettype($array1))); } elseif (!is_array($array2)) { // Right one is not an array - debug_report_bug(sprintf("[%s:%s] array2 is not an array. array != %s", __FUNCTION__, __LINE__, gettype($array2))); + debug_report_bug(__FILE__, __LINE__, sprintf("array2 is not an array. array != %s", gettype($array2))); } // Merge all together @@ -185,7 +170,13 @@ function isFileReadable ($FQFN) { if (!isset($GLOBALS['file_readable'][$FQFN])) { // Check all... $GLOBALS['file_readable'][$FQFN] = ((file_exists($FQFN)) && (is_file($FQFN)) && (is_readable($FQFN))); - } // END - if + + // Debug message + //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'file=' . basename($FQFN) . ' - CHECK! (' . intval($GLOBALS['file_readable'][$FQFN]) . ')'); + } else { + // Cache used + //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'file=' . basename($FQFN) . ' - CACHE! (' . intval($GLOBALS['file_readable'][$FQFN]) . ')'); + } // Return result return $GLOBALS['file_readable'][$FQFN]; @@ -237,12 +228,12 @@ function detectRemoteHostname () { } // "Getter" for user agent -function detectUserAgent () { +function detectUserAgent ($alwaysReal = false) { // Get remote ip from environment $userAgent = getenv('HTTP_USER_AGENT'); // Is removeip installed? - if (isExtensionActive('removeip')) { + if ((isExtensionActive('removeip')) && ($alwaysReal === false)) { // Then anonymize it $userAgent = getAnonymousUserAgent($userAgent); } // END - if @@ -266,16 +257,33 @@ function detectReferer () { return $referer; } +// "Getter" for request URI +function detectRequestUri () { + // Return it + return (getenv('REQUEST_URI')); +} + +// "Getter" for query string +function detectQueryString () { + return str_replace('&', '&', (getenv('QUERY_STRING'))); +} + +// "Getter" for SERVER_NAME +function detectServerName () { + // Return it + return (getenv('SERVER_NAME')); +} + // Check wether we are installing function isInstalling () { // Determine wether we are installing - if (!isset($GLOBALS['mxchange_installing'])) { + if (!isset($GLOBALS['mailer_installing'])) { // Check URL (css.php/js.php need this) - $GLOBALS['mxchange_installing'] = isGetRequestElementSet('installing'); + $GLOBALS['mailer_installing'] = isGetRequestParameterSet('installing'); } // END - if // Return result - return $GLOBALS['mxchange_installing']; + return $GLOBALS['mailer_installing']; } // Check wether this script is installed @@ -286,14 +294,20 @@ function isInstalled () { $GLOBALS['is_installed'] = ( ( // First is config - getConfig('MXCHANGE_INSTALLED') == 'Y' + ( + ( + isConfigEntrySet('MXCHANGE_INSTALLED') + ) && ( + getConfig('MXCHANGE_INSTALLED') == 'Y' + ) + ) ) || ( // New config file found and loaded - isIncludeReadable(getConfig('CACHE_PATH') . 'config-local.php') + isIncludeReadable(getCachePath() . 'config-local.php') ) || ( ( // New config file found, but not yet read - isIncludeReadable(getConfig('CACHE_PATH') . 'config-local.php') + isIncludeReadable(getCachePath() . 'config-local.php') ) && ( ( // Only new config file is found @@ -312,7 +326,14 @@ function isInstalled () { // Check wether an admin is registered function isAdminRegistered () { - return (getConfig('ADMIN_REGISTERED') == 'Y'); + // Is cache set? + if (!isset($GLOBALS['is_admin_registered'])) { + // Simply check it + $GLOBALS['is_admin_registered'] = ((isConfigEntrySet('ADMIN_REGISTERED')) && (getConfig('ADMIN_REGISTERED') == 'Y')); + } // END - if + + // Return it + return $GLOBALS['is_admin_registered']; } // Checks wether the reset mode is active @@ -323,14 +344,38 @@ function isResetModeEnabled () { // Checks wether the debug mode is enabled function isDebugModeEnabled () { - // Simply check it - return (getConfig('DEBUG_MODE') == 'Y'); + // Is cache set? + if (!isset($GLOBALS['is_debugmode_enabled'])) { + // Simply check it + $GLOBALS['is_debugmode_enabled'] = ((isConfigEntrySet('DEBUG_MODE')) && (getConfig('DEBUG_MODE') == 'Y')); + } // END - if + + // Return it + return $GLOBALS['is_debugmode_enabled']; +} + +// Checks wether SQL debugging is enabled +function isSqlDebuggingEnabled () { + // Is cache set? + if (!isset($GLOBALS['is_sql_debug_enabled'])) { + // Determine if SQL debugging is enabled + $GLOBALS['is_sql_debug_enabled'] = ((isConfigEntrySet('DEBUG_SQL')) && (getConfig('DEBUG_SQL') == 'Y')); + } // END - if + + // Return it + return $GLOBALS['is_sql_debug_enabled']; } // Checks wether we shall debug regular expressions -function isDebugRegExpressionEnabled () { - // Simply check it - return (getConfig('DEBUG_REGEX') == 'Y'); +function isDebugRegularExpressionEnabled () { + // Is cache set? + if (!isset($GLOBALS['is_regular_exp_debug_enabled'])) { + // Simply check it + $GLOBALS['is_regular_exp_debug_enabled'] = ((isConfigEntrySet('DEBUG_REGEX')) && (getConfig('DEBUG_REGEX') == 'Y')); + } // END - if + + // Return it + return $GLOBALS['is_regular_exp_debug_enabled']; } // Checks wether the cache instance is valid @@ -348,19 +393,19 @@ function copyFileVerified ($source, $dest, $chmod = '') { // Is the source file there? if (!isFileReadable($source)) { // Then abort here - debug_report_bug('Cannot read from source file ' . basename($source) . '.'); + debug_report_bug(__FUNCTION__, __LINE__, 'Cannot read from source file ' . basename($source) . '.'); } // END - if // Is the target directory there? if (!isDirectory(dirname($dest))) { // Then abort here - debug_report_bug('Cannot find directory ' . str_replace(getConfig('PATH'), '', dirname($dest)) . '.'); + debug_report_bug(__FUNCTION__, __LINE__, 'Cannot find directory ' . str_replace(getPath(), '', dirname($dest)) . '.'); } // END - if // Now try to copy it if (!copy($source, $dest)) { // Something went wrong - debug_report_bug('copy() has failed to copy the file.'); + debug_report_bug(__FUNCTION__, __LINE__, 'copy() has failed to copy the file.'); } else { // Reset cache $GLOBALS['file_readable'][$dest] = true; @@ -382,14 +427,28 @@ function copyFileVerified ($source, $dest, $chmod = '') { // 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('Headers already sent!'); + debug_report_bug(__FUNCTION__, __LINE__, 'Headers already sent!'); } // END - if - // Send the header - header(trim($header)); + // 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() @@ -398,7 +457,7 @@ function changeMode ($FQFN, $mode) { // Is the file/directory there? if ((!isFileReadable($FQFN)) && (!isDirectory($FQFN))) { // Neither, so abort here - debug_report_bug('Cannot chmod() on ' . basename($FQFN) . '.'); + debug_report_bug(__FUNCTION__, __LINE__, 'Cannot chmod() on ' . basename($FQFN) . '.'); } // END - if // Try to set them @@ -422,8 +481,15 @@ function removeFile ($FQFN) { } // Wrapper for $_POST['sel'] -function countPostSelection () { - return countSelection(postRequestElement('sel')); +function countPostSelection ($element = 'sel') { + // Is it set? + if (isPostRequestParameterSet($element)) { + // Return counted elements + return countSelection(postRequestParameter($element)); + } else { + // Return zero if not found + return 0; + } } // Checks wether the config-local.php is loaded @@ -437,15 +503,15 @@ function isNicknameUsed ($userid) { $isUsed = false; // Is the cache there - if (isset($GLOBALS['cache_probe_nicknames'][$userid])) { + if (isset($GLOBALS['is_nickname_used'][$userid])) { // Then use it - $isUsed = $GLOBALS['cache_probe_nicknames'][$userid]; + $isUsed = $GLOBALS['is_nickname_used'][$userid]; } else { // Determine it - $isUsed = ((isExtensionActive('nickname')) && (('' . round($userid) . '') != $userid)); + $isUsed = (('' . round($userid) . '') != $userid); // And write it to the cache - $GLOBALS['cache_probe_nicknames'][$userid] = $isUsed; + $GLOBALS['is_nickname_used'][$userid] = $isUsed; } // Return the result @@ -482,14 +548,14 @@ function setWhatFromConfig ($configEntry) { } // Checks wether what is set and optionally aborts on miss -function isWhatSet ($abortOnMiss = false) { +function isWhatSet ($strict = false) { // Check for it - $isset = (isset($GLOBALS['what'])); + $isset = isset($GLOBALS['what']); // Should we abort here? - if (($abortOnMiss === true) && ($isset === false)) { + if (($strict === true) && ($isset === false)) { // Output backtrace - debug_report_bug('what is empty.'); + debug_report_bug(__FUNCTION__, __LINE__, 'what is empty.'); } // END - if // Return it @@ -497,12 +563,12 @@ function isWhatSet ($abortOnMiss = false) { } // Getter for 'action' value -function getAction () { +function getAction ($strict = true) { // Default is null $action = null; // Is the value set? - if (isActionSet(true)) { + if (isActionSet(($strict) && (getOutputMode() == 0))) { // Then use it $action = $GLOBALS['action']; } // END - if @@ -517,14 +583,14 @@ function setAction ($newAction) { } // Checks wether action is set and optionally aborts on miss -function isActionSet ($abortOnMiss = false) { +function isActionSet ($strict = false) { // Check for it - $isset = (isset($GLOBALS['action'])); + $isset = ((isset($GLOBALS['action'])) && (!empty($GLOBALS['action']))); // Should we abort here? - if (($abortOnMiss === true) && ($isset === false)) { + if (($strict === true) && ($isset === false)) { // Output backtrace - debug_report_bug('action is empty.'); + debug_report_bug(__FUNCTION__, __LINE__, 'action is empty.'); } // END - if // Return it @@ -532,12 +598,12 @@ function isActionSet ($abortOnMiss = false) { } // Getter for 'module' value -function getModule () { +function getModule ($strict = true) { // Default is null $module = null; // Is the value set? - if (isModuleSet(true)) { + if (isModuleSet($strict)) { // Then use it $module = $GLOBALS['module']; } // END - if @@ -553,21 +619,18 @@ function setModule ($newModule) { } // Checks wether module is set and optionally aborts on miss -function isModuleSet ($abortOnMiss = false) { +function isModuleSet ($strict = false) { // Check for it $isset = (!empty($GLOBALS['module'])); // Should we abort here? - if (($abortOnMiss === true) && ($isset === false)) { + if (($strict === true) && ($isset === false)) { // Output backtrace - print '
';
-		debug_print_backtrace();
-		die('= $version));
+	} else {
+		// Cache hits should be incremented twice
+		incrementStatsEntry('cache_hits', 2);
+	}
+
 	// Return it
-	return ((isExtensionInstalled($ext_name)) && (getExtensionVersion($ext_name) >= $version));
+	//* DEBUG: */ debugOutput(__FUNCTION__.':'.$ext_name.'=>'.$version.':'.intval($GLOBALS['ext_installed_newer'][$ext_name][$version]));
+	return $GLOBALS['ext_installed_newer'][$ext_name][$version];
 }
 
 // Wrapper function for checking if extension is installed and older than given version
 function isExtensionInstalledAndOlder ($ext_name, $version) {
+	// Is an cache entry found?
+	if (!isset($GLOBALS['ext_installed_older'][$ext_name][$version])) {
+		$GLOBALS['ext_installed_older'][$ext_name][$version] = ((isExtensionInstalled($ext_name)) && (isExtensionOlder($ext_name, $version)));
+	} else {
+		// Cache hits should be incremented twice
+		incrementStatsEntry('cache_hits', 2);
+	}
+
 	// Return it
-	return ((isExtensionInstalled($ext_name)) && (isExtensionOlder($ext_name, $version)));
+	//* DEBUG: */ debugOutput(__FUNCTION__.':'.$ext_name.'<'.$version.':'.intval($GLOBALS['ext_installed_older'][$ext_name][$version]));
+	return $GLOBALS['ext_installed_older'][$ext_name][$version];
 }
 
 // Set username
@@ -656,6 +754,13 @@ function setUsername ($userName) {
 
 // Get username
 function getUsername () {
+	// User name set?
+	if (!isset($GLOBALS['username'])) {
+		// No, so it has to be a guest
+		$GLOBALS['username'] = '{--USERNAME_GUEST--}';
+	} // END - if
+
+	// Return it
 	return $GLOBALS['username'];
 }
 
@@ -673,16 +778,14 @@ function isInstallationPhase () {
 
 // Checks wether the extension demo is actuve and the admin login is demo (password needs to be demo, too!)
 function isDemoModeActive () {
-	return ((isExtensionActive('demo')) && (getSession('admin_login') == 'demo'));
-}
-
-// Wrapper function to redirect to de-refered URL
-function redirectToDereferedUrl ($URL) {
-	// De-refer the URL
-	$URL = generateDerefererUrl($URL);
+	// Is cache set?
+	if (!isset($GLOBALS['demo_mode_active'])) {
+		// Simply check it
+		$GLOBALS['demo_mode_active'] = ((isExtensionActive('demo')) && (getAdminLogin(getSession('admin_id')) == 'demo'));
+	} // END - if
 
-	// Redirect to to
-	redirectToUrl($URL);
+	// Return it
+	return $GLOBALS['demo_mode_active'];
 }
 
 // Getter for PHP caching value
@@ -690,5 +793,747 @@ function getPhpCaching () {
 	return $GLOBALS['php_caching'];
 }
 
+// Checks wether the admin hash is set
+function isAdminHashSet ($adminId) {
+	// Is the array there?
+	if (!isset($GLOBALS['cache_array']['admin'])) {
+		// Missing array should be reported
+		debug_report_bug(__FUNCTION__, __LINE__, 'Cache not set.');
+	} // END - if
+
+	// Check for admin hash
+	return isset($GLOBALS['cache_array']['admin']['password'][$adminId]);
+}
+
+// Setter for admin hash
+function setAdminHash ($adminId, $hash) {
+	$GLOBALS['cache_array']['admin']['password'][$adminId] = $hash;
+}
+
+// Init user data array
+function initUserData () {
+	// User id should not be zero
+	if (getCurrentUserId() < 1) debug_report_bug(__FUNCTION__.': User id is zero.');
+
+	// Init the user
+	$GLOBALS['user_data'][getCurrentUserId()] = array();
+}
+
+// Getter for user data
+function getUserData ($column) {
+	// User id should not be zero
+	if (getCurrentUserId() < 1) debug_report_bug(__FUNCTION__.': User id is zero.');
+
+	// Return the value
+	return $GLOBALS['user_data'][getCurrentUserId()][$column];
+}
+
+// Geter for whole user data array
+function getUserDataArray () {
+	// Get user id
+	$uid = getCurrentUserId();
+
+	// User id should not be zero
+	if ($uid < 1) debug_report_bug(__FUNCTION__.': User id is zero.');
+
+	// Get the whole array if found
+	if (isset($GLOBALS['user_data'][$uid])) {
+		// Found, so return it
+		return $GLOBALS['user_data'][$uid];
+	} else {
+		// Return empty array
+		return array();
+	}
+}
+
+// Checks if the user data is valid, this may indicate that the user has logged
+// in, but you should use isMember() if you want to find that out.
+function isUserDataValid () {
+	// User id should not be zero so abort here
+	if (!isCurrentUserIdSet()) return false;
+
+	// Is it cached?
+	if (!isset($GLOBALS['is_userdata_valid'][getCurrentUserId()])) {
+		// Determine it
+		$GLOBALS['is_userdata_valid'][getCurrentUserId()] = ((isset($GLOBALS['user_data'][getCurrentUserId()])) && (count($GLOBALS['user_data'][getCurrentUserId()]) > 1));
+	} // END - if
+
+	// Return the result
+	return $GLOBALS['is_userdata_valid'][getCurrentUserId()];
+}
+
+// Setter for current userid
+function setCurrentUserId ($userid) {
+	// Set userid
+	$GLOBALS['current_userid'] = bigintval($userid);
+
+	// Unset it to re-determine the actual state
+	unset($GLOBALS['is_userdata_valid'][$userid]);
+}
+
+// Getter for current userid
+function getCurrentUserId () {
+	// Userid must be set before it can be used
+	if (!isCurrentUserIdSet()) {
+		// Not set
+		debug_report_bug(__FUNCTION__, __LINE__, 'User id is not set.');
+	} // END - if
+
+	// Return the userid
+	return $GLOBALS['current_userid'];
+}
+
+// Checks if current userid is set
+function isCurrentUserIdSet () {
+	return ((isset($GLOBALS['current_userid'])) && ($GLOBALS['current_userid'] > 0));
+}
+
+// Checks wether we are debugging template cache
+function isDebuggingTemplateCache () {
+	// Do we have cache?
+	if (!isset($GLOBALS['debug_template_cache'])) {
+		// Determine it
+		$GLOBALS['debug_template_cache'] = (getConfig('DEBUG_TEMPLATE_CACHE') == 'Y');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['debug_template_cache'];
+}
+
+// Wrapper for fetchUserData() and getUserData() calls
+function getFetchedUserData ($keyColumn, $userid, $valueColumn) {
+	// Is it cached?
+	if (!isset($GLOBALS['user_data_cache'][$userid][$keyColumn][$valueColumn])) {
+		// Default is 'guest'
+		$data = '{--USERNAME_GUEST--}';
+
+		// Can we fetch the user data?
+		if (($userid > 0) && (fetchUserData($userid, $keyColumn))) {
+			// Now get the data back
+			$data = getUserData($valueColumn);
+		} // END - if
+
+		// Cache it
+		$GLOBALS['user_data_cache'][$userid][$keyColumn][$valueColumn] = $data;
+	} // END - if
+
+	// Return it
+	return $GLOBALS['user_data_cache'][$userid][$keyColumn][$valueColumn];
+}
+
+// Wrapper for strpos() to ease porting from deprecated ereg() function
+function isInString ($needle, $haystack) {
+	//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'needle=' . $needle . ', haystack=' . $haystack . ', returned=' . intval(strpos($haystack, $needle) !== false));
+	return (strpos($haystack, $needle) !== false);
+}
+
+// Wrapper for strpos() to ease porting from deprecated eregi() function
+// This function is case-insensitive
+function isInStringIgnoreCase ($needle, $haystack) {
+	return (isInString(strtolower($needle), strtolower($haystack)));
+}
+
+// Wrapper to check for if fatal errors where detected
+function ifFatalErrorsDetected () {
+	// Just call the inner function
+	return (getTotalFatalErrors() > 0);
+}
+
+// Setter for HTTP status
+function setHttpStatus ($status) {
+	$GLOBALS['http_status'] = (string) $status;
+}
+
+// Getter for HTTP status
+function getHttpStatus () {
+	return $GLOBALS['http_status'];
+}
+
+/**
+ * Send a HTTP redirect to the browser. This function was taken from DokuWiki
+ * (GNU GPL 2; http://www.dokuwiki.org) and modified to fit into mailer project.
+ *
+ * ----------------------------------------------------------------------------
+ * If you want to redirect, please use redirectToUrl(); instead
+ * ----------------------------------------------------------------------------
+ *
+ * Works arround Microsoft IIS cookie sending bug. Does exit the script.
+ *
+ * @link    http://support.microsoft.com/kb/q176113/
+ * @author  Andreas Gohr 
+ * @access  private
+ */
+function sendRawRedirect ($url) {
+	// always close the session
+	session_write_close();
+
+	// Revert entity &
+	$url = str_replace('&', '&', $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) &&
+		(preg_match('|^Microsoft-IIS/(\d)\.\d$|', trim($_SERVER['SERVER_SOFTWARE']), $matches)) &&
+		($matches[1] < 6)) {
+		// Send the IIS header
+		sendHeader('Refresh: 0;url=' . $url);
+	} else {
+		// Send generic header
+		sendHeader('Location: ' . $url);
+	}
+
+	// Shutdown here
+	shutdown();
+}
+
+// Determines the country of the given user id
+function determineCountry ($userid) {
+	// Default is 'invalid'
+	$country = 'invalid';
+
+	// Is extension country active?
+	if (isExtensionActive('country')) {
+		// Determine the right country code through the country id
+		$id = getUserData('country_code');
+
+		// Then handle it over
+		$country = generateCountryInfo($id);
+	} else {
+		// Get raw code from user data
+		$country = getUserData('country');
+	}
+
+	// Return it
+	return $country;
+}
+
+// "Getter" for total confirmed user accounts
+function getTotalConfirmedUser () {
+	// Is it cached?
+	if (!isset($GLOBALS['total_confirmed_users'])) {
+		// Then do it
+		$GLOBALS['total_confirmed_users'] = countSumTotalData('CONFIRMED', 'user_data', 'userid', 'status', true);
+	} // END - if
+
+	// Return cached value
+	return $GLOBALS['total_confirmed_users'];
+}
+
+// Is given userid valid?
+function isValidUserId ($userid) {
+	// Do we have cache?
+	if (!isset($GLOBALS['is_valid_userid'][$userid])) {
+		// Check it out
+		$GLOBALS['is_valid_userid'][$userid] = ((!is_null($userid)) && (!empty($userid)) && ($userid > 0));
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['is_valid_userid'][$userid];
+}
+
+// Encodes entities
+function encodeEntities ($str) {
+	// Secure it first
+	$str = secureString($str);
+
+	// Encode dollar sign as well
+	$str = str_replace('$', '$', $str);
+
+	// Return it
+	return $str;
+}
+
+// "Getter" for date from patch_ctime
+function getDateFromPatchTime () {
+	// Is it cached?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Then set it
+		$GLOBALS[__FUNCTION__] = generateDateTime(getConfig('patch_ctime'), '5');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for current year (default)
+function getYear ($timestamp = null) {
+	// Is it cached?
+	if (!isset($GLOBALS['year'][$timestamp])) {
+		// null is time()
+		if (is_null($timestamp)) $timestamp = time();
+
+		// Then create it
+		$GLOBALS['year'][$timestamp] = date('Y', $timestamp);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['year'][$timestamp];
+}
+
+// Getter for current month (default)
+function getMonth ($timestamp = null) {
+	// Is it cached?
+	if (!isset($GLOBALS['month'][$timestamp])) {
+		// null is time()
+		if (is_null($timestamp)) $timestamp = time();
+
+		// Then create it
+		$GLOBALS['month'][$timestamp] = date('m', $timestamp);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['month'][$timestamp];
+}
+
+// Getter for current day (default)
+function getDay ($timestamp = null) {
+	// Is it cached?
+	if (!isset($GLOBALS['day'][$timestamp])) {
+		// null is time()
+		if (is_null($timestamp)) $timestamp = time();
+
+		// Then create it
+		$GLOBALS['day'][$timestamp] = date('d', $timestamp);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['day'][$timestamp];
+}
+
+// Getter for current week (default)
+function getWeek ($timestamp = null) {
+	// Is it cached?
+	if (!isset($GLOBALS['week'][$timestamp])) {
+		// null is time()
+		if (is_null($timestamp)) $timestamp = time();
+
+		// Then create it
+		$GLOBALS['week'][$timestamp] = date('W', $timestamp);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['week'][$timestamp];
+}
+
+// Getter for current short_hour (default)
+function getShortHour ($timestamp = null) {
+	// Is it cached?
+	if (!isset($GLOBALS['short_hour'][$timestamp])) {
+		// null is time()
+		if (is_null($timestamp)) $timestamp = time();
+
+		// Then create it
+		$GLOBALS['short_hour'][$timestamp] = date('G', $timestamp);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['short_hour'][$timestamp];
+}
+
+// Getter for current long_hour (default)
+function getLongHour ($timestamp = null) {
+	// Is it cached?
+	if (!isset($GLOBALS['long_hour'][$timestamp])) {
+		// null is time()
+		if (is_null($timestamp)) $timestamp = time();
+
+		// Then create it
+		$GLOBALS['long_hour'][$timestamp] = date('H', $timestamp);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['long_hour'][$timestamp];
+}
+
+// Getter for current second (default)
+function getSecond ($timestamp = null) {
+	// Is it cached?
+	if (!isset($GLOBALS['second'][$timestamp])) {
+		// null is time()
+		if (is_null($timestamp)) $timestamp = time();
+
+		// Then create it
+		$GLOBALS['second'][$timestamp] = date('s', $timestamp);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['second'][$timestamp];
+}
+
+// Getter for current minute (default)
+function getMinute ($timestamp = null) {
+	// Is it cached?
+	if (!isset($GLOBALS['minute'][$timestamp])) {
+		// null is time()
+		if (is_null($timestamp)) $timestamp = time();
+
+		// Then create it
+		$GLOBALS['minute'][$timestamp] = date('i', $timestamp);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['minute'][$timestamp];
+}
+
+// Checks wether the title decoration is enabled
+function isTitleDecorationEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['title_deco_enabled'])) {
+		// Just check it
+		$GLOBALS['title_deco_enabled'] = (getConfig('enable_title_deco') == 'Y');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['title_deco_enabled'];
+}
+
+// Checks wether filter usage updates are enabled (expensive queries!)
+function isFilterUsageUpdateEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['filter_usage_updates'])) {
+		// Determine it
+		$GLOBALS['filter_usage_updates'] = ((isExtensionInstalledAndNewer('sql_patches', '0.6.0')) && (isConfigEntrySet('update_filter_usage')) && (getConfig('update_filter_usage') == 'Y'));
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['filter_usage_updates'];
+}
+
+// Checks wether debugging of weekly resets is enabled
+function isWeeklyResetDebugEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['weekly_reset_debug'])) {
+		// Determine it
+		$GLOBALS['weekly_reset_debug'] = ((isConfigEntrySet('DEBUG_WEEKLY')) && (getConfig('DEBUG_WEEKLY') == 'Y'));
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['weekly_reset_debug'];
+}
+
+// Checks wether debugging of monthly resets is enabled
+function isMonthlyResetDebugEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['monthly_reset_debug'])) {
+		// Determine it
+		$GLOBALS['monthly_reset_debug'] = ((isConfigEntrySet('DEBUG_MONTHLY')) && (getConfig('DEBUG_MONTHLY') == 'Y'));
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['monthly_reset_debug'];
+}
+
+// Checks wether displaying of debug SQLs are enabled
+function isDisplayDebugSqlEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['display_debug_sql'])) {
+		// Determine it
+		$GLOBALS['display_debug_sql'] = ((isExtensionInstalledAndNewer('other', '0.2.2')) && (getConfig('display_debug_sqls') == 'Y'));
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['display_debug_sql'];
+}
+
+// Checks wether module title is enabled
+function isModuleTitleEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['mod_title_enabled'])) {
+		// Determine it
+		$GLOBALS['mod_title_enabled'] = (getConfig('enable_mod_title') == 'Y');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['mod_title_enabled'];
+}
+
+// Checks wether what title is enabled
+function isWhatTitleEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['mod_title_enabled'])) {
+		// Determine it
+		$GLOBALS['mod_title_enabled'] = (getConfig('enable_what_title') == 'Y');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['mod_title_enabled'];
+}
+
+// Checks wether stats are enabled
+function ifStatsAreEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['stats_enabled'])) {
+		// Then determine it
+		$GLOBALS['stats_enabled'] = (getConfig('stats_enabled') == 'Y');
+	} // END - if
+
+	// Return cached value
+	return $GLOBALS['stats_enabled'];
+}
+
+// Checks wether admin-notification of certain user actions is enabled
+function isAdminNotificationEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['admin_notification_enabled'])) {
+		// Determine it
+		$GLOBALS['admin_notification_enabled'] = (getConfig('admin_notify') == 'Y');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['admin_notification_enabled'];
+}
+
+// Checks wether random referal id selection is enabled
+function isRandomReferalIdEnabled () {
+	// Do we have cache?
+	if (!isset($GLOBALS['select_user_zero_refid'])) {
+		// Determine it
+		$GLOBALS['select_user_zero_refid'] = (getConfig('select_user_zero_refid') == 'Y');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['select_user_zero_refid'];
+}
+
+// "Getter" for default language
+function getDefaultLanguage () {
+	// Do we have cache?
+	if (!isset($GLOBALS['default_language'])) {
+		// Determine it
+		$GLOBALS['default_language'] = getConfig('DEFAULT_LANG');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['default_language'];
+}
+
+// "Getter" for path
+function getPath () {
+	// Do we have cache?
+	if (!isset($GLOBALS['path'])) {
+		// Determine it
+		$GLOBALS['path'] = getConfig('PATH');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['path'];
+}
+
+// "Getter" for url
+function getUrl () {
+	// Do we have cache?
+	if (!isset($GLOBALS['url'])) {
+		// Determine it
+		$GLOBALS['url'] = getConfig('URL');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['url'];
+}
+
+// "Getter" for cache_path
+function getCachePath () {
+	// Do we have cache?
+	if (!isset($GLOBALS['cache_path'])) {
+		// Determine it
+		$GLOBALS['cache_path'] = getConfig('CACHE_PATH');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['cache_path'];
+}
+
+// "Getter" for secret_key
+function getSecretKey () {
+	// Do we have cache?
+	if (!isset($GLOBALS['secret_key'])) {
+		// Determine it
+		$GLOBALS['secret_key'] = getConfig('secret_key');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['secret_key'];
+}
+
+// "Getter" for master_salt
+function getMasterSalt () {
+	// Do we have cache?
+	if (!isset($GLOBALS['master_salt'])) {
+		// Determine it
+		$GLOBALS['master_salt'] = getConfig('master_salt');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['master_salt'];
+}
+
+// "Getter" for prime
+function getPrime () {
+	// Do we have cache?
+	if (!isset($GLOBALS['prime'])) {
+		// Determine it
+		$GLOBALS['prime'] = getConfig('_PRIME');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['prime'];
+}
+
+// "Getter" for encrypt_seperator
+function getEncryptSeperator () {
+	// Do we have cache?
+	if (!isset($GLOBALS['encrypt_seperator'])) {
+		// Determine it
+		$GLOBALS['encrypt_seperator'] = getConfig('ENCRYPT_SEPERATOR');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['encrypt_seperator'];
+}
+
+// "Getter" for mysql_prefix
+function getMysqlPrefix () {
+	// Do we have cache?
+	if (!isset($GLOBALS['mysql_prefix'])) {
+		// Determine it
+		$GLOBALS['mysql_prefix'] = getConfig('_MYSQL_PREFIX');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['mysql_prefix'];
+}
+
+// "Getter" for salt_length
+function getSaltLength () {
+	// Do we have cache?
+	if (!isset($GLOBALS['salt_length'])) {
+		// Determine it
+		$GLOBALS['salt_length'] = getConfig('salt_length');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['salt_length'];
+}
+
+// "Getter" for output_mode
+function getCachedOutputMode () {
+	// Do we have cache?
+	if (!isset($GLOBALS['cached_output_mode'])) {
+		// Determine it
+		$GLOBALS['cached_output_mode'] = getConfig('OUTPUT_MODE');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['cached_output_mode'];
+}
+
+// "Getter" for full_version
+function getFullVersion () {
+	// Do we have cache?
+	if (!isset($GLOBALS['full_version'])) {
+		// Determine it
+		$GLOBALS['full_version'] = getConfig('FULL_VERSION');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['full_version'];
+}
+
+// "Getter" for title
+function getTitle () {
+	// Do we have cache?
+	if (!isset($GLOBALS['title'])) {
+		// Determine it
+		$GLOBALS['title'] = getConfig('TITLE');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['title'];
+}
+
+// "Getter" for curr_svn_revision
+function getCurrSvnRevision () {
+	// Do we have cache?
+	if (!isset($GLOBALS['curr_svn_revision'])) {
+		// Determine it
+		$GLOBALS['curr_svn_revision'] = getConfig('CURR_SVN_REVISION');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['curr_svn_revision'];
+}
+
+// "Getter" for server_url
+function getServerUrl () {
+	// Do we have cache?
+	if (!isset($GLOBALS['server_url'])) {
+		// Determine it
+		$GLOBALS['server_url'] = getConfig('SERVER_URL');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['server_url'];
+}
+
+// "Getter" for mt_word
+function getMtWord () {
+	// Do we have cache?
+	if (!isset($GLOBALS['mt_word'])) {
+		// Determine it
+		$GLOBALS['mt_word'] = getConfig('mt_word');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['mt_word'];
+}
+
+// "Getter" for main_title
+function getMainTitle () {
+	// Do we have cache?
+	if (!isset($GLOBALS['main_title'])) {
+		// Determine it
+		$GLOBALS['main_title'] = getConfig('MAIN_TITLE');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['main_title'];
+}
+
+// "Getter" for file_hash
+function getFileHash () {
+	// Do we have cache?
+	if (!isset($GLOBALS['file_hash'])) {
+		// Determine it
+		$GLOBALS['file_hash'] = getConfig('file_hash');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['file_hash'];
+}
+
+// "Getter" for pass_scramble
+function getPassScramble () {
+	// Do we have cache?
+	if (!isset($GLOBALS['pass_scramble'])) {
+		// Determine it
+		$GLOBALS['pass_scramble'] = getConfig('pass_scramble');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['pass_scramble'];
+}
+
+// "Getter" for ap_inactive_since
+function getApInactiveSince () {
+	// Do we have cache?
+	if (!isset($GLOBALS['ap_inactive_since'])) {
+		// Determine it
+		$GLOBALS['ap_inactive_since'] = getConfig('ap_inactive_since');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS['ap_inactive_since'];
+}
+
 // [EOF]
 ?>