A lot code rewritten:
[mailer.git] / inc / libs / admins_functions.php
index eb79a8c705c213ac7623cfacf21adfefe7080930..e9a5e8a79b5df96b1d141d75075a596efc74a718 100644 (file)
@@ -1,7 +1,7 @@
 <?php
 /************************************************************************
- * MXChange v0.2.1                                    Start: 06/30/2003 *
- * ===============                              Last change: 11/27/2004 *
+ * Mailer v0.2.1-FINAL                                Start: 06/30/2003 *
+ * ===================                          Last change: 11/27/2004 *
  *                                                                      *
  * -------------------------------------------------------------------- *
  * File              : admins_functions.php                             *
  * -------------------------------------------------------------------- *
  * Kurzbeschreibung  : Funktionen fuer die admins-Erweiterung           *
  * -------------------------------------------------------------------- *
- *                                                                      *
+ * $Revision::                                                        $ *
+ * $Date::                                                            $ *
+ * $Tag:: 0.2.1-FINAL                                                 $ *
+ * $Author::                                                          $ *
+ * Needs to be in all Files and every File needs "svn propset           *
+ * svn:keywords Date Revision" (autoprobset!) at least!!!!!!            *
  * -------------------------------------------------------------------- *
- * Copyright (c) 2003 - 2008 by Roland Haeder                           *
+ * Copyright (c) 2003 - 2009 by Roland Haeder                           *
+ * Copyright (c) 2009, 2010 by Mailer Developer Team                    *
  * For more information visit: http://www.mxchange.org                  *
  *                                                                      *
  * This program is free software; you can redistribute it and/or modify *
  ************************************************************************/
 
 // Some security stuff...
-if (ereg(basename(__FILE__), $_SERVER['PHP_SELF']))
-{
-       $INC = substr(dirname(__FILE__), 0, strpos(dirname(__FILE__), "/inc") + 4) . "/security.php";
-       require($INC);
-}
-//
-function ADMINS_CHECK_ACL($act, $wht)
-{
-       global $ADMINS, $ADMINS_ACLS, $CONFIG, $CACHE;
+if (!defined('__SECURITY')) {
+       die();
+}
+
+// Check ACL for menu combination
+function adminsCheckAdminAcl ($action, $what) {
        // If action is login or logout allow allways!
-       $default = "allow";
-       if (($act == "login") || ($act == "logout")) return true;
+       $default = 'allow';
+       if (($action == 'login') || ($action == 'logout')) return true;
 
        // Default is deny
        $ret = false;
 
-       // Get admin's defult access right
-       if (!empty($ADMINS['def_acl'][$_COOKIE['admin_login']])) {
-               // Load from cache
-               $default = $ADMINS['def_acl'][$_COOKIE['admin_login']];
+       // Get admin's id
+       $adminId = getCurrentAdminId();
 
-               // Count cache hits
-               $CONFIG['cache_hits']++;
-       } elseif (!is_object($CACHE)) {
-               // Load from database
-               $result = SQL_QUERY_ESC("SELECT default_acl FROM "._MYSQL_PREFIX."_admins WHERE login='%s' LIMIT 1",
-                array($_COOKIE['admin_login']), __FILE__, __LINE__);
-               list($default) = SQL_FETCHROW($result);
-               SQL_FREERESULT($result);
-       }
-
-       // Get admin's ID
-       $aid = GET_ADMIN_ID($_COOKIE['admin_login']);
+       // Get admin's defult access right
+       $default = getAdminDefaultAcl($adminId);
 
-       if (!empty($wht))
-       {
+       if (!empty($what)) {
                // Check for parent menu:
                // First get it's action value
-               $parent_action = GET_ACTION("admin", $wht);
+               $parent_action = getActionFromModuleWhat('admin', $what);
 
                // Check with this function...
-               $parent = ADMINS_CHECK_ACL($parent_action, "");
-       }
-        else
-       {
+               $parent = adminsCheckAdminAcl($parent_action, '');
+       } else {
                // Anything else is true!
                $parent = false;
        }
 
        // Shall I test for a main or sub menu? (action or what?)
-       $lines = 0; $acl_mode = "failed";
-       if (GET_EXT_VERSION("cache") >= "0.1.2")
-       {
-               // Load only from array when there are lines!
-               if (count($ADMINS_ACLS) > 0)
-               {
-                       // Load ACL from array
-                       foreach ($ADMINS_ACLS['admin_id'] as $id=>$aid_acls)
-                       {
-                               if ($aid == $aid_acls)
-                               {
-                                       // Okay, one line was found!
-                                       if ((!empty($act)) && ($ADMINS_ACLS['action_menu'][$id] == $act))
-                                       {
-                                               // Main menu line found
-                                               $acl_mode = $ADMINS_ACLS['access_mode'][$id];
-                                               $lines = 1;
-                                       }
-                                        elseif ((!empty($wht)) && ($ADMINS_ACLS['what_menu'][$id] == $wht))
-                                       {
-                                               // Check sub menu
-                                               $acl_mode = $ADMINS_ACLS['access_mode'][$id];
-                                               $lines = 1;
-                                       }
-                                       if ($lines == 1)
-                                       {
-                                               // Count cache hits
-                                               $CONFIG['cache_hits']++;
-                                               break;
-                                       }
-                               }
-                       }
+       $acl_mode = '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])) & ($GLOBALS['cache_array']['admin_acls']['action_menu'][$adminId] == $action)) {
+                       // Main menu line found
+                       $acl_mode = $GLOBALS['cache_array']['admin_acls']['access_mode'][$adminId];
 
-                       // No ACL found?
-                       if ($acl_mode == "failed")
-                       {
-                               $acl_mode = "";
-                               $lines = 0;
-                       }
-               }
-                else
-               {
-                       // No lines here
-                       $lines = 0;
+                       // Count cache hits
+                       incrementStatsEntry('cache_hits');
+               } elseif ((!empty($what)) && (isset($GLOBALS['cache_array']['admin_acls']['what_menu'][$adminId])) && ($GLOBALS['cache_array']['admin_acls']['what_menu'][$adminId] == $what)) {
+                       // Check sub menu
+                       $acl_mode = $GLOBALS['cache_array']['admin_acls']['access_mode'][$adminId];
+
+                       // Count cache hits
+                       incrementStatsEntry('cache_hits');
                }
-       }
-        else
-       {
+       } elseif (!isExtensionActive('cache')) {
                // Old version, so load it from database
-               if (!empty($act))
-               {
+               $result = false;
+               if (!empty($action)) {
                        // Main menu
-                       $result = SQL_QUERY_ESC("SELECT access_mode FROM "._MYSQL_PREFIX."_admins_acls WHERE admin_id=%d AND action_menu='%s' LIMIT 1",
-                        array(bigintval($aid), $act), __FILE__, __LINE__);
-               }
-                elseif (!empty($wht))
-               {
+                       $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=%d AND what_menu='%s' LIMIT 1",
-                        array(bigintval($aid), $wht), __FILE__, __LINE__);
+                       $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__);
                }
 
-               // Get number of lines
-               $lines = SQL_NUMROWS($result);
+               // Is an entry found?
+               if (SQL_NUMROWS($result) == 1) {
+                       // Load ACL
+                       list($acl_mode) = SQL_FETCHROW($result);
+               } // END - if
 
-               // Load ACL
-               list($acl_mode) = SQL_FETCHROW($result);
+               // Free memory
                SQL_FREERESULT($result);
        }
 
        // Check ACL and (maybe) allow
-       if ((($default == "allow") && ($lines == 0)) || (($default == "deny") && ($lines == "1") && ($acl_mode == "allow")) || (($lines == 0) && ($parent))) $ret = true;
+       //* DEBUG: */ debugOutput('default='.$default.',acl_mode='.$acl_mode.',parent='.intval($parent));
+       if (($default == 'allow') || (($default == 'deny') && ($acl_mode == 'allow')) || ($parent === true) || (($default == '***') && ($acl_mode == 'failed') && ($parent === false))) {
+               // Access is granted
+               $ret = true;
+       } // END - if
 
        // Return value
+       //* DEBUG: */ debugOutput(__FUNCTION__.'['.__LINE__.']:act='.$action.',wht='.$what.',default='.$default.',acl_mode='.$acl_mode);
        return $ret;
 }
+
 // Create email link to admins's account
-function ADMINS_CREATE_EMAIL_LINK($email, $mod="admin")
-{
-       $locked = " AND status='CONFIRMED'";
-       if (IS_ADMIN()) $locked = "";
-       if (strpos("@", $email) > 0)
-       {
+function generateAdminEmailLink ($email, $mod = 'admin') {
+       // Is it an email?
+       if (strpos($email, '@') !== false) {
                // Create email link
-               $result = SQL_QUERY_ESC("SELECT id
-FROM "._MYSQL_PREFIX."_admins
-WHERE email='%s'".$locked." LIMIT 1",
- array($email), __FILE__, __LINE__);
-               if (SQL_NUMROWS($result) == 1)
-               {
+               $result = SQL_QUERY_ESC("SELECT `id`
+FROM
+       `{?_MYSQL_PREFIX?}_admins`
+WHERE
+       `email`='%s'
+LIMIT 1",
+               array($email), __FUNCTION__, __LINE__);
+
+               // Is there an entry?
+               if (SQL_NUMROWS($result) == 1) {
                        // Load userid
-                       list($uid) = SQL_FETCHROW($result);
+                       list($adminId) = SQL_FETCHROW($result);
 
                        // Rewrite email address to contact link
-                       $email = URL."/modules.php?module=".$mod."&amp;what=user_contct&amp;u_id=".bigintval($uid);
-               }
+                       $email = '{%url=modules.php?module=' . $mod . '&amp;what=admins_contct&amp;admin=' . bigintval($adminId) . '%}';
+               } // END - if
 
                // Free memory
                SQL_FREERESULT($result);
-       }
-        elseif (bigintval($email) > 0)
-       {
-               // Direct ID given
-               $email = URL."/modules.php?module=".$mod."&amp;what=admins_contct&amp;admin=".bigintval($email);
+       } elseif ((is_int($email)) && ($email > 0)) {
+               // Direct id given
+               $email = '{%url=modules.php?module=' . $mod . '&amp;what=admins_contct&amp;admin=' . bigintval($email) . '%}';
        }
 
        // Return rewritten (?) email address
        return $email;
 }
-//
+
+// Change a lot admin account
+function adminsChangeAdminAccount ($postData, $element = '') {
+       // Begin the update
+       $cache_update = '0';
+       foreach ($postData['login'] as $id => $login) {
+               // Secure id number
+               $id = bigintval($id);
+
+               // 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 ((isset($postData['pass1'])) && (isset($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));
+
+                               // 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
+                                       setSession('admin_last', time());
+
+                                       if ($adminId != getSession('admin_id')) {
+                                               // Update login cookie
+                                               setSession('admin_id', $adminId);
+
+                                               // Update password cookie as well?
+                                               if (!empty($add)) setSession('admin_md5', $hash);
+                                       } elseif (generateHash($postData['pass1'][$id], $salt) != getSession('admin_md5')) {
+                                               // Update password cookie
+                                               setSession('admin_md5', $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['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 = '{--ADMINS_ERROR_PASS_MISMATCH--}';
+                       }
+               } else {
+                       // Update whole array
+                       $SQL = 'UPDATE `{?_MYSQL_PREFIX?}_admins` SET ';
+                       foreach ($postData as $entry => $value) {
+                               // Skip login/id entry
+                               if (in_array($entry, array('login', 'id'))) continue;
+
+                               // Do we have a non-string (e.g. number, NOW() or back-tick at the beginning?
+                               if ((bigintval($value[$id], true, false) === $value[$id]) || ($value[$id] == 'NOW()') || (substr($value[$id], 0, 1) == '`'))  {
+                                       // No need for ticks (')
+                                       $SQL .= '`' . $entry . '`=' . $value[$id] . ',';
+                               } else {
+                                       // Strings need ticks (') around them
+                                       $SQL .= '`' . $entry . "`='" . SQL_ESCAPE($value[$id]) . "',";
+                               }
+                       } // END - foreach
+
+                       // Remove last tick and finish query
+                       $SQL = substr($SQL, 0, -1) . ' WHERE `id`=%s LIMIT 1';
+
+                       // Run it
+                       SQL_QUERY_ESC($SQL, array(bigintval($id)), __FUNCTION__, __LINE__);
+               }
+       } // END - foreach
+
+       // Display message
+       if (!empty($message)) {
+               loadTemplate('admin_settings_saved', false, $message);
+       } // END - if
+
+       // Remove cache file
+       runFilterChain('post_admin_edited', postRequestArray());
+}
+
+// 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`, `default_acl` AS mode, `la_mode` 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);
+                       SQL_FREERESULT($result);
+
+                       // Prepare some more data for the template
+                       $content['id'] = $id;
+
+                       // Shall we allow changing default ACL?
+                       if ($currMode == 'allow') {
+                               // Allow chaning it
+                               $content['mode']    = generateOptionList('/ARRAY/', array('allow', 'deny'), array('{--ADMINS_ALLOW_MODE--}', '{--ADMINS_DENY_MODE--}'), $content['mode']);
+                       } else {
+                               // Don't allow it
+                               $content['mode'] = '&nbsp;';
+                       }
+                       $content['la_mode'] = generateOptionList('/ARRAY/', array('global', 'OLD', 'NEW'), array('{--ADMINS_GLOBAL_LA_SETTING--}', '{--ADMINS_OLD_LA_SETTING--}', '{--ADMINS_NEW_LA_SETTING--}'), $content['la_mode']);
+
+                       // Load row template and switch color
+                       $OUT .= loadTemplate('admin_edit_admins_row', true, $content);
+               } // END - if
+       } // END - foreach
+
+       // Load template
+       loadTemplate('admin_edit_admins', false, $OUT);
+}
+
+// Delete given admin accounts
+function adminsDeleteAdminAccount ($postData) {
+       // Check if this account is the last one which cannot be deleted...
+       $result_main = SQL_QUERY("SELECT `id` FROM `{?_MYSQL_PREFIX?}_admins`", __FUNCTION__, __LINE__);
+       $accounts = SQL_NUMROWS($result_main);
+       SQL_FREERESULT($result_main);
+       if ($accounts > 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 mode, la_mode FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
+                               array($id), __FUNCTION__, __LINE__);
+                       if (SQL_NUMROWS($result) == 1) {
+                               // Entry found
+                               $content = SQL_FETCHARRAY($result);
+                               SQL_FREERESULT($result);
+                               $content['mode']    = '{--ADMINS_' . strtoupper($content['mode'])    . '_MODE--}';
+                               $content['la_mode'] = '{--ADMINS_' . strtoupper($content['la_mode']) . '_LA_SETTING--}';
+
+                               // Prepare some more data
+                               $content['id'] = $id;
+
+                               // Load row template and switch color
+                               $OUT .= loadTemplate('admin_del_admins_row', true, $content);
+                       } // END - if
+               } // END - foreach
+
+               // Load template
+               loadTemplate('admin_del_admins', false, $OUT);
+       } else {
+               // Cannot delete last account!
+               loadTemplate('admin_settings_saved', false, '{--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`=0 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_admin_deleted', postRequestArray());
+}
+
+// List all admin accounts
+function adminsListAdminAccounts() {
+       // Select all admin accounts
+       $result = SQL_QUERY("SELECT `id`, `login`, `email`, `default_acl` AS mode, `la_mode` FROM `{?_MYSQL_PREFIX?}_admins` ORDER BY `login` ASC", __FUNCTION__, __LINE__);
+       $OUT = '';
+       while ($content = SQL_FETCHARRAY($result)) {
+               // Compile some variables
+               $content['mode']    = '{--ADMINS_' . strtoupper($content['mode'])    . '_MODE--}';
+               $content['la_mode'] = '{--ADMINS_' . strtoupper($content['la_mode']) . '_LA_SETTING--}';
+
+               // Prepare some more data
+               $content['email_link'] = generateEmailLink($content['id'], 'admins');
+
+               // 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 ($subj, $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__);
+       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__);
+       } else {
+               // Load admin ids...
+               // @TODO This can be, somehow, rewritten
+               $adminIds = array();
+               while ($content = SQL_FETCHARRAY($result)) {
+                       $adminIds[] = $content['admin_id'];
+               } // END - while
+
+               // Free memory
+               SQL_FREERESULT($result);
+
+               // Init result
+               $result = false;
+
+               // "implode" ids and query string
+               $adminId = implode(',', $adminIds);
+               if ($adminId == '-1') {
+                       if (isExtensionActive('events')) {
+                               // Add line to user events
+                               EVENTS_ADD_LINE($subj, $message, $userid);
+                       } else {
+                               // Log error for debug
+                               logDebugMessage(__FUNCTION__, __LINE__, sprintf("Extension 'events' missing: tpl=%s,subj=%s,userid=%s",
+                                       $template,
+                                       $subj,
+                                       $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__);
+               }
+       }
+
+       // Load email addresses and send away
+       while ($content = SQL_FETCHARRAY($result)) {
+               sendEmail($content['email'], $subj, $message);
+       } // 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 login
+       $admin = getAdminLogin(getCurrentAdminId());
+
+       // Lookup settings in cache
+       if (isset($GLOBALS['cache_array']['admin']['expert_settings'][$admin])) {
+               // Use cache
+               $data['expert_settings'] = $GLOBALS['cache_array']['admin']['expert_settings'][$admin];
+
+               // Update cache hits
+               incrementStatsEntry('cache_hits');
+       } elseif (!isExtensionInstalled('cache')) {
+               // Load from database
+               $result = SQL_QUERY_ESC("SELECT `expert_settings` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `login`='%s' LIMIT 1",
+                       array($admin), __FUNCTION__, __LINE__);
+
+               // Entry found?
+               if (SQL_NUMROWS($result) == 1) {
+                       // Fetch data
+                       $data = SQL_FETCHARRAY($result);
+
+                       // Set cache
+                       $GLOBALS['cache_array']['admin']['expert_settings'][$admin] = $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 login
+       $admin = getAdminLogin(getCurrentAdminId());
+
+       // Lookup warning in cache
+       if (isset($GLOBALS['cache_array']['admin']['expert_warning'][$admin])) {
+               // Use cache
+               $data['expert_warning'] = $GLOBALS['cache_array']['admin']['expert_warning'][$admin];
+
+               // Update cache hits
+               incrementStatsEntry('cache_hits');
+       } elseif (!isExtensionInstalled('cache')) {
+               // Load from database
+               $result = SQL_QUERY_ESC("SELECT `expert_warning` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `login`='%s' LIMIT 1",
+                       array($admin), __FUNCTION__, __LINE__);
+
+               // Entry found?
+               if (SQL_NUMROWS($result) == 1) {
+                       // Fetch data
+                       $data = SQL_FETCHARRAY($result);
+
+                       // Set cache
+                       $GLOBALS['cache_array']['admin']['expert_warning'][$admin] = $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 ($adminLogin) {
+       // Admin login should not be empty
+       if (empty($adminLogin)) {
+               debug_report_bug(__FUNCTION__, __LINE__, 'adminLogin is empty.');
+       } // END - if
+
+       // By default no admin is found
+       $data['login_failures'] = '-1';
+
+       // Check cache
+       if (isset($GLOBALS['cache_array']['admin']['login_failures'][$adminLogin])) {
+               // Use it if found to save SQL queries
+               $data['login_failures'] = $GLOBALS['cache_array']['admin']['login_failures'][$adminLogin];
+
+               // Update cache hits
+               incrementStatsEntry('cache_hits');
+       } elseif (!isExtensionActive('cache')) {
+               // Load from database
+               $result = SQL_QUERY_ESC("SELECT `login_failures` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `login`='%s' LIMIT 1",
+                       array($adminLogin), __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 ($adminLogin) {
+       // Admin login should not be empty
+       if (empty($adminLogin)) {
+               debug_report_bug(__FUNCTION__, __LINE__, 'adminLogin is empty.');
+       } // END - if
+
+       // By default no admin is found
+       $data['last_failure'] = '-1';
+
+       // Check cache
+       if (isset($GLOBALS['cache_array']['admin']['last_failure'][$adminLogin])) {
+               // Use it if found to save SQL queries
+               $data['last_failure'] = $GLOBALS['cache_array']['admin']['last_failure'][$adminLogin];
+
+               // 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 `login`='%s' LIMIT 1",
+                       array($adminLogin), __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'];
+}
+
+//*****************************************************************************
+//                     Below only filter functions
+//*****************************************************************************
+
+// Filter for adding extra data to the query
+function FILTER_ADD_EXTRA_SQL_DATA ($add = '') {
+       // Is the admins extension updated? (should be!)
+       if (isExtensionInstalledAndNewer('admins', '0.3.0')) $add .= ', `default_acl` AS def_acl';
+       if (isExtensionInstalledAndNewer('admins', '0.6.7')) $add .= ', `la_mode`';
+       if (isExtensionInstalledAndNewer('admins', '0.7.2')) $add .= ', `login_failures`, UNIX_TIMESTAMP(`last_failure`) AS last_failure';
+       if (isExtensionInstalledAndNewer('admins', '0.7.3')) $add .= ', `expert_settings`, `expert_warning`';
+
+       // Return it
+       return $add;
+}
+
+// Reset the login failures
+function FILTER_RESET_ADMINS_LOGIN_FAILURES ($data) {
+       // Store it in session
+       setSession('mailer_admin_failures'    , getAdminLoginFailures($data['login']));
+       setSession('mailer_admin_last_failure', getAdminLastFailure($data['login']));
+
+       // Prepare update data
+       $postData['login'][getCurrentAdminId()]          = $data['login'];
+       $postData['login_failures'][getCurrentAdminId()] = '0';
+       $postData['last_failure'][getCurrentAdminId()]   = '0000-00-00 00:00:00';
+
+       // Change it in the admin
+       adminsChangeAdminAccount($postData);
+
+       // Always make sure the cache is destroyed
+       rebuildCache('admin');
+
+       // Return the data for further processing
+       return $data;
+}
+
+// Count the login failure
+function FILTER_COUNT_ADMINS_LOGIN_FAILURE ($data) {
+       // Prepare update data
+       $postData['login'][getCurrentAdminId()]          = $data['login'];
+       $postData['login_failures'][getCurrentAdminId()] = '`login_failures`+1';
+       $postData['last_failure'][getCurrentAdminId()]   = 'NOW()';
+
+       // Change it in the admin
+       adminsChangeAdminAccount($postData);
+
+       // Always make sure the cache is destroyed
+       rebuildCache('admin');
+
+       // Return the data for further processing
+       return $data;
+}
+
+// Rehashes the given plain admin password and stores it the database
+function FILTER_REHASH_ADMINS_PASSWORD ($data) {
+       // Generate new hash
+       $newHash = generateHash($data['plain_pass']);
+
+       // Prepare update data
+       $postData['login'][getCurrentAdminId()]    = $data['login'];
+       $postData['password'][getCurrentAdminId()] = $newHash;
+
+       // Change it in the admin
+       adminsChangeAdminAccount($postData);
+
+       // Update cookie/session and data array
+       setSession('admin_md5', encodeHashForCookie($newHash));
+       $data['pass_hash'] = $newHash;
+
+       // Always make sure the cache is destroyed
+       rebuildCache('admin');
+
+       // Return the data for further processing
+       return $data;
+}
+
+// [EOF]
 ?>