<?php
/************************************************************************
 * Mailer v0.2.1-FINAL                                Start: 06/30/2003 *
 * ===================                          Last change: 11/27/2004 *
 *                                                                      *
 * -------------------------------------------------------------------- *
 * File              : admins_functions.php                             *
 * -------------------------------------------------------------------- *
 * Short description : Functions for the admins extension               *
 * -------------------------------------------------------------------- *
 * Kurzbeschreibung  : Funktionen fuer die admins-Erweiterung           *
 * -------------------------------------------------------------------- *
 * $Revision::                                                        $ *
 * $Date::                                                            $ *
 * $Tag:: 0.2.1-FINAL                                                 $ *
 * $Author::                                                          $ *
 * -------------------------------------------------------------------- *
 * Copyright (c) 2003 - 2009 by Roland Haeder                           *
 * Copyright (c) 2009 - 2012 by Mailer Developer Team                   *
 * 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 *
 * the Free Software Foundation; either version 2 of the License, or    *
 * (at your option) any later version.                                  *
 *                                                                      *
 * This program is distributed in the hope that it will be useful,      *
 * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
 * GNU General Public License for more details.                         *
 *                                                                      *
 * You should have received a copy of the GNU General Public License    *
 * along with this program; if not, write to the Free Software          *
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
 * MA  02110-1301  USA                                                  *
 ************************************************************************/

// Some security stuff...
if (!defined('__SECURITY')) {
	die();
}

// Check ACL for menu combination
function isAdminsAllowedByAcl ($action, $what) {
	// Get admin's id
	$adminId = getCurrentAdminId();

	if (($action == 'login') || ($action == 'logout')) {
		// If action is login or logout allow allways!
		return true;
	} elseif (isset($GLOBALS[__FUNCTION__][$adminId][$action][$what])) {
		// If we have cache, use it
		return $GLOBALS[__FUNCTION__][$adminId][$action][$what];
	}

	// But default result is failed
	$GLOBALS[__FUNCTION__][$action][$what] = false;

	// Get admin's defult access right
	$default = getAdminDefaultAcl($adminId);

	if (!empty($what)) {
		// Check for parent menu:
		// First get it's action value
		$parent_action = getActionFromModuleWhat('admin', $what);

		// Check with this function...
		$parent = isAdminsAllowedByAcl($parent_action, '');
	} else {
		// Anything else is true!
		$parent = false;
	}

	// Shall I test for a main or sub menu? (action or what?)
	$aclMode = 'failed';
	if ((isExtensionInstalledAndNewer('cache', '0.1.2')) && (isset($GLOBALS['cache_array']['admin_acls'])) && (count($GLOBALS['cache_array']['admin_acls']) > 0)) {
		// Lookup in cache
		if ((!empty($action)) && (isset($GLOBALS['cache_array']['admin_acls']['action_menu'][$adminId])) & (in_array($action, $GLOBALS['cache_array']['admin_acls']['action_menu'][$adminId]))) {
			// Search for it
			$key = array_search($action, $GLOBALS['cache_array']['admin_acls']['action_menu'][$adminId]);

			// Main menu line found
			$aclMode = $GLOBALS['cache_array']['admin_acls']['access_mode'][$adminId][$key];

			// Log debug message
			//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'action=' . $action . ',key=' . $key . ',acl_mode=' . $aclMode);

			// Count cache hits
			incrementStatsEntry('cache_hits');
		} elseif ((!empty($what)) && (isset($GLOBALS['cache_array']['admin_acls']['what_menu'][$adminId])) && (in_array($what, $GLOBALS['cache_array']['admin_acls']['what_menu'][$adminId]))) {
			// Search for it
			$key = array_search($action, $GLOBALS['cache_array']['admin_acls']['what_menu'][$adminId]);

			// Check sub menu
			$aclMode = $GLOBALS['cache_array']['admin_acls']['access_mode'][$adminId][$key];

			// Log debug message
			//* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'what=' . $what . ',key=' . $key . ',acl_mode=' . $aclMode);

			// Count cache hits
			incrementStatsEntry('cache_hits');
		}
	} elseif (!isExtensionActive('cache')) {
		// Extension ext-cache is absent, so load it from database
		$result = false;
		if (!empty($action)) {
			// Main menu
			$result = SQL_QUERY_ESC("SELECT `access_mode` FROM `{?_MYSQL_PREFIX?}_admins_acls` WHERE `admin_id`=%s AND `action_menu`='%s' LIMIT 1",
				array(bigintval($adminId), $action), __FUNCTION__, __LINE__);
		} elseif (!empty($what)) {
			// Sub menu
			$result = SQL_QUERY_ESC("SELECT `access_mode` FROM `{?_MYSQL_PREFIX?}_admins_acls` WHERE `admin_id`=%s AND `what_menu`='%s' LIMIT 1",
				array(bigintval($adminId), $what), __FUNCTION__, __LINE__);
		}

		// Is an entry found?
		if (SQL_NUMROWS($result) == 1) {
			// Load ACL
			list($aclMode) = SQL_FETCHROW($result);
		} // END - if

		// Free memory
		SQL_FREERESULT($result);
	}

	// Check ACL and (maybe) allow
	//* DEBUG: */ debugOutput('default='.$default.',acl_mode='.$aclMode.',parent='.intval($parent));
	if ((($default == 'allow') && ($aclMode != 'deny')) || (($default == 'deny') && ($aclMode == 'allow')) || ($parent === true) || (($default == 'NO-ACL') && ($aclMode == 'failed') && ($parent === false))) {
		// Access is granted
		$GLOBALS[__FUNCTION__][$adminId][$action][$what] = true;
	} // END - if

	// Return value
	//* DEBUG: */ debugOutput(__FUNCTION__.'['.__LINE__.']:act='.$action.',wht='.$what.',default='.$default.',aclMode='.$aclMode);
	return $GLOBALS[__FUNCTION__][$adminId][$action][$what];
}

// Create email link to admins's account
function generateAdminEmailLink ($email, $mod = 'admin') {
	// Is it an email?
	if (isInString('@', $email)) {
		// Create email link
		$result = SQL_QUERY_ESC("SELECT `id`
FROM
	`{?_MYSQL_PREFIX?}_admins`
WHERE
	'%s' REGEXP `email`
LIMIT 1",
		array($email), __FUNCTION__, __LINE__);

		// Is there an entry?
		if (SQL_NUMROWS($result) == 1) {
			// Load userid
			list($adminId) = SQL_FETCHROW($result);

			// Call this function again
			$email = generateAdminEmailLink($adminId, $mod);
		} // END - if

		// Free memory
		SQL_FREERESULT($result);
	} elseif (isValidUserId($email)) {
		// Direct id given
		$email = '{%url=modules.php?module=' . $mod . '&amp;what=admins_contct&amp;id=' . bigintval($email) . '%}';
	} else {
		// This is strange and needs fixing
		reportBug(__FUNCTION__, __LINE__, 'email[' . gettype($email) . ']=' . $email . ',mod=' . $mod . ' - This should not happen.');
	}

	// Return rewritten (?) email address
	return $email;
}

// Change a lot admin account
function adminsChangeAdminAccount ($postData, $element = '', $displayMessage = true) {
	// Begin the update
	$cache_update = '0';
	$message = '';

	foreach ($postData['login'] as $id => $login) {
		// Secure id number
		$id = bigintval($id);
		/* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'id=' . $id . ',login=' . $login);

		// When both passwords match update admin account
		if ((!empty($element)) && (isset($postData[$element]))) {
			// Save this setting
			SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_admins` SET `%s`='%s' WHERE `id`=%s LIMIT 1",
				array($element, $postData[$element][$id], $id), __FUNCTION__, __LINE__);

			// Admin account saved
			$message = '{--ADMIN_ACCOUNT_SAVED--}';
		} elseif ((!empty($postData['pass1'])) && (!empty($postData['pass2']))) {
			// Update only if both passwords match
			if (($postData['pass1'][$id] == $postData['pass2'][$id])) {
				// Save only when both passwords are the same (also when they are empty)
				$add = ''; $cache_update = 1;

				// Generate hash
				$hash = generateHash($postData['pass1'][$id]);

				// Save password when set
				if (!empty($postData['pass1'][$id])) {
					$add = sprintf(",`password`='%s'", SQL_ESCAPE($hash));
				} // END - if

				// Get admin's id
				$adminId = getCurrentAdminId();
				$salt = substr(getAdminHash(getAdminLogin($adminId)), 0, -40);

				// Rewrite cookie when it's own account
				if ($adminId == $id) {
					// Set timeout cookie
					setAdminLast(time());

					if ($adminId != getCurrentAdminId()) {
						// Update login cookie
						setAdminId($adminId);

						// Update password cookie as well?
						if (!empty($add)) {
							setAdminMd5($hash);
						} // END - if
					} elseif (generateHash($postData['pass1'][$id], $salt) != getAdminMd5()) {
						// Update password cookie
						setAdminMd5($hash);
					}
				} // END - if

				// Get default ACL from admin to check if we can allow him to change the default ACL
				$default = getAdminDefaultAcl(getCurrentAdminId());

				// Update admin account
				if ($default == 'allow') {
					// Allow changing default ACL
					SQL_QUERY_ESC("UPDATE
	`{?_MYSQL_PREFIX?}_admins`
SET
	`login`='%s'" . $add . ",
	`email`='%s',
	`default_acl`='%s',
	`la_mode`='%s'
WHERE
	`id`=%s
LIMIT 1",
					array(
						$login,
						$postData['email'][$id],
						$postData['access_mode'][$id],
						$postData['la_mode'][$id],
						$id
					), __FUNCTION__, __LINE__);
				} else {
					// Do not allow it here
					SQL_QUERY_ESC("UPDATE
	`{?_MYSQL_PREFIX?}_admins`
SET
	`login`='%s'" . $add . ",
	`email`='%s',
	`la_mode`='%s'
WHERE
	`id`=%s
LIMIT 1",
					array(
						$login,
						$postData['email'][$id],
						$postData['la_mode'][$id],
						$id
					), __FUNCTION__, __LINE__);
				}

				// Admin account saved
				$message = '{--ADMIN_ACCOUNT_SAVED--}';
			} else {
				// Passwords did not match
				$message = '{--ADMIN_ADMINS_ERROR_PASS_MISMATCH--}';
			}
		} else {
			// Update whole array
			$SQL = getUpdateSqlFromArray($postData, 'admins', 'id', '%s', array('login', 'id'), $id);

			// Run it
			SQL_QUERY_ESC($SQL, array(bigintval($id)), __FUNCTION__, __LINE__);

			// Was it updated?
			if (SQL_AFFECTEDROWS() == 1) {
				// Admin account saved
				$message = '{--ADMIN_ACCOUNT_SAVED--}';
			} else {
				// Passwords did not match
				$message = '{--ADMIN_ADMINS_ERROR_PASS_MISMATCH--}';
			}
		}
	} // END - foreach

	// Display message if not empty and allowed
	if ((!empty($message)) && ($displayMessage === true)) {
		// Display it
		displayMessage($message);
	} // END - if

	// Remove cache file
	runFilterChain('post_form_submited', postRequestArray());

	// Return message
	return $message;
}

// Make admin accounts editable
function adminsEditAdminAccount ($postData) {
	// "Resolve" current's admin access mode
	$currMode = getAdminDefaultAcl(getCurrentAdminId());

	// Begin the edit loop
	$OUT = '';
	foreach ($postData['sel'] as $id => $selected) {
		// Secure id number
		$id = bigintval($id);

		// Get the admin's data
		$result = SQL_QUERY_ESC("SELECT `login`,`email` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
			array($id), __FUNCTION__, __LINE__);
		if ((SQL_NUMROWS($result) == 1) && ($selected == 1)) {
			// Entry found
			$content = SQL_FETCHARRAY($result);

			// Prepare some more data for the template
			$content['id'] = $id;

			// Shall we allow changing default ACL?
			if ($currMode == 'allow') {
				// Allow changing it
				$content['access_mode'] = '{%pipe,generateAdminAccessModeSelectionBox=' . $id . '%}';
			} else {
				// Don't allow it
				$content['access_mode'] = '&nbsp;';
			}

			// Load row template and switch color
			$OUT .= loadTemplate('admin_edit_admins_row', true, $content);
		} // END - if

		// Free result
		SQL_FREERESULT($result);
	} // END - foreach

	// Load template
	loadTemplate('admin_edit_admins', false, $OUT);
}

// Generate access mode selection box for given admin id
function generateAdminAccessModeSelectionBox ($adminId = NULL) {
	// Start the selection box
	$OUT = '<select name="access_mode[' . $adminId . ']" size="1" class="form_select">';

	// Add option list
	$OUT .= generateOptions(
		'/ARRAY/',
		array(
			'allow',
			'deny'
		), array(
			'{--ADMIN_ADMINS_ACCESS_MODE_ALLOW--}',
			'{--ADMIN_ADMINS_ACCESS_MODE_DENY--}'
		),
		getAdminDefaultAcl($adminId)
	);

	// Finish it
	$OUT .= '</select>';

	// Return content
	return $OUT;
}

// Generate menu mode selection box for given admin it
function generateAdminMenuModeSelectionBox ($adminId = NULL) {
	// Start the selection box
	$OUT = '<select name="la_mode[{%pipe,convertNullToZero=' . convertZeroToNull($adminId) . '%}]" size="1" class="form_select">';

	// Add option list
	$OUT .= generateOptions(
		'/ARRAY/',
		array(
			'global',
			'OLD',
			'NEW'
		), array(
			'{--ADMIN_ADMINS_LA_MODE_GLOBAL--}',
			'{--ADMIN_ADMINS_LA_MODE_OLD--}',
			'{--ADMIN_ADMINS_LA_MODE_NEW--}'
		),
		getAdminMenuMode($adminId)
	);

	// Finish it
	$OUT .= '</select>';

	// Return content
	return $OUT;
}

// Delete given admin accounts
function adminsDeleteAdminAccount ($postData) {
	// Check if this account is the last one which cannot be deleted...
	if (countSumTotalData('', 'admins', 'id', '', true) > 1) {
		// Delete accounts
		$OUT = '';
		foreach ($postData['sel'] as $id => $selected) {
			// Secure id number
			$id = bigintval($id);

			// Get the admin's data
			$result = SQL_QUERY_ESC("SELECT `login`,`email`,`default_acl` AS `access_mode`,`la_mode` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
				array($id), __FUNCTION__, __LINE__);

			// Do we have an entry?
			if (SQL_NUMROWS($result) == 1) {
				// Entry found, so load data
				$content = SQL_FETCHARRAY($result);
				$content['access_mode'] = '{--ADMIN_ADMINS_ACCESS_MODE_' . strtoupper($content['access_mode'])    . '--}';
				$content['la_mode']     = '{--ADMIN_ADMINS_LA_MODE_' . strtoupper($content['la_mode']) . '--}';

				// Prepare some more data
				$content['id'] = $id;

				// Load row template and switch color
				$OUT .= loadTemplate('admin_delete_admins_row', true, $content);
			} // END - if

			// Free result
			SQL_FREERESULT($result);
		} // END - foreach

		// Load template
		loadTemplate('admin_delete_admins', false, $OUT);
	} else {
		// Cannot delete last account!
		displayMessage('{--ADMIN_ADMINS_CANNOT_DELETE_LAST--}');
	}
}

// Remove the given accounts
function adminsRemoveAdminAccount ($postData) {
	// Begin removal
	$cache_update = '0';
	foreach ($postData['sel'] as $id => $del) {
		// Secure id number
		$id = bigintval($id);

		// Delete only when it's not your own account!
		if (($del == 1) && (getCurrentAdminId() != $id)) {
			// Rewrite his tasks to all admins
			SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_task_system` SET `assigned_admin`=NULL WHERE `assigned_admin`=%s",
				array($id), __FUNCTION__, __LINE__);

			// Remove account
			SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
				array($id), __FUNCTION__, __LINE__);
		}
	}

	// Remove cache if cache system is activated
	runFilterChain('post_form_deleted', postRequestArray());
}

// List all admin accounts
function adminsListAdminAccounts() {
	// Select all admin accounts
	$result = SQL_QUERY('SELECT
	`id`,
	`login`,
	`email`,
	`default_acl` AS `access_mode`,
	`la_mode`
FROM
	`{?_MYSQL_PREFIX?}_admins`
ORDER BY
	`login` ASC', __FUNCTION__, __LINE__);
	$OUT = '';
	while ($content = SQL_FETCHARRAY($result)) {
		// Compile some variables
		$content['access_mode'] = '{--ADMIN_ADMINS_ACCESS_MODE_' . strtoupper($content['access_mode'])    . '--}';
		$content['la_mode']     = '{--ADMIN_ADMINS_LA_MODE_' . strtoupper($content['la_mode']) . '--}';

		// Load row template and switch color
		$OUT .= loadTemplate('admin_list_admins_row', true, $content);
	} // END - while

	// Free memory
	SQL_FREERESULT($result);

	// Load template
	loadTemplate('admin_list_admins', false, $OUT);
}

// Sends out mail to all administrators
// IMPORTANT: Please use sendAdminNotification() instead of calling this function directly
function sendAdminsEmails ($subject, $template, $content, $userid) {
	// Trim template name
	$template = trim($template);

	// Load email template
	$message = loadEmailTemplate($template, $content, $userid);

	// Check which admin shall receive this mail
	$result = SQL_QUERY_ESC("SELECT `admin_id` FROM `{?_MYSQL_PREFIX?}_admins_mails` WHERE `mail_template`='%s' ORDER BY `admin_id` ASC",
		array($template), __FUNCTION__, __LINE__);

	// No entries found?
	if (SQL_HASZERONUMS($result)) {
		// Create new entry (to all admins)
		SQL_QUERY_ESC("INSERT INTO `{?_MYSQL_PREFIX?}_admins_mails` (`admin_id`,`mail_template`) VALUES (0, '%s')",
			array($template), __FUNCTION__, __LINE__);

		// Select all email adresses (default)
		$result = SQL_QUERY('SELECT `email` FROM `{?_MYSQL_PREFIX?}_admins` ORDER BY `id` ASC',
			__FUNCTION__, __LINE__);
	} else {
		// Load admin ids...
		// @TODO This can be, somehow, rewritten
		$adminIds = array();
		while ($content = SQL_FETCHARRAY($result)) {
			array_push($adminIds, $content['admin_id']);
		} // END - while

		// Free memory
		SQL_FREERESULT($result);

		// Init result
		$result = false;

		// "implode" ids and query string
		$adminId = implode(',', $adminIds);

		// To which admin shall we sent it?
		if ($adminId == '-1') {
			// Is an "event"
			if (isExtensionActive('events')) {
				// Add line to user events
				EVENTS_ADD_LINE($subject, $message, $userid);
			} else {
				// Log error for debug
				logDebugMessage(__FUNCTION__, __LINE__, sprintf("Extension 'ext-events' missing: template=%s,subj=%s,userid=%s",
					$template,
					$subject,
					$userid
				));
			}
		} elseif (($adminId == '0') || (empty($adminId))) {
			// Select all email adresses
			$result = SQL_QUERY('SELECT `email` FROM `{?_MYSQL_PREFIX?}_admins` ORDER BY `id` ASC',
				__FUNCTION__, __LINE__);
		} else {
			// If Admin-Id is not "to-all" select
			$result = SQL_QUERY_ESC("SELECT `email` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id` IN (%s) ORDER BY `id` ASC",
				array($adminId), __FUNCTION__, __LINE__);
		}
	}

	// Default is no special mail header
	$mailHeader = '';

	// Is the template a bug report?
	if ($template == 'admin_report_bug') {
		// Then set 'Reply-To:' again
		$mailHeader = 'Reply-To: webmaster@mxchange.org' . chr(10);
	} // END - if

	// Load email addresses and send away
	while ($content = SQL_FETCHARRAY($result)) {
		sendEmail($content['email'], $subject, $message, 'N', $mailHeader);
	} // END - while

	// Free memory
	SQL_FREERESULT($result);
}

// "Getter" for current admin's expert settings
function getAminsExpertSettings () {
	// Default is has not the right
	$data['expert_settings'] = 'N';

	// Get current admin Id
	$adminId = getCurrentAdminId();

	// Lookup settings in cache
	if (isset($GLOBALS['cache_array']['admin']['expert_settings'][$adminId])) {
		// Use cache
		$data['expert_settings'] = $GLOBALS['cache_array']['admin']['expert_settings'][$adminId];

		// Update cache hits
		incrementStatsEntry('cache_hits');
	} elseif (!isExtensionInstalled('cache')) {
		// Load from database
		$result = SQL_QUERY_ESC("SELECT `expert_settings` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
			array($adminId), __FUNCTION__, __LINE__);

		// Entry found?
		if (SQL_NUMROWS($result) == 1) {
			// Fetch data
			$data = SQL_FETCHARRAY($result);

			// Set cache
			$GLOBALS['cache_array']['admin']['expert_settings'][$adminId] = $data['expert_settings'];
		} // END - if

		// Free memory
		SQL_FREERESULT($result);
	}

	// Return the result
	return $data['expert_settings'];
}

// "Getter" for current admin's expert warning (if he wants to see them or not
function getAminsExpertWarning () {
	// Default is has not the right
	$data['expert_warning'] = 'N';

	// Get current admin id
	$adminId = getCurrentAdminId();

	// Lookup warning in cache
	if (isset($GLOBALS['cache_array']['admin']['expert_warning'][$adminId])) {
		// Use cache
		$data['expert_warning'] = $GLOBALS['cache_array']['admin']['expert_warning'][$adminId];

		// Update cache hits
		incrementStatsEntry('cache_hits');
	} elseif (!isExtensionInstalled('cache')) {
		// Load from database
		$result = SQL_QUERY_ESC("SELECT `expert_warning` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
			array($adminId), __FUNCTION__, __LINE__);

		// Entry found?
		if (SQL_NUMROWS($result) == 1) {
			// Fetch data
			$data = SQL_FETCHARRAY($result);

			// Set cache
			$GLOBALS['cache_array']['admin']['expert_warning'][$adminId] = $data['expert_warning'];
		} // END - if

		// Free memory
		SQL_FREERESULT($result);
	}

	// Return the result
	return $data['expert_warning'];
}

// Get login_failures number from administrator's login name
function getAdminLoginFailures ($adminId) {
	// Admin login should not be empty
	if (empty($adminId)) {
		reportBug(__FUNCTION__, __LINE__, 'adminId is empty.');
	} // END - if

	// By default no admin is found
	$data['login_failures'] = -1;

	// Check cache
	if (isset($GLOBALS['cache_array']['admin']['login_failures'][$adminId])) {
		// Use it if found to save SQL queries
		$data['login_failures'] = $GLOBALS['cache_array']['admin']['login_failures'][$adminId];

		// Update cache hits
		incrementStatsEntry('cache_hits');
	} elseif (!isExtensionActive('cache')) {
		// Load from database
		$result = SQL_QUERY_ESC("SELECT `login_failures` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
			array($adminId), __FUNCTION__, __LINE__);

		// Do we have an entry?
		if (SQL_NUMROWS($result) == 1) {
			// Get it
			$data = SQL_FETCHARRAY($result);
		} // END - if

		// Free result
		SQL_FREERESULT($result);
	}

	// Return the login_failures
	return $data['login_failures'];
}

// Get last_failure number from administrator's login name
function getAdminLastFailure ($adminId) {
	// Admin login should not be empty
	if (empty($adminId)) {
		reportBug(__FUNCTION__, __LINE__, 'adminId is empty.');
	} // END - if

	// By default no admin is found
	$data['last_failure'] = -1;

	// Check cache
	if (isset($GLOBALS['cache_array']['admin']['last_failure'][$adminId])) {
		// Use it if found to save SQL queries
		$data['last_failure'] = $GLOBALS['cache_array']['admin']['last_failure'][$adminId];

		// Update cache hits
		incrementStatsEntry('cache_hits');
	} elseif (!isExtensionActive('cache')) {
		// Load from database
		$result = SQL_QUERY_ESC("SELECT UNIX_TIMESTAMP(`last_failure`) AS `last_failure` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
			array($adminId), __FUNCTION__, __LINE__);

		// Do we have an entry?
		if (SQL_NUMROWS($result) == 1) {
			// Get it
			$data = SQL_FETCHARRAY($result);
		} // END - if

		// Free result
		SQL_FREERESULT($result);
	}

	// Return the last_failure
	return $data['last_failure'];
}

//-----------------------------------------------------------------------------
//                             Wrapper functions
//-----------------------------------------------------------------------------

// Wrapper function to check whether expert setting warning is enabled
function isAdminsExpertWarningEnabled () {
	return (getAminsExpertWarning() == 'Y');
}

// [EOF]
?>