+// 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
+ return generateEmailLink($email, 'user_data');
+}
+
+// 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
+ $GLOBALS[__FUNCTION__][$userid] = ((getFetchedUserData('userid', $userid, 'ref_payout') > 0) && (!isDirectPaymentEnabled()));
+ } // END - if
+
+ // Return cache
+ //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',locked=' . intval($GLOBALS[__FUNCTION__][$userid]) . ' - EXIT!');
+ return $GLOBALS[__FUNCTION__][$userid];
+}
+
+// Appends a line to an existing file or creates it instantly with given content.
+// This function does always add a new-line character to every line.
+function appendLineToFile ($file, $line) {
+ $fp = fopen($file, 'a') or debug_report_bug(__FUNCTION__, __LINE__, 'Cannot write to file ' . basename($file) . '!');
+ fwrite($fp, $line . "\n");
+ fclose($fp);
+}
+
+// Wrapper for changeDataInFile() but with full path added
+function changeDataInInclude ($FQFN, $comment, $prefix, $suffix, $inserted, $seek=0) {
+ // Add full path
+ $FQFN = getPath() . $FQFN;
+
+ // Call inner function
+ return changeDataInFile($FQFN, $comment, $prefix, $suffix, $inserted, $seek);
+}
+
+// Wrapper for changing entries in config-local.php
+function changeDataInLocalConfigurationFile ($comment, $prefix, $suffix, $inserted, $seek = 0) {
+ // Call the inner function
+ return changeDataInInclude(getCachePath() . 'config-local.php', $comment, $prefix, $suffix, $inserted, $seek);
+}
+
+// Shortens ucfirst(strtolower()) calls
+function firstCharUpperCase ($str) {
+ return ucfirst(strtolower($str));
+}
+
+// Shortens calls with configuration entry as first argument (the second will become obsolete in the future)
+function createConfigurationTimeSelections ($configEntry, $stamps, $align = 'center') {
+ // Get the configuration entry
+ $configValue = getConfig($configEntry);
+
+ // Call inner method
+ return createTimeSelections($configValue, $configEntry, $stamps, $align);
+}
+
+// Shortens converting of German comma to Computer's version in POST data
+function convertCommaToDotInPostData ($postEntry) {
+ // Read and convert given entry
+ $postValue = convertCommaToDot(postRequestElement($postEntry));
+
+ // ... and set it again
+ setPostRequestElement($postEntry, $postValue);
+}
+
+// Converts German commas to Computer's version in all entries
+function convertCommaToDotInPostDataArray ($postEntries) {
+ // Replace german decimal comma with computer decimal dot
+ foreach ($postEntries as $entry) {
+ // Is the entry there?
+ if (isPostRequestElementSet($entry)) {
+ // Then convert it
+ convertCommaToDotInPostData($entry);
+ } // END - if
+ } // END - foreach
+}
+
+/**
+ * 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){
+ // 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 ($defaultValue = '') {
+ // Generate it
+ return generateOptionList('/ARRAY/', array('Y', 'N'), array('{--YES--}', '{--NO--}'), $defaultValue);
+}
+
+// "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 cache
+ 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');
+}
+