Full rewrite of extension updates (multiple updates are supported)
[mailer.git] / inc / modules / admin / admin-inc.php
1 <?php
2 /************************************************************************
3  * MXChange v0.2.1                                    Start: 08/31/2003 *
4  * ===============                              Last change: 11/23/2004 *
5  *                                                                      *
6  * -------------------------------------------------------------------- *
7  * File              : admin-inc.php                                    *
8  * -------------------------------------------------------------------- *
9  * Short description : Administrative related functions                 *
10  * -------------------------------------------------------------------- *
11  * Kurzbeschreibung  : Fuer die Administration benoetigte Funktionen    *
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 - 2008 by Roland Haeder                           *
21  * For more information visit: http://www.mxchange.org                  *
22  *                                                                      *
23  * This program is free software; you can redistribute it and/or modify *
24  * it under the terms of the GNU General Public License as published by *
25  * the Free Software Foundation; either version 2 of the License, or    *
26  * (at your option) any later version.                                  *
27  *                                                                      *
28  * This program is distributed in the hope that it will be useful,      *
29  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
30  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
31  * GNU General Public License for more details.                         *
32  *                                                                      *
33  * You should have received a copy of the GNU General Public License    *
34  * along with this program; if not, write to the Free Software          *
35  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
36  * MA  02110-1301  USA                                                  *
37  ************************************************************************/
38
39 // Some security stuff...
40 if (!defined('__SECURITY')) {
41         $INC = substr(dirname(__FILE__), 0, strpos(dirname(__FILE__), "/inc") + 4) . "/security.php";
42         require($INC);
43 }
44
45 // Register an administrator account
46 function REGISTER_ADMIN ($user, $md5, $email) {
47         // Login does already exist
48         $ret = "already";
49
50         // Lookup the admin
51         $result = SQL_QUERY_ESC("SELECT id FROM `{!_MYSQL_PREFIX!}_admins` WHERE login='%s' LIMIT 1",
52                 array($user), __FUNCTION__, __LINE__);
53
54         // Is the entry there?
55         if (SQL_NUMROWS($result) == 0) {
56                 // Ok, let's create the admin login
57                 SQL_QUERY_ESC("INSERT INTO `{!_MYSQL_PREFIX!}_admins` (login, password, email) VALUES ('%s', '%s', '%s')",
58                         array($user, $md5, $email), __FUNCTION__, __LINE__);
59                 $ret = "done";
60         } // END - if
61
62         // Free memory
63         SQL_FREERESULT($result);
64
65         // Return result
66         return $ret;
67 }
68
69 // Only be executed on login procedure!
70 function CHECK_ADMIN_LOGIN ($admin_login, $password) {
71         // By default no admin is found
72         $ret = "404";
73
74         // Get admin id
75         $aid = GET_ADMIN_ID($admin_login);
76
77         // Init array with admin id by default
78         $data = array('aid' => $aid);
79
80         // Is the cache valid?
81         if (isset($GLOBALS['cache_array']['admins']['password'][$aid])) {
82                 // Get password from cache
83                 $data['password'] = $GLOBALS['cache_array']['admins']['password'][$aid];
84                 $ret = "pass";
85                 incrementConfigEntry('cache_hits');
86
87                 // Include more admins data?
88                 if (GET_EXT_VERSION("admins") >= "0.7.2") {
89                         // Load them here
90                         $data['login_failures'] = $GLOBALS['cache_array']['admins']['login_failures'][$aid];
91                         $data['last_failure']   = $GLOBALS['cache_array']['admins']['last_failure'][$aid];
92                 } // END - if
93         } elseif (!EXT_IS_ACTIVE("cache")) {
94                 // Add extra data via filter now
95                 $ADD = runFilterChain('sql_admin_extra_data');
96
97                 // Get password from DB
98                 $result = SQL_QUERY_ESC("SELECT password".$ADD." FROM `{!_MYSQL_PREFIX!}_admins` WHERE id=%s LIMIT 1",
99                         array($aid), __FUNCTION__, __LINE__);
100
101                 // Entry found?
102                 if (SQL_NUMROWS($result) == 1) {
103                         // Login password found
104                         $ret = "pass";
105
106                         // Fetch data
107                         $data = SQL_FETCHARRAY($result);
108                 } // END - if
109
110                 // Free result
111                 SQL_FREERESULT($result);
112         }
113
114         //* DEBUG: */ echo "*".$data['password']."/".md5($password)."/".$ret."<br />";
115         if ((isset($data['password'])) && (strlen($data['password']) == 32) && ($data['password'] == md5($password))) {
116                 // Generate new hash
117                 $data['password'] = generateHash($password);
118
119                 // Is the sql_patches not installed, than we cannot have a valid hashed password here!
120                 if (($ret == "pass") && ((EXT_VERSION_IS_OLDER("sql_patches", "0.3.6")) || (GET_EXT_VERSION("sql_patches") == ""))) $ret = "done";
121         } elseif ((EXT_VERSION_IS_OLDER("sql_patches", "0.3.6")) || (GET_EXT_VERSION("sql_patches") == "")) {
122                 // Old hashing way
123                 return $ret;
124         } elseif (!isset($data['password'])) {
125                 // Password not found, so no valid login!
126                 return $ret;
127         }
128
129         // Generate salt of password
130         define('__SALT', substr($data['password'], 0, -40));
131         $salt = __SALT;
132
133         // Check if password is same
134         //* DEBUG: */ echo "*".$ret.",".$data['password'].",".$password.",".$salt."*<br >\n";
135         if (($ret == "pass") && ($data['password'] == generateHash($password, $salt)) && ((!empty($salt))) || ($data['password'] == $password)) {
136                 // Re-hash the plain passord with new random salt
137                 $data['password'] = generateHash($password);
138
139                 // Do we have 0.7.0 of admins or later?
140                 // Remmeber login failures if available
141                 if (GET_EXT_VERSION("admins") >= "0.7.2") {
142                         // Store it in session
143                         set_session('mxchange_admin_failures', $data['login_failures']);
144                         set_session('mxchange_admin_last_fail', $data['last_failure']);
145
146                         // Update password and reset login failures
147                         SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_admins` SET password='%s',login_failures=0,last_failure='0000-00-00 00:00:00' WHERE id=%s LIMIT 1",
148                                 array($data['password'], $aid), __FUNCTION__, __LINE__);
149                 } else {
150                         // Update password
151                         SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_admins` SET password='%s' WHERE id=%s LIMIT 1",
152                                 array($data['password'], $aid), __FUNCTION__, __LINE__);
153                 }
154
155                 // Rebuild cache
156                 rebuildCacheFiles("admins", "admin");
157
158                 // Login has failed by default... ;-)
159                 $ret = "failed";
160
161                 // Password matches so login here
162                 if (LOGIN_ADMIN($admin_login, $data['password'])) {
163                         // All done now
164                         $ret = "done";
165                 } // END - if
166         } elseif ((empty($salt)) && ($ret == "pass")) {
167                 // Something bad went wrong
168                 $ret = "failed";
169         } elseif ($ret == "done") {
170                 // Try to login here if we have the old hashing way (sql_patches not installed?)
171                 if (!LOGIN_ADMIN($admin_login, $data['password'])) {
172                         // Something went wrong
173                         $ret = "failed";
174                 } // END - if
175         }
176
177         // Count login failure if admins extension version is 0.7.0+
178         if (($ret == "pass") && (GET_EXT_VERSION("admins") >= "0.7.0")) {
179                 // Update counter
180                 SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_admins` SET login_failures=login_failures+1,last_failure=NOW() WHERE id=%s LIMIT 1",
181                         array($aid), __FUNCTION__, __LINE__);
182
183                 // Rebuild cache
184                 rebuildCacheFiles("admins", "admin");
185         } // END - if
186
187         // Return the result
188         //* DEBUG: */ die("RETURN=".$ret);
189         return $ret;
190 }
191
192 // Try to login the admin by setting some session/cookie variables
193 function LOGIN_ADMIN ($adminLogin, $passHash) {
194         // Reset failure counter on matching admins version
195         if ((GET_EXT_VERSION("admins") >= "0.7.0") && ((EXT_VERSION_IS_OLDER("sql_patches", "0.3.6")) || (GET_EXT_VERSION("sql_patches") == ""))) {
196                 // Reset counter on out-dated sql_patches version
197                 SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_admins` SET login_failures=0,last_failure='0000-00-00 00:00:00' WHERE login='%s' LIMIT 1",
198                         array($adminLogin), __FUNCTION__, __LINE__);
199
200                 // Rebuild cache
201                 rebuildCacheFiles("admins", "admin");
202         } // END - if
203
204         // Now set all session variables and return the result
205         return (
206                 (
207                         set_session('admin_md5', generatePassString($passHash))
208                 ) && (
209                         set_session('admin_login', $adminLogin)
210                 ) && (
211                         set_session('admin_last', time())
212                 ) && (
213                         set_session('admin_to', bigintval(REQUEST_POST('timeout')))
214                 )
215         );
216 }
217
218 // Only be executed on cookie checking
219 function CHECK_ADMIN_COOKIES ($admin_login, $password) {
220         // By default no admin cookies are found
221         $ret = "404"; $pass = "";
222
223         // Get hash
224         $pass = GET_ADMIN_HASH(GET_ADMIN_ID($admin_login));
225         if ($pass != "-1") $ret = "pass";
226
227         //* DEBUG: */ print __FUNCTION__."(<font color=\"#0000aa\">".__LINE__."</font>):".generatePassString($pass)."(".strlen($pass).")/".$password."(".strlen($password).")<br />\n";
228
229         // Check if password matches
230         if (($ret == "pass") && ((generatePassString($pass) == $password) || ($pass == $password) || ((strlen($pass) == 32) && (md5($password) == $pass)))) {
231                 // Passwords matches!
232                 $ret = "done";
233         }
234
235         // Return result
236         return $ret;
237 }
238
239 //
240 function ADMIN_DO_ACTION ($wht) {
241         global $DATA;
242         //* DEBUG: */ echo __LINE__."*".$wht."/".$GLOBALS['module']."/".$GLOBALS['action']."/".$GLOBALS['what']."*<br />\n";
243
244         // Remove any spaces from variable
245         if (empty($wht)) {
246                 // Default admin action is the overview page
247                 $wht = "overview";
248         } else {
249                 // Compile out some chars
250                 $wht = COMPILE_CODE($wht, false, false, false);
251         }
252
253         // Get action value
254         $act = GET_ACTION($GLOBALS['module'], $wht);
255
256         // Define admin login name and ID number
257         define('__ADMIN_LOGIN', get_session('admin_login'));
258         define('__ADMIN_ID'   , GET_CURRENT_ADMIN_ID());
259
260         // Preload templates
261         if (EXT_IS_ACTIVE("admins")) {
262                 define('__ADMIN_WELCOME', LOAD_TEMPLATE("admin_welcome_admins", true));
263         } else {
264                 define('__ADMIN_WELCOME', LOAD_TEMPLATE("admin_welcome", true));
265         }
266         define('__ADMIN_FOOTER' , LOAD_TEMPLATE("admin_footer" , true));
267         define('__ADMIN_MENU'   , ADD_ADMIN_MENU($act, $wht, true));
268
269         // Tableset header
270         LOAD_TEMPLATE("admin_main_header");
271
272         // Check if action/what pair is valid
273         $result_action = SQL_QUERY_ESC("SELECT id FROM `{!_MYSQL_PREFIX!}_admin_menu`
274 WHERE `action`='%s' AND ((what='%s' AND what != 'overview') OR ((what='' OR `what` IS NULL) AND '%s'='overview'))
275 LIMIT 1", array($act, $wht, $wht), __FUNCTION__, __LINE__);
276         if (SQL_NUMROWS($result_action) == 1) {
277                 // Is valid but does the inlcude file exists?
278                 $INC = sprintf("inc/modules/admin/action-%s.php", $act);
279                 if ((INCLUDE_READABLE($INC)) && (VALIDATE_MENU_ACTION("admin", $act, $wht)) && ($GLOBALS['acl_allow'] === true)) {
280                         // Ok, we finally load the admin action module
281                         LOAD_INC($INC);
282                 } elseif ($GLOBALS['acl_allow'] === false) {
283                         // Access denied
284                         LOAD_TEMPLATE("admin_menu_failed", false, getMessage('ADMIN_ACCESS_DENIED'));
285                         addFatalMessage(__FUNCTION__, __LINE__, getMessage('ADMIN_ACCESS_DENIED'));
286                 } else {
287                         // Include file not found! :-(
288                         LOAD_TEMPLATE("admin_menu_failed", false, sprintf(getMessage('ADMIN_ACTION_404'), $act));
289                         addFatalMessage(__FUNCTION__, __LINE__, getMessage('ADMIN_ACTION_404'), $act);
290                 }
291         } else {
292                 // Invalid action/what pair found!
293                 LOAD_TEMPLATE("admin_menu_failed", false, sprintf(getMessage('ADMIN_ACTION_INVALID'), $act."/".$wht));
294                 addFatalMessage(__FUNCTION__, __LINE__, getMessage('ADMIN_ACTION_INVALID'), $act."/".$wht);
295         }
296
297         // Free memory
298         SQL_FREERESULT($result_action);
299
300         // Tableset footer
301         LOAD_TEMPLATE("admin_main_footer");
302 }
303
304 //
305 function ADD_ADMIN_MENU ($act, $wht, $return=false) {
306         // Init variables
307         $SUB = false;
308         $OUT = "";
309
310         // Menu descriptions
311         $GLOBALS['menu']['description'] = array();
312         $GLOBALS['menu']['title'] = array();
313
314         // Is there a cache instance?
315         if ((isCacheInstanceValid()) && (getConfig('cache_admin_menu') == "Y")) {
316                 // Create cache name
317                 $cacheName = "admin_".$act."_".$wht."_".GET_LANGUAGE()."_".strtolower(get_session('admin_login'));
318
319                 // Is that cache there?
320                 if ($GLOBALS['cache_instance']->loadCacheFile($cacheName)) {
321                         // Then load it
322                         $data = $GLOBALS['cache_instance']->getArrayFromCache();
323
324                         // Extract all parts
325                         $OUT = base64_decode($data['output'][0]);
326                         $GLOBALS['menu']['title'] = unserialize(base64_decode($data['title'][0]));
327                         $GLOBALS['menu']['description'] = unserialize(base64_decode($data['descr'][0]));
328
329                         // Return or output content?
330                         if ($return === true) {
331                                 return $OUT;
332                         } else {
333                                 OUTPUT_HTML($OUT);
334                         }
335                 } // END - if
336         } // END - if
337
338         // Build main menu
339         $result_main = SQL_QUERY("SELECT action, title, descr FROM `{!_MYSQL_PREFIX!}_admin_menu` WHERE (what='' OR `what` IS NULL) ORDER BY `sort`, id DESC", __FUNCTION__, __LINE__);
340         if (SQL_NUMROWS($result_main) > 0) {
341                 $OUT = "<table border=\"0\" cellspacing=\"0\" cellpadding=\"0\" class=\"admin_menu_main\">
342 <tr><td colspan=\"2\" height=\"7\" class=\"seperator\">&nbsp;</td></tr>\n";
343                 // @TODO Rewrite this to $content = SQL_FETCHARRAY()
344                 while (list($menu, $title, $descr) = SQL_FETCHROW($result_main)) {
345                         if ((EXT_IS_ACTIVE("admins")) && (GET_EXT_VERSION("admins") > "0.2")) {
346                                 $ACL = ADMINS_CHECK_ACL($menu, "");
347                         } else {
348                                 // ACL is "allow"... hmmm
349                                 $ACL = true;
350                         }
351
352                         if ($ACL === true) {
353                                 if (!$SUB) {
354                                         // Insert compiled menu title and description
355                                         $GLOBALS['menu']['title'][$menu]      = $title;
356                                         $GLOBALS['menu']['description'][$menu] = $descr;
357                                 }
358                                 $OUT .= "<tr>
359         <td class=\"admin_menu\" colspan=\"2\">
360                 <nobr>&nbsp;<strong>&middot;</strong>&nbsp;";
361
362                                 if (($menu == $act) && (empty($wht))) {
363                                         $OUT .= "<strong>";
364                                 } else {
365                                         $OUT .= "[<a href=\"{!URL!}/modules.php?module=admin&amp;action=".$menu."\">";
366                                 }
367
368                                 $OUT .= $title;
369
370                                 if (($menu == $act) && (empty($wht))) {
371                                         $OUT .= "</strong>";
372                                 } else {
373                                         $OUT .= "</a>]";
374                                 }
375
376                                 $OUT .= "</nobr></td>
377 </tr>\n";
378
379                                 // Check for menu entries
380                                 $result_what = SQL_QUERY_ESC("SELECT what, title, descr FROM `{!_MYSQL_PREFIX!}_admin_menu` WHERE `action`='%s' AND `what` != '' AND `what` IS NOT NULL ORDER BY `sort`, id DESC",
381                                         array($menu), __FUNCTION__, __LINE__);
382
383                                 // Remember the count for later checks
384                                 setAdminMenuHasEntries($menu, ((SQL_NUMROWS($result_what) > 0) && ($act == $menu)));
385
386                                 // Do we have entries?
387                                 if (ifAdminMenuHasEntries($menu)) {
388                                         $GLOBALS['menu']['description'] = array();
389                                         $GLOBALS['menu']['title'] = array(); $SUB = true;
390                                         $OUT .= "<tr>
391         <td width=\"10\" class=\"seperator\">&nbsp;</td>
392         <td class=\"admin_menu\">
393                 <table border=\"0\" cellspacing=\"0\" cellpadding=\"0\" class=\"admin_menu_sub\">\n";
394                                         // @TODO Rewrite this to $content = SQL_FETCHARRAY()
395                                         while (list($wht_sub, $title_what, $desc_what) = SQL_FETCHROW($result_what)) {
396                                                 // Filename
397                                                 $INC = sprintf("inc/modules/admin/what-%s.php", $wht_sub);
398                                                 if ((EXT_IS_ACTIVE("admins")) && (GET_EXT_VERSION("admins") > "0.2")) {
399                                                         $ACL = ADMINS_CHECK_ACL("", $wht_sub);
400                                                 } else {
401                                                         // ACL is "allow"... hmmm
402                                                         $ACL = true;
403                                                 }
404
405                                                 // Is the file readable?
406                                                 $readable = INCLUDE_READABLE($INC);
407
408                                                 // Access allowed?
409                                                 if ($ACL === true) {
410                                                         // Insert compiled title and description
411                                                         $GLOBALS['menu']['title'][$wht_sub]      = $title_what;
412                                                         $GLOBALS['menu']['description'][$wht_sub] = $desc_what;
413                                                         $OUT .= "<tr>
414         <td class=\"admin_menu\" colspan=\"2\">
415                 <nobr>&nbsp;<strong>--&gt;</strong>&nbsp;";
416                                                         if ($readable === true) {
417                                                                 if ($wht == $wht_sub) {
418                                                                         $OUT .= "<strong>";
419                                                                 } else {
420                                                                         $OUT .= "[<a href=\"{!URL!}/modules.php?module=admin&amp;what=".$wht_sub."\">";
421                                                                 }
422                                                         } else {
423                                                                 $OUT .= "<i class=\"admin_note\">";
424                                                         }
425
426                                                         $OUT .= $title_what;
427
428                                                         if ($readable === true) {
429                                                                 if ($wht == $wht_sub) {
430                                                                         $OUT .= "</strong>";
431                                                                 } else {
432                                                                         $OUT .= "</a>]";
433                                                                 }
434                                                         } else {
435                                                                 $OUT .= "</em>";
436                                                         }
437                                                         $OUT .= "</nobr></td>
438 </tr>\n";
439                                                 }
440                                         }
441
442                                         // Free memory
443                                         SQL_FREERESULT($result_what);
444                                         $OUT .= "    </table>
445         </td>
446 </tr>\n";
447                                 }
448
449                                 $OUT .= "<tr><td height=\"7\" colspan=\"2\"></td></tr>\n";
450                         }
451                 }
452
453                 // Free memory
454                 SQL_FREERESULT($result_main);
455                 $OUT .= "</table>\n";
456         }
457
458         // Is there a cache instance again?
459         if ((isCacheInstanceValid()) && (getConfig('cache_admin_menu') == "Y")) {
460                 // Init cache
461                 $GLOBALS['cache_instance']->init($cacheName);
462
463                 // Prepare cache data
464                 $data = array(
465                         'output' => base64_encode($OUT),
466                         'title'  => $GLOBALS['menu']['title'],
467                         'descr'  => $GLOBALS['menu']['description']
468                 );
469
470                 // Write the data away
471                 $GLOBALS['cache_instance']->addRow($data);
472
473                 // Close cache
474                 $GLOBALS['cache_instance']->finalize();
475         } // END - if
476
477         // Return or output content?
478         if ($return === true) {
479                 return $OUT;
480         } else {
481                 OUTPUT_HTML($OUT);
482         }
483 }
484
485 // Create member selection box
486 function ADD_MEMBER_SELECTION_BOX ($def="0", $add_all=false, $return=false, $none=false, $field="userid") {
487         // Output selection form with all confirmed user accounts listed
488         $result = SQL_QUERY("SELECT userid, surname, family FROM `{!_MYSQL_PREFIX!}_user_data` ORDER BY userid", __FUNCTION__, __LINE__);
489
490         // Default output
491         $OUT = "";
492
493         // USe this only for adding points (e.g. adding refs really makes no sence ;-) )
494         if ($add_all === true)   $OUT = "      <option value=\"all\">{--ALL_MEMBERS--}</option>\n";
495          elseif ($none === true) $OUT = "      <option value=\"0\">{--SELECT_NONE--}</option>\n";
496
497         while ($content = SQL_FETCHARRAY($result)) {
498                 $OUT .= "      <option value=\"".bigintval($content['userid'])."\"";
499                 if ($def == $content['userid']) $OUT .= " selected=\"selected\"";
500                 $OUT .= ">".$content['surname']." ".$content['family']." (".bigintval($content['userid']).")</option>\n";
501         } // END - while
502
503         // Free memory
504         SQL_FREERESULT($result);
505
506         if (!$return) {
507                 // Remeber options in constant
508                 // @TODO Rewrite these both constants
509                 define('_MEMBER_SELECTION', $OUT);
510
511                 // Display selection box
512                 define('__LANG_VALUE', GET_LANGUAGE());
513
514                 // Load template
515                 LOAD_TEMPLATE("admin_member_selection_box", false, $GLOBALS['what']);
516         } else {
517                 // Return content in selection frame
518                 return "<select class=\"admin_select\" name=\"".$field."\" size=\"1\">\n".$OUT."</select>\n";
519         }
520 }
521
522 // Create a menu selection box for given menu system
523 function ADMIN_MENU_SELECTION ($MODE, $default="", $defid="") {
524         $wht = "`what` != ''";
525         if ($MODE == "action") $wht = "(what='' OR `what` IS NULL) AND action !='login'";
526         $result = SQL_QUERY_ESC("SELECT %s, title FROM `{!_MYSQL_PREFIX!}_admin_menu` WHERE ".$wht." ORDER BY `sort`",
527                 array($MODE), __FUNCTION__, __LINE__);
528         if (SQL_NUMROWS($result) > 0) {
529                 // Load menu as selection
530                 $OUT = "<select name=\"".$MODE."_menu";
531                 if ((!empty($defid)) || ($defid == "0")) $OUT .= "[".$defid."]";
532                 $OUT .= "\" size=\"1\" class=\"admin_select\">
533         <option value=\"\">{--SELECT_NONE--}</option>\n";
534                 // @TODO Try to rewrite this to $content = SQL_FETCHARRAY(). Please look some lines above for the dynamic query
535                 while (list($menu, $title) = SQL_FETCHROW($result)) {
536                         $OUT .= "  <option value=\"".$menu."\"";
537                         if ((!empty($default)) && ($default == $menu)) $OUT .= " selected=\"selected\"";
538                         $OUT .= ">".$title."</option>\n";
539                 } // END - while
540
541                 // Free memory
542                 SQL_FREERESULT($result);
543                 $OUT .= "</select>\n";
544         } else {
545                 // No menus???
546                 $OUT = getMessage('ADMIN_PROBLEM_NO_MENU');
547         }
548
549         // Return output
550         return $OUT;
551 }
552
553 // Wrapper for $_POST and ADMIN_SAVE_SETTINGS
554 function ADMIN_SAVE_SETTINGS_POST () {
555         // Get the array
556         $POST = REQUEST_POST_ARRAY();
557
558         // Call the lower function
559         ADMIN_SAVE_SETTINGS($POST);
560 }
561
562 // Save settings to the database
563 function ADMIN_SAVE_SETTINGS (&$POST, $tableName = "_config", $whereStatement = "config=0", $translateComma = array(), $alwaysAdd = false) {
564         // Prepare all arrays, variables
565         $DATA = array();
566         $skip = false;
567
568         // Now, walk through all entries and prepare them for saving
569         foreach ($POST as $id => $val) {
570                 // Process only formular field but not submit buttons ;)
571                 if ($id != "ok") {
572                         // Do not save the ok value
573                         CONVERT_SELECTIONS_TO_TIMESTAMP($POST, $DATA, $id, $skip);
574
575                         // Shall we process this ID? It muss not be empty, of course
576                         if ((!$skip) && (!empty($id))) {
577                                 // Save this entry
578                                 $val = COMPILE_CODE($val);
579
580                                 // Translate the value? (comma to dot!)
581                                 if ((is_array($translateComma)) && (in_array($id, $translateComma))) {
582                                         // Then do it here... :)
583                                         $val = REVERT_COMMA($val);
584                                 } // END - if
585
586                                 // Shall we add numbers or strings?
587                                 $test = (float)$val;
588                                 if ("".$val."" == "".$test."") {
589                                         // Add numbers
590                                         $DATA[] = sprintf("`%s`=%s", $id, $test);
591                                 } else {
592                                         // Add strings
593                                         $DATA[] = sprintf("`%s`='%s'", $id, trim($val));
594                                 }
595
596                                 // Update current configuration
597                                 setConfigEntry($id, $val);
598                         } // END - if
599                 } // END - if
600         } // END - foreach
601
602         // Check if entry does exist
603         $result = false;
604         if (!$alwaysAdd) {
605                 if (!empty($whereStatement)) {
606                         $result = SQL_QUERY("SELECT * FROM `{!_MYSQL_PREFIX!}".$tableName."` WHERE ".$whereStatement." LIMIT 1", __FUNCTION__, __LINE__);
607                 } else {
608                         $result = SQL_QUERY("SELECT * FROM `{!_MYSQL_PREFIX!}".$tableName."` LIMIT 1", __FUNCTION__, __LINE__);
609                 }
610         } // END - if
611
612         if (SQL_NUMROWS($result) == 1) {
613                 // "Implode" all data to single string
614                 $DATA_UPDATE = implode(", ", $DATA);
615
616                 // Generate SQL string
617                 $sql = sprintf("UPDATE `{!_MYSQL_PREFIX!}%s` SET %s WHERE %s LIMIT 1",
618                         $tableName,
619                         $DATA_UPDATE,
620                         $whereStatement
621                 );
622         } else {
623                 // Add Line (does only work with auto_increment!
624                 $KEYs = array(); $VALUEs = array();
625                 foreach ($DATA as $entry) {
626                         // Split up
627                         $line = explode("=", $entry);
628                         $KEYs[] = $line[0]; $VALUEs[] = $line[1];
629                 } // END - foreach
630
631                 // Add both in one line
632                 $KEYs = implode(", ", $KEYs);
633                 $VALUEs = implode(", ", $VALUEs);
634
635                 // Generate SQL string
636                 $sql = sprintf("INSERT INTO {!_MYSQL_PREFIX!}%s (%s) VALUES (%s)",
637                         $tableName,
638                         $KEYs,
639                         $VALUEs
640                 );
641         }
642
643         // Free memory
644         SQL_FREERESULT($result);
645
646         // Simply run generated SQL string
647         SQL_QUERY($sql, __FUNCTION__, __LINE__);
648
649         // Rebuild cache
650         rebuildCacheFiles("config", "config");
651
652         // Settings saved
653         LOAD_TEMPLATE("admin_settings_saved", false, getMessage('SETTINGS_SAVED'));
654 }
655
656 // Generate a selection box
657 function ADMIN_MAKE_MENU_SELECTION ($menu, $type, $name, $default="") {
658         // Open the requested menu directory
659         $handle = opendir(sprintf("%sinc/modules/%s/", constant('PATH'), $menu)) or mxchange_die("Cannot load menu ".$menu."!");
660
661         // Init the selection box
662         $OUT = "<select name=\"".$name."\" class=\"admin_select\" size=\"1\">
663         <option value=\"\">{--IS_TOP_MENU--}</option>\n";
664
665         // Walk through all files
666         while ($file = readdir($handle)) {
667                 // Is this a PHP script?
668                 if (($file != ".") && ($file != "..") && ($file != "lost+found") && (strpos($file, "".$type."-") > -1) && (strpos($file, ".php") > 0)) {
669                         // Then test if the file is readable
670                         $test = sprintf("%sinc/modules/%s/%s", constant('PATH'), $menu, $file);
671
672                         // Is the file there?
673                         if (FILE_READABLE($test)) {
674                                 // Extract the value for what=xxx
675                                 $part = substr($file, (strlen($type) + 1));
676                                 $part = substr($part, 0, -4);
677
678                                 // Is that part different from the overview?
679                                 if ($part != "overview") {
680                                         $OUT .= "       <option value=\"".$part."\"";
681                                         if ($part == $default) $OUT .= " selected=\"selected\"";
682                                         $OUT .= ">".$part."</option>\n";
683                                 } // END - if
684                         } // END - if
685                 } // END - if
686         } // END - while
687
688         // Close dir and selection box
689         closedir($handle);
690         $OUT .= "</select>\n";
691         
692         // Return contents
693         return $OUT;
694 }
695
696 // Creates a user-profile link for the admin. This function can also be used for many other purposes
697 function ADMIN_USER_PROFILE_LINK ($uid, $title="", $wht="list_user") {
698         if (($title == "") && ($title != "0")) {
699                 // Set userid as title
700                 $title = $uid;
701         } // END - if
702
703         if (($title == "0") && ($wht == "list_refs")) {
704                 // Return title again
705                 return $title;
706         } // END - if
707
708         //* DEBUG: */ echo "a:".$title."<br />";
709         // Return link
710         return "<a href=\"{!URL!}/modules.php?module=admin&amp;what=".$wht."&amp;uid=".$uid."\" title=\"{--ADMIN_USER_PROFILE_TITLE--}\">".$title."</a>";
711 }
712
713 // Check "logical-area-mode"
714 function ADMIN_CHECK_MENU_MODE () {
715         // Set the global mode as the mode for all admins
716         $MODE = getConfig('admin_menu');
717         $ADMIN = $MODE;
718
719         // Get admin id
720         $aid = GET_CURRENT_ADMIN_ID();
721
722         // Check individual settings of current admin
723         if (isset($GLOBALS['cache_array']['admins']['la_mode'][$aid])) {
724                 // Load from cache
725                 $ADMIN = $GLOBALS['cache_array']['admins']['la_mode'][$aid];
726                 incrementConfigEntry('cache_hits');
727         } elseif (GET_EXT_VERSION("admins") >= "0.6.7") {
728                 // Load from database when version of "admins" is enough
729                 $result = SQL_QUERY_ESC("SELECT la_mode FROM `{!_MYSQL_PREFIX!}_admins` WHERE id=%s LIMIT 1",
730                         array($aid), __FUNCTION__, __LINE__);
731                 if (SQL_NUMROWS($result) == 1) {
732                         // Load data
733                         list($ADMIN) = SQL_FETCHROW($result);
734                 }
735
736                 // Free memory
737                 SQL_FREERESULT($result);
738         }
739
740         // Check what the admin wants and set it when it's not the global mode
741         if ($ADMIN != "global") $MODE = $ADMIN;
742
743         // Return admin-menu's mode
744         return $MODE;
745 }
746
747 // Change activation status
748 function ADMIN_CHANGE_ACTIVATION_STATUS ($IDs, $table, $row, $idRow = "id") {
749         $cnt = 0; $newStatus = "Y";
750         if ((is_array($IDs)) && (count($IDs) > 0)) {
751                 // "Walk" all through and count them
752                 foreach ($IDs as $id => $selected) {
753                         // Secure the ID number
754                         $id = bigintval($id);
755
756                         // Should always be set... ;-)
757                         if (!empty($selected)) {
758                                 // Determine new status
759                                 $result = SQL_QUERY_ESC("SELECT %s FROM `{!_MYSQL_PREFIX!}_%s` WHERE %s=%s LIMIT 1",
760                                         array($row, $table, $idRow, $id), __FUNCTION__, __LINE__);
761
762                                 // Row found?
763                                 if (SQL_NUMROWS($result) == 1) {
764                                         // Load the status
765                                         list($currStatus) = SQL_FETCHROW($result);
766
767                                         // And switch it N<->Y
768                                         if ($currStatus == "Y") $newStatus = "N"; else $newStatus = "Y";
769
770                                         // Change this status
771                                         SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_%s` SET %s='%s' WHERE %s=%s LIMIT 1",
772                                                 array($table, $row, $newStatus, $idRow, $id), __FUNCTION__, __LINE__);
773
774                                         // Count up affected rows
775                                         $cnt += SQL_AFFECTEDROWS();
776                                 } // END - if
777
778                                 // Free the result
779                                 SQL_FREERESULT($result);
780                         } // END - if
781                 } // END - foreach
782
783                 // Output status
784                 LOAD_TEMPLATE("admin_settings_saved", false, sprintf(getMessage('ADMIN_STATUS_CHANGED'), $cnt, count($IDs)));
785         } else {
786                 // Nothing selected!
787                 LOAD_TEMPLATE("admin_settings_saved", false, getMessage('ADMIN_NOTHING_SELECTED_CHANGE'));
788         }
789 }
790
791 // Send mails for del/edit/lock build modes
792 function ADMIN_SEND_BUILD_MAILS ($mode, $table, $content, $id, $subjectPart="") {
793         // Default subject is the subject part
794         $subject = $subjectPart;
795
796         // Is the subject part not set?
797         if (empty($subjectPart)) {
798                 // Then use it from the mode
799                 $subject = strtoupper($mode);
800         } // END - if
801
802         // Is the raw userid set?
803         if (REQUEST_POST('uid_raw', $id) > 0) {
804                 // Generate subject
805                 $subjectLine = getMessage('MEMBER_'.strtoupper($subject).'_'.strtoupper($table).'_SUBJECT');
806
807                 // Load email template
808                 if (!empty($subjectPart)) {
809                         $mail = LOAD_EMAIL_TEMPLATE("member_".$mode."_".strtolower($subjectPart)."_".$table, $content);
810                 } else {
811                         $mail = LOAD_EMAIL_TEMPLATE("member_".$mode."_".$table, $content);
812                 }
813
814                 // Send email out
815                 SEND_EMAIL(REQUEST_POST('uid_raw', $id), $subjectLine, $mail);
816         } // END - if
817
818         // Generate subject
819         $subjectLine = getMessage('ADMIN_'.strtoupper($subject).'_'.strtoupper($table).'_SUBJECT');
820
821         // Send admin notification out
822         if (!empty($subjectPart)) {
823                 SEND_ADMIN_NOTIFICATION($subjectLine, "admin_".$mode."_".strtolower($subjectPart)."_".$table, $content, REQUEST_POST('uid_raw', $id));
824         } else {
825                 SEND_ADMIN_NOTIFICATION($subjectLine, "admin_".$mode."_".$table, $content, REQUEST_POST('uid_raw', $id));
826         }
827 }
828
829 // Build a special template list
830 function ADMIN_BUILD_LIST ($listType, $IDs, $table, $columns, $filterFunctions, $extraValues, $idColumn, $userIdColumn) {
831         $OUT = ""; $SW = 2;
832
833         // "Walk" through all entries
834         foreach ($IDs as $id => $selected) {
835                 // Secure ID number
836                 $id = bigintval($id);
837
838                 // Get result from a given column array and table name
839                 $result = SQL_RESULT_FROM_ARRAY($table, $columns, $idColumn, $id, __FUNCTION__, __LINE__);
840
841                 // Is there one entry?
842                 if (SQL_NUMROWS($result) == 1) {
843                         // Load all data
844                         $content = SQL_FETCHARRAY($result);
845
846                         // Filter all data
847                         foreach ($content as $key => $value) {
848                                 // Search index
849                                 $idx = array_search($key, $columns, true);
850
851                                 // Do we have a userid?
852                                 if ($key == "userid") {
853                                         // Add it again as raw id
854                                         $content['uid'] = bigintval($value);
855                                 } // END - if
856
857                                 // Handle the call in external function
858                                 $content[$key] = HANDLE_EXTRA_VALUES($filterFunctions[$idx], $value, $extraValues[$idx]);
859                         } // END - foreach
860
861                         // Add color switching
862                         $content['sw'] = $SW;
863
864                         // Then list it
865                         $OUT .= LOAD_TEMPLATE(sprintf("admin_%s_%s_row",
866                                         $listType,
867                                         $table
868                                 ), true, $content
869                         );
870
871                         // Switch color
872                         $SW = 3 - $SW;
873                 } // END - if
874
875                 // Free the result
876                 SQL_FREERESULT($result);
877         } // END - foreach
878
879         // Load master template
880         LOAD_TEMPLATE(sprintf("admin_%s_%s",
881                         $listType,
882                         $table
883                 ), false, $OUT
884         );
885 }
886
887 // Change status of "build" list
888 function ADMIN_BUILD_STATUS_HANDLER ($mode, $IDs, $table, $columns, $filterFunctions, $extraValues, $idColumn, $userIdColumn, $statusArray) {
889         // All valid entries? (We hope so here!)
890         if ((is_array($IDs)) && (count($IDs) > 0) && (count($columns) == count($filterFunctions)) && (count($columns) == count($extraValues)) && (count($statusArray) > 0)) {
891                 // "Walk" through all entries
892                 foreach ($IDs as $id => $sel) {
893                         // Construct SQL query
894                         $sql = sprintf("UPDATE `{!_MYSQL_PREFIX!}_%s` SET",
895                                 SQL_ESCAPE($table)
896                         );
897
898                         // Load data of entry
899                         $result = SQL_QUERY_ESC("SELECT * FROM `{!_MYSQL_PREFIX!}_%s` WHERE %s=%s LIMIT 1",
900                                 array($table, $idColumn, $id), __FUNCTION__, __LINE__);
901
902                         // Fetch the data
903                         $content = SQL_FETCHARRAY($result);
904
905                         // Free the result
906                         SQL_FREERESULT($result);
907
908                         // Add all status entries (e.g. status column last_updated or so)
909                         $newStatus = "UNKNOWN";
910                         $oldStatus = "UNKNOWN";
911                         $statusColumn = "unknown";
912                         foreach ($statusArray as $column => $statusInfo) {
913                                 // Does the entry exist?
914                                 if ((isset($content[$column])) && (isset($statusInfo[$content[$column]]))) {
915                                         // Add these entries for update
916                                         $sql .= sprintf(" %s='%s',", SQL_ESCAPE($column), SQL_ESCAPE($statusInfo[$content[$column]]));
917
918                                         // Remember status
919                                         if ($statusColumn == "unknown") {
920                                                 // Always (!!!) change status column first!
921                                                 $oldStatus = $content[$column];
922                                                 $newStatus = $statusInfo[$oldStatus];
923                                                 $statusColumn = $column;
924                                         } // END - if
925                                 } elseif (isset($content[$column])) {
926                                         // Unfinished!
927                                         mxchange_die("{--".__FUNCTION__."--}:".__LINE__.":UNFINISHED: id={$id}/{$column}[".gettype($statusInfo)."] = {$content[$column]}");
928                                 }
929                         } // END - foreach
930
931                         // Add other columns as well
932                         foreach (REQUEST_POST_ARRAY() as $key => $entries) {
933                                 // Skip id, raw userid and 'do_$mode'
934                                 if (!in_array($key, array($idColumn, 'uid_raw', ('do_'.$mode)))) {
935                                         // Are there brackets () at the end?
936                                         if (substr($entries[$id], -2, 2) == "()") {
937                                                 // Direct SQL command found
938                                                 $sql .= sprintf(" %s=%s,", SQL_ESCAPE($key), SQL_ESCAPE($entries[$id]));
939                                         } else {
940                                                 // Add regular entry
941                                                 $sql .= sprintf(" %s='%s',", SQL_ESCAPE($key), SQL_ESCAPE($entries[$id]));
942
943                                                 // Add entry
944                                                 $content[$key] = $entries[$id];
945                                         }
946                                 } // END - if
947                         } // END - foreach
948
949                         // Finish SQL statement
950                         $sql = substr($sql, 0, -1) . sprintf(" WHERE %s=%s AND %s='%s' LIMIT 1",
951                                 $idColumn,
952                                 bigintval($id),
953                                 $statusColumn,
954                                 $oldStatus
955                         );
956
957                         // Run the SQL
958                         SQL_QUERY($sql, __FUNCTION__, __LINE__);
959
960                         // Do we have an URL?
961                         if (isset($content['url'])) {
962                                 // Then add a framekiller test as well
963                                 $content['frametester'] = FRAMETESTER($content['url']);
964                         } // END - if
965
966                         // Send "build mails" out
967                         ADMIN_SEND_BUILD_MAILS($mode, $table, $content, $id, $statusInfo[$content[$column]]);
968                 } // END - foreach
969         } // END - if
970 }
971
972 // Delete rows by given ID numbers
973 function ADMIN_DELETE_ENTRIES_CONFIRM ($IDs, $table, $columns=array(), $filterFunctions=array(), $extraValues=array(), $deleteNow=false, $idColumn="id", $userIdColumn="userid") {
974         // All valid entries? (We hope so here!)
975         if ((is_array($IDs)) && (count($IDs) > 0) && (count($columns) == count($filterFunctions)) && (count($columns) == count($extraValues))) {
976                 // Shall we delete here or list for deletion?
977                 if ($deleteNow) {
978                         // The base SQL command:
979                         $sql = "DELETE LOW_PRIORITY FROM `{!_MYSQL_PREFIX!}_%s` WHERE %s IN (%s)";
980
981                         // Delete them all
982                         $idList = "";
983                         foreach ($IDs as $id => $sel) {
984                                 // Is there a userid?
985                                 if (REQUEST_ISSET_POST('uid_raw', $id)) {
986                                         // Load all data from that id
987                                         $result = SQL_QUERY_ESC("SELECT * FROM `{!_MYSQL_PREFIX!}_%s` WHERE %s=%s LIMIT 1",
988                                                 array($table, $idColumn, $id), __FUNCTION__, __LINE__);
989
990                                         // Fetch the data
991                                         $content = SQL_FETCHARRAY($result);
992
993                                         // Free the result
994                                         SQL_FREERESULT($result);
995
996                                         // Send "build mails" out
997                                         ADMIN_SEND_BUILD_MAILS("del", $table, $content, $id);
998                                 } // END - if
999
1000                                 // Add id number
1001                                 $idList .= $id.",";
1002                         } // END - foreach
1003
1004                         // Run the query
1005                         SQL_QUERY($sql, array($table, $idColumn, substr($idList, 0, -1)), __FUNCTION__, __LINE__);
1006
1007                         // Was this fine?
1008                         if (SQL_AFFECTEDROWS() == count($IDs)) {
1009                                 // All deleted
1010                                 LOAD_TEMPLATE("admin_settings_saved", false, getMessage('ADMIN_ALL_ENTRIES_REMOVED'));
1011                         } else {
1012                                 // Some are still there :(
1013                                 LOAD_TEMPLATE("admin_settings_saved", false, sprintf(getMessage('ADMIN_SOME_ENTRIES_NOT_DELETED'), SQL_AFFECTEDROWS(), count($IDs)));
1014                         }
1015                 } else {
1016                         // List for deletion confirmation
1017                         ADMIN_BUILD_LIST("del", $IDs, $table, $columns, $filterFunctions, $extraValues, $idColumn, $userIdColumn);
1018                 }
1019         } // END - if
1020 }
1021
1022 // Edit rows by given ID numbers
1023 function ADMIN_EDIT_ENTRIES_CONFIRM ($IDs, $table, $columns=array(), $filterFunctions=array(), $extraValues=array(), $editNow=false, $idColumn="id", $userIdColumn="userid") {
1024         // All valid entries? (We hope so here!)
1025         if ((is_array($IDs)) && (count($IDs) > 0) && (count($columns) == count($filterFunctions)) && (count($columns) == count($extraValues))) {
1026                 // Shall we change here or list for editing?
1027                 if ($editNow) {
1028                         // Change them all
1029                         $affected = 0;
1030                         foreach ($IDs as $id => $sel) {
1031                                 // Prepare content array (new values)
1032                                 $content = array();
1033
1034                                 // Prepare SQL for this row
1035                                 $sql = sprintf("UPDATE `{!_MYSQL_PREFIX!}_ SET",
1036                                         SQL_ESCAPE($table)
1037                                 );
1038                                 foreach (REQUEST_POST_ARRAY() as $key => $entries) {
1039                                         // Skip raw userid which is always invalid
1040                                         if ($key == "uid_raw") {
1041                                                 // Continue with next field
1042                                                 continue;
1043                                         } // END - if
1044
1045                                         // Is entries an array?
1046                                         if (($key != $idColumn) && (is_array($entries)) && (isset($entries[$id]))) {
1047                                                 // Add this entry to content
1048                                                 $content[$key] = $entries[$id];
1049
1050                                                 // Send data through the filter function if found
1051                                                 if ((isset($filterFunctions[$key])) && (isset($extraValues[$key]))) {
1052                                                         // Filter function set!
1053                                                         $entries[$id] = HANDLE_EXTRA_VALUES($filterFunctions[$key], $entries[$id], $extraValues[$key]);
1054                                                 } // END - if
1055
1056                                                 // Then add this value
1057                                                 $sql .= sprintf(" %s='%s',",
1058                                                         SQL_ESCAPE($key),
1059                                                         SQL_ESCAPE($entries[$id])
1060                                                 );
1061                                         } elseif (($key != $idColumn) && (!is_array($entries))) {
1062                                                 // Add normal entries as well!
1063                                                 $content[$key] =  $entries;
1064                                         }
1065
1066                                         // Do we have an URL?
1067                                         if ($key == "url") {
1068                                                 // Then add a framekiller test as well
1069                                                 $content['frametester'] = FRAMETESTER($content[$key]);
1070                                         } // END - if
1071                                 } // END - foreach
1072
1073                                 // Finish SQL command
1074                                 $sql = substr($sql, 0, -1) . " WHERE ".$idColumn."=".bigintval($id)." LIMIT 1";
1075
1076                                 // Run this query
1077                                 SQL_QUERY($sql, __FUNCTION__, __LINE__);
1078
1079                                 // Add affected rows
1080                                 $affected += SQL_AFFECTEDROWS();
1081
1082                                 // Load all data from that id
1083                                 $result = SQL_QUERY_ESC("SELECT * FROM `{!_MYSQL_PREFIX!}_%s` WHERE %s=%s LIMIT 1",
1084                                         array($table, $idColumn, $id), __FUNCTION__, __LINE__);
1085
1086                                 // Fetch the data
1087                                 global $DATA;
1088                                 $DATA = SQL_FETCHARRAY($result);
1089
1090                                 // Free the result
1091                                 SQL_FREERESULT($result);
1092
1093                                 // Send "build mails" out
1094                                 ADMIN_SEND_BUILD_MAILS("edit", $table, $content, $id);
1095                         } // END - foreach
1096
1097                         // Was this fine?
1098                         if ($affected == count($IDs)) {
1099                                 // All deleted
1100                                 LOAD_TEMPLATE("admin_settings_saved", false, getMessage('ADMIN_ALL_ENTRIES_EDITED'));
1101                         } else {
1102                                 // Some are still there :(
1103                                 LOAD_TEMPLATE("admin_settings_saved", false, sprintf(getMessage('ADMIN_SOME_ENTRIES_NOT_EDITED'), $affected, count($IDs)));
1104                         }
1105                 } else {
1106                         // List for editing
1107                         ADMIN_BUILD_LIST("edit", $IDs, $table, $columns, $filterFunctions, $extraValues, $idColumn, $userIdColumn);
1108                 }
1109         } // END - if
1110 }
1111
1112 // Un-/lock rows by given ID numbers
1113 function ADMIN_LOCK_ENTRIES_CONFIRM ($IDs, $table, $columns=array(), $filterFunctions=array(), $extraValues=array(), $statusArray=array(), $lockNow=false, $idColumn="id", $userIdColumn="userid") {
1114         // All valid entries? (We hope so here!)
1115         if ((is_array($IDs)) && (count($IDs) > 0) && (count($columns) == count($filterFunctions)) && (count($columns) == count($extraValues)) && ((!$lockNow) || (count($statusArray) == 1))) {
1116                 // Shall we un-/lock here or list for locking?
1117                 if ($lockNow) {
1118                         // Un-/lock entries
1119                         ADMIN_BUILD_STATUS_HANDLER("lock", $IDs, $table, $columns, $filterFunctions, $extraValues, $idColumn, $userIdColumn, $statusArray);
1120                 } else {
1121                         // List for editing
1122                         ADMIN_BUILD_LIST("lock", $IDs, $table, $columns, $filterFunctions, $extraValues, $idColumn, $userIdColumn);
1123                 }
1124         } // END - if
1125 }
1126
1127 // Undelete rows by given ID numbers
1128 function ADMIN_UNDELETE_ENTRIES_CONFIRM ($IDs, $table, $columns=array(), $filterFunctions=array(), $extraValues=array(), $statusArray=array(), $lockNow=false, $idColumn="id", $userIdColumn="userid") {
1129         // All valid entries? (We hope so here!)
1130         if ((is_array($IDs)) && (count($IDs) > 0) && (count($columns) == count($filterFunctions)) && (count($columns) == count($extraValues)) && ((!$lockNow) || (count($statusArray) == 1))) {
1131                 // Shall we un-/lock here or list for locking?
1132                 if ($lockNow) {
1133                         // Undelete entries
1134                         ADMIN_BUILD_STATUS_HANDLER("undelete", $IDs, $table, $columns, $filterFunctions, $extraValues, $idColumn, $userIdColumn, $statusArray);
1135                 } else {
1136                         // List for editing
1137                         ADMIN_BUILD_LIST("undelete", $IDs, $table, $columns, $filterFunctions, $extraValues, $idColumn, $userIdColumn);
1138                 }
1139         } // END - if
1140 }
1141
1142 // Checks proxy settins by fetching check-updates3.php from www.mxchange.org
1143 function ADMIN_TEST_PROXY_SETTINGS ($settingsArray) {
1144         // Set temporary the new settings
1145         mergeConfig($settingsArray);
1146
1147         // Now get the test URL
1148         $content = GET_URL("check-updates3.php");
1149
1150         // Is the first line with "200 OK"?
1151         $valid = eregi("200 OK", $content[0]);
1152
1153         // Return result
1154         return $valid;
1155 }
1156
1157 // Sends out a link to the given email adress so the admin can reset his/her password
1158 function ADMIN_SEND_PASSWORD_RESET_LINK ($email) {
1159         // Init output
1160         $OUT = "";
1161
1162         // Compile out security characters (must be for looking up!)
1163         $email = COMPILE_CODE($email);
1164
1165         // Look up administator login
1166         $result = SQL_QUERY_ESC("SELECT id, login, password FROM `{!_MYSQL_PREFIX!}_admins` WHERE email='%s' LIMIT 1",
1167                 array($email), __FUNCTION__, __LINE__);
1168
1169         // Is there an account?
1170         if (SQL_NUMROWS($result) == 0) {
1171                 // No account found!
1172                 return getMessage('ADMIN_NO_LOGIN_WITH_EMAIL');
1173         } // END - if
1174
1175         // Load all data
1176         $content = SQL_FETCHARRAY($result);
1177
1178         // Free result
1179         SQL_FREERESULT($result);
1180
1181         // Generate hash for reset link
1182         $content['hash'] = generateHash(URL.":".$content['id'].":".$content['login'].":".$content['password'], substr($content['password'], 10));
1183
1184         // Remove some data
1185         unset($content['id']);
1186         unset($content['password']);
1187
1188         // Prepare email
1189         $mailText = LOAD_EMAIL_TEMPLATE("admin_reset_password", $content);
1190
1191         // Send it out
1192         SEND_EMAIL($email, getMessage('ADMIN_RESET_PASS_LINK_SUBJ'), $mailText);
1193
1194         // Prepare output
1195         return getMessage('ADMIN_RESET_LINK_SENT');
1196 }
1197
1198 // Validate hash and login for password reset
1199 function ADMIN_VALIDATE_RESET_LINK_HASH_LOGIN ($hash, $login) {
1200         // By default nothing validates... ;)
1201         $valid = false;
1202
1203         // Compile the login for lookup
1204         $login = COMPILE_CODE($login);
1205
1206         // Then try to find that user
1207         $result = SQL_QUERY_ESC("SELECT id, password, email FROM `{!_MYSQL_PREFIX!}_admins` WHERE login='%s' LIMIT 1",
1208                 array($login), __FUNCTION__, __LINE__);
1209
1210         // Is an account here?
1211         if (SQL_NUMROWS($result) == 1) {
1212                 // Load all data
1213                 $content = SQL_FETCHARRAY($result);
1214
1215                 // Generate hash again
1216                 $hashFromData = generateHash(URL.":".$content['id'].":".$login.":".$content['password'], substr($content['password'], 10));
1217
1218                 // Does both match?
1219                 $valid = ($hash == $hashFromData);
1220         } // END - if
1221
1222         // Free result
1223         SQL_FREERESULT($result);
1224
1225         // Return result
1226         return $valid;
1227 }
1228
1229 // Reset the password for the login. Do NOT call this function without calling above function first!
1230 function ADMIN_RESET_PASSWORD ($login, $password) {
1231         // Init hash
1232         $passHash = "";
1233
1234         // Now check if we have sql_patches installed
1235         if (GET_EXT_VERSION("sql_patches") >= "0.3.6") {
1236                 // Use new way of hashing
1237                 $passHash = generateHash($password);
1238         } else {
1239                 // Old MD5 method
1240                 $passHash = md5($password);
1241         }
1242
1243         // Update database
1244         SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_admins` SET password='%s' WHERE login='%s' LIMIT 1",
1245                 array($passHash, $login), __FUNCTION__, __LINE__);
1246
1247         // Run filters
1248         runFilterChain('post_admin_reset_pass', array('login' => $login, 'hash' => $passHash));
1249
1250         // Return output
1251         return ADMIN_PASSWORD_RESET_DONE;
1252 }
1253
1254 // Solves a task by given id number
1255 function ADMIN_SOLVE_TASK ($id) {
1256         // Update the task data
1257         ADMIN_UPDATE_TASK_DATA($id, "status", "SOLVED");
1258 }
1259
1260 // Marks a given task as deleted
1261 function ADMIN_DELETE_TASK ($id) {
1262         // Update the task data
1263         ADMIN_UPDATE_TASK_DATA($id, "status", "DELETED");
1264 }
1265
1266 // Function to update task data
1267 function ADMIN_UPDATE_TASK_DATA ($id, $row, $data) {
1268         // Is the id not set, then we need a backtrace here... :(
1269         if ($id <= 0) {
1270                 // Initiate backtrace
1271                 debug_report_bug(sprintf("id is invalid: %s. row=%s, data=%s",
1272                         $id,
1273                         $row,
1274                         $data
1275                 ));
1276         } // END - if
1277
1278         // Update the task
1279         SQL_QUERY_ESC("UPDATE `{!_MYSQL_PREFIX!}_task_system` SET %s='%s' WHERE id=%s LIMIT 1",
1280                 array($row, $data, bigintval($id)), __FUNCTION__, __LINE__);
1281 }
1282
1283 // Checks wether if the admin menu has entries
1284 function ifAdminMenuHasEntries ($action) {
1285         return (
1286                 ((
1287                         isset($GLOBALS['admin_menu_has_entries'][$action])
1288                 ) && (
1289                         $GLOBALS['admin_menu_has_entries'][$action] === true
1290                 )) || (
1291                         $action == "login"
1292                 )
1293         );
1294 }
1295
1296 // Setter for 'admin_menu_has_entries'
1297 function setAdminMenuHasEntries ($action, $hasEntries) {
1298         $GLOBALS['admin_menu_has_entries'][$action] = (bool) $hasEntries;
1299 }
1300
1301 //
1302 ?>