X-Git-Url: https://git.mxchange.org/?p=mailer.git;a=blobdiff_plain;f=inc%2Flibs%2Fuser_functions.php;h=5041a8c3a66b6f509535af2a3b2ec032f563c283;hp=1241a8748bd1f4264365ed40c29be449ec00512d;hb=99966a712b3b3d8b521524762e153353d1d20bd4;hpb=b4042713447d2eb3777a49f24523511dbba8970f

diff --git a/inc/libs/user_functions.php b/inc/libs/user_functions.php
index 1241a8748b..5041a8c3a6 100644
--- a/inc/libs/user_functions.php
+++ b/inc/libs/user_functions.php
@@ -16,7 +16,7 @@
  * $Author::                                                          $ *
  * -------------------------------------------------------------------- *
  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
- * Copyright (c) 2009 - 2011 by Mailer Developer Team                   *
+ * Copyright (c) 2009 - 2013 by Mailer Developer Team                   *
  * For more information visit: http://mxchange.org                      *
  *                                                                      *
  * This program is free software; you can redistribute it and/or modify *
@@ -41,17 +41,19 @@ if (!defined('__SECURITY')) {
 } // END - if
 
 // Add links for selecting some users
-function alpha ($sortby) {
+function addAlphabeticalSorting ($sortby) {
 	$add = '';
-	foreach (array('page','offset','mode','status') as $param) {
+	foreach (array('page', 'offset', 'do', 'status') as $param) {
 		if (isGetRequestElementSet($param)) {
 			$add .= '&' . $param . '=' . getRequestElement($param);
 		} // END - if
 	} // END - foreach
 
-	/* Creates the list of letters and makes them a link. */
+	// Creates the list of letters and makes them a link.
 	$alphabet = 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,');
 	$num = count($alphabet) - 1;
+
+	// Add all letter links
 	$OUT = '';
 	while (list($counter, $ltr) = each($alphabet)) {
 		if (getRequestElement('letter') == $ltr) {
@@ -62,20 +64,20 @@ function alpha ($sortby) {
 			$OUT .= '<a href="{%url=modules.php?module=admin&amp;what=' . getWhat() . '&amp;letter=' . $ltr . '&amp;sortby=' . $sortby . $add . '%}">' . $ltr . '</a>';
 		}
 
-		if ((($counter / getConfig('user_alpha')) == round($counter / getConfig('user_alpha'))) && ($counter > 0)) {
+		if ((($counter / getUserAlpha()) == round($counter / getUserAlpha())) && ($counter > 0)) {
 			$OUT .= ']<br />[';
-		} elseif ( $counter != $num ) {
+		} elseif ($counter != $num) {
 			$OUT .= '|';
 		}
 	} // END - while
 
 	// Prepare content
 	$content = array (
-		'alpha_selection' => $OUT
+		'alpha_selection' => $OUT,
 	);
 
 	// Load template
-	$OUT = loadTemplate('admin_list_user_alpha', true, $content);
+	$OUT = loadTemplate('admin_list_user_alpha', TRUE, $content);
 
 	// Return generated code
 	return $OUT;
@@ -91,7 +93,7 @@ function addSortLinks ($letter, $sortby) {
 	$add = '&amp;page=' . getRequestElement('page') . '&amp;offset=' . getRequestElement('offset');
 
 	// Add status/ mode
-	foreach (array('mode','status') as $param) {
+	foreach (array('do','status') as $param) {
 		if (isGetRequestElementSet($param)) {
 			$add .= '&amp;' . $param . '=' . getRequestElement($param);
 		} // END - if
@@ -127,7 +129,7 @@ function addSortLinks ($letter, $sortby) {
 	$content['list'] = substr($OUT, 0, -1);
 
 	// Load template
-	$OUT = loadTemplate('admin_list_user_sort', true, $content);
+	$OUT = loadTemplate('admin_list_user_sort', TRUE, $content);
 
 	// Return code
 	return $OUT;
@@ -152,14 +154,14 @@ function addPageNavigation ($numPages) {
 				$OUT .= '<a href="{%url=modules.php?module=admin&amp;what=' . getWhat();
 
 				// Add status/mode
-				foreach (array('mode','status') as $param) {
+				foreach (array('do','status') as $param) {
 					if (isGetRequestElementSet($param)) {
 						$OUT .= '&amp;' . $param . '=' . getRequestElement($param);
 					} // END - if
 				} // END - foreach
 
 				// Letter and so on
-				$OUT .= '&amp;letter=' . getRequestElement('letter') . '&amp;sortby=' . getRequestElement('sortby') . '&amp;page=' . $page . '&amp;offset=' . getConfig('user_limit') . '%}">';
+				$OUT .= '&amp;letter=' . getRequestElement('letter') . '&amp;sortby=' . getRequestElement('sortby') . '&amp;page=' . $page . '&amp;offset=' . getUserLimit() . '%}">';
 			}
 
 			$OUT .= $page;
@@ -179,7 +181,7 @@ function addPageNavigation ($numPages) {
 		$content['list'] = $OUT;
 
 		// Load template
-		$OUT = loadTemplate('admin_list_user_pagenav', true, $content);
+		$OUT = loadTemplate('admin_list_user_pagenav', TRUE, $content);
 	} // END - if
 
 	// Return code
@@ -197,7 +199,7 @@ function generateUserEmailLink ($email, $mod = 'admin') {
 	} // END - if
 
 	// Search for the email address
-	$result = SQL_QUERY_ESC("SELECT
+	$result = sqlQueryEscaped("SELECT
 	`userid`
 FROM
 	`{?_MYSQL_PREFIX?}_user_data`
@@ -207,50 +209,52 @@ WHERE
 LIMIT 1",
 		array($email), __FUNCTION__, __LINE__);
 
-	// Do we have an entry?
-	if (SQL_NUMROWS($result) == 1) {
+	// Is there an entry?
+	if (sqlNumRows($result) == 1) {
 		// Load userid
-		list($userid) = SQL_FETCHROW($result);
+		list($userid) = sqlFetchRow($result);
 
 		// Rewrite email address to contact link
 		$email = '{%url=modules.php?module=' . $mod . '&amp;what=user_contct&amp;userid=' . bigintval($userid) . '%}';
 	} // END - if
 
 	// Free memory
-	SQL_FREERESULT($result);
+	sqlFreeResult($result);
 
 	// Return rewritten (?) email address
 	return $email;
 }
 
 // Selects a random user id as the new referral id if they have at least X confirmed mails in this run
-// @TODO Double-check configuration entry here
 function determineRandomReferralId () {
 	// Default is zero refid
 	$refid = NULL;
 
 	// Is the extension version fine?
-	if (isExtensionInstalledAndNewer('user', '0.3.4')) {
+	if ((isRandomReferralIdEnabled()) && (isExtensionInstalledAndNewer('user', '0.3.4'))) {
 		// Get all user ids
-		$totalUsers = countSumTotalData('CONFIRMED', 'user_data', 'userid', 'status', true, " AND `rand_confirmed` >= {?user_min_confirmed?}");
+		$totalUsers = countSumTotalData('CONFIRMED', 'user_data', 'userid', 'status', TRUE, runFilterChain('user_exclusion_sql', ' AND `rand_confirmed` >= {?user_min_confirmed?}'));
 
-		// Do we have at least one?
+		// Is there at least one?
 		if ($totalUsers > 0) {
-			// Then choose random number
-			$randNum = mt_rand(0, ($totalUsers - 1));
+			// Then choose random userid
+			$randUserid = mt_rand(0, ($totalUsers - 1));
 
 			// Look for random user
-			$result = SQL_QUERY_ESC("SELECT `userid` FROM `{?_MYSQL_PREFIX?}_user_data` WHERE `status`='CONFIRMED' AND `rand_confirmed` >= {?user_min_confirmed?} ORDER BY `rand_confirmed` DESC LIMIT %s, 1",
-				array($randNum), __FUNCTION__, __LINE__);
+			$result = sqlQueryEscaped("SELECT `userid` FROM `{?_MYSQL_PREFIX?}_user_data` " . runFilterChain('user_exclusion_sql', "WHERE `status`='CONFIRMED'") . ' AND `rand_confirmed` >= {?user_min_confirmed?} ORDER BY `rand_confirmed` DESC LIMIT %s, 1',
+				array($randUserid), __FUNCTION__, __LINE__);
 
-			// Do we have one entry there?
-			if (SQL_NUMROWS($result) == 1) {
+			// Is there one entry there?
+			if (sqlNumRows($result) == 1) {
 				// Use that userid as new referral id
-				list($refid) = SQL_FETCHROW($result);
+				list($refid) = sqlFetchRow($result);
+
+				// Debug message
+				/* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'refid=' . $refid . ' - choosen!');
 			} // END - if
 
 			// Free result
-			SQL_FREERESULT($result);
+			sqlFreeResult($result);
 		} // END - if
 	} // END - if
 
@@ -265,7 +269,7 @@ function doUserLogin ($userid, $passwd, $successUrl = '', $errorUrl = 'modules.p
 	$add = '';
 	$errorCode = '0';
 	$ext = '';
-	$isFound = false;
+	$isFound = FALSE;
 
 	// Init array
 	$content = array(
@@ -279,7 +283,7 @@ function doUserLogin ($userid, $passwd, $successUrl = '', $errorUrl = 'modules.p
 	// Check login data
 	if ((isExtensionActive('nickname')) && (isNicknameUsed($userid))) {
 		// Nickname entered
-		fetchUserData($userid, 'nickname');
+		$isFound = fetchUserData($userid, 'nickname');
 	} elseif (isNicknameUsed($userid)) {
 		// No nickname installed
 		$errorCode = getCode('EXTENSION_PROBLEM');
@@ -290,7 +294,7 @@ function doUserLogin ($userid, $passwd, $successUrl = '', $errorUrl = 'modules.p
 	}
 
 	// No error found?
-	if (($errorCode == '0') && ($isFound === true)) {
+	if (($errorCode == '0') && ($isFound === TRUE)) {
 		// Get user data array and set userid (e.g. important if we login with nickname)
 		$content = getUserDataArray();
 		if (!empty($content['userid'])) {
@@ -298,8 +302,11 @@ function doUserLogin ($userid, $passwd, $successUrl = '', $errorUrl = 'modules.p
 		} // END - if
 	} // END - if
 
+	// Debug message
+	//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',isValidUserData()=' . intval(isValidUserData()) . ',userStatus=' . getUserData('status') . ',errorCode=' . $errorCode . ',ext=' . $ext . ',isFound=' . intval($isFound));
+
 	// Is there an entry?
-	if (($errorCode == '0') && (isUserDataValid()) && (getUserData('status') == 'CONFIRMED') && (!empty($content['userid']))) {
+	if (($errorCode == '0') && (isValidUserData()) && (getUserData('status') == 'CONFIRMED') && (!empty($content['userid']))) {
 		// Check for old MD5 passwords
 		if ((strlen(getUserData('password')) == 32) && (md5($passwd) == getUserData('password'))) {
 			// Just set the hash to the password from DB... :)
@@ -316,11 +323,11 @@ function doUserLogin ($userid, $passwd, $successUrl = '', $errorUrl = 'modules.p
 
 			// ... and update database
 			// @TODO Make this filter working: $ADDON = runFilterChain('post_login_update', $content);
-			SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `password`='%s' WHERE `userid`=%s AND `status`='CONFIRMED' LIMIT 1",
+			sqlQueryEscaped("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `password`='%s' WHERE `userid`=%s AND `status`='CONFIRMED' LIMIT 1",
 				array($content['hash'], $userid), __FUNCTION__, __LINE__);
 
 			// No login bonus by default
-			$GLOBALS['bonus_payed'] = false;
+			$GLOBALS['bonus_payed'] = FALSE;
 
 			// Is bonus up-to-date?
 			if (isExtensionInstalledAndNewer('bonus', '0.2.2')) {
@@ -332,10 +339,10 @@ function doUserLogin ($userid, $passwd, $successUrl = '', $errorUrl = 'modules.p
 				} // END - if
 
 				// Is the timeout reached?
-				if ($probe >= getConfig('login_timeout')) {
+				if ($probe >= getLoginTimeout()) {
 					// Add login bonus to user's account
 					$add = ',`login_bonus`=`login_bonus`+{?login_bonus?}';
-					$GLOBALS['bonus_payed'] = true;
+					$GLOBALS['bonus_payed'] = TRUE;
 
 					// Subtract login bonus from userid's account or jackpot
 					if ((isExtensionInstalledAndNewer('bonus', '0.3.5')) && (getBonusMode() != 'ADD')) {
@@ -353,18 +360,18 @@ function doUserLogin ($userid, $passwd, $successUrl = '', $errorUrl = 'modules.p
 			//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',hash=' . $content['hash'] . '(' . strlen($content['hash']) . ')');
 			if ((setSession('userid', $userid )) && (setSession('u_hash', encodeHashForCookie($content['hash'])))) {
 				// Update database records
-				SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `total_logins`=`total_logins`+1" . $add . " WHERE `userid`=%s LIMIT 1",
+				sqlQueryEscaped("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `total_logins`=`total_logins`+1" . $add . " WHERE `userid`=%s LIMIT 1",
 					array($userid), __FUNCTION__, __LINE__);
-				if (!SQL_HASZEROAFFECTED()) {
+				if (!ifSqlHasZeroAffectedRows()) {
 					// Is a success URL set?
 					if (empty($successUrl)) {
 						// Procedure to checking for login data
-						if (($GLOBALS['bonus_payed'] === true) && (isExtensionActive('bonus'))) {
+						if (($GLOBALS['bonus_payed'] === TRUE) && (isExtensionActive('bonus'))) {
 							// Bonus added (just displaying!)
-							$url = 'modules.php?module=chk_login&amp;mode=bonus';
+							$url = 'modules.php?module=chk_login&amp;do=bonus';
 						} else {
 							// Bonus not added
-							$url = 'modules.php?module=chk_login&amp;mode=login';
+							$url = 'modules.php?module=chk_login&amp;do=login';
 						}
 					} else {
 						// Use this URL
@@ -380,19 +387,19 @@ function doUserLogin ($userid, $passwd, $successUrl = '', $errorUrl = 'modules.p
 			}
 		} elseif (isExtensionInstalledAndNewer('sql_patches', '0.6.1')) {
 			// Update failure counter
-			SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `login_failures`=`login_failures`+1,`last_failure`=NOW() WHERE `userid`=%s LIMIT 1",
+			sqlQueryEscaped("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `login_failures`=`login_failures`+1,`last_failure`=NOW() WHERE `userid`=%s LIMIT 1",
 				array($userid), __FUNCTION__, __LINE__);
 
 			// Wrong password!
 			$errorCode = getCode('WRONG_PASS');
 		}
-	} elseif ((isUserDataValid()) && (getUserData('status') != 'CONFIRMED')) {
+	} elseif ((isValidUserData()) && (getUserData('status') != 'CONFIRMED')) {
 		// Create an error code from given status
 		$errorCode = generateErrorCodeFromUserStatus(getUserData('status'));
 
 		// Set userid in session
-		setSession('current_userid', getUserData('userid'));
-	} elseif (!isUserDataValid()) {
+		setSession('userid', getUserData('userid'));
+	} elseif (!isValidUserData()) {
 		// User id not found
 		$errorCode = getCode('WRONG_ID');
 	} else {
@@ -420,7 +427,7 @@ function doNewUserPassword ($email, $userid) {
 	//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'email=' . $email . ',userid=' . $userid . ' - ENTERED!');
 	// Init found-status and error
 	$errorCode = '';
-	$accountFound = false;
+	$accountFound = FALSE;
 
 	// Probe userid/nickname
 	if (!empty($email)) {
@@ -429,34 +436,37 @@ function doNewUserPassword ($email, $userid) {
 	} elseif ((isExtensionActive('nickname')) && (isNicknameOrUserid($userid))) {
 		// Nickname entered
 		$accountFound = fetchUserData($userid, 'nickname');
-	} elseif ((isValidUserId($userid)) && (empty($email))) {
+	} elseif ((isValidId($userid)) && (empty($email))) {
 		// Direct userid entered
 		$accountFound = fetchUserData($userid);
-	} else {
+	} elseif (isDebugModeEnabled()) {
 		// Userid not set!
 		logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',email=' . $email . ': Important variables are empty.');
 	}
 
 	// Any entry found?
-	if ($accountFound === true) {
+	if ($accountFound === TRUE) {
 		// Is the account confirmed
 		if (getUserData('status') == 'CONFIRMED') {
 			// Generate new password
-			$NEW_PASS = generatePassword();
+			$newPassword = generatePassword();
 
 			// Update database
-			SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `password`='%s' WHERE `userid`=%s LIMIT 1",
-				array(generateHash($NEW_PASS), getUserData('userid')), __FUNCTION__, __LINE__);
+			sqlQueryEscaped("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `password`='%s' WHERE `userid`=%s LIMIT 1",
+				array(
+					generateHash($newPassword),
+					getUserData('userid')
+				), __FUNCTION__, __LINE__);
 
 			// Prepare data and message for email
 			$message = loadEmailTemplate('guest_new_password',
 				array(
-					'new_pass' => $NEW_PASS,
+					'new_pass' => $newPassword,
 					'nickname' => $userid
-				), bigintval(getUserData('userid')));
+				), getUserData('userid'));
 
 			// ... and send it away
-			sendEmail(bigintval(getUserData('userid')), '{--GUEST_NEW_PASSWORD--}', $message);
+			sendEmail(bigintval(getUserData('userid')), '{--GUEST_NEW_PASSWORD_SUBJECT--}', $message);
 
 			// Output note to user
 			displayMessage('{--GUEST_NEW_PASSWORD_SEND--}');
@@ -494,8 +504,8 @@ function getEpocheTimeFromUserStats ($statsType, $statsData, $userid = NULL) {
 	} // END - if
 
 	// Try to find the entry
-	$result = SQL_QUERY_ESC("SELECT
-	UNIX_TIMESTAMP(`inserted`) AS inserted
+	$result = sqlQueryEscaped("SELECT
+	UNIX_TIMESTAMP(`inserted`) AS `inserted`
 FROM
 	`{?_MYSQL_PREFIX?}_user_stats_data`
 WHERE
@@ -510,13 +520,13 @@ LIMIT 1",
 		), __FUNCTION__, __LINE__);
 
 	// Is the entry there?
-	if (SQL_NUMROWS($result) == 1) {
+	if (sqlNumRows($result) == 1) {
 		// Get this stamp
-		$data = SQL_FETCHARRAY($result);
+		$data = sqlFetchArray($result);
 	} // END - if
 
 	// Free result
-	SQL_FREERESULT($result);
+	sqlFreeResult($result);
 
 	// Return stamp
 	return $data['inserted'];
@@ -527,16 +537,16 @@ function insertUserStatsRecord ($userid, $statsType, $statsData) {
 	// Is the extension installed and updated?
 	if ((!isExtensionActive('sql_patches')) || (isExtensionInstalledAndOlder('sql_patches', '0.5.6'))) {
 		// Return zero here
-		return false;
+		return FALSE;
 	} // END - if
 
 	// Default is not working
-	$return = false;
+	$return = FALSE;
 
 	// Does it exist?
 	if ((!getEpocheTimeFromUserStats($statsType, $statsData, $userid)) && (!is_array($statsData))) {
 		// Then insert it!
-		SQL_QUERY_ESC("INSERT INTO `{?_MYSQL_PREFIX?}_user_stats_data` (`userid`,`stats_type`,`stats_data`) VALUES (%s,'%s','%s')",
+		sqlQueryEscaped("INSERT INTO `{?_MYSQL_PREFIX?}_user_stats_data` (`userid`, `stats_type`, `stats_data`) VALUES (%s,'%s','%s')",
 			array(
 				bigintval($userid),
 				$statsType,
@@ -544,7 +554,7 @@ function insertUserStatsRecord ($userid, $statsType, $statsData) {
 			), __FUNCTION__, __LINE__);
 
 		// Does it have worked?
-		$return = (!SQL_HASZEROAFFECTED());
+		$return = (!ifSqlHasZeroAffectedRows());
 	} elseif (is_array($statsData)) {
 		// Invalid data!
 		logDebugMessage(__FUNCTION__, __LINE__, 'userid=' . $userid . ',type=' . $statsType . ',data=' . gettype($statsData) . ': Invalid statistics data type!');
@@ -566,23 +576,23 @@ function doConfirmUserAccount ($hash) {
 	$userid = NULL;
 
 	// Search for an unconfirmed or confirmed account
-	$result = SQL_QUERY_ESC("SELECT `userid`,`refid` FROM `{?_MYSQL_PREFIX?}_user_data` WHERE `user_hash`='%s' AND (`status`='UNCONFIRMED' OR `status`='CONFIRMED') LIMIT 1",
+	$result = sqlQueryEscaped("SELECT `userid`, `refid` FROM `{?_MYSQL_PREFIX?}_user_data` WHERE `user_hash`='%s' AND (`status`='UNCONFIRMED' OR `status`='CONFIRMED') LIMIT 1",
 		array($hash), __FILE__, __LINE__);
-	if (SQL_NUMROWS($result) == 1) {
+	if (sqlNumRows($result) == 1) {
 		// Ok, he want's to confirm now so we load some data
-		list($userid, $refid) = SQL_FETCHROW($result);
+		list($userid, $refid) = sqlFetchRow($result);
 
 		// Fetch user data
 		if (!fetchUserData($userid)) {
 			// Not found, should not happen
-			debug_report_bug(__FILE__, __LINE__, 'User account ' . $userid . ' not found.');
+			reportBug(__FILE__, __LINE__, 'User account ' . $userid . ' not found.');
 		} // END - if
 
 		// Load all data and add points
 		$content = getUserDataArray();
 
 		// Unlock his account (but only when it is on UNCONFIRMED!)
-		SQL_QUERY_ESC("UPDATE
+		sqlQueryEscaped("UPDATE
 	`{?_MYSQL_PREFIX?}_user_data`
 SET
 	`status`='CONFIRMED',
@@ -594,7 +604,7 @@ LIMIT 1",
 			array($hash), __FILE__, __LINE__);
 
 		// Was it updated?
-		if (!SQL_HASZEROAFFECTED()) {
+		if (!ifSqlHasZeroAffectedRows()) {
 			// Send email if updated
 			$message = loadEmailTemplate('guest_user_confirmed', $content, bigintval($userid));
 
@@ -602,7 +612,7 @@ LIMIT 1",
 			sendEmail($userid, '{--GUEST_THANX_CONFIRM--}', $message);
 
 			// Maybe he got "referraled"?
-			if ((isValidUserId($refid)) && ($refid != $userid)) {
+			if ((isValidId($refid)) && ($refid != $userid)) {
 				// Select the referral userid
 				if (fetchUserData($refid)) {
 					// Update ref counter...
@@ -611,11 +621,11 @@ LIMIT 1",
 					// If version matches add ref bonus to refid's account
 					if ((isExtensionInstalledAndNewer('bonus', '0.4.4')) && (isBonusRallyeActive())) {
 						// Add points (directly only!)
-						SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `bonus_ref`=`bonus_ref`+{?bonus_ref?} WHERE `userid`=%s LIMIT 1",
+						sqlQueryEscaped("UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `bonus_ref`=`bonus_ref`+{?bonus_ref?} WHERE `userid`=%s LIMIT 1",
 							array(bigintval($refid)), __FILE__, __LINE__);
 
 						// Subtract points from system
-						handleBonusPoints(getConfig('bonus_ref'), $refid);
+						handleBonusPoints(getBonusRef(), $refid);
 					} // END - if
 
 					// Add one-time referral bonus over referral system or directly
@@ -708,7 +718,7 @@ function getConfirmationMessageFromUserStatus ($status) {
 			break;
 
 		default: // This should not happen
-			debug_report_bug(__FUNCTION__, __LINE__, 'Unknown user status ' . $status . ' detected.');
+			reportBug(__FUNCTION__, __LINE__, 'Unknown user status ' . $status . ' detected.');
 			break;
 	} // END - switch
 
@@ -716,6 +726,275 @@ function getConfirmationMessageFromUserStatus ($status) {
 	return $message;
 }
 
+// "Getter" for total tester accounts
+function getTotalTesterUsers () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = countSumTotalData('', 'user_data', 'userid', '', TRUE, runFilterChain('user_inclusion_sql'));
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Checks whether the admin is allowed to create more tester accounts
+function isNewUserTesterAllowed () {
+	// By default only admins are allowed
+	if (!isAdmin()) {
+		// This should not happen and must be fixed
+		reportBug(__FUNCTION__, __LINE__, 'isAdmin()=false - Not allowed.');
+	} // END - if
+
+	// Are more tester accounts allowed?
+	$isAllowed = (getTotalTesterUsers() < bigintval(getTesterUserMaximum() + 1));
+
+	// Return result
+	return $isAllowed;
+}
+
+// "Getter" for next free tester account number
+function getNextFreeTesterUserNumber () {
+	// Get current total amount because we start with zero
+	$nextTester = getTotalTesterUsers();
+
+	// Prepend zeros
+	$nextTester = padLeftZero($nextTester, 6);
+
+	// Return it
+	return $nextTester;
+}
+
+// Wrapper function to return a selection box for tester user default referral id
+function addTesterUserDefaultRefidSelectionBox ($fieldName = 'tester_user_default_refid') {
+	// Return it
+	return addMemberSelectionBox(getConfig('tester_user_default_refid'), FALSE, TRUE, TRUE, $fieldName, " WHERE `surname` LIKE '{?tester_user_surname_prefix?}%'");
+}
+
+// Checks whether given surname is a test user name
+function isTesterUserName ($surname) {
+	// Determine it
+	return (substr($surname, 0, strlen(getTesterUserSurnamePrefix())) == getTesterUserSurnamePrefix());
+}
+
+// Creates a tester account from given POST data
+function createTesterUserAccount () {
+	// Add generated surname
+	setPostRequestElement('surname', (getTesterUserSurnamePrefix() . getNextFreeTesterUserNumber()));
+
+	// Is the registration data complete?
+	if (!isRegistrationDataComplete()) {
+		// Then abort here
+		//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'isRegistrationDataComplete()=false, please check if you e.g. have selected the required minimum of categories.');
+		return FALSE;
+	} // END - if
+
+	// Do registration
+	$isCreated = doUserRegistration();
+
+	// Remove cache to force recalculation of total tester accounts
+	unset($GLOBALS['getTotalTesterUsers']);
+
+	// Return status
+	return $isCreated;
+}
+
+// Checks whether the given sub id is fused by current member
+function isMemberSubIdFree ($subId) {
+	// Only do this for logged-in members
+	assert(isMember());
+
+	// Check it
+	$isFree = (countSumTotalData(getMemberId(), 'user_subids', 'id', 'userid', TRUE, sprintf(" AND `subid`='%s'", $subId)) == 0);
+
+	// Return result
+	return $isFree;
+}
+
+// Checks whether the sub id is valid
+function isValidSubId ($subId) {
+	// First convert any spaces/dashes to underscores
+	$subId = str_replace(' ', '_', str_replace('-', '_', $subId));
+
+	// Then filter out any unwanted characters
+	$subIdTest = preg_replace('/([^a-zA-Z0-9_])/', '', $subId);
+
+	// Is it valid?
+	return ($subId == $subIdTest);
+} // END - if
+
+// Prepares found sub id for updating in database
+function prepareFoundSubId ($subId) {
+	// Then check if it is valid and available
+	if ((!isValidSubId($subId)) || (isMemberSubIdFree($subId))) {
+		// Is not free or invalid
+		$subId = FALSE;
+	} // END - if
+
+	// Return prepared sub id
+	return $subId;
+}
+
+// Validates sub id and returns FALSE if not valid
+function validateSubId ($subId) {
+	// Then check if it is valid and available
+	if (!isValidSubId($subId)) {
+		// Is not free or invalid
+		$subId = FALSE;
+	} // END - if
+
+	// Return prepared sub id
+	return $subId;
+}
+
+// Prepares given sub id for inserting into database
+function prepareSubId ($subId) {
+	// Then check if it is valid and available
+	if ((!isValidSubId($subId)) || (!isMemberSubIdFree($subId))) {
+		// Is not free or invalid
+		$subId = FALSE;
+	} // END - if
+
+	// Return prepared sub id
+	return $subId;
+}
+
+// Check whether given sub *id* is assigned to current member
+function isUserSubIdAssignedToMember ($subId, $userid = NULL) {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__][$subId][$userid])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__][$subId][$userid] = (
+			(
+				// Is a userid set or current set?
+				(isValidId($userid)) || (isMember())
+			) && (
+				// .. and it assigned with subid's id?
+				countSumTotalData(
+					(isValidId($userid) ? $userid : getMemberId()),
+						'user_subids',
+						'id',
+						'userid',
+						TRUE,
+						sprintf(' AND `id`=%s', bigintval($subId))
+				) == 1
+			)
+		);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__][$subId][$userid];
+}
+
+// Getter for subid from given id number
+function getSubId ($id) {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__][$id])) {
+		// Check database for record
+		$result = sqlQueryEscaped("SELECT `subid` FROM `{?_MYSQL_PREFIX?}_user_subids` WHERE `id`=%s LIMIT 1",
+			array(bigintval($id)), __FUNCTION__, __LINE__);
+
+		// Is there an entry?
+		if (sqlNumRows($result) == 1) {
+			// Load it
+			list($GLOBALS[__FUNCTION__][$id]) = sqlFetchRow($result);
+		} // END - if
+
+		// Free result
+		sqlFreeResult($result);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__][$id];
+}
+
+// "Getter for total count of current user's sub ids
+function getTotalMemberSubIds () {
+	// Only do this for logged-in members
+	assert(isMember());
+
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = countSumTotalData(getMemberId(), 'user_subids', 'id', 'userid', TRUE);
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Displays generic user registration form
+function doDisplayGenericUserRegistrationForm () {
+	// Do this only if form is sent
+	if (isFormSent()) {
+		if (postRequestElement('agree') == '!') {
+			registerOutputFailedMessage('HAVE_TO_AGREE');
+		} // END - if
+
+		if (postRequestElement('email') == '!') {
+			registerOutputFailedMessage('ENTER_EMAIL');
+			setPostRequestElement('email', '');
+		} elseif (postRequestElement('email') == '?') {
+			registerOutputFailedMessage('GUEST_EMAIL_IS_ALREADY_REGISTERED');
+			setPostRequestElement('email', '');
+		}
+
+		if (postRequestElement('surname') == '!') {
+			registerOutputFailedMessage('ENTER_SURNAME');
+			setPostRequestElement('surname', '');
+		} // END - if
+
+		if (postRequestElement('family') == '!') {
+			registerOutputFailedMessage('ENTER_FAMILY');
+			setPostRequestElement('family', '');
+		} // END - if
+
+		if ((postRequestElement('password1') == '!') && (postRequestElement('password2') == '!')) {
+			registerOutputFailedMessage('ENTER_BOTH_PASSWORDS');
+		} elseif (postRequestElement('password1') == '!') {
+			registerOutputFailedMessage('ENTER_PASSWORD1');
+		} elseif (postRequestElement('password2') == '!') {
+			registerOutputFailedMessage('ENTER_PASSWORD2');
+		}
+
+		if ((isset($GLOBALS['registration_weak_password'])) && ($GLOBALS['registration_weak_password'] === TRUE)) {
+			registerOutputFailedMessage('GUEST_WEAK_PASSWORD');
+		} // END - if
+
+		if ((isset($GLOBALS['registration_ip_timeout'])) && ($GLOBALS['registration_ip_timeout'] === TRUE)) {
+			registerOutputFailedMessage('REMOTE_ADDR_TIMEOUT');
+		} // END - if
+
+		if ((!empty($GLOBALS['registration_selected_cats'])) && ($GLOBALS['registration_selected_cats'] < getLeastCats())) {
+			registerOutputFailedMessage('', '{--CHOOSE_MORE_CATEGORIES--}');
+		} // END - if
+	} // END - if
+
+	// Generate birthday selection
+	$content['birthday_selection'] = generateDayMonthYearSelectionBox(postRequestElement('day'),postRequestElement('month'),postRequestElement('year'));
+
+	// ZIP codes are numerical values
+	$content['zip'] = '';
+	if ((isPostRequestElementSet('zip')) && (isValidNumber(postRequestElement('zip')))) {
+		$content['zip'] = bigintval(postRequestElement('zip'));
+	} // END - if
+
+	// Other values
+	foreach (array('gender', 'surname', 'family', 'street_nr', 'city', 'email') as $entry) {
+		$content[$entry] = sqlEscapeString(postRequestElement($entry));
+	} // END - foreach
+
+	// Set must-fillout fields
+	$content = runFilterChain('register_must_fillout', $content);
+
+	// Display registration form
+	loadTemplate('guest_register', FALSE, $content);
+}
+
+//-----------------------------------------------------------------------------
+//                                EL code functions
+//-----------------------------------------------------------------------------
+
 // Expression call-back function for fetching user data
 function doExpressionUser ($data) {
 	// Use current userid by default
@@ -723,12 +1002,12 @@ function doExpressionUser ($data) {
 
 	// User-related data, so is there a userid?
 	if (!empty($data['matches'][4][$data['key']])) {
-		// Do we have a userid or $userid?
+		// Is there a userid or $userid?
 		if (substr($data['matches'][4][$data['key']], 0, 1) == '$') {
 			// Use dynamic call
 			$functionName = "getFetchedUserData('userid', " . $data['matches'][4][$data['key']] . ", '" . $data['callback'] . "')";
 		} elseif (!empty($data['matches'][4][$data['key']])) {
-			// Do we have a number or a dollar sign in front of it?
+			// Is there a number or a dollar sign in front of it?
 			if (preg_replace('/[^0123456789]/', '', $data['matches'][4][$data['key']]) != $data['matches'][4][$data['key']]) {
 				// Possible database column, so get it again
 				$data['matches'][4][$data['key']] = "getFetchedUserData('userid', getMemberId(), '" . $data['matches'][4][$data['key']] . "')";
@@ -737,12 +1016,12 @@ function doExpressionUser ($data) {
 			// Fix all together
 			$functionName = "getFetchedUserData('userid', " . $data['matches'][4][$data['key']] . ", '" . $data['callback'] . "')";
 		}
-	} elseif ((!empty($data['callback'])) && (isUserDataValid())) {
+	} elseif ((!empty($data['callback'])) && (isValidUserData())) {
 		// "Call-back" alias column for current logged in user's data
 		$functionName = "getUserData('" . $data['callback'] . "')";
 	}
 
-	// Do we have another function to run (e.g. translations)
+	// Is there another function to run (e.g. translations)
 	if (!empty($data['extra_func'])) {
 		// Surround the original function call with it
 		$functionName = $data['extra_func'] . '(' . $functionName . ')';
@@ -759,18 +1038,22 @@ function doExpressionUser ($data) {
 	return $code;
 }
 
+//-----------------------------------------------------------------------------
+//                             Template helper functions
+//-----------------------------------------------------------------------------
+
 // Template call-back function for list_user admin function
-function doTemplateAdminListUserTitle ($template, $clear = false) {
+function doTemplateAdminListUserTitle ($template, $clear = FALSE) {
 	// Init title with "all accounts"
 	$code = '{--ADMIN_LIST_ALL_ACCOUNTS--}';
 
-	// Do we have a 'status' or 'mode' set?
+	// Is there a 'status' or 'do' set?
 	if (isGetRequestElementSet('status')) {
 		// Set title according to the 'status'
 		$code = sprintf("{--ADMIN_LIST_STATUS_%s_ACCOUNTS--}", strtoupper(getRequestElement('status')));
-	} elseif (isGetRequestElementSet('mode')) {
-		// Set title according to the "mode"
-		$code = sprintf("{--ADMIN_LIST_MODE_%s_ACCOUNTS--}", strtoupper(getRequestElement('mode')));
+	} elseif (isGetRequestElementSet('do')) {
+		// Set title according to 'do'
+		$code = sprintf("{--ADMIN_LIST_DO_%s_ACCOUNTS--}", strtoupper(getRequestElement('do')));
 	}
 
 	// Return the code
@@ -778,14 +1061,14 @@ function doTemplateAdminListUserTitle ($template, $clear = false) {
 }
 
 // Template call-back function for displaying "username"
-function doTemplateDisplayUsername ($template, $clear = false, $userid = NULL) {
+function doTemplateDisplayUsername ($template, $clear = FALSE, $userid = NULL) {
 	// Is a userid set?
-	if (!isValidUserId($userid)) {
+	if (!isValidId($userid)) {
 		// Please don't call this without a valid userid
-		debug_report_bug(__FUNCTION__, __LINE__, 'template=' . $template . ',clear=' . intval($clear) . ',userid[' . gettype($userid) . ']=' . intval($userid) . ' - Invalid userid provided.');
+		reportBug(__FUNCTION__, __LINE__, 'template=' . $template . ',clear=' . intval($clear) . ',userid[' . gettype($userid) . ']=' . intval($userid) . ' - Invalid userid provided.');
 	} // END - if
 
-	// Do we have cache?
+	// Is there cache?
 	if (!isset($GLOBALS[__FUNCTION__][$userid])) {
 		// Generate code
 		$GLOBALS[__FUNCTION__][$userid] = $userid . ' ({%user,nickname,fixEmptyContentToDashes=' . $userid . '%})';
@@ -795,5 +1078,212 @@ function doTemplateDisplayUsername ($template, $clear = false, $userid = NULL) {
 	return $GLOBALS[__FUNCTION__][$userid];
 }
 
+// ----------------------------------------------------------------------------
+//                             XML call-back functions
+// ----------------------------------------------------------------------------
+
+// For 'doing' add subid, the column-index is required
+function addXmlSpecialMemberAddDoUserSubid () {
+	// So set it all here
+	$GLOBALS['__COLUMN_INDEX']['doXmlCallbackFunction']  = 'column';
+	$GLOBALS['__XML_ARGUMENTS']['doXmlCallbackFunction']['column_index'] = 'column';
+}
+
+// ----------------------------------------------------------------------------
+//                 Wrapper functions for configuration entries
+// ----------------------------------------------------------------------------
+
+// Getter for user_alpha
+function getUserAlpha () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('user_alpha');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for user_limit
+function getUserLimit () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('user_limit');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_surname_prefix
+function getTesterUserSurnamePrefix () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_surname_prefix');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_maximum
+function getTesterUserMaximum () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_maximum');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_check_cat
+function getTesterUserCheckCat () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_check_cat');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_gender
+function getTesterUserGender () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_gender');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_family
+function getTesterUserFamily () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_family');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_password
+function getTesterUserPassword () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_password');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_street_nr
+function getTesterUserStreetNr () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_street_nr');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_zip
+function getTesterUserZip () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_zip');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_city
+function getTesterUserCity () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_city');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for tester_user_email
+function getTesterUserEmail () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('tester_user_email');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for 'ap_subids' config entry
+function getApSubids () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('ap_subids');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Determines whether 'ap_subids' is set to 'Y'
+function isApSubidsEnabled () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = (getApSubids() == 'Y');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for 'ap_subids_since' config entry
+function getApSubidsSince () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('ap_subids_since');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
+// Getter for 'select_user_zero_refid' config entry
+function getSelectUserZeroRefid () {
+	// Is there cache?
+	if (!isset($GLOBALS[__FUNCTION__])) {
+		// Determine it
+		$GLOBALS[__FUNCTION__] = getConfig('select_user_zero_refid');
+	} // END - if
+
+	// Return cache
+	return $GLOBALS[__FUNCTION__];
+}
+
 // [EOF]
 ?>