* -------------------------------------------------------------------- *
* 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 *
}
// 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;
}
// 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
// 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
// Checks wether the cache instance is valid
function isCacheInstanceValid () {
- return ((isset($GLOBALS['cache_instance'])) && (is_object($GLOBALS['cache_instance'])));
+ // Do we have cache?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // Determine it
+ $GLOBALS[__FUNCTION__] = ((isset($GLOBALS['cache_instance'])) && (is_object($GLOBALS['cache_instance'])));
+ } // END - if
+
+ // Return cache
+ return $GLOBALS[__FUNCTION__];
}
// Copies a file from source to destination and verifies if that goes fine.
// 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;
// Is the cache there
if (!isset($GLOBALS[__FUNCTION__][$userid])) {
// Determine it
- $GLOBALS[__FUNCTION__][$userid] = (('' . round($userid) . '') != $userid);
+ $GLOBALS[__FUNCTION__][$userid] = ((!empty($userid)) && (('' . round($userid) . '') != $userid) && ($userid != 'NULL'));
} // END - if
// Return the result
// Getter for 'what' value
function getWhat () {
// Default is null
- $what = null;
+ $what = NULL;
// Is the value set?
if (isWhatSet(true)) {
// Getter for 'action' value
function getAction ($strict = true) {
// Default is null
- $action = null;
+ $action = NULL;
// Is the value set?
if (isActionSet(($strict) && (isHtmlOutputMode()))) {
// Getter for 'module' value
function getModule ($strict = true) {
// Default is null
- $module = null;
+ $module = NULL;
// Is the value set?
if (isModuleSet($strict)) {
// 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
// Do we have cache?
if (!isset($GLOBALS[__FUNCTION__])) {
// Default is null
- $output_mode = null;
+ $output_mode = NULL;
// Is the value set?
if (isOutputModeSet(true)) {
return $GLOBALS['block_mode'];
}
-// Wrapper function for addPointsThroughReferalSystem()
+/**
+ * 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
+ * @param $userid The recipient (member) for given points
+ * @param $points Points to be added to member's account
+ * @return $added Wether the points has been added to the user's account
+ */
function addPointsDirectly ($subject, $userid, $points) {
// Reset level here
- unset($GLOBALS['ref_level']);
+ 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
} // END - if
// Init the user
+ unset($GLOBALS['is_userdata_valid'][getCurrentUserId()]);
$GLOBALS['user_data'][getCurrentUserId()] = array();
}
debug_report_bug(__FUNCTION__, __LINE__, 'Current user id is invalid: ' . getCurrentUserId());
} // END - if
- // Return the value
- return $GLOBALS['user_data'][getCurrentUserId()][$column];
+ // Default is empty
+ $data = NULL;
+
+ if (isset($GLOBALS['user_data'][getCurrentUserId()][$column])) {
+ // Return the value
+ $data = $GLOBALS['user_data'][getCurrentUserId()][$column];
+ } // END - if
+
+ // Return it
+ return $data;
+}
+
+// Checks wether given user data is set to 'Y'
+function isUserDataEnabled ($column) {
+ // Do we have cache?
+ if (!isset($GLOBALS[__FUNCTION__][getCurrentUserId()][$column])) {
+ // Determine it
+ $GLOBALS[__FUNCTION__][getCurrentUserId()][$column] = (getUserData($column) == 'Y');
+ } // END - if
+
+ // Return cache
+ return $GLOBALS[__FUNCTION__][getCurrentUserId()][$column];
}
// Geter for whole user data array
// 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;
+ if (!isCurrentUserIdSet()) {
+ return false;
+ } // END - if
// Is it cached?
if (!isset($GLOBALS['is_userdata_valid'][getCurrentUserId()])) {
// Wrapper for fetchUserData() and getUserData() calls
function getFetchedUserData ($keyColumn, $userid, $valueColumn) {
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'keyColumn=' . $keyColumn . ',userid=' . $userid . ',valueColumn=' . $valueColumn . ' - ENTERED!');
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$userid][$keyColumn][$valueColumn])) {
- // Default is 'guest'
- $data = '{--USERNAME_GUEST--}';
+ // Default is NULL
+ $data = NULL;
// Can we fetch the user data?
if ((isValidUserId($userid)) && (fetchUserData($userid, $keyColumn))) {
} // END - if
// Return it
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'keyColumn=' . $keyColumn . ',userid=' . $userid . ',valueColumn=' . $valueColumn . ',value=' . $GLOBALS[__FUNCTION__][$userid][$keyColumn][$valueColumn] . ' - EXIT!');
return $GLOBALS[__FUNCTION__][$userid][$keyColumn][$valueColumn];
}
// 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
return $GLOBALS[__FUNCTION__];
}
+// "Getter" for total locked user accounts
+function getTotalRandomRefidUser () {
+ // Is it cached?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // Then do it
+ if (isExtensionInstalledAndNewer('user', '0.3.4')) {
+ $GLOBALS[__FUNCTION__] = countSumTotalData('{?user_min_confirmed?}', 'user_data', 'userid', 'rand_confirmed', true, '', '>=');
+ } else {
+ $GLOBALS[__FUNCTION__] = 0;
+ }
+ } // END - if
+
+ // Return cached value
+ return $GLOBALS[__FUNCTION__];
+}
+
// Is given userid valid?
function isValidUserId ($userid) {
// Do we have cache?
}
// "Getter" for date from patch_ctime
-function getDateFromPatchTime () {
+function getDateFromRepository () {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__])) {
// Then set it
- $GLOBALS[__FUNCTION__] = generateDateTime(getConfig('patch_ctime'), '5');
+ $GLOBALS[__FUNCTION__] = generateDateTime(getConfig('CURRENT_REPOSITORY_DATE'), '5');
+ } // END - if
+
+ // Return cache
+ return $GLOBALS[__FUNCTION__];
+}
+
+// "Getter" for date/time from patch_ctime
+function getDateTimeFromRepository () {
+ // Is it cached?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // Then set it
+ $GLOBALS[__FUNCTION__] = generateDateTime(getConfig('CURRENT_REPOSITORY_DATE'), '2');
} // END - if
// Return cache
}
// Getter for current year (default)
-function getYear ($timestamp = null) {
+function getYear ($timestamp = NULL) {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$timestamp])) {
// null is time()
}
// Getter for current month (default)
-function getMonth ($timestamp = null) {
+function getMonth ($timestamp = NULL) {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$timestamp])) {
// If null is set, use time()
}
// Getter for current hour (default)
-function getHour ($timestamp = null) {
+function getHour ($timestamp = NULL) {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$timestamp])) {
// null is time()
}
// Getter for current day (default)
-function getDay ($timestamp = null) {
+function getDay ($timestamp = NULL) {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$timestamp])) {
// null is time()
}
// Getter for current week (default)
-function getWeek ($timestamp = null) {
+function getWeek ($timestamp = NULL) {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$timestamp])) {
// null is time()
}
// Getter for current short_hour (default)
-function getShortHour ($timestamp = null) {
+function getShortHour ($timestamp = NULL) {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$timestamp])) {
// null is time()
}
// Getter for current long_hour (default)
-function getLongHour ($timestamp = null) {
+function getLongHour ($timestamp = NULL) {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$timestamp])) {
// null is time()
}
// Getter for current second (default)
-function getSecond ($timestamp = null) {
+function getSecond ($timestamp = NULL) {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$timestamp])) {
// null is time()
}
// Getter for current minute (default)
-function getMinute ($timestamp = null) {
+function getMinute ($timestamp = NULL) {
// Is it cached?
if (!isset($GLOBALS[__FUNCTION__][$timestamp])) {
// null is time()
}
// 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
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
return $GLOBALS[__FUNCTION__];
}
-// "Getter" for default referal id
+// "Getter" for default referral id
function getDefRefid () {
// Do we have cache?
if (!isset($GLOBALS[__FUNCTION__])) {
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
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?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // No, so determine it
+ $GLOBALS[__FUNCTION__] = getConfig('check_double_email');
+ } // END - if
+
+ // Return cached entry
+ return $GLOBALS[__FUNCTION__];
+}
+
+// Checks wether 'check_double_email' is 'Y'
+function isCheckDoubleEmailEnabled () {
+ // Is the cache entry set?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // No, so determine it
+ $GLOBALS[__FUNCTION__] = (getCheckDoubleEmail() == 'Y');
+ } // END - if
+
+ // Return cached entry
+ return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for 'display_home_in_index'
+function getDisplayHomeInIndex () {
+ // Is the cache entry set?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // No, so determine it
+ $GLOBALS[__FUNCTION__] = getConfig('display_home_in_index');
+ } // END - if
+
+ // Return cached entry
+ return $GLOBALS[__FUNCTION__];
+}
+
+// Checks wether 'display_home_in_index' is 'Y'
+function isDisplayHomeInIndexEnabled () {
+ // Is the cache entry set?
+ if (!isset($GLOBALS[__FUNCTION__])) {
+ // No, so determine it
+ $GLOBALS[__FUNCTION__] = (getDisplayHomeInIndex() == 'Y');
+ } // END - if
+
+ // Return cached entry
+ return $GLOBALS[__FUNCTION__];
+}
+
// Checks wether proxy configuration is used
function isProxyUsed () {
// Do we have cache?
// 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
function getTotalPoints ($userid) {
// Do we have cache?
if (!isset($GLOBALS[__FUNCTION__][$userid])) {
+ // Init array for filter chain
+ $data = array(
+ 'userid' => $userid,
+ 'points' => 0
+ );
+
+ // Run filter chain for getting more point values
+ $data = runFilterChain('get_total_points', $data);
+
// Determine it
- $GLOBALS[__FUNCTION__][$userid] = countSumTotalData($userid, 'user_points', 'points') - countSumTotalData($userid, 'user_points', 'order_points') - countSumTotalData($userid, 'user_data', 'used_points');
+ $GLOBALS[__FUNCTION__][$userid] = $data['points'] - countSumTotalData($userid, 'user_data', 'used_points');
} // END - if
// Return cache
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?
// Wrapper to check if user points are locked
function ifUserPointsLocked ($userid) {
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ' - ENTERED!');
// Do we have cache?
if (!isset($GLOBALS[__FUNCTION__][$userid])) {
// Determine it
} // END - if
// Return cache
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',locked=' . intval($GLOBALS[__FUNCTION__][$userid]) . ' - EXIT!');
return $GLOBALS[__FUNCTION__][$userid];
}
}
// Wrapper for changeDataInFile() but with full path added
-function changeDataInInclude ($FQFN, $comment, $prefix, $suffix, $DATA, $seek=0) {
+function changeDataInInclude ($FQFN, $comment, $prefix, $suffix, $inserted, $seek=0) {
// Add full path
$FQFN = getPath() . $FQFN;
// Call inner function
- return changeDataInFile($FQFN, $comment, $prefix, $suffix, $DATA, $seek);
+ return changeDataInFile($FQFN, $comment, $prefix, $suffix, $inserted, $seek);
}
// Wrapper for changing entries in config-local.php
-function changeDataInLocalConfigurationFile ($comment, $prefix, $suffix, $DATA, $seek = 0) {
+function changeDataInLocalConfigurationFile ($comment, $prefix, $suffix, $inserted, $seek = 0) {
// Call the inner function
- return changeDataInInclude(getCachePath() . 'config-local.php', $comment, $prefix, $suffix, $DATA, $seek);
+ return changeDataInInclude(getCachePath() . 'config-local.php', $comment, $prefix, $suffix, $inserted, $seek);
}
// Shortens ucfirst(strtolower()) calls
// 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
-function convertCommaToDotInPostDataArray (array $postEntries) {
+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
} // END - foreach
}
-// Getter for 'check_double_email'
-function getCheckDoubleEmail () {
- // Is the cache entry set?
- if (!isset($GLOBALS[__FUNCTION__])) {
- // No, so determine it
- $GLOBALS[__FUNCTION__] = getConfig('check_double_email');
- } // END - if
+/**
+ * Parses a string into a US formated float variable, taken from user comments
+ * from PHP documentation website.
+ *
+ * @param $floatString A string holding a float expression
+ * @return $float Corresponding float variable
+ * @author chris<at>georgakopoulos<dot>com
+ * @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);
+}
- // Return cached entry
- return $GLOBALS[__FUNCTION__];
+// Generates a YES/NO option list from given default
+function generateYesNoOptionList ($defaultValue = '') {
+ // Generate it
+ return generateOptionList('/ARRAY/', array('Y', 'N'), array('{--YES--}', '{--NO--}'), $defaultValue);
}
-// Checks wether 'check_double_email' is "YES"
-function isCheckDoubleEmailEnabled () {
- // Is the cache entry set?
- if (!isset($GLOBALS[__FUNCTION__])) {
- // No, so determine it
- $GLOBALS[__FUNCTION__] = (getCheckDoubleEmail() == 'Y');
+// "Getter" for total available receivers
+function getTotalReceivers ($mode = 'normal') {
+ // Get num rows
+ $numRows = countSumTotalData('CONFIRMED', 'user_data', 'userid', 'status', true, ' AND `receive_mails` > 0' . runFilterChain('exclude_users', $mode));
+
+ // Return value
+ return $numRows;
+}
+
+// Wrapper "getter" to get total unconfirmed mails for given userid
+function getTotalUnconfirmedMails ($userid) {
+ // Do we have cache?
+ if (!isset($GLOBALS[__FUNCTION__][$userid])) {
+ // Determine it
+ $GLOBALS[__FUNCTION__][$userid] = countSumTotalData($userid, 'user_links', 'id', 'userid', true);
} // END - if
- // Return cached entry
- return $GLOBALS[__FUNCTION__];
+ // Return cache
+ return $GLOBALS[__FUNCTION__][$userid];
}
// [EOF]