1:   2:   3:   4:   5:   6:   7:   8:   9:  10:  11:  12:  13:  14:  15:  16:  17:  18:  19:  20:  21:  22:  23:  24:  25:  26:  27:  28:  29:  30:  31:  32:  33:  34:  35:  36:  37:  38:  39:  40:  41:  42:  43:  44:  45:  46:  47:  48:  49:  50:  51:  52:  53:  54:  55:  56:  57:  58:  59:  60:  61:  62:  63:  64:  65:  66:  67:  68:  69:  70:  71:  72:  73:  74:  75:  76:  77:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: 211: 212: 213: 214: 215: 216: 217: 218: 219: 220: 221: 222: 223: 224: 225: 226: 227: 228: 229: 230: 231: 232: 233: 234: 235: 236: 237: 238: 239: 240: 241: 242: 243: 244: 245: 246: 247: 248: 249: 250: 251: 252: 253: 254: 255: 256: 257: 258: 259: 260: 261: 262: 263: 264: 265: 266: 267: 268: 269: 270: 271: 272: 273: 274: 275: 276: 277: 278: 279: 280: 281: 282: 283: 284: 285: 286: 287: 288: 289: 290: 291: 292: 293: 294: 295: 296: 297: 298: 299: 300: 301: 302: 303: 304: 305: 306: 307: 308: 309: 310: 311: 312: 313: 314: 315: 316: 317: 318: 319: 320: 321: 322: 323: 324: 325: 326: 327: 328: 329: 330: 331: 332: 333: 334: 335: 336: 337: 338: 339: 340: 341: 342: 343: 344: 345: 346: 347: 348: 349: 350: 351: 352: 353: 354: 355: 356: 357: 358: 359: 360: 361: 362: 363: 364: 365: 366: 367: 368: 369: 370: 371: 372: 373: 374: 375: 376: 377: 378: 379: 380: 381: 382: 383: 384: 385: 386: 387: 388: 389: 390: 391: 392: 393: 394: 395: 396: 397: 398: 399: 400: 401: 402: 403: 404: 405: 406: 407: 408: 409: 410: 411: 412: 413: 414: 415: 416: 417: 418: 419: 420: 421: 422: 423: 424: 425: 426: 427: 428: 429: 430: 431: 432: 433: 434: 435: 436: 437: 438: 439: 440: 441: 442: 443: 444: 445: 446: 447: 448: 449: 450: 451: 452: 453: 454: 455: 456: 457: 458: 459: 460: 461: 462: 463: 464: 465: 466: 467: 468: 469: 470: 471: 472: 473: 474: 475: 476: 477: 478: 479: 480: 481: 482: 483: 484: 485: 486: 487: 488: 489: 490: 491: 492: 493: 494: 495: 496: 497: 498: 499: 500: 501: 502: 503: 504: 505: 506: 507: 508: 509: 510: 511: 512: 513: 514: 515: 516: 517: 518: 519: 520: 521: 522: 523: 524: 525: 526: 527: 528: 529: 530: 531: 532: 533: 534: 535: 536: 537: 538: 539: 540: 541: 542: 543: 544: 545: 546: 547: 548: 549: 550: 551: 552: 553: 554: 555: 556: 557: 558: 559: 560: 561: 562: 563: 564: 565: 566: 567: 568: 569: 570: 571: 572: 573: 574: 575: 576: 577: 578: 579: 580: 581: 582: 583: 584: 585: 586: 587: 588: 589: 590: 591: 592: 593: 594: 595: 596: 597: 598: 599: 600: 601: 602: 603: 604: 605: 606: 607: 608: 609: 610: 611: 612: 613: 614: 615: 616: 617: 618: 619: 620: 621: 622: 623: 624: 625: 626: 627: 628: 629: 630: 631: 632: 633: 634: 635: 636: 637: 638: 639: 640: 641: 642: 643: 644: 645: 646: 647: 648: 649: 650: 651: 652: 653: 654: 655: 656: 657: 658: 659: 660: 661: 662: 663: 664: 665: 666: 667: 668: 669: 670: 671: 672: 673: 674: 675: 676: 677: 678: 679: 680: 681: 682: 683: 684: 685: 686: 687: 688: 689: 690: 691: 692: 693: 694: 695: 696: 697: 698: 699: 700: 701: 702: 703: 704: 705: 706: 707: 708: 709: 710: 711: 712: 713: 714: 715: 716: 717: 718: 719: 720: 721: 722: 723: 724: 725: 726: 727: 728: 729: 730: 731: 732: 733: 734: 735: 736: 737: 738: 739: 740: 741: 742: 743: 744: 745: 746: 747: 748: 749: 750: 751: 752: 753: 754: 755: 756: 757: 758: 759: 760: 761: 762: 763: 764: 765: 766: 767: 768: 769: 770: 771: 772: 773: 774: 775: 776: 777: 778: 779: 780: 781: 782: 783: 784: 785: 786: 787: 788: 789: 790: 791: 792: 793: 794: 795: 796: 797: 798: 799: 800: 801: 802: 803: 804: 805: 806: 807: 808: 809: 810: 811: 812: 813: 814: 815: 816: 817: 818: 819: 820: 821: 822: 823: 824: 825: 826: 827: 828: 829: 830: 831: 832: 833: 834: 835: 836: 837: 838: 839: 840: 841: 842: 843: 844: 845: 846: 847: 848: 849: 850: 851: 852: 853: 854: 855: 856: 857: 858: 859: 860: 861: 862: 863: 864: 865: 866: 867: 868: 869: 870: 871: 872: 873: 874: 875: 876: 877: 878: 879: 880: 881: 882: 883: 884: 885: 886: 887: 888: 889: 890: 891: 892: 893: 894: 895: 896: 897: 898: 899: 900: 901: 902: 903: 904: 905: 906: 907: 908: 909: 910: 911: 912: 913: 914: 915: 916: 917: 918: 919: 920: 921: 922: 923: 924: 925: 926: 927: 928: 929: 930: 931: 932: 933: 934: 935: 936: 937: 938: 939: 940: 941: 942: 943: 944: 945: 946: 947: 948: 949: 950: 951: 952: 953: 954: 955: 956: 957: 958: 959: 960: 961: 962: 963: 964: 965: 966: 
<?php

/**
 * This file, unpredictable as this might be, handles basic administration.
 *
 * Simple Machines Forum (SMF)
 *
 * @package SMF
 * @author Simple Machines http://www.simplemachines.org
 * @copyright 2019 Simple Machines and individual contributors
 * @license http://www.simplemachines.org/about/smf/license.php BSD
 *
 * @version 2.1 RC1
 */

if (!defined('SMF'))
    die('No direct access...');

/**
 * The main admin handling function.<br>
 * It initialises all the basic context required for the admin center.<br>
 * It passes execution onto the relevant admin section.<br>
 * If the passed section is not found it shows the admin home page.
 */
function AdminMain()
{
    global $txt, $context, $scripturl, $modSettings, $settings;
    global $smcFunc, $sourcedir, $options, $boarddir;

    // Load the language and templates....
    loadLanguage('Admin');
    loadTemplate('Admin');
    loadJavaScriptFile('admin.js', array('minimize' => true), 'smf_admin');
    loadCSSFile('admin.css', array(), 'smf_admin');

    // No indexing evil stuff.
    $context['robot_no_index'] = true;

    require_once($sourcedir . '/Subs-Menu.php');

    // Some preferences.
    $context['admin_preferences'] = !empty($options['admin_preferences']) ? $smcFunc['json_decode']($options['admin_preferences'], true) : array();

    /** @var array $admin_areas Defines the menu structure for the admin center. see Subs-Menu.php for details! */
    $admin_areas = array(
        'forum' => array(
            'title' => $txt['admin_main'],
            'permission' => array('admin_forum', 'manage_permissions', 'moderate_forum', 'manage_membergroups', 'manage_bans', 'send_mail', 'edit_news', 'manage_boards', 'manage_smileys', 'manage_attachments'),
            'areas' => array(
                'index' => array(
                    'label' => $txt['admin_center'],
                    'function' => 'AdminHome',
                    'icon' => 'administration',
                ),
                'credits' => array(
                    'label' => $txt['support_credits_title'],
                    'function' => 'AdminHome',
                    'icon' => 'support',
                ),
                'news' => array(
                    'label' => $txt['news_title'],
                    'file' => 'ManageNews.php',
                    'function' => 'ManageNews',
                    'icon' => 'news',
                    'permission' => array('edit_news', 'send_mail', 'admin_forum'),
                    'subsections' => array(
                        'editnews' => array($txt['admin_edit_news'], 'edit_news'),
                        'mailingmembers' => array($txt['admin_newsletters'], 'send_mail'),
                        'settings' => array($txt['settings'], 'admin_forum'),
                    ),
                ),
                'packages' => array(
                    'label' => $txt['package'],
                    'file' => 'Packages.php',
                    'function' => 'Packages',
                    'permission' => array('admin_forum'),
                    'icon' => 'packages',
                    'subsections' => array(
                        'browse' => array($txt['browse_packages']),
                        'packageget' => array($txt['download_packages'], 'url' => $scripturl . '?action=admin;area=packages;sa=packageget;get'),
                        'perms' => array($txt['package_file_perms']),
                        'options' => array($txt['package_settings']),
                    ),
                ),
                'search' => array(
                    'function' => 'AdminSearch',
                    'permission' => array('admin_forum'),
                    'select' => 'index'
                ),
                'adminlogoff' => array(
                    'label' => $txt['admin_logoff'],
                    'function' => 'AdminEndSession',
                    'enabled' => empty($modSettings['securityDisable']),
                    'icon' => 'exit',
                ),

            ),
        ),
        'config' => array(
            'title' => $txt['admin_config'],
            'permission' => array('admin_forum'),
            'areas' => array(
                'featuresettings' => array(
                    'label' => $txt['modSettings_title'],
                    'file' => 'ManageSettings.php',
                    'function' => 'ModifyFeatureSettings',
                    'icon' => 'features',
                    'subsections' => array(
                        'basic' => array($txt['mods_cat_features']),
                        'bbc' => array($txt['manageposts_bbc_settings']),
                        'layout' => array($txt['mods_cat_layout']),
                        'sig' => array($txt['signature_settings_short']),
                        'profile' => array($txt['custom_profile_shorttitle']),
                        'likes' => array($txt['likes']),
                        'mentions' => array($txt['mentions']),
                        'alerts' => array($txt['notifications']),
                    ),
                ),
                'antispam' => array(
                    'label' => $txt['antispam_title'],
                    'file' => 'ManageSettings.php',
                    'function' => 'ModifyAntispamSettings',
                    'icon' => 'security',
                ),
                'languages' => array(
                    'label' => $txt['language_configuration'],
                    'file' => 'ManageLanguages.php',
                    'function' => 'ManageLanguages',
                    'icon' => 'languages',
                    'subsections' => array(
                        'edit' => array($txt['language_edit']),
                        'add' => array($txt['language_add']),
                        'settings' => array($txt['language_settings']),
                    ),
                ),
                'current_theme' => array(
                    'label' => $txt['theme_current_settings'],
                    'file' => 'Themes.php',
                    'function' => 'ThemesMain',
                    'custom_url' => $scripturl . '?action=admin;area=theme;sa=list;th=' . $settings['theme_id'],
                    'icon' => 'current_theme',
                ),
                'theme' => array(
                    'label' => $txt['theme_admin'],
                    'file' => 'Themes.php',
                    'function' => 'ThemesMain',
                    'custom_url' => $scripturl . '?action=admin;area=theme',
                    'icon' => 'themes',
                    'subsections' => array(
                        'admin' => array($txt['themeadmin_admin_title']),
                        'list' => array($txt['themeadmin_list_title']),
                        'reset' => array($txt['themeadmin_reset_title']),
                        'edit' => array($txt['themeadmin_edit_title']),
                    ),
                ),
                'modsettings' => array(
                    'label' => $txt['admin_modifications'],
                    'file' => 'ManageSettings.php',
                    'function' => 'ModifyModSettings',
                    'icon' => 'modifications',
                    'subsections' => array(
                        'general' => array($txt['mods_cat_modifications_misc']),
                        // Mod Authors for a "ADD AFTER" on this line. Ensure you end your change with a comma. For example:
                        // 'shout' => array($txt['shout']),
                        // Note the comma!! The setting with automatically appear with the first mod to be added.
                    ),
                ),
            ),
        ),
        'layout' => array(
            'title' => $txt['layout_controls'],
            'permission' => array('manage_boards', 'admin_forum', 'manage_smileys', 'manage_attachments', 'moderate_forum'),
            'areas' => array(
                'manageboards' => array(
                    'label' => $txt['admin_boards'],
                    'file' => 'ManageBoards.php',
                    'function' => 'ManageBoards',
                    'icon' => 'boards',
                    'permission' => array('manage_boards'),
                    'subsections' => array(
                        'main' => array($txt['boards_edit']),
                        'newcat' => array($txt['mboards_new_cat']),
                        'settings' => array($txt['settings'], 'admin_forum'),
                    ),
                ),
                'postsettings' => array(
                    'label' => $txt['manageposts'],
                    'file' => 'ManagePosts.php',
                    'function' => 'ManagePostSettings',
                    'permission' => array('admin_forum'),
                    'icon' => 'posts',
                    'subsections' => array(
                        'posts' => array($txt['manageposts_settings']),
                        'censor' => array($txt['admin_censored_words']),
                        'topics' => array($txt['manageposts_topic_settings']),
                        'drafts' => array($txt['manage_drafts']),
                    ),
                ),
                'managecalendar' => array(
                    'label' => $txt['manage_calendar'],
                    'file' => 'ManageCalendar.php',
                    'function' => 'ManageCalendar',
                    'icon' => 'calendar',
                    'permission' => array('admin_forum'),
                    'inactive' => empty($modSettings['cal_enabled']),
                    'subsections' => empty($modSettings['cal_enabled']) ? array() : array(
                        'holidays' => array($txt['manage_holidays'], 'admin_forum'),
                        'settings' => array($txt['calendar_settings'], 'admin_forum'),
                    ),
                ),
                'managesearch' => array(
                    'label' => $txt['manage_search'],
                    'file' => 'ManageSearch.php',
                    'function' => 'ManageSearch',
                    'icon' => 'search',
                    'permission' => array('admin_forum'),
                    'subsections' => array(
                        'weights' => array($txt['search_weights']),
                        'method' => array($txt['search_method']),
                        'settings' => array($txt['settings']),
                    ),
                ),
                'smileys' => array(
                    'label' => $txt['smileys_manage'],
                    'file' => 'ManageSmileys.php',
                    'function' => 'ManageSmileys',
                    'icon' => 'smiley',
                    'permission' => array('manage_smileys'),
                    'subsections' => array(
                        'editsets' => array($txt['smiley_sets']),
                        'addsmiley' => array($txt['smileys_add'], 'enabled' => !empty($modSettings['smiley_enable'])),
                        'editsmileys' => array($txt['smileys_edit'], 'enabled' => !empty($modSettings['smiley_enable'])),
                        'setorder' => array($txt['smileys_set_order'], 'enabled' => !empty($modSettings['smiley_enable'])),
                        'editicons' => array($txt['icons_edit_message_icons'], 'enabled' => !empty($modSettings['messageIcons_enable'])),
                        'settings' => array($txt['settings']),
                    ),
                ),
                'manageattachments' => array(
                    'label' => $txt['attachments_avatars'],
                    'file' => 'ManageAttachments.php',
                    'function' => 'ManageAttachments',
                    'icon' => 'attachment',
                    'permission' => array('manage_attachments'),
                    'subsections' => array(
                        'browse' => array($txt['attachment_manager_browse']),
                        'attachments' => array($txt['attachment_manager_settings']),
                        'avatars' => array($txt['attachment_manager_avatar_settings']),
                        'attachpaths' => array($txt['attach_directories']),
                        'maintenance' => array($txt['attachment_manager_maintenance']),
                    ),
                ),
                'sengines' => array(
                    'label' => $txt['search_engines'],
                    'inactive' => empty($modSettings['spider_mode']),
                    'file' => 'ManageSearchEngines.php',
                    'icon' => 'engines',
                    'function' => 'SearchEngines',
                    'permission' => 'admin_forum',
                    'subsections' => empty($modSettings['spider_mode']) ? array() : array(
                        'stats' => array($txt['spider_stats']),
                        'logs' => array($txt['spider_logs']),
                        'spiders' => array($txt['spiders']),
                        'settings' => array($txt['settings']),
                    ),
                ),
            ),
        ),
        'members' => array(
            'title' => $txt['admin_manage_members'],
            'permission' => array('moderate_forum', 'manage_membergroups', 'manage_bans', 'manage_permissions', 'admin_forum'),
            'areas' => array(
                'viewmembers' => array(
                    'label' => $txt['admin_users'],
                    'file' => 'ManageMembers.php',
                    'function' => 'ViewMembers',
                    'icon' => 'members',
                    'permission' => array('moderate_forum'),
                    'subsections' => array(
                        'all' => array($txt['view_all_members']),
                        'search' => array($txt['mlist_search']),
                    ),
                ),
                'membergroups' => array(
                    'label' => $txt['admin_groups'],
                    'file' => 'ManageMembergroups.php',
                    'function' => 'ModifyMembergroups',
                    'icon' => 'membergroups',
                    'permission' => array('manage_membergroups'),
                    'subsections' => array(
                        'index' => array($txt['membergroups_edit_groups'], 'manage_membergroups'),
                        'add' => array($txt['membergroups_new_group'], 'manage_membergroups'),
                        'settings' => array($txt['settings'], 'admin_forum'),
                    ),
                ),
                'permissions' => array(
                    'label' => $txt['edit_permissions'],
                    'file' => 'ManagePermissions.php',
                    'function' => 'ModifyPermissions',
                    'icon' => 'permissions',
                    'permission' => array('manage_permissions'),
                    'subsections' => array(
                        'index' => array($txt['permissions_groups'], 'manage_permissions'),
                        'board' => array($txt['permissions_boards'], 'manage_permissions'),
                        'profiles' => array($txt['permissions_profiles'], 'manage_permissions'),
                        'postmod' => array($txt['permissions_post_moderation'], 'manage_permissions'),
                        'settings' => array($txt['settings'], 'admin_forum'),
                    ),
                ),
                'regcenter' => array(
                    'label' => $txt['registration_center'],
                    'file' => 'ManageRegistration.php',
                    'function' => 'RegCenter',
                    'icon' => 'regcenter',
                    'permission' => array('admin_forum', 'moderate_forum'),
                    'subsections' => array(
                        'register' => array($txt['admin_browse_register_new'], 'moderate_forum'),
                        'agreement' => array($txt['registration_agreement'], 'admin_forum'),
                        'reservednames' => array($txt['admin_reserved_set'], 'admin_forum'),
                        'settings' => array($txt['settings'], 'admin_forum'),
                    ),
                ),
                'warnings' => array(
                    'label' => $txt['warnings'],
                    'file' => 'ManageSettings.php',
                    'function' => 'ModifyWarningSettings',
                    'icon' => 'warning',
                    'inactive' => $modSettings['warning_settings'][0] == 0,
                    'permission' => array('admin_forum'),
                ),
                'ban' => array(
                    'label' => $txt['ban_title'],
                    'file' => 'ManageBans.php',
                    'function' => 'Ban',
                    'icon' => 'ban',
                    'permission' => 'manage_bans',
                    'subsections' => array(
                        'list' => array($txt['ban_edit_list']),
                        'add' => array($txt['ban_add_new']),
                        'browse' => array($txt['ban_trigger_browse']),
                        'log' => array($txt['ban_log']),
                    ),
                ),
                'paidsubscribe' => array(
                    'label' => $txt['paid_subscriptions'],
                    'inactive' => empty($modSettings['paid_enabled']),
                    'file' => 'ManagePaid.php',
                    'icon' => 'paid',
                    'function' => 'ManagePaidSubscriptions',
                    'permission' => 'admin_forum',
                    'subsections' => empty($modSettings['paid_enabled']) ? array() : array(
                        'view' => array($txt['paid_subs_view']),
                        'settings' => array($txt['settings']),
                    ),
                ),
            ),
        ),
        'maintenance' => array(
            'title' => $txt['admin_maintenance'],
            'permission' => array('admin_forum'),
            'areas' => array(
                'serversettings' => array(
                    'label' => $txt['admin_server_settings'],
                    'file' => 'ManageServer.php',
                    'function' => 'ModifySettings',
                    'icon' => 'server',
                    'subsections' => array(
                        'general' => array($txt['general_settings']),
                        'database' => array($txt['database_settings']),
                        'cookie' => array($txt['cookies_sessions_settings']),
                        'security' => array($txt['security_settings']),
                        'cache' => array($txt['caching_settings']),
                        'loads' => array($txt['load_balancing_settings']),
                        'phpinfo' => array($txt['phpinfo_settings']),
                    ),
                ),
                'maintain' => array(
                    'label' => $txt['maintain_title'],
                    'file' => 'ManageMaintenance.php',
                    'icon' => 'maintain',
                    'function' => 'ManageMaintenance',
                    'subsections' => array(
                        'routine' => array($txt['maintain_sub_routine'], 'admin_forum'),
                        'database' => array($txt['maintain_sub_database'], 'admin_forum'),
                        'members' => array($txt['maintain_sub_members'], 'admin_forum'),
                        'topics' => array($txt['maintain_sub_topics'], 'admin_forum'),
                        'hooks' => array($txt['hooks_title_list'], 'admin_forum'),
                    ),
                ),
                'scheduledtasks' => array(
                    'label' => $txt['maintain_tasks'],
                    'file' => 'ManageScheduledTasks.php',
                    'icon' => 'scheduled',
                    'function' => 'ManageScheduledTasks',
                    'subsections' => array(
                        'tasks' => array($txt['maintain_tasks'], 'admin_forum'),
                        'tasklog' => array($txt['scheduled_log'], 'admin_forum'),
                        'settings' => array($txt['scheduled_tasks_settings'], 'admin_forum'),
                    ),
                ),
                'mailqueue' => array(
                    'label' => $txt['mailqueue_title'],
                    'file' => 'ManageMail.php',
                    'function' => 'ManageMail',
                    'icon' => 'mail',
                    'subsections' => array(
                        'browse' => array($txt['mailqueue_browse'], 'admin_forum'),
                        'settings' => array($txt['mailqueue_settings'], 'admin_forum'),
                        'test' => array($txt['mailqueue_test'], 'admin_forum'),
                    ),
                ),
                'reports' => array(
                    'label' => $txt['generate_reports'],
                    'file' => 'Reports.php',
                    'function' => 'ReportsMain',
                    'icon' => 'reports',
                ),
                'logs' => array(
                    'label' => $txt['logs'],
                    'function' => 'AdminLogs',
                    'icon' => 'logs',
                    'subsections' => array(
                        'errorlog' => array($txt['errorlog'], 'admin_forum', 'enabled' => !empty($modSettings['enableErrorLogging']), 'url' => $scripturl . '?action=admin;area=logs;sa=errorlog;desc'),
                        'adminlog' => array($txt['admin_log'], 'admin_forum', 'enabled' => !empty($modSettings['adminlog_enabled'])),
                        'modlog' => array($txt['moderation_log'], 'admin_forum', 'enabled' => !empty($modSettings['modlog_enabled'])),
                        'banlog' => array($txt['ban_log'], 'manage_bans'),
                        'spiderlog' => array($txt['spider_logs'], 'admin_forum', 'enabled' => !empty($modSettings['spider_mode'])),
                        'tasklog' => array($txt['scheduled_log'], 'admin_forum'),
                        'settings' => array($txt['log_settings'], 'admin_forum'),
                    ),
                ),
                'repairboards' => array(
                    'label' => $txt['admin_repair'],
                    'file' => 'RepairBoards.php',
                    'function' => 'RepairBoards',
                    'select' => 'maintain',
                    'hidden' => true,
                ),
            ),
        ),
    );

    // Any files to include for administration?
    if (!empty($modSettings['integrate_admin_include']))
    {
        $admin_includes = explode(',', $modSettings['integrate_admin_include']);
        foreach ($admin_includes as $include)
        {
            $include = strtr(trim($include), array('$boarddir' => $boarddir, '$sourcedir' => $sourcedir, '$themedir' => $settings['theme_dir']));
            if (file_exists($include))
                require_once($include);
        }
    }

    // Make sure the administrator has a valid session...
    validateSession();

    // Actually create the menu!
    $admin_include_data = createMenu($admin_areas, array('do_big_icons' => true));
    unset($admin_areas);

    // Nothing valid?
    if ($admin_include_data == false)
        fatal_lang_error('no_access', false);

    // Build the link tree.
    $context['linktree'][] = array(
        'url' => $scripturl . '?action=admin',
        'name' => $txt['admin_center'],
    );
    if (isset($admin_include_data['current_area']) && $admin_include_data['current_area'] != 'index')
        $context['linktree'][] = array(
            'url' => $scripturl . '?action=admin;area=' . $admin_include_data['current_area'] . ';' . $context['session_var'] . '=' . $context['session_id'],
            'name' => $admin_include_data['label'],
        );
    if (!empty($admin_include_data['current_subsection']) && $admin_include_data['subsections'][$admin_include_data['current_subsection']][0] != $admin_include_data['label'])
        $context['linktree'][] = array(
            'url' => $scripturl . '?action=admin;area=' . $admin_include_data['current_area'] . ';sa=' . $admin_include_data['current_subsection'] . ';' . $context['session_var'] . '=' . $context['session_id'],
            'name' => $admin_include_data['subsections'][$admin_include_data['current_subsection']][0],
        );

    // Make a note of the Unique ID for this menu.
    $context['admin_menu_id'] = $context['max_menu_id'];
    $context['admin_menu_name'] = 'menu_data_' . $context['admin_menu_id'];

    // Where in the admin are we?
    $context['admin_area'] = $admin_include_data['current_area'];

    // Now - finally - call the right place!
    if (isset($admin_include_data['file']))
        require_once($sourcedir . '/' . $admin_include_data['file']);

    // Get the right callable.
    $call = call_helper($admin_include_data['function'], true);

    // Is it valid?
    if (!empty($call))
        call_user_func($call);
}

/**
 * The main administration section.
 * It prepares all the data necessary for the administration front page.
 * It uses the Admin template along with the admin sub template.
 * It requires the moderate_forum, manage_membergroups, manage_bans,
 *  admin_forum, manage_permissions, manage_attachments, manage_smileys,
 *  manage_boards, edit_news, or send_mail permission.
 *  It uses the index administrative area.
 *  It can be found by going to ?action=admin.
 */
function AdminHome()
{
    global $sourcedir, $txt, $scripturl, $context, $user_info;

    // You have to be able to do at least one of the below to see this page.
    isAllowedTo(array('admin_forum', 'manage_permissions', 'moderate_forum', 'manage_membergroups', 'manage_bans', 'send_mail', 'edit_news', 'manage_boards', 'manage_smileys', 'manage_attachments'));

    // Find all of this forum's administrators...
    require_once($sourcedir . '/Subs-Membergroups.php');
    if (listMembergroupMembers_Href($context['administrators'], 1, 32) && allowedTo('manage_membergroups'))
    {
        // Add a 'more'-link if there are more than 32.
        $context['more_admins_link'] = '<a href="' . $scripturl . '?action=moderate;area=viewgroups;sa=members;group=1">' . $txt['more'] . '</a>';
    }

    // Load the credits stuff.
    require_once($sourcedir . '/Who.php');
    Credits(true);

    // This makes it easier to get the latest news with your time format.
    $context['time_format'] = urlencode($user_info['time_format']);
    $context['forum_version'] = SMF_FULL_VERSION;

    // Get a list of current server versions.
    require_once($sourcedir . '/Subs-Admin.php');
    $checkFor = array(
        'gd',
        'imagemagick',
        'db_server',
        'phpa',
        'apc',
        'memcache',
        'xcache',
        'php',
        'server',
    );
    $context['current_versions'] = getServerVersions($checkFor);

    $context['can_admin'] = allowedTo('admin_forum');

    $context['sub_template'] = $context['admin_area'] == 'credits' ? 'credits' : 'admin';
    $context['page_title'] = $context['admin_area'] == 'credits' ? $txt['support_credits_title'] : $txt['admin_center'];
    if ($context['admin_area'] != 'credits')
        $context[$context['admin_menu_name']]['tab_data'] = array(
            'title' => $txt['admin_center'],
            'help' => '',
            'description' => '<strong>' . $txt['hello_guest'] . ' ' . $context['user']['name'] . '!</strong>
                ' . sprintf($txt['admin_main_welcome'], $txt['admin_center'], $txt['help'], $txt['help']),
        );

    // Lastly, fill in the blanks in the support resources paragraphs.
    $txt['support_resources_p1'] = sprintf($txt['support_resources_p1'],
        'https://wiki.simplemachines.org/',
        'https://wiki.simplemachines.org/smf/features2',
        'https://wiki.simplemachines.org/smf/options2',
        'https://wiki.simplemachines.org/smf/themes2',
        'https://wiki.simplemachines.org/smf/packages2'
    );
    $txt['support_resources_p2'] = sprintf($txt['support_resources_p2'],
        'https://www.simplemachines.org/community/',
        'https://www.simplemachines.org/redirect/english_support',
        'https://www.simplemachines.org/redirect/international_support_boards',
        'https://www.simplemachines.org/redirect/smf_support',
        'https://www.simplemachines.org/redirect/customize_support'
    );

    if ($context['admin_area'] == 'admin')
        loadJavaScriptFile('admin.js', array('defer' => false, 'minimize' => true), 'smf_admin');
}

/**
 * Get one of the admin information files from Simple Machines.
 */
function DisplayAdminFile()
{
    global $context, $modSettings, $smcFunc;

    setMemoryLimit('32M');

    if (empty($_REQUEST['filename']) || !is_string($_REQUEST['filename']))
        fatal_lang_error('no_access', false);

    // Strip off the forum cache part or we won't find it...
    $_REQUEST['filename'] = str_replace($context['browser_cache'], '', $_REQUEST['filename']);

    $request = $smcFunc['db_query']('', '
        SELECT data, filetype
        FROM {db_prefix}admin_info_files
        WHERE filename = {string:current_filename}
        LIMIT 1',
        array(
            'current_filename' => $_REQUEST['filename'],
        )
    );

    if ($smcFunc['db_num_rows']($request) == 0)
        fatal_lang_error('admin_file_not_found', true, array($_REQUEST['filename']), 404);

    list ($file_data, $filetype) = $smcFunc['db_fetch_row']($request);
    $smcFunc['db_free_result']($request);

    // @todo Temp
    // Figure out if sesc is still being used.
    if (strpos($file_data, ';sesc=') !== false && $filetype == 'text/javascript')
        $file_data = '
if (!(\'smfForum_sessionvar\' in window))
    window.smfForum_sessionvar = \'sesc\';
' . strtr($file_data, array(';sesc=' => ';\' + window.smfForum_sessionvar + \'='));

    $context['template_layers'] = array();
    // Lets make sure we aren't going to output anything nasty.
    @ob_end_clean();
    if (!empty($modSettings['enableCompressedOutput']))
        @ob_start('ob_gzhandler');
    else
        @ob_start();

    // Make sure they know what type of file we are.
    header('content-type: ' . $filetype);
    echo $file_data;
    obExit(false);
}

/**
 * This function allocates out all the search stuff.
 */
function AdminSearch()
{
    global $txt, $context, $smcFunc, $sourcedir;

    isAllowedTo('admin_forum');

    // What can we search for?
    $subActions = array(
        'internal' => 'AdminSearchInternal',
        'online' => 'AdminSearchOM',
        'member' => 'AdminSearchMember',
    );

    $context['search_type'] = !isset($_REQUEST['search_type']) || !isset($subActions[$_REQUEST['search_type']]) ? 'internal' : $_REQUEST['search_type'];
    $context['search_term'] = isset($_REQUEST['search_term']) ? $smcFunc['htmlspecialchars']($_REQUEST['search_term'], ENT_QUOTES) : '';

    $context['sub_template'] = 'admin_search_results';
    $context['page_title'] = $txt['admin_search_results'];

    // Keep track of what the admin wants.
    if (empty($context['admin_preferences']['sb']) || $context['admin_preferences']['sb'] != $context['search_type'])
    {
        $context['admin_preferences']['sb'] = $context['search_type'];

        // Update the preferences.
        require_once($sourcedir . '/Subs-Admin.php');
        updateAdminPreferences();
    }

    if (trim($context['search_term']) == '')
        $context['search_results'] = array();
    else
        call_helper($subActions[$context['search_type']]);
}

/**
 * A complicated but relatively quick internal search.
 */
function AdminSearchInternal()
{
    global $context, $txt, $helptxt, $scripturl, $sourcedir;

    // Try to get some more memory.
    setMemoryLimit('128M');

    // Load a lot of language files.
    $language_files = array(
        'Help', 'ManageMail', 'ManageSettings', 'ManageCalendar', 'ManageBoards', 'ManagePaid', 'ManagePermissions', 'Search',
        'Login', 'ManageSmileys', 'Drafts',
    );

    // All the files we need to include.
    $include_files = array(
        'ManageSettings', 'ManageBoards', 'ManageNews', 'ManageAttachments', 'ManageCalendar', 'ManageMail', 'ManagePaid', 'ManagePermissions',
        'ManagePosts', 'ManageRegistration', 'ManageSearch', 'ManageSearchEngines', 'ManageServer', 'ManageSmileys', 'ManageLanguages',
    );

    // This is a special array of functions that contain setting data - we query all these to simply pull all setting bits!
    $settings_search = array(
        array('ModifyBasicSettings', 'area=featuresettings;sa=basic'),
        array('ModifyBBCSettings', 'area=featuresettings;sa=bbc'),
        array('ModifyLayoutSettings', 'area=featuresettings;sa=layout'),
        array('ModifyLikesSettings', 'area=featuresettings;sa=likes'),
        array('ModifyMentionsSettings', 'area=featuresettings;sa=mentions'),
        array('ModifySignatureSettings', 'area=featuresettings;sa=sig'),
        array('ModifyAntispamSettings', 'area=antispam'),
        array('ModifyWarningSettings', 'area=warnings'),
        array('ModifyGeneralModSettings', 'area=modsettings;sa=general'),
        // Mod authors if you want to be "real freaking good" then add any setting pages for your mod BELOW this line!
        array('ManageAttachmentSettings', 'area=manageattachments;sa=attachments'),
        array('ManageAvatarSettings', 'area=manageattachments;sa=avatars'),
        array('ModifyCalendarSettings', 'area=managecalendar;sa=settings'),
        array('EditBoardSettings', 'area=manageboards;sa=settings'),
        array('ModifyMailSettings', 'area=mailqueue;sa=settings'),
        array('ModifyNewsSettings', 'area=news;sa=settings'),
        array('GeneralPermissionSettings', 'area=permissions;sa=settings'),
        array('ModifyPostSettings', 'area=postsettings;sa=posts'),
        array('ModifyTopicSettings', 'area=postsettings;sa=topics'),
        array('ModifyDraftSettings', 'area=postsettings;sa=drafts'),
        array('EditSearchSettings', 'area=managesearch;sa=settings'),
        array('EditSmileySettings', 'area=smileys;sa=settings'),
        array('ModifyGeneralSettings', 'area=serversettings;sa=general'),
        array('ModifyDatabaseSettings', 'area=serversettings;sa=database'),
        array('ModifyCookieSettings', 'area=serversettings;sa=cookie'),
        array('ModifyGeneralSecuritySettings', 'area=serversettings;sa=security'),
        array('ModifyCacheSettings', 'area=serversettings;sa=cache'),
        array('ModifyLanguageSettings', 'area=languages;sa=settings'),
        array('ModifyRegistrationSettings', 'area=regcenter;sa=settings'),
        array('ManageSearchEngineSettings', 'area=sengines;sa=settings'),
        array('ModifySubscriptionSettings', 'area=paidsubscribe;sa=settings'),
        array('ModifyLogSettings', 'area=logs;sa=settings'),
    );

    call_integration_hook('integrate_admin_search', array(&$language_files, &$include_files, &$settings_search));

    loadLanguage(implode('+', $language_files));

    foreach ($include_files as $file)
        require_once($sourcedir . '/' . $file . '.php');

    /* This is the huge array that defines everything... it's a huge array of items formatted as follows:
        0 = Language index (Can be array of indexes) to search through for this setting.
        1 = URL for this indexes page.
        2 = Help index for help associated with this item (If different from 0)
    */

    $search_data = array(
        // All the major sections of the forum.
        'sections' => array(
        ),
        'settings' => array(
            array('COPPA', 'area=regcenter;sa=settings'),
            array('CAPTCHA', 'area=antispam'),
        ),
    );

    // Go through the admin menu structure trying to find suitably named areas!
    foreach ($context[$context['admin_menu_name']]['sections'] as $section)
    {
        foreach ($section['areas'] as $menu_key => $menu_item)
        {
            $search_data['sections'][] = array($menu_item['label'], 'area=' . $menu_key);
            if (!empty($menu_item['subsections']))
                foreach ($menu_item['subsections'] as $key => $sublabel)
                {
                    if (isset($sublabel['label']))
                        $search_data['sections'][] = array($sublabel['label'], 'area=' . $menu_key . ';sa=' . $key);
                }
        }
    }

    foreach ($settings_search as $setting_area)
    {
        // Get a list of their variables.
        $config_vars = call_user_func($setting_area[0], true);

        foreach ($config_vars as $var)
            if (!empty($var[1]) && !in_array($var[0], array('permissions', 'switch', 'desc')))
                $search_data['settings'][] = array($var[(isset($var[2]) && in_array($var[2], array('file', 'db'))) ? 0 : 1], $setting_area[1], 'alttxt' => (isset($var[2]) && in_array($var[2], array('file', 'db'))) || isset($var[3]) ? (in_array($var[2], array('file', 'db')) ? $var[1] : $var[3]) : '');
    }

    $context['page_title'] = $txt['admin_search_results'];
    $context['search_results'] = array();

    $search_term = strtolower(un_htmlspecialchars($context['search_term']));
    // Go through all the search data trying to find this text!
    foreach ($search_data as $section => $data)
    {
        foreach ($data as $item)
        {
            $found = false;
            if (!is_array($item[0]))
                $item[0] = array($item[0]);
            foreach ($item[0] as $term)
            {
                if (stripos($term, $search_term) !== false || (isset($txt[$term]) && stripos($txt[$term], $search_term) !== false) || (isset($txt['setting_' . $term]) && stripos($txt['setting_' . $term], $search_term) !== false))
                {
                    $found = $term;
                    break;
                }
            }

            if ($found)
            {
                // Format the name - and remove any descriptions the entry may have.
                $name = isset($txt[$found]) ? $txt[$found] : (isset($txt['setting_' . $found]) ? $txt['setting_' . $found] : (!empty($item['alttxt']) ? $item['alttxt'] : $found));
                $name = preg_replace('~<(?:div|span)\sclass="smalltext">.+?</(?:div|span)>~', '', $name);

                $context['search_results'][] = array(
                    'url' => (substr($item[1], 0, 4) == 'area' ? $scripturl . '?action=admin;' . $item[1] : $item[1]) . ';' . $context['session_var'] . '=' . $context['session_id'] . ((substr($item[1], 0, 4) == 'area' && $section == 'settings' ? '#' . $item[0][0] : '')),
                    'name' => $name,
                    'type' => $section,
                    'help' => shorten_subject(isset($item[2]) ? strip_tags($helptxt[$item[2]]) : (isset($helptxt[$found]) ? strip_tags($helptxt[$found]) : ''), 255),
                );
            }
        }
    }
}

/**
 * All this does is pass through to manage members.
 * {@see ViewMembers()}
 */
function AdminSearchMember()
{
    global $context, $sourcedir;

    require_once($sourcedir . '/ManageMembers.php');
    $_REQUEST['sa'] = 'query';

    $_POST['membername'] = un_htmlspecialchars($context['search_term']);
    $_POST['types'] = '';

    ViewMembers();
}

/**
 * This file allows the user to search the SM online manual for a little of help.
 */
function AdminSearchOM()
{
    global $context, $sourcedir;

    $context['doc_apiurl'] = 'https://wiki.simplemachines.org/api.php';
    $context['doc_scripturl'] = 'https://wiki.simplemachines.org/smf/';

    // Set all the parameters search might expect.
    $postVars = explode(' ', $context['search_term']);

    // Encode the search data.
    foreach ($postVars as $k => $v)
        $postVars[$k] = urlencode($v);

    // This is what we will send.
    $postVars = implode('+', $postVars);

    // Get the results from the doc site.
    // Demo URL:
    // https://wiki.simplemachines.org/api.php?action=query&list=search&srprop=timestamp|snippet&format=xml&srwhat=text&srsearch=template+eval
    $search_results = fetch_web_data($context['doc_apiurl'] . '?action=query&list=search&srprop=timestamp|snippet&format=xml&srwhat=text&srsearch=' . $postVars);

    // If we didn't get any xml back we are in trouble - perhaps the doc site is overloaded?
    if (!$search_results || preg_match('~<' . '\?xml\sversion="\d+\.\d+"\?' . '>\s*(<api\b[^>]*>.+?</api>)~is', $search_results, $matches) != true)
        fatal_lang_error('cannot_connect_doc_site');

    $search_results = $matches[1];

    // Otherwise we simply walk through the XML and stick it in context for display.
    $context['search_results'] = array();
    require_once($sourcedir . '/Class-Package.php');

    // Get the results loaded into an array for processing!
    $results = new xmlArray($search_results, false);

    // Move through the api layer.
    if (!$results->exists('api'))
        fatal_lang_error('cannot_connect_doc_site');

    // Are there actually some results?
    if ($results->exists('api/query/search/p'))
    {
        $relevance = 0;
        foreach ($results->set('api/query/search/p') as $result)
        {
            $context['search_results'][$result->fetch('@title')] = array(
                'title' => $result->fetch('@title'),
                'relevance' => $relevance++,
                'snippet' => str_replace('class=\'searchmatch\'', 'class="highlight"', un_htmlspecialchars($result->fetch('@snippet'))),
            );
        }
    }
}

/**
 * This function decides which log to load.
 */
function AdminLogs()
{
    global $sourcedir, $context, $txt, $scripturl, $modSettings;

    // These are the logs they can load.
    $log_functions = array(
        'errorlog' => array('ManageErrors.php', 'ViewErrorLog'),
        'adminlog' => array('Modlog.php', 'ViewModlog', 'disabled' => empty($modSettings['adminlog_enabled'])),
        'modlog' => array('Modlog.php', 'ViewModlog', 'disabled' => empty($modSettings['modlog_enabled'])),
        'banlog' => array('ManageBans.php', 'BanLog'),
        'spiderlog' => array('ManageSearchEngines.php', 'SpiderLogs'),
        'tasklog' => array('ManageScheduledTasks.php', 'TaskLog'),
        'settings' => array('ManageSettings.php', 'ModifyLogSettings'),
    );

    // If it's not got a sa set it must have come here for first time, pretend error log should be reversed.
    if (!isset($_REQUEST['sa']))
        $_REQUEST['desc'] = true;

    // Setup some tab stuff.
    $context[$context['admin_menu_name']]['tab_data'] = array(
        'title' => $txt['logs'],
        'help' => '',
        'description' => $txt['maintain_info'],
        'tabs' => array(
            'errorlog' => array(
                'url' => $scripturl . '?action=admin;area=logs;sa=errorlog;desc',
                'description' => sprintf($txt['errorlog_desc'], $txt['remove']),
            ),
            'adminlog' => array(
                'description' => $txt['admin_log_desc'],
            ),
            'modlog' => array(
                'description' => $txt['moderation_log_desc'],
            ),
            'banlog' => array(
                'description' => $txt['ban_log_description'],
            ),
            'spiderlog' => array(
                'description' => $txt['spider_log_desc'],
            ),
            'tasklog' => array(
                'description' => $txt['scheduled_log_desc'],
            ),
            'settings' => array(
                'description' => $txt['log_settings_desc'],
            ),
        ),
    );

    call_integration_hook('integrate_manage_logs', array(&$log_functions));

    $subAction = isset($_REQUEST['sa']) && isset($log_functions[$_REQUEST['sa']]) && empty($log_functions[$_REQUEST['sa']]['disabled']) ? $_REQUEST['sa'] : 'errorlog';

    require_once($sourcedir . '/' . $log_functions[$subAction][0]);
    call_helper($log_functions[$subAction][1]);
}

/**
 * This ends a admin session, requiring authentication to access the ACP again.
 */
function AdminEndSession()
{
    // This is so easy!
    unset($_SESSION['admin_time']);

    // Clean any admin tokens as well.
    foreach ($_SESSION['token'] as $key => $token)
        if (strpos($key, '-admin') !== false)
            unset($_SESSION['token'][$key]);

    redirectexit();
}

?>