3ec0d018869a6c7d6a770bb94d0266f6822b8ad7
[mailer.git] / inc / libs / admins_functions.php
1 <?php
2 /************************************************************************
3  * Mailer v0.2.1-FINAL                                Start: 06/30/2003 *
4  * ===================                          Last change: 11/27/2004 *
5  *                                                                      *
6  * -------------------------------------------------------------------- *
7  * File              : admins_functions.php                             *
8  * -------------------------------------------------------------------- *
9  * Short description : Functions for the admins extension               *
10  * -------------------------------------------------------------------- *
11  * Kurzbeschreibung  : Funktionen fuer die admins-Erweiterung           *
12  * -------------------------------------------------------------------- *
13  * $Revision::                                                        $ *
14  * $Date::                                                            $ *
15  * $Tag:: 0.2.1-FINAL                                                 $ *
16  * $Author::                                                          $ *
17  * Needs to be in all Files and every File needs "svn propset           *
18  * svn:keywords Date Revision" (autoprobset!) at least!!!!!!            *
19  * -------------------------------------------------------------------- *
20  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
21  * Copyright (c) 2009, 2010 by Mailer Developer Team                    *
22  * For more information visit: http://www.mxchange.org                  *
23  *                                                                      *
24  * This program is free software; you can redistribute it and/or modify *
25  * it under the terms of the GNU General Public License as published by *
26  * the Free Software Foundation; either version 2 of the License, or    *
27  * (at your option) any later version.                                  *
28  *                                                                      *
29  * This program is distributed in the hope that it will be useful,      *
30  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
31  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
32  * GNU General Public License for more details.                         *
33  *                                                                      *
34  * You should have received a copy of the GNU General Public License    *
35  * along with this program; if not, write to the Free Software          *
36  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
37  * MA  02110-1301  USA                                                  *
38  ************************************************************************/
39
40 // Some security stuff...
41 if (!defined('__SECURITY')) {
42         die();
43 }
44
45 // Check ACL for menu combination
46 function adminsCheckAdminAcl ($action, $what) {
47         // If action is login or logout allow allways!
48         $default = 'allow';
49         if (($action == 'login') || ($action == 'logout')) return true;
50
51         // Default is deny
52         $ret = false;
53
54         // Get admin's id
55         $adminId = getCurrentAdminId();
56
57         // Get admin's defult access right
58         $default = getAdminDefaultAcl($adminId);
59
60         if (!empty($what)) {
61                 // Check for parent menu:
62                 // First get it's action value
63                 $parent_action = getActionFromModuleWhat('admin', $what);
64
65                 // Check with this function...
66                 $parent = adminsCheckAdminAcl($parent_action, '');
67         } else {
68                 // Anything else is true!
69                 $parent = false;
70         }
71
72         // Shall I test for a main or sub menu? (action or what?)
73         $acl_mode = 'failed';
74         if ((isExtensionInstalledAndNewer('cache', '0.1.2')) && (isset($GLOBALS['cache_array']['admin_acls'])) && (count($GLOBALS['cache_array']['admin_acls']) > 0)) {
75                 // Lookup in cache
76                 if ((!empty($action)) && (isset($GLOBALS['cache_array']['admin_acls']['action_menu'][$adminId])) & ($GLOBALS['cache_array']['admin_acls']['action_menu'][$adminId] == $action)) {
77                         // Main menu line found
78                         $acl_mode = $GLOBALS['cache_array']['admin_acls']['access_mode'][$adminId];
79
80                         // Count cache hits
81                         incrementStatsEntry('cache_hits');
82                 } elseif ((!empty($what)) && (isset($GLOBALS['cache_array']['admin_acls']['what_menu'][$adminId])) && ($GLOBALS['cache_array']['admin_acls']['what_menu'][$adminId] == $what)) {
83                         // Check sub menu
84                         $acl_mode = $GLOBALS['cache_array']['admin_acls']['access_mode'][$adminId];
85
86                         // Count cache hits
87                         incrementStatsEntry('cache_hits');
88                 }
89         } elseif (!isExtensionActive('cache')) {
90                 // Old version, so load it from database
91                 $result = false;
92                 if (!empty($action)) {
93                         // Main menu
94                         $result = SQL_QUERY_ESC("SELECT `access_mode` FROM `{?_MYSQL_PREFIX?}_admins_acls` WHERE `admin_id`=%s AND `action_menu`='%s' LIMIT 1",
95                                 array(bigintval($adminId), $action), __FUNCTION__, __LINE__);
96                 } elseif (!empty($what)) {
97                         // Sub menu
98                         $result = SQL_QUERY_ESC("SELECT `access_mode` FROM `{?_MYSQL_PREFIX?}_admins_acls` WHERE `admin_id`=%s AND `what_menu`='%s' LIMIT 1",
99                                 array(bigintval($adminId), $what), __FUNCTION__, __LINE__);
100                 }
101
102                 // Is an entry found?
103                 if (SQL_NUMROWS($result) == 1) {
104                         // Load ACL
105                         list($acl_mode) = SQL_FETCHROW($result);
106                 } // END - if
107
108                 // Free memory
109                 SQL_FREERESULT($result);
110         }
111
112         // Check ACL and (maybe) allow
113         //* DEBUG: */ print 'default='.$default.',acl_mode='.$acl_mode.',parent='.intval($parent).'<br />';
114         if (($default == 'allow') || (($default == 'deny') && ($acl_mode == 'allow')) || ($parent === true) || (($default == '***') && ($acl_mode == 'failed') && ($parent === false))) {
115                 // Access is granted
116                 $ret = true;
117         } // END - if
118
119         // Return value
120         //* DEBUG: */ outputHtml(__FUNCTION__."[".__LINE__."]:act={$action},wht={$whatOR},default={$default},acl_mode={$acl_mode}<br />");
121         return $ret;
122 }
123
124 // Create email link to admins's account
125 function generateAdminEmailLink ($email, $mod = 'admin') {
126         // Is it an email?
127         if (strpos($email, '@') !== false) {
128                 // Create email link
129                 $result = SQL_QUERY_ESC("SELECT `id`
130 FROM
131         `{?_MYSQL_PREFIX?}_admins`
132 WHERE
133         `email`='%s'
134 LIMIT 1",
135                 array($email), __FUNCTION__, __LINE__);
136
137                 // Is there an entry?
138                 if (SQL_NUMROWS($result) == 1) {
139                         // Load userid
140                         list($adminId) = SQL_FETCHROW($result);
141
142                         // Rewrite email address to contact link
143                         $email = '{%url=modules.php?module=' . $mod . '&amp;what=admins_contct&amp;admin=' . bigintval($adminId) . '%}';
144                 } // END - if
145
146                 // Free memory
147                 SQL_FREERESULT($result);
148         } elseif ((is_int($email)) && ($email > 0)) {
149                 // Direct id given
150                 $email = '{%url=modules.php?module=' . $mod . '&amp;what=admins_contct&amp;admin=' . bigintval($email) . '%}';
151         }
152
153         // Return rewritten (?) email address
154         return $email;
155 }
156
157 // Change a lot admin account
158 function adminsChangeAdminAccount ($postData, $element = '') {
159         // Begin the update
160         $cache_update = '0';
161         foreach ($postData['login'] as $id => $login) {
162                 // Secure id number
163                 $id = bigintval($id);
164
165                 // When both passwords match update admin account
166                 if ((!empty($element)) && (isset($postData[$element]))) {
167                         // Save this setting
168                         SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_admins` SET `%s`='%s' WHERE `id`=%s LIMIT 1",
169                                 array($element, $postData[$element][$id], $id), __FILE__, __LINE__);
170
171                         // Admin account saved
172                         $message = getMessage('ADMIN_ACCOUNT_SAVED');
173                 } elseif ((isset($postData['pass1'])) && (isset($postData['pass2']))) {
174                         // Update only if both passwords match
175                         if (($postData['pass1'][$id] == $postData['pass2'][$id])) {
176                                 // Save only when both passwords are the same (also when they are empty)
177                                 $add = ''; $cache_update = 1;
178
179                                 // Generate hash
180                                 $hash = generateHash($postData['pass1'][$id]);
181
182                                 // Save password when set
183                                 if (!empty($postData['pass1'][$id])) $add = sprintf(", `password`='%s'", SQL_ESCAPE($hash));
184
185                                 // Get admin's id
186                                 $adminId = getCurrentAdminId();
187                                 $salt = substr(getAdminHash(getAdminLogin($adminId)), 0, -40);
188
189                                 // Rewrite cookie when it's own account
190                                 if ($adminId == $id) {
191                                         // Set timeout cookie
192                                         setSession('admin_last', time());
193
194                                         if ($login != getSession('admin_login')) {
195                                                 // Update login cookie
196                                                 setSession('admin_login', $login);
197
198                                                 // Update password cookie as well?
199                                                 if (!empty($add)) setSession('admin_md5', $hash);
200                                         } elseif (generateHash($postData['pass1'][$id], $salt) != getSession('admin_md5')) {
201                                                 // Update password cookie
202                                                 setSession('admin_md5', $hash);
203                                         }
204                                 } // END - if
205
206                                 // Get default ACL from admin to check if we can allow him to change the default ACL
207                                 $default = getAdminDefaultAcl(getCurrentAdminId());
208
209                                 // Update admin account
210                                 if ($default == 'allow') {
211                                         // Allow changing default ACL
212                                         SQL_QUERY_ESC("UPDATE
213         `{?_MYSQL_PREFIX?}_admins`
214 SET
215         `login`='%s'".$add.",
216         `email`='%s',
217         `default_acl`='%s',
218         `la_mode`='%s'
219 WHERE
220         `id`=%s
221 LIMIT 1",
222                                         array(
223                                                 $login,
224                                                 $postData['email'][$id],
225                                                 $postData['mode'][$id],
226                                                 $postData['la_mode'][$id],
227                                                 $id
228                                         ), __FUNCTION__, __LINE__);
229                                 } else {
230                                         // Do not allow it here
231                                         SQL_QUERY_ESC("UPDATE
232         `{?_MYSQL_PREFIX?}_admins`
233 SET
234         `login`='%s'".$add.",
235         `email`='%s',
236         `la_mode`='%s'
237 WHERE
238         `id`=%s
239 LIMIT 1",
240                                         array(
241                                                 $login,
242                                                 $postData['email'][$id],
243                                                 $postData['la_mode'][$id],
244                                                 $id
245                                         ), __FUNCTION__, __LINE__);
246                                 }
247
248                                 // Admin account saved
249                                 $message = getMessage('ADMIN_ACCOUNT_SAVED');
250                         } else {
251                                 // Passwords did not match
252                                 $message = getMessage('ADMINS_ERROR_PASS_MISMATCH');
253                         }
254                 } else {
255                         // Update whole array
256                         $SQL = 'UPDATE `{?_MYSQL_PREFIX?}_admins` SET ';
257                         foreach ($postData as $entry => $value) {
258                                 // Skip login/id entry
259                                 if (in_array($entry, array('login', 'id'))) continue;
260
261                                 // Do we have a non-string (e.g. number, NOW() or back-tick at the beginning?
262                                 if ((bigintval($value[$id], true, false) === $value[$id]) || ($value[$id] == 'NOW()') || (substr($value[$id], 0, 1) == '`'))  {
263                                         // No need for ticks (')
264                                         $SQL .= '`' . $entry . '`=' . $value[$id] . ',';
265                                 } else {
266                                         // Strings need ticks (') around them
267                                         $SQL .= '`' . $entry . "`='" . SQL_ESCAPE($value[$id]) . "',";
268                                 }
269                         } // END - foreach
270
271                         // Remove last tick and finish query
272                         $SQL = substr($SQL, 0, -1) . ' WHERE `id`=%s LIMIT 1';
273
274                         // Run it
275                         SQL_QUERY_ESC($SQL, array(bigintval($id)), __FUNCTION__, __LINE__);
276                 }
277         } // END - foreach
278
279         // Display message
280         if (!empty($message)) {
281                 loadTemplate('admin_settings_saved', false, $message);
282         } // END - if
283
284         // Remove cache file
285         runFilterChain('post_admin_edited', postRequestArray());
286 }
287
288 // Make admin accounts editable
289 function adminsEditAdminAccount ($postData) {
290         // "Resolve" current's admin access mode
291         $currMode = getAdminDefaultAcl(getCurrentAdminId());
292
293         // Begin the edit loop
294         $OUT = ''; $SW = 2;
295         foreach ($postData['sel'] as $id => $selected) {
296                 // Secure id number
297                 $id = bigintval($id);
298
299                 // Get the admin's data
300                 $result = SQL_QUERY_ESC("SELECT `login`, `email`, `default_acl` AS mode, `la_mode` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
301                         array($id), __FUNCTION__, __LINE__);
302                 if ((SQL_NUMROWS($result) == 1) && ($selected == 1)) {
303                         // Entry found
304                         $content = SQL_FETCHARRAY($result);
305                         SQL_FREERESULT($result);
306
307                         // Prepare some more data for the template
308                         $content['sw'] = $SW;
309                         $content['id'] = $id;
310
311                         // Shall we allow changing default ACL?
312                         if ($currMode == 'allow') {
313                                 // Allow chaning it
314                                 $content['mode']    = generateOptionList('/ARRAY/', array('allow', 'deny'), array(getMessage('ADMINS_ALLOW_MODE'), getMessage('ADMINS_DENY_MODE')), $content['mode']);
315                         } else {
316                                 // Don't allow it
317                                 $content['mode'] = '&nbsp;';
318                         }
319                         $content['la_mode'] = generateOptionList('/ARRAY/', array('global', 'OLD', 'NEW'), array(getMessage('ADMINS_GLOBAL_LA_SETTING'), getMessage('ADMINS_OLD_LA_SETTING'), getMessage('ADMINS_NEW_LA_SETTING')), $content['la_mode']);
320
321                         // Load row template and switch color
322                         $OUT .= loadTemplate('admin_edit_admins_row', true, $content);
323                         $SW = 3 - $SW;
324                 }
325         }
326
327         // Load template
328         loadTemplate('admin_edit_admins', false, $OUT);
329 }
330
331 // Delete given admin accounts
332 function adminsDeleteAdminAccount ($postData) {
333         // Check if this account is the last one which cannot be deleted...
334         $result_main = SQL_QUERY("SELECT `id` FROM `{?_MYSQL_PREFIX?}_admins`", __FUNCTION__, __LINE__);
335         $accounts = SQL_NUMROWS($result_main);
336         SQL_FREERESULT($result_main);
337         if ($accounts > 1) {
338                 // Delete accounts
339                 $OUT = ''; $SW = 2;
340                 foreach ($postData['sel'] as $id => $selected) {
341                         // Secure id number
342                         $id = bigintval($id);
343
344                         // Get the admin's data
345                         $result = SQL_QUERY_ESC("SELECT login, email, default_acl AS mode, la_mode FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
346                                 array($id), __FUNCTION__, __LINE__);
347                         if (SQL_NUMROWS($result) == 1) {
348                                 // Entry found
349                                 $content = SQL_FETCHARRAY($result);
350                                 SQL_FREERESULT($result);
351                                 $content['mode'] = getMessage('ADMINS_'.strtoupper($content['mode']).'_MODE');
352                                 $content['la_mode'] = getMessage('ADMINS_'.strtoupper($content['la_mode']).'_LA_SETTING');
353
354                                 // Prepare some more data
355                                 $content['sw'] = $SW;
356                                 $content['id'] = $id;
357
358                                 // Load row template and switch color
359                                 $OUT .= loadTemplate('admin_del_admins_row', true, $content);
360                                 $SW = 3 - $SW;
361                         }
362                 }
363
364                 // Load template
365                 loadTemplate('admin_del_admins', false, $OUT);
366         } else {
367                 // Cannot delete last account!
368                 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_ADMINS_CANNOT_DELETE_LAST'));
369         }
370 }
371
372 // Remove the given accounts
373 function adminsRemoveAdminAccount ($postData) {
374         // Begin removal
375         $cache_update = '0';
376         foreach ($postData['sel'] as $id => $del) {
377                 // Secure id number
378                 $id = bigintval($id);
379
380                 // Delete only when it's not your own account!
381                 if (($del == 1) && (getCurrentAdminId() != $id)) {
382                         // Rewrite his tasks to all admins
383                         SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_task_system` SET `assigned_admin`=0 WHERE `assigned_admin`=%s",
384                                 array($id), __FUNCTION__, __LINE__);
385
386                         // Remove account
387                         SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id`=%s LIMIT 1",
388                                 array($id), __FUNCTION__, __LINE__);
389                 }
390         }
391
392         // Remove cache if cache system is activated
393         runFilterChain('post_admin_deleted', postRequestArray());
394 }
395
396 // List all admin accounts
397 function adminsListAdminAccounts() {
398         // Select all admin accounts
399         $result = SQL_QUERY("SELECT `id`, `login`, `email`, `default_acl` AS mode, `la_mode` FROM `{?_MYSQL_PREFIX?}_admins` ORDER BY `login` ASC", __FUNCTION__, __LINE__);
400         $OUT = ''; $SW = 2;
401         while ($content = SQL_FETCHARRAY($result)) {
402                 // Compile some variables
403                 $content['mode'] = getMessage('ADMINS_'.strtoupper($content['mode']).'_MODE');
404                 $content['la_mode'] = getMessage('ADMINS_'.strtoupper($content['la_mode']).'_LA_SETTING');
405
406                 // Prepare some more data
407                 $content['sw']         = $SW;
408                 $content['email_link'] = generateEmailLink($content['id'], 'admins');
409
410                 // Load row template and switch color
411                 $OUT .= loadTemplate('admin_list_admins_row', true, $content);
412                 $SW = 3 - $SW;
413         }
414
415         // Free memory
416         SQL_FREERESULT($result);
417
418         // Load template
419         loadTemplate('admin_list_admins', false, $OUT);
420 }
421
422 // Sends out mail to all administrators
423 // IMPORTANT: Please use sendAdminNotification() instead of calling this function directly
424 function sendAdminsEmails ($subj, $template, $content, $userid) {
425         // Trim template name
426         $template = trim($template);
427
428         // Load email template
429         $message = loadEmailTemplate($template, $content, $userid);
430
431         // Check which admin shall receive this mail
432         $result = SQL_QUERY_ESC("SELECT `admin_id` FROM `{?_MYSQL_PREFIX?}_admins_mails` WHERE `mail_template`='%s' ORDER BY `admin_id` ASC",
433                 array($template), __FUNCTION__, __LINE__);
434         if (SQL_HASZERONUMS($result)) {
435                 // Create new entry (to all admins)
436                 SQL_QUERY_ESC("INSERT INTO `{?_MYSQL_PREFIX?}_admins_mails` (`admin_id`, `mail_template`) VALUES (0, '%s')",
437                         array($template), __FUNCTION__, __LINE__);
438         } else {
439                 // Load admin ids...
440                 // @TODO This can be, somehow, rewritten
441                 $adminIds = array();
442                 while ($content = SQL_FETCHARRAY($result)) {
443                         $adminIds[] = $content['admin_id'];
444                 } // END - while
445
446                 // Free memory
447                 SQL_FREERESULT($result);
448
449                 // Init result
450                 $result = false;
451
452                 // "implode" ids and query string
453                 $adminId = implode(',', $adminIds);
454                 if ($adminId == '-1') {
455                         if (isExtensionActive('events')) {
456                                 // Add line to user events
457                                 EVENTS_ADD_LINE($subj, $message, $userid);
458                         } else {
459                                 // Log error for debug
460                                 logDebugMessage(__FUNCTION__, __LINE__, sprintf("Extension 'events' missing: tpl=%s,subj=%s,userid=%s",
461                                         $template,
462                                         $subj,
463                                         $userid
464                                 ));
465                         }
466                 } elseif (($adminId == '0') || (empty($adminId))) {
467                         // Select all email adresses
468                         $result = SQL_QUERY("SELECT `email` FROM `{?_MYSQL_PREFIX?}_admins` ORDER BY `id` ASC",
469                                 __FUNCTION__, __LINE__);
470                 } else {
471                         // If Admin-Id is not "to-all" select
472                         $result = SQL_QUERY_ESC("SELECT `email` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `id` IN (%s) ORDER BY `id` ASC",
473                                 array($adminId), __FUNCTION__, __LINE__);
474                 }
475         }
476
477         // Load email addresses and send away
478         while ($content = SQL_FETCHARRAY($result)) {
479                 sendEmail($content['email'], $subj, $message);
480         } // END - while
481
482         // Free memory
483         SQL_FREERESULT($result);
484 }
485
486 // "Getter" for current admin's expert settings
487 function getAminsExpertSettings () {
488         // Default is has not the right
489         $data['expert_settings'] = 'N';
490
491         // Get current admin login
492         $admin = getAdminLogin(getCurrentAdminId());
493
494         // Lookup settings in cache
495         if (isset($GLOBALS['cache_array']['admin']['expert_settings'][$admin])) {
496                 // Use cache
497                 $data['expert_settings'] = $GLOBALS['cache_array']['admin']['expert_settings'][$admin];
498
499                 // Update cache hits
500                 incrementStatsEntry('cache_hits');
501         } elseif (!isExtensionInstalled('cache')) {
502                 // Load from database
503                 $result = SQL_QUERY_ESC("SELECT `expert_settings` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `login`='%s' LIMIT 1",
504                         array($admin), __FUNCTION__, __LINE__);
505
506                 // Entry found?
507                 if (SQL_NUMROWS($result) == 1) {
508                         // Fetch data
509                         $data = SQL_FETCHARRAY($result);
510
511                         // Set cache
512                         $GLOBALS['cache_array']['admin']['expert_settings'][$admin] = $data['expert_settings'];
513                 } // END - if
514
515                 // Free memory
516                 SQL_FREERESULT($result);
517         }
518
519         // Return the result
520         return $data['expert_settings'];
521 }
522
523 // "Getter" for current admin's expert warning (if he wants to see them or not
524 function getAminsExpertWarning () {
525         // Default is has not the right
526         $data['expert_warning'] = 'N';
527
528         // Get current admin login
529         $admin = getAdminLogin(getCurrentAdminId());
530
531         // Lookup warning in cache
532         if (isset($GLOBALS['cache_array']['admin']['expert_warning'][$admin])) {
533                 // Use cache
534                 $data['expert_warning'] = $GLOBALS['cache_array']['admin']['expert_warning'][$admin];
535
536                 // Update cache hits
537                 incrementStatsEntry('cache_hits');
538         } elseif (!isExtensionInstalled('cache')) {
539                 // Load from database
540                 $result = SQL_QUERY_ESC("SELECT `expert_warning` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `login`='%s' LIMIT 1",
541                         array($admin), __FUNCTION__, __LINE__);
542
543                 // Entry found?
544                 if (SQL_NUMROWS($result) == 1) {
545                         // Fetch data
546                         $data = SQL_FETCHARRAY($result);
547
548                         // Set cache
549                         $GLOBALS['cache_array']['admin']['expert_warning'][$admin] = $data['expert_warning'];
550                 } // END - if
551
552                 // Free memory
553                 SQL_FREERESULT($result);
554         }
555
556         // Return the result
557         return $data['expert_warning'];
558 }
559
560 // Get login_failures number from administrator's login name
561 function getAdminLoginFailures ($adminLogin) {
562         // Admin login should not be empty
563         if (empty($adminLogin)) {
564                 debug_report_bug('adminLogin is empty.');
565         } // END - if
566
567         // By default no admin is found
568         $data['login_failures'] = '-1';
569
570         // Check cache
571         if (isset($GLOBALS['cache_array']['admin']['login_failures'][$adminLogin])) {
572                 // Use it if found to save SQL queries
573                 $data['login_failures'] = $GLOBALS['cache_array']['admin']['login_failures'][$adminLogin];
574
575                 // Update cache hits
576                 incrementStatsEntry('cache_hits');
577         } elseif (!isExtensionActive('cache')) {
578                 // Load from database
579                 $result = SQL_QUERY_ESC("SELECT `login_failures` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `login`='%s' LIMIT 1",
580                         array($adminLogin), __FUNCTION__, __LINE__);
581
582                 // Do we have an entry?
583                 if (SQL_NUMROWS($result) == 1) {
584                         // Get it
585                         $data = SQL_FETCHARRAY($result);
586                 } // END - if
587
588                 // Free result
589                 SQL_FREERESULT($result);
590         }
591
592         // Return the login_failures
593         return $data['login_failures'];
594 }
595
596 // Get last_failure number from administrator's login name
597 function getAdminLastFailure ($adminLogin) {
598         // Admin login should not be empty
599         if (empty($adminLogin)) {
600                 debug_report_bug('adminLogin is empty.');
601         } // END - if
602
603         // By default no admin is found
604         $data['last_failure'] = '-1';
605
606         // Check cache
607         if (isset($GLOBALS['cache_array']['admin']['last_failure'][$adminLogin])) {
608                 // Use it if found to save SQL queries
609                 $data['last_failure'] = $GLOBALS['cache_array']['admin']['last_failure'][$adminLogin];
610
611                 // Update cache hits
612                 incrementStatsEntry('cache_hits');
613         } elseif (!isExtensionActive('cache')) {
614                 // Load from database
615                 $result = SQL_QUERY_ESC("SELECT UNIX_TIMESTAMP(`last_failure`) AS `last_failure` FROM `{?_MYSQL_PREFIX?}_admins` WHERE `login`='%s' LIMIT 1",
616                         array($adminLogin), __FUNCTION__, __LINE__);
617
618                 // Do we have an entry?
619                 if (SQL_NUMROWS($result) == 1) {
620                         // Get it
621                         $data = SQL_FETCHARRAY($result);
622                 } // END - if
623
624                 // Free result
625                 SQL_FREERESULT($result);
626         }
627
628         // Return the last_failure
629         return $data['last_failure'];
630 }
631
632 //*****************************************************************************
633 //                     Below only filter functions
634 //*****************************************************************************
635
636 // Filter for adding extra data to the query
637 function FILTER_ADD_EXTRA_SQL_DATA ($add = '') {
638         // Is the admins extension updated? (should be!)
639         if (isExtensionInstalledAndNewer('admins', '0.3.0')) $add .= ', `default_acl` AS def_acl';
640         if (isExtensionInstalledAndNewer('admins', '0.6.7')) $add .= ', `la_mode`';
641         if (isExtensionInstalledAndNewer('admins', '0.7.2')) $add .= ', `login_failures`, UNIX_TIMESTAMP(`last_failure`) AS last_failure';
642         if (isExtensionInstalledAndNewer('admins', '0.7.3')) $add .= ', `expert_settings`, `expert_warning`';
643
644         // Return it
645         return $add;
646 }
647
648 // Reset the login failures
649 function FILTER_RESET_ADMINS_LOGIN_FAILURES ($data) {
650         // Store it in session
651         setSession('mailer_admin_failures'    , getAdminLoginFailures($data['login']));
652         setSession('mailer_admin_last_failure', getAdminLastFailure($data['login']));
653
654         // Prepare update data
655         $postData['login'][getCurrentAdminId()]          = $data['login'];
656         $postData['login_failures'][getCurrentAdminId()] = '0';
657         $postData['last_failure'][getCurrentAdminId()]   = '0000-00-00 00:00:00';
658
659         // Change it in the admin
660         adminsChangeAdminAccount($postData);
661
662         // Always make sure the cache is destroyed
663         rebuildCache('admin');
664
665         // Return the data for further processing
666         return $data;
667 }
668
669 // Count the login failure
670 function FILTER_COUNT_ADMINS_LOGIN_FAILURE ($data) {
671         // Prepare update data
672         $postData['login'][getCurrentAdminId()]          = $data['login'];
673         $postData['login_failures'][getCurrentAdminId()] = '`login_failures`+1';
674         $postData['last_failure'][getCurrentAdminId()]   = 'NOW()';
675
676         // Change it in the admin
677         adminsChangeAdminAccount($postData);
678
679         // Always make sure the cache is destroyed
680         rebuildCache('admin');
681
682         // Return the data for further processing
683         return $data;
684 }
685
686 // Rehashes the given plain admin password and stores it the database
687 function FILTER_REHASH_ADMINS_PASSWORD ($data) {
688         // Generate new hash
689         $newHash = generateHash($data['plain_pass']);
690
691         // Prepare update data
692         $postData['login'][getCurrentAdminId()]    = $data['login'];
693         $postData['password'][getCurrentAdminId()] = $newHash;
694
695         // Change it in the admin
696         adminsChangeAdminAccount($postData);
697
698         // Update cookie/session and data array
699         setSession('admin_md5', encodeHashForCookie($newHash));
700         $data['pass_hash'] = $newHash;
701
702         // Always make sure the cache is destroyed
703         rebuildCache('admin');
704
705         // Return the data for further processing
706         return $data;
707 }
708
709 // [EOF]
710 ?>