inc/modules/admin/admin-inc.php

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