TracyDebugger.module.php

<?php namespace ProcessWire;

/**
 * Processwire module for running the Tracy debugger from Nette.
 * by Adrian Jones
 *
 * Copyright (C) 2024 by Adrian Jones
 * Licensed under GNU/GPL v2, see LICENSE.TXT
 *
 * A big thanks to Roland Toth (https://github.com/rolandtoth/) for the idea for this module
 * and for significant feedback, testing, and feature suggestions.
 *
 */

// --- Namespace migration: bridge old non-namespaced class name to new namespaced one ---
// If PW's module cache still has the root namespace from a pre-namespace version,
// it will try to instantiate \TracyDebugger instead of \ProcessWire\TracyDebugger.
// This autoloader transparently aliases the old name to the new one,
// sets a flag so init() can trigger a modules refresh and reload.
spl_autoload_register(function($class) {
    if($class === 'TracyDebugger' && class_exists('ProcessWire\\TracyDebugger', false)) {
        class_alias('ProcessWire\\TracyDebugger', 'TracyDebugger');
        TracyDebugger::$namespaceMigration = true;
    }
    // BasePanel must be in autoloader because init() may return early before loading it
    if($class === 'ProcessWire\\BasePanel' || $class === 'BasePanel') {
        require_once __DIR__ . '/includes/BasePanel.php';
        if($class === 'ProcessWire\\BasePanel' && class_exists('BasePanel', false)) {
            class_alias('BasePanel', $class);
        }
        elseif($class === 'BasePanel' && class_exists('ProcessWire\\BasePanel', false)) {
            class_alias('ProcessWire\\BasePanel', $class);
        }
    }
});
// --- End namespace migration ---

use Tracy\Debugger;
use Tracy\Helpers;
use Tracy\Dumper;

class TracyDebugger extends WireData implements Module, ConfigurableModule {

    /**
     * Basic information about module
     */
    public static function getModuleInfo() {
        return array(
            'title' => __('Tracy Debugger', __FILE__),
            'summary' => __('Tracy debugger from Nette with many PW specific custom tools.', __FILE__),
            'author' => 'Adrian Jones',
            'href' => 'https://processwire.com/talk/forum/58-tracy-debugger/',
            'version' => '5.1.10',
            'autoload' => 100000, // in PW 3.0.114+ higher numbers are loaded first - we want Tracy first
            'singular' => true,
            'requires'  => 'ProcessWire>=3.0.0, PHP>=7.1.0',
            'installs' => array('ProcessTracyAdminer'),
            'icon' => 'bug',
        );
    }


    const COOKIE_SECRET = 'tracy-debug';

    const COLOR_LIGHTGREY = '#999999';
    const COLOR_GREEN = '#009900';
    const COLOR_NORMAL = '#354B60';
    const COLOR_WARN = '#ff8309';
    const COLOR_ALERT = '#cd1818';

    protected $data = array();
    protected $time;
    public $httpReferer;
    protected $tracyEnabled = false;
    protected $earlyExit = false;
    protected $tracyCacheDir;
    protected $modulesDbBackupFilename;
    protected $serverStyleInfo;
    protected static $useOnlineEditor;
    protected static $onlineEditor;
    protected static $onlineFileEditorDirPath;
    public static $inAdmin;
    public static $namespaceMigration = false;
    public static $isLocal = false;
    public static $allowedSuperuser = false;
    public static $allowedTracyUser = false;
    public static $validSwitchedUser = false;
    public static $validLocalUser = false;
    public static $dumpItems = array();
    public static $autocompleteArr = array();
    public static $allApiData = array();
    public static $allApiClassesArr = array();
    public static $pageFinderQueries = array();
    public static $templateVars = array();
    public static $templateConsts = array();
    public static $initialFuncs = array();
    public static $initialConsts = array();
    public static $templateFuncs = array();
    public static $includedFiles = array();
    public static $fromConsole = false;
    public static $cliHtmlDumps = false;
    public static $consoleCliJob = null;
    public static $oncePanels;
    public static $stickyPanels;
    public static $showPanels;

    public static $disabableModules = array();
    public static $restrictedUserDisabledPanels = array();
    public static $disabledModules = array();
    public static $templatePath;
    public static $pageVersion;
    public static $templatePathOnce;
    public static $templatePathSticky;
    public static $templatePathPermission;
    public static $tempTemplateFilename;
    public static $tracyVersion;
    public static $panelGenerationTime = array();
    public static $hideInAdmin = array('validator', 'templateResources', 'templatePath');
    // phpInfo shows environment variables (often credentials) and the request's cookies, incl. the session cookie
    // eventInterceptor can make any hooked method return a chosen value (e.g. Page::editable), which would let
    // other users get past permission checks
    public static $superUserOnlyPanels = array('console', 'fileEditor', 'adminer', 'terminal', 'adminTools', 'moduleDisabler', 'phpInfo', 'eventInterceptor');
    public static $pageHtml;
    public static $consoleRunId = '';
    public static $consoleRunStatusDir = '';
    public static $consoleRunCacheDir = '';
    public static $consolePidHandle = null;
    public static $skipTracyShutdownHandler = false;
    public static $consoleLastError = null;
    public static $downloadStaged = false;
    public static $pendingDownloadEnvelope = null;
    public static $preDownloadOutput = '';
    public static $downloadDelivered = false;
    public static $redirectInfo;
    public static $processWireInfoSections = array(
        'configData' => 'Config Data',
        'versionsList' => 'Versions List',
        'adminLinks' => 'Admin Links',
        'documentationLinks' => 'Documentation Links',
        'gotoId' => 'Goto Page By ID',
        'processWireWebsiteSearch' => 'ProcessWire Website Search'
    );
    public static $requestInfoSections = array(
        'moduleSettings' => 'Module Settings',
        'templateSettings' => 'Template Settings',
        'fieldSettings' => 'Field Settings',
        'inputFieldSettings' => 'Inputfield Settings',
        'fieldCode' => 'Field Code',
        'fieldExportCode' => 'Field Export Code',
        'pageInfo' => 'Page Info',
        'redirectInfo' => 'Redirect Info',
        'pagePermissions' => 'Page Permissions',
        'languageInfo' => 'Language Info',
        'templateInfo' => 'Template Info',
        'templateCode' => 'Template Code',
        'templateExportCode' => 'Template Export Code',
        'pageMeta' => 'Page Meta',
        'fieldsListValues' => 'Field List & Values',
        'serverRequest' => 'Server Request',
        'inputGet' => 'Input GET',
        'inputPost' => 'Input POST',
        'inputCookie' => 'Input COOKIE',
        'session' => 'SESSION',
        'pageObject' => 'Page Object',
        'templateObject' => 'Template Object',
        'fieldsObject' => 'Fields Object',
        'editLinks' => 'Page/Template Edit Links'
    );
    public static $debugModeSections = array(
        'pagesLoaded' => 'Pages Loaded',
        'modulesLoaded' => 'Modules Loaded',
        'hooks' => 'Hooks Triggered',
        'databaseQueries' => 'Database Queries',
        'selectorQueries' => 'Selector Queries',
        'timers' => 'Timers',
        'user' => 'User',
        'cache' => 'Cache',
        'autoload' => 'Autoload'
    );
    public static $diagnosticsSections = array(
        'filesystemFolders' => 'Filesystem Folders',
        'filesystemFiles' => 'Filesystem Files',
        'mysqlInfo' => 'MySQL Info'
    );
    public static $dumpPanelTabs = array(
        'debugInfo' => 'Debug Info',
        'iterator' => 'Iterator',
        'fullObject' => 'Full Object'
    );
    public static $externalPanels = array();
    public static $allPanels = array(
        'adminTools' => 'Admin Tools',
        'adminer' => 'Adminer',
        'apiExplorer' => 'API Explorer',
        'captainHook' => 'Captain Hook',
        'console' => 'Console',
        'customPhp' => 'Custom PHP',
        'debugMode' => 'Debug Mode',
        'diagnostics' => 'Diagnostics',
        'dumpsRecorder' => 'Dumps Recorder',
        'eventInterceptor' => 'Event Interceptor',
        'fileEditor' => 'File Editor',
        'gitInfo' => 'Git Info',
        'helloWorld' => 'Hello World',
        'languageSwitcher' => 'Language Switcher',
        'links' => 'Links',
        'mailInterceptor' => 'Mail Interceptor',
        'methodsInfo' => 'Methods Info',
        'moduleDisabler' => 'Module Disabler',
        'outputMode' => 'Output Mode',
        'pageFiles' => 'Page Files',
        'pageRecorder' => 'Page Recorder',
        'panelSelector' => 'Panel Selector',
        'performance' => 'Performance',
        'phpInfo' => 'PHP Info',
        'processwireInfo' => 'ProcessWire Info',
        'processwireLogs' => 'ProcessWire Logs',
        'processwireVersion' => 'ProcessWire Version',
        'requestInfo' => 'Request Info',
        'requestLogger' => 'Request Logger',
        'terminal' => 'Terminal',
        'templatePath' => 'Template Path',
        'templateResources' => 'Template Resources',
        'todo' => 'ToDo',
        'tracyExceptions' => 'Tracy Exceptions',
        'tracyToggler' => 'Tracy Toggler',
        'tracyLogs' => 'Tracy Logs',
        'userSwitcher' => 'User Switcher',
        'users' => 'Users',
        'validator' => 'Validator',
        'viewports' => 'Viewports'
    );
    public static $userBarFeatures = array(
        'admin' => 'Admin',
        'editPage' => 'Edit Page',
        'pageVersions' => 'Page Versions'
    );

   /**
     * Default configuration for module
     *
     */
    static public function getDefaultData() {
        return [
            "enabled" => 1,
            "use_php_session" => 0,
            "superuserForceDevelopment" => '',
            "guestForceDevelopmentLocal" => '',
            "forceIsLocal" => '',
            "recordGuestDumps" => false,
            "ipAddress" => null,
            "restrictSuperusers" => '',
            "strictMode" => '',
            "strictModeAjax" => '',
            "forceScream" => '',
            "outputMode" => 'detect',
            "showLocation" => ['Tracy\Dumper::LOCATION_SOURCE', 'Tracy\Dumper::LOCATION_LINK', 'Tracy\Dumper::LOCATION_CLASS'],
            "keysToHide" => 'dbPass, dbName, dbUser, user, username, pass, password, pwd, pw, auth, token, secret',
            "logSeverity" => [],
            "excludedPwLogFiles" => ['session', 'modules', 'file-compiler'],
            "excludedTracyLogFiles" => [],
            "numLogEntries" => 100,
            "numExceptions" => 25,
            "collapse" => 14,
            "collapse_count" => 7,
            "maxDepth" => 3,
            "maxLength" => 150,
            "maxItems" => 100,
            "maxAjaxRows" => 3,
            "showDebugBar" => ['frontend', 'backend'],
            "hideDebugBar" => '',
            "hideDebugBarFrontendTemplates" => [],
            "hideDebugBarBackendTemplates" => [],
            "hideDebugBarModals" => [],
            "frontendPanels" => ['processwireInfo', 'requestInfo', 'processwireLogs', 'tracyLogs', 'tracyExceptions', 'methodsInfo', 'debugMode', 'console', 'panelSelector', 'tracyToggler'],
            "backendPanels" => ['processwireInfo', 'requestInfo', 'processwireLogs', 'tracyLogs', 'tracyExceptions', 'methodsInfo', 'debugMode', 'console', 'panelSelector', 'tracyToggler'],
            "restrictedUserDisabledPanels" => [],
            "nonToggleablePanels" => [],
            "panelSelectorTracyTogglerButton" => 1,
            "showUserBar" => '',
            "showUserBarTracyUsers" => '',
            "userBarFeatures" => ['admin', 'editPage'],
            "userBarCustomFeatures" => '',
            "userBarBackgroundColor" => '',
            "userBarBackgroundOpacity" => 1,
            "userBarIconColor" => '#666666',
            "userBarTopBottom" => 'bottom',
            "userBarLeftRight" => 'left',
            "showPanelLabels" => '',
            "barPosition" => 'bottom-right',
            "panelZindex" => 100,
            "styleWhere" => ['backend', 'frontend'],
            "styleAdminElements" => "body::before {\n\tcontent: \"[type]\";\n\tbackground: [color];\n\tposition: fixed;\n\tleft: 0;\n\tbottom: 100%;\n\tcolor: #ffffff;\n\twidth: 100vh;\n\tpadding: 0;\n\ttext-align: center;\n\tfont-weight: 600;\n\ttext-transform: uppercase;\n\ttransform: rotate(90deg);\n\ttransform-origin: bottom left;\n\tz-index: 999999;\n\tfont-family: sans-serif;\n\tfont-size: 11px;\n\theight: 13px;\n\tline-height: 13px;\npointer-events: none;\n}\n",
            "styleAdminColors" => "\nlocal|#FF9933\n*.local|#FF9933\ndev.*|#FF9933\n*.test|#FF9933\nstaging.*|#8b0066\n*.com|#009900",
            "styleAdminType" => ['favicon'],
            "showPWInfoPanelIconLabels" => 1,
            "linksNewTab" => '',
            "versionAssetFilenames" => '',
            "pWInfoPanelLinksNewTab" => '',
            "customPWInfoPanelLinks" => [11, 16, 22, 21, 29, 30, 31, 304],
            "adminerEditFieldLink" => 1,
            "adminerStandAlone" => '',
            "adminerThemeColor" => 'blue',
            "adminerJsonMaxLevel" => 3,
            "adminerJsonInTable" => 1,
            "adminerJsonInEdit" => 1,
            "adminerJsonMaxTextLength" => 200,
            "adminerGeminiApiKey" => '',
            "adminerGeminiModel" => 'gemini-3.1-flash-lite',
            "adminerClaudeApiKey" => '',
            "adminerClaudeModel" => 'claude-opus-5-5',
            "adminerOpenWebUiApiUrl" => '',
            "adminerOpenWebUiModel" => 'gpt-oss:120b',
            "adminerOpenWebUiApiKey" => '',
            "captainHookShowDescription" => 1,
            "captainHookToggleDocComment" => '',
            "apiExplorerShowDescription" => 1,
            "apiExplorerToggleDocComment" => '',
            "apiExplorerModuleClasses" => [],
            "requestInfoPanelSections" => ['moduleSettings', 'templateSettings', 'fieldSettings', 'fieldExportCode', 'pageInfo', 'redirectInfo', 'pagePermissions', 'languageInfo', 'templateInfo', 'pageMeta', 'fieldsListValues', 'serverRequest', 'inputGet', 'inputPost', 'inputCookie', 'session', 'editLinks'],
            "processwireInfoPanelSections" => ['versionsList', 'adminLinks', 'documentationLinks', 'gotoId', 'processWireWebsiteSearch'],
            "debugModePanelSections" => ['pagesLoaded', 'modulesLoaded', 'hooks', 'databaseQueries', 'selectorQueries', 'timers', 'user', 'cache', 'autoload'],
            "diagnosticsPanelSections" => ['filesystemFolders'],
            "dumpPanelTabs" => ['debugInfo', 'fullObject'],
            "requestMethods" => ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'],
            "requestLoggerMaxLogs" => 10,
            "requestLoggerReturnType" => 'array',
            "imagesInFieldListValues" => 0,
            "snippetsPath" => 'templates',
            "consoleBackupLimit" => 25,
            "consolePhpCliPath" => '',
            "consoleCodePrefix" => '',
            "userSwitcherSelector" => '',
            "userSwitcherRestricted" => [],
            "userSwitcherIncluded" => [],
            "userSwitcherUserLabel" => '{name} ({email})',
            "todoIgnoreDirs" => 'git, svn, images, img, errors, sass-cache, node_modules',
            "todoScanAssets" => '',
            "todoScanModules" => '',
            "todoSpecifiedDirectories" => '',
            "todoAllowedExtensions" => 'php, module, inc, txt, latte, html, htm, md, css, scss, less, js',
            "variablesShowPwObjects" => '',
            "alwaysShowDebugTools" => 1,
            "respectConfigDebugTools" => '',
            "userDevTemplate" => '',
            "userDevTemplateSuffix" => 'dev',
            "customPhpCode" => '',
            "linksCode" => '',
            "fromEmail" => '',
            "email" => '',
            "clearEmailSent" => '',
            "slackChannel" => '',
            "slackAppOauthToken" => '',
            "reservedMemorySize" => 500000,
            "referencePageEdited" => 1,
            "debugInfo" => 1,
            "editor" => 'vscode://file/%file:%line',
            "useOnlineEditor" => [],
            "onlineEditor" => 'tracy',
            "forceEditorLinksToTracy" => 1,
            "localRootPath" => '',
            "aceTheme" => 'tomorrow_night_bright',
            "consoleTabsTheme" => 'dark-theme',
            "codeFontSize" => 14,
            "codeLineHeight" => 24,
            "codeShowInvisibles" => true,
            "codeTabSize" => 4,
            "codeUseSoftTabs" => true,
            "codeShowDescription" => 1,
            "customSnippetsUrl" => '',
            "pwAutocompletions" => 1,
            "fileEditorAllowedExtensions" => 'php, module, js, css, txt, log, htaccess',
            "fileEditorExcludedDirs" => 'site/assets',
            "fileEditorBaseDirectory" => 'templates',
            "enableShortcutMethods" => 1,
            "enabledShortcutMethods" => ['addBreakpoint', 'bp', 'barDump', 'bd', 'barDumpBig', 'bdb', 'barEcho', 'be', 'debugAll', 'da', 'dump', 'd', 'dumpBig', 'db', 'l', 'templateVars', 'tv', 'timer', 't']
        ];
    }


    /**
     * Populate the default config data
     *
     */
    public static $_data;

    public function __construct() {
        foreach(self::getDefaultData() as $key => $value) {
            $this->$key = $value;
        }
    }


    /**
     * Initialize the module
     */
    public function init() {

        // namespace migration: PW's module cache still references the old non-namespaced class
        // refresh module cache and reload so subsequent requests work natively
        if(static::$namespaceMigration) {
            $this->wire('modules')->resetCache();
            if(!headers_sent()) {
                $this->wire('session')->redirect(self::inputUrl(true));
                return;
            }
        }

        // legacy installs may have null values stored in JSON for fields whose defaults were null
        // before commit 061d081. PHP's isset(null) is false, so ProcessModule's !isset($data[$name])
        // check flags them as "updated" on every save. backfill nulls with current defaults — runs once.
        $nullKeys = array();
        foreach($this->data as $key => $value) {
            if($value === null) $nullKeys[] = $key;
        }
        if($nullKeys) {
            $stored = $this->wire('modules')->getModuleConfigData($this);
            $defaults = self::getDefaultData();
            $changed = false;
            foreach($nullKeys as $key) {
                if(array_key_exists($key, $stored) && $stored[$key] === null && array_key_exists($key, $defaults)) {
                    $stored[$key] = $defaults[$key];
                    $this->$key = $defaults[$key];
                    $changed = true;
                }
            }
            if($changed) $this->wire('modules')->saveModuleConfigData($this, $stored);
        }

        $this->time = $_SERVER['REQUEST_TIME_FLOAT'] ?? microtime(true);

        if(class_exists('\Tracy\Debugger', false) && Debugger::isEnabled()) return;

        // load Tracy files and our helper files
        if(version_compare(PHP_VERSION, '8.2.0', '>=')) {
            self::$tracyVersion = '2.12.x';
        }
        elseif(version_compare(PHP_VERSION, '8.0.0', '>=')) {
            self::$tracyVersion = '2.10.x';
        }
        elseif(version_compare(PHP_VERSION, '7.2.0', '>=')) {
            self::$tracyVersion = '2.9.x';
        }
        else {
            self::$tracyVersion = '2.7.x';
        }
        require_once __DIR__ . '/tracy-'.self::$tracyVersion.'/src/tracy.php';
        require_once __DIR__ . '/includes/TD.php';
        if(!class_exists('TD', false)) {
            class_alias('ProcessWire\\TD', 'TD');
        }
        require_once __DIR__ . '/includes/PwVersionSwitcher.php';


        // load any custom function files if includes dir exists
        $functionsPath = 'templates/TracyDebugger/includes/';
        if(file_exists($this->wire('config')->paths->site.$functionsPath)) {
            $functionsFiles = new \RecursiveDirectoryIterator($this->wire('config')->paths->site.$functionsPath, \RecursiveDirectoryIterator::SKIP_DOTS);
            foreach($functionsFiles as $functionFile) {
                include_once $functionFile;
            }
        }

        if($this->data['enableShortcutMethods']) {
            require_once __DIR__ . '/includes/ShortcutMethods.php';
        }

        // load base panel class
        require_once __DIR__ . '/includes/BasePanel.php';

        // load AIExport scrub patterns (used by TD::agentText for the agent path)
        require_once __DIR__ . '/includes/AIExport.php';

        $externalPanelPaths = glob($this->wire('config')->paths->root.'/site/modules/*/TracyPanels/*.php');
        foreach($externalPanelPaths as $panelPath) {
            $path_parts = pathinfo($panelPath);
            $panelName = lcfirst($path_parts['filename']);
            static::$externalPanels[$panelName] = $panelPath;
            static::$allPanels[$panelName] = implode(' ', preg_split('/(?=[A-Z])/', $path_parts['filename']));
        }
        ksort(static::$allPanels);

        // merge in settings from config.php file
        if(isset($this->wire('config')->tracy) && is_array($this->wire('config')->tracy)) {
            $this->data = array_merge($this->data, $this->wire('config')->tracy);
        }
        //populate for later static access to data
        self::$_data = $this;

        // determine if server is local dev or live
        static::$isLocal = static::isLocal();

        // url for $session->redirects
        if(isset($_SERVER['HTTP_REFERER'])) {
            $referer = $this->wire('sanitizer')->text($_SERVER['HTTP_REFERER']);
            $refererHost = parse_url($referer, PHP_URL_HOST);
            $this->httpReferer = ($refererHost === $this->wire('config')->httpHost) ? $referer : self::inputHttpUrl(true);
        } else {
            $this->httpReferer = self::inputHttpUrl(true);
        }

        // determine if we are in the admin / backend
        static::$inAdmin = $this->inAdmin();

        // check if user is superuser and has tracy-debugger permission if required
        if($this->data['restrictSuperusers'] && $this->wire('user')->isSuperuser()) {
            static::$allowedSuperuser = self::userHasPermission('tracy-debugger');
        }
        else {
            static::$allowedSuperuser = $this->wire('user')->isSuperuser();
        }

        // determine whether user is allowed to use Tracy and whether DEV or PRODUCTION
        static::$allowedTracyUser = static::allowedTracyUser();

        $this->tracyCacheDir = $this->wire('config')->paths->cache . 'TracyDebugger/';

        if(!is_dir($this->tracyCacheDir)) {
            if(!wireMkdir($this->tracyCacheDir)) {
                throw new WireException("Unable to create cache path: " . $this->tracyCacheDir);
            }
        }

        // Tracy log folder path
        $logFolder = $this->wire('config')->paths->logs.'tracy';
        // if Tracy log folder doesn't exist, create it now
        if(!is_dir($logFolder)) wireMkdir($logFolder);


        // REQUEST LOGGER
        // add getRequestData() method to the $page object
        // before Tracy enabled check in case this method is used in a template file
        $this->wire()->addHook('Page::getRequestData', $this, 'getRequestData');


        // EARLY EXITS
        // these keep the bar and Tracy's development features out of iframes, modals and polling requests, so
        // they match on the URL's path (not its query string) and only apply to development mode users below
        $earlyExitPath = (string) parse_url(isset($_SERVER['REQUEST_URI']) ? $_SERVER['REQUEST_URI'] : '', PHP_URL_PATH);
        // modals
        if(in_array('regularModal', $this->data['hideDebugBarModals']) && $this->wire('input')->get->modal == '1') $this->earlyExit = true;
        if(in_array('inlineModal', $this->data['hideDebugBarModals']) && $this->wire('input')->get->modal == 'inline') $this->earlyExit = true;
        if(in_array('overlayPanels', $this->data['hideDebugBarModals']) && $this->wire('input')->get->modal == 'panel') $this->earlyExit = true;

        // formbuilder iframe
        if(in_array('formBuilderIframe', $this->data['hideDebugBarModals']) &&
            !static::$inAdmin &&
            strpos($earlyExitPath, '/form-builder/') !== false) {
                $this->earlyExit = true;
            }

        // adminer iframe
        if(static::$inAdmin && preg_match('#/adminer-renderer(/|$)#', $earlyExitPath)) $this->earlyExit = true;
        // terminal iframe
        if(static::$inAdmin && preg_match('#/terminal(/|$)#', $earlyExitPath)) $this->earlyExit = true;

        // don't init Tracy for @soma's PageEditSoftLock polling on Page Edit
        if(static::$inAdmin && strpos($earlyExitPath, 'checkpagelock') !== false) $this->earlyExit = true;

        // don't init Tracy for PW ProDevTools ajax request - ATM I know this works for UserActivity module
        if($this->wire('config')->input->pwpdt) $this->earlyExit = true;

        // don't init Tracy for Pro Profiler ajax request
        if(static::$inAdmin && $this->wire('input')->get('field') === 'ProfilerEventsTable') $this->earlyExit = true;

        if(isset($_SERVER['REQUEST_URI'])) {
            $info = parse_url($_SERVER['REQUEST_URI']);
            $queryString = isset($info['query']) ? $info['query'] : '';
            // don't init Tracy for the PW Notifications module polling
            if(static::$inAdmin && strpos($queryString, 'Notifications=update') !== false) $this->earlyExit = true;

            // don't init Tracy for sidenav iframes in admin themes that support this
            if(static::$inAdmin && (strpos($queryString, 'layout=sidenav-side') !== false ||
                strpos($queryString, 'layout=sidenav-tree') !== false ||
                strpos($queryString, 'layout=sidenav-init') !== false)) $this->earlyExit = true;

            // don't init Tracy for Setup > Logs view polling
            if(static::$inAdmin && strpos($earlyExitPath, '/logs/view/') !== false &&
                strpos($queryString, 'q=') !== false) $this->earlyExit = true;

        }

        // for everyone else there's no bar to keep out, and skipping Tracy would only skip its production error logging
        if($this->earlyExit && static::$allowedTracyUser !== 'development') $this->earlyExit = false;

        // if "enabled" not checked or tracyDisabled via config or other early exit
        if(!$this->data['enabled'] || $this->wire('config')->tracyDisabled || $this->earlyExit) {
            return;
        }

        $this->wire()->addHookAfter('ProcessWire::ready', function($event) {

            // console autocomplete endpoint: the PW API autocomplete list is ~200KB of JSON with
            // descriptions enabled, and used to be inlined into the Console panel on every page
            // load whether or not the console was ever opened. The panel JS fetches it from here
            // when the editor initialises instead, and the URL's cache key + the ETag let the
            // browser reuse it from then on. Plain fetch(), not an AJAX-flagged request, so this
            // branch must live outside the ajax guard below.
            //
            // The parameter's value is the cache key from getConsoleApiAutocompleteKey() and is
            // not otherwise used: it only has to change when the data could have, so a stale
            // browser copy is never reused. It is carried in this single parameter rather than a
            // second one because panel HTML is escaped into an attribute, which turns a literal
            // "&" in the URL into "&amp;" by the time the JS reads it.
            if($this->wire('input')->get('tracyAutocomplete') !== null) {
                Debugger::$showBar = false;
                header_remove('X-Tracy-Ajax');
                if(!self::$allowedSuperuser && !self::$validLocalUser && !self::$validSwitchedUser) {
                    http_response_code(403);
                    exit;
                }
                while(ob_get_level()) ob_end_clean();
                $etag = '"' . self::getConsoleApiAutocompleteKey() . '"';
                header('Content-Type: application/json');
                header('Cache-Control: private, max-age=604800');
                header('ETag: ' . $etag);
                if(isset($_SERVER['HTTP_IF_NONE_MATCH']) && trim($_SERVER['HTTP_IF_NONE_MATCH']) === $etag) {
                    http_response_code(304);
                    exit;
                }
                echo json_encode(self::getConsoleApiAutocomplete());
                exit;
            }

            // console download endpoint: stream a file staged by CodeProcessor's WireHttp::sendFile
            // hook. Triggered by the panel JS via a hidden <a download> click — a regular GET
            // navigation, NOT an AJAX request, so this branch must live outside the ajax guard
            // below.
            if($this->wire('input')->get->tracyConsoleDownload == 1) {
                Debugger::$showBar = false;
                header_remove('X-Tracy-Ajax');
                if(!self::$allowedSuperuser && !self::$validLocalUser && !self::$validSwitchedUser) {
                    http_response_code(403);
                    exit;
                }
                $runId = preg_replace('/[^a-zA-Z0-9_.]/', '', (string) $this->wire('input')->get->runId);
                $rawFilename = (string) $this->wire('input')->get->filename;
                $filename = basename($rawFilename);
                // Reject empty / dot-traversal runIds and filenames. preg_replace above
                // strips slashes but lets dots through, so ".." or "." would slip past
                // without this explicit check.
                if(!$runId || !$filename
                    || $runId === '.' || $runId === '..' || strpos($runId, '..') !== false
                    || $filename === '.' || $filename === '..') {
                    http_response_code(404);
                    exit;
                }
                $base = realpath($this->wire('config')->paths->cache . 'TracyDebugger/console_downloads');
                $dir = $this->wire('config')->paths->cache . 'TracyDebugger/console_downloads/' . $runId . '/';
                $path = $dir . $filename;
                $realPath = $path ? realpath($path) : false;
                // Confine to the console_downloads directory regardless of sanitization
                // bugs above — realpath returns false for non-existent files (covering
                // the "not found" case) and a normalized absolute path otherwise.
                if(!$base || !$realPath || strncmp($realPath, $base . DIRECTORY_SEPARATOR, strlen($base) + 1) !== 0) {
                    http_response_code(404);
                    exit;
                }
                $contentType = 'application/octet-stream';
                $metaPath = $path . '.meta.json';
                if(file_exists($metaPath)) {
                    $meta = json_decode(file_get_contents($metaPath), true);
                    if(is_array($meta) && isset($meta['contentType']) && is_string($meta['contentType'])) {
                        $contentType = $meta['contentType'];
                    }
                }
                while(ob_get_level()) ob_end_clean();
                header('Content-Type: ' . $contentType);
                header('Content-Disposition: attachment; filename="' . str_replace('"', '', $filename) . '"');
                header('Content-Length: ' . filesize($path));
                header('Cache-Control: no-store, no-cache, must-revalidate');
                header('Pragma: no-cache');
                @readfile($path);
                @unlink($path);
                @unlink($metaPath);
                @rmdir($dir);
                exit;
            }

            if(!$this->wire('config')->ajax) return;

            // live dumps polling: return new dump entries since lastIndex
            if($this->wire('input')->post->tracyDumpsPoll == 1) {
                Debugger::$showBar = false;
                header_remove('X-Tracy-Ajax');
                if(static::$allowedTracyUser !== 'development') {
                    http_response_code(403);
                    exit;
                }
                $dumpsFile = $this->wire('config')->paths->cache . 'TracyDebugger/dumps.json';
                $allEntries = file_exists($dumpsFile) ? json_decode(file_get_contents($dumpsFile), true) : array();
                $allEntries = static::visibleRecordedDumps($allEntries);
                header('Content-Type: application/json');
                echo json_encode(array(
                    'entries' => $allEntries,
                    'totalCount' => count($allEntries)
                ));
                exit;
            }

            // background execution: cancel a running console script
            if($this->wire('input')->post->tracyConsoleCancel == 1) {
                Debugger::$showBar = false;
                header_remove('X-Tracy-Ajax');
                if(!self::$allowedSuperuser && !self::$validLocalUser && !self::$validSwitchedUser) {
                    http_response_code(403);
                    exit;
                }
                $csrfToken = isset($_POST['csrfToken']) ? $_POST['csrfToken'] : '';
                if(!self::validTracyRequest($this->wire('session')->tracyConsoleToken, $csrfToken)) {
                    http_response_code(403);
                    exit;
                }
                $runId = isset($_POST['runId']) ? preg_replace('/[^a-zA-Z0-9_.]/', '', $_POST['runId']) : '';
                header('Content-Type: application/json');
                if(!$runId) {
                    echo json_encode(array('status' => 'error', 'message' => 'missing runId'));
                    exit;
                }
                $r = $this->cleanupConsoleRun($runId, true);
                $payload = array(
                    'status' => 'cancelled',
                    'wasLive' => $r['wasLive'],
                    'killed' => $r['killed'],
                    'connKilled' => $r['connKilled'],
                    'output' => $r['capturedOutput'],
                );
                /* json_encode() returns false if the captured bytes aren't valid
                   UTF-8 (a binary echo, a non-UTF-8 d() title), and `echo false`
                   is an empty 200 the client can't parse — losing the killed /
                   status fields the cancel UI depends on. Drop the output rather
                   than the whole response. */
                $out = json_encode($payload);
                if($out === false) {
                    $payload['output'] = '';
                    $payload['encodeError'] = true;
                    $out = json_encode($payload);
                }
                echo $out === false ? '{"status":"cancelled"}' : $out;
                exit;
            }

            // background execution: force-kill every running console script and clear all state.
            // The break-glass option for when a normal cancel can't get to the runaway script.
            if($this->wire('input')->post->tracyConsoleCancelAll == 1) {
                Debugger::$showBar = false;
                header_remove('X-Tracy-Ajax');
                if(!self::$allowedSuperuser && !self::$validLocalUser && !self::$validSwitchedUser) {
                    http_response_code(403);
                    exit;
                }
                $csrfToken = isset($_POST['csrfToken']) ? $_POST['csrfToken'] : '';
                if(!self::validTracyRequest($this->wire('session')->tracyConsoleToken, $csrfToken)) {
                    http_response_code(403);
                    exit;
                }
                header('Content-Type: application/json');
                $statusDir = $this->wire('config')->paths->assets . 'TracyDebugger/console_runs/';
                $cacheDir  = $this->wire('config')->paths->cache  . 'TracyDebugger/console_runs/';
                $cachePath = $this->wire('config')->paths->cache  . 'TracyDebugger/';
                $runIds = array();
                foreach(array($cacheDir, $statusDir) as $dir) {
                    if(!is_dir($dir)) continue;
                    foreach(glob($dir . '*.{json,pid,connid,partial}', GLOB_BRACE) as $file) {
                        $base = pathinfo($file, PATHINFO_FILENAME);
                        if($base !== '') $runIds[$base] = true;
                    }
                }
                foreach(glob($cachePath . 'consoleCode_*.php') as $file) {
                    $base = pathinfo($file, PATHINFO_FILENAME);
                    if(strpos($base, 'consoleCode_') === 0) {
                        $runIds[substr($base, strlen('consoleCode_'))] = true;
                    }
                }
                $runs = array();
                $liveKilled = 0;
                $staleSwept = 0;
                foreach(array_keys($runIds) as $rid) {
                    /* no captured output here: cancelAllRuns() reads only the
                       liveKilled/staleSwept counts, and shipping up to 2MB per run
                       would bloat (and risk failing to encode) the one response
                       whose whole purpose is recovery when nothing else works */
                    $r = $this->cleanupConsoleRun($rid);
                    $runs[] = array_merge(array('runId' => $rid), $r);
                    if($r['wasLive']) $liveKilled++;
                    else $staleSwept++;
                }
                /* sweep anything left over (orphan files where we couldn't recover a runId) */
                foreach(array($cacheDir, $statusDir) as $dir) {
                    if(!is_dir($dir)) continue;
                    foreach(glob($dir . '*') as $file) {
                        if(is_file($file)) @unlink($file);
                    }
                }
                foreach(glob($cachePath . 'consoleCode_*.php') as $file) @unlink($file);
                echo json_encode(array(
                    'status' => 'ok',
                    'liveKilled' => $liveKilled,
                    'staleSwept' => $staleSwept,
                    'runs' => $runs,
                ));
                exit;
            }

            // background execution: fetch result from cache and cleanup
            if($this->wire('input')->post->tracyConsoleCleanup == 1) {
                Debugger::$showBar = false;
                header_remove('X-Tracy-Ajax');
                if(!self::$allowedSuperuser && !self::$validLocalUser && !self::$validSwitchedUser) {
                    http_response_code(403);
                    exit;
                }
                $csrfToken = isset($_POST['csrfToken']) ? $_POST['csrfToken'] : '';
                if(!self::validTracyRequest($this->wire('session')->tracyConsoleToken, $csrfToken)) {
                    http_response_code(403);
                    exit;
                }
                $runId = isset($_POST['runId']) ? preg_replace('/[^a-zA-Z0-9_.]/', '', $_POST['runId']) : '';
                if($runId) {
                    $statusDir = $this->wire('config')->paths->assets . 'TracyDebugger/console_runs/';
                    $cacheDir = $this->wire('config')->paths->cache . 'TracyDebugger/console_runs/';
                    $cacheFile = $cacheDir . $runId . '.json';
                    $returnResult = !empty($_POST['returnResult']);
                    header('Content-Type: application/json');
                    if($returnResult && file_exists($cacheFile)) {
                        echo file_get_contents($cacheFile);
                    }
                    else if($returnResult) {
                        /* distinct status (not 'error') — the result was already delivered
                           and cleaned up, or swept; the panel should quietly clear its
                           stored runId pointer rather than render an error block */
                        echo json_encode(array('status' => 'gone'));
                    }
                    @unlink($cacheFile);
                    @unlink($statusDir . $runId . '.json');
                    @unlink($cacheDir . $runId . '.pid');
                    @unlink($cacheDir . $runId . '.connid');
                    @unlink($cacheDir . $runId . '.partial');
                    @unlink($cacheDir . $runId . '.log');
                }
                exit;
            }

            // background execution: lightweight status poll for a runId. We can't rely
            // on a static-file fetch with .htaccess rewriting because some servers don't
            // honour AllowOverride for that directory and the request falls through to
            // index.php — which boots PW + Tracy, breaks the JSON response, and adds a
            // bar entry every poll. A dedicated PHP endpoint with bar suppression avoids
            // both issues.
            if($this->wire('input')->post->tracyConsolePoll == 1) {
                Debugger::$showBar = false;
                header_remove('X-Tracy-Ajax');
                if(!self::$allowedSuperuser && !self::$validLocalUser && !self::$validSwitchedUser) {
                    http_response_code(403);
                    exit;
                }
                $csrfToken = isset($_POST['csrfToken']) ? $_POST['csrfToken'] : '';
                if(!self::validTracyRequest($this->wire('session')->tracyConsoleToken, $csrfToken)) {
                    http_response_code(403);
                    exit;
                }
                $runId = isset($_POST['runId']) ? preg_replace('/[^a-zA-Z0-9_.]/', '', $_POST['runId']) : '';
                header('Content-Type: application/json');
                header('Cache-Control: no-cache, no-store, must-revalidate');
                if(!$runId) {
                    echo json_encode(array('status' => 'error'));
                    exit;
                }
                $statusFile = $this->wire('config')->paths->assets . 'TracyDebugger/console_runs/' . $runId . '.json';
                $status = 'missing';
                if(file_exists($statusFile)) {
                    $data = @json_decode((string) @file_get_contents($statusFile), true);
                    if(is_array($data) && isset($data['status'])) $status = $data['status'];
                }
                /* A worker that was killed outright (SIGKILL, a host's time or memory limit) never gets to
                   update its status, so without this it would be polled as "running" forever. It holds
                   LOCK_EX on its .pid file while alive. The status is re-read after finding the lock free
                   because a finishing worker writes its final status BEFORE releasing the lock. */
                $pidFile = $this->wire('config')->paths->cache . 'TracyDebugger/console_runs/' . $runId . '.pid';
                if($status === 'running' && file_exists($pidFile) && !$this->consoleRunIsLive($runId)) {
                    clearstatcache(true, $statusFile);
                    $data = @json_decode((string) @file_get_contents($statusFile), true);
                    if(is_array($data) && isset($data['status']) && $data['status'] === 'running') {
                        file_put_contents($this->wire('config')->paths->cache . 'TracyDebugger/console_runs/' . $runId . '.json', json_encode(array(
                            'status' => 'error',
                            'output' => 'The process running this code ended before it finished - it may have been stopped by the server (eg. a time or memory limit).',
                            'time' => '',
                            'memory' => ''
                        )));
                        file_put_contents($statusFile, json_encode(array('status' => 'error')));
                        $status = 'error';
                    }
                    elseif(is_array($data) && isset($data['status'])) {
                        $status = $data['status'];
                    }
                }
                /* realtime streaming: hand back whatever d()/db() has published to
                   the .partial file since the caller's offset, so the panel can
                   render dumps while the script is still running. Read-only — the
                   file is deleted by the cleanup/cancel endpoints, never here.
                   Only the preview poller (pollForStream) sends an offset. The
                   delivery poller sends none and gets exactly the response it got
                   before this feature existed — just the status — so it never pays
                   to read/encode/parse the whole accumulated .partial every 3s. */
                $wantsChunk = isset($_POST['offset']);
                $offset = $wantsChunk ? max(0, (int) $_POST['offset']) : 0;
                $payload = array('status' => $status);
                if($wantsChunk) {
                    $chunk = '';
                    $partialFile = $this->wire('config')->paths->cache . 'TracyDebugger/console_runs/' . $runId . '.partial';
                    if(is_file($partialFile)) {
                        $size = (int) @filesize($partialFile);
                        /* Clamp an offset beyond EOF rather than echoing it back. No
                           client sends one today, but returning a bogus offset would
                           park that client past the end permanently — it would never
                           see another byte of a still-growing file. */
                        if($offset > $size) $offset = $size;
                        if($size > $offset) {
                            $fh = @fopen($partialFile, 'rb');
                            if($fh) {
                                /* Shared lock against the writer's LOCK_EX. Appends are
                                   very unlikely to tear on POSIX, but the writer already
                                   takes an exclusive lock, so honouring it costs nothing
                                   and removes the question. */
                                @flock($fh, LOCK_SH);
                                if(@fseek($fh, $offset) === 0) {
                                    $read = @stream_get_contents($fh);
                                    if($read !== false) $chunk = $read;
                                }
                                @flock($fh, LOCK_UN);
                                @fclose($fh);
                            }
                        }
                    }
                    $payload['chunk'] = $chunk;
                    $payload['offset'] = $offset + strlen($chunk);
                }
                /* json_encode() returns false on invalid UTF-8 (raw bytes in the
                   buffer tail), and `echo false` is an empty 200 body. The delivery
                   poller shares this endpoint and treats an unparseable response as
                   "retry in 3s" forever, so such a run would never deliver. Always
                   get the status through, dropping the chunk if that's what it takes. */
                $out = json_encode($payload);
                if($out === false) {
                    if($wantsChunk) {
                        $payload['chunk'] = '';
                        $payload['offset'] = $offset;
                    }
                    $payload['encodeError'] = true;
                    $out = json_encode($payload);
                }
                if($out === false) $out = json_encode(array('status' => $status));
                echo $out === false ? '{"status":"error"}' : $out;
                exit;
            }

            // background execution: list runs that are still alive so the panel can re-attach
            // its UI to a script started in a now-closed tab
            if($this->wire('input')->post->tracyConsoleActiveRuns == 1) {
                Debugger::$showBar = false;
                header_remove('X-Tracy-Ajax');
                if(!self::$allowedSuperuser && !self::$validLocalUser && !self::$validSwitchedUser) {
                    http_response_code(403);
                    exit;
                }
                $csrfToken = isset($_POST['csrfToken']) ? $_POST['csrfToken'] : '';
                if(!self::validTracyRequest($this->wire('session')->tracyConsoleToken, $csrfToken)) {
                    http_response_code(403);
                    exit;
                }
                header('Content-Type: application/json');
                $statusDir = $this->wire('config')->paths->assets . 'TracyDebugger/console_runs/';
                $cacheDir  = $this->wire('config')->paths->cache  . 'TracyDebugger/console_runs/';
                $runs = array();
                if(is_dir($statusDir)) {
                    foreach(glob($statusDir . '*.json') as $file) {
                        $runId = pathinfo($file, PATHINFO_FILENAME);
                        if(!preg_match('/^[a-zA-Z0-9_.]+$/', $runId)) continue;
                        $data = @json_decode((string) @file_get_contents($file), true);
                        $status = is_array($data) && isset($data['status']) ? $data['status'] : null;
                        if($status !== 'running') continue;
                        $pidFile = $cacheDir . $runId . '.pid';
                        $live = false;
                        if(file_exists($pidFile)) {
                            $fh = @fopen($pidFile, 'r');
                            if($fh) {
                                $live = !@flock($fh, LOCK_SH | LOCK_NB);
                                if(!$live) @flock($fh, LOCK_UN);
                                @fclose($fh);
                            }
                        }
                        if(!$live) continue;
                        $startedAt = (int) filemtime($pidFile);
                        $runs[] = array('runId' => $runId, 'startedAt' => $startedAt);
                    }
                }
                usort($runs, function($a, $b) { return $b['startedAt'] - $a['startedAt']; });
                echo json_encode(array('runs' => $runs));
                exit;
            }

            // code execution - checked here too (CodeProcessor.php checks again with the token), so a request from
            // anyone else doesn't get the run's status/pid files, lock and unlimited time limit set up first
            if($this->wire('input')->post->tracyConsole == 1 && (static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser)) {
                // garbage collect files left behind by finished background runs (older than
                // 1 hour). A run can legitimately outlive that window (set_time_limit(0)), so
                // skip any run whose worker is still alive — its .pid lock is the cancel
                // endpoint's liveness signal and removing a live run's files would break it.
                $cachePath    = $this->wire('config')->paths->cache  . 'TracyDebugger/';
                $statusDir    = $this->wire('config')->paths->assets . 'TracyDebugger/console_runs/';
                $cacheRunDir  = $cachePath . 'console_runs/';
                $downloadsDir = $cachePath . 'console_downloads/';
                $gcCutoff     = time() - 3600;

                // collect every runId that has files on disk
                $gcRunIds = array();
                foreach(array($statusDir, $cacheRunDir) as $runDir) {
                    if(!is_dir($runDir)) continue;
                    foreach(glob($runDir . '*.{json,pid,connid,partial,log}', GLOB_BRACE) as $file) {
                        $gcRunIds[preg_replace('/\.job$/', '', pathinfo($file, PATHINFO_FILENAME))] = true;
                    }
                }
                foreach(glob($cachePath . 'consoleCode_*.php') as $file) {
                    $base = pathinfo($file, PATHINFO_FILENAME);
                    $gcRunIds[substr($base, strlen('consoleCode_'))] = true;
                }
                if(is_dir($downloadsDir)) {
                    foreach(new \DirectoryIterator($downloadsDir) as $subdir) {
                        if($subdir->isDot() || !$subdir->isDir()) continue;
                        $gcRunIds[$subdir->getFilename()] = true;
                    }
                }

                foreach(array_keys($gcRunIds) as $gcRunId) {
                    if($gcRunId === '' || $this->consoleRunIsLive($gcRunId)) continue;
                    foreach(array($statusDir, $cacheRunDir) as $runDir) {
                        foreach(array('.json', '.pid', '.connid', '.partial', '.log', '.job.json') as $ext) {
                            $f = $runDir . $gcRunId . $ext;
                            if(is_file($f) && filemtime($f) < $gcCutoff) @unlink($f);
                        }
                    }
                    $codeFile = $cachePath . 'consoleCode_' . $gcRunId . '.php';
                    if(is_file($codeFile) && filemtime($codeFile) < $gcCutoff) @unlink($codeFile);
                    $dlDir = $downloadsDir . $gcRunId . '/';
                    if(is_dir($dlDir) && filemtime($dlDir) < $gcCutoff) {
                        foreach(new \DirectoryIterator($dlDir) as $f) {
                            if($f->isDot()) continue;
                            @unlink($f->getPathname());
                        }
                        @rmdir($dlDir);
                    }
                }

                // include the Console panel's codeProcessor after ready so it has access to any properties/methods added by other modules
                require_once(__DIR__ . '/includes/CodeProcessor.php');
                return;
            }
        }, array('priority' => 9999));


        // log requests for Request Logger
        $this->wire()->addHookAfter('ProcessWire::ready', function($event) {
            if(!method_exists($event->page, 'render')) {
                $event->page->addHookAfter('render', $this, 'logRequests');
            }
        });
        $this->wire()->addHookAfter('Page::logRequests', $this, 'logRequests');


        // clear session & cookies option in Processwire Info panel
        // not inside the static::$allowedTracyUser === 'development' block below because it won't validate during
        // forceLogin(), but still only for development mode users, and only from the panel's link (validActionRequest)
        if($this->wire('input')->get->tracyClearSession && static::$allowedTracyUser === 'development' && static::validActionRequest()) {
            $userName = $this->wire('user')->name;
            $this->wire('session')->logout();

            if(isset($_SERVER['HTTP_COOKIE'])) {
                $cookies = explode(';', $_SERVER['HTTP_COOKIE']);
                foreach($cookies as $cookie) {
                    $parts = explode('=', $cookie);
                    $name = trim($parts[0]);
                    setcookie($name, '', time()-1000);
                    setcookie($name, '', time()-1000, '/');
                }
            }

            $this->wire('session')->forceLogin($userName);
            $this->wire('session')->tracyLastUrl = substr(str_replace('tracyClearSession=1', '', self::urlWithoutActionToken(self::inputUrl(true))), 0, -1);
            $this->wire('session')->redirect($this->wire('config')->urls->admin.'module/?reset=1');

        }


        // USER BAR
        if(
            $this->wire('user')->isLoggedin() &&
            !static::$inAdmin &&
            $this->data['showUserBar'] &&
            count($this->data['userBarFeatures'])>0 &&
            !$this->wire('config')->ajax &&
            (static::$allowedTracyUser !== 'development' || $this->data['showUserBarTracyUsers']) &&
            (strpos(self::inputUrl(true), '/form-builder/') === false)
        ) {
            $this->wire()->addHookAfter('ProcessWire::ready', function($event) {
                if(!method_exists($event->page, 'render')) {
                    $event->page->addHookAfter('render', $this, 'addUserBar', array('priority'=>1000));
                }
            });
        }


        // Various features that can be run before loading Tracy core files
        if(static::$allowedTracyUser === 'development') {

            // PANELS TO DISPLAY
            $configEnabledPanels = static::$inAdmin ? $this->data['backendPanels'] : $this->data['frontendPanels'];

            // need to set $stickyPanels here so it is alway set if available, rather than in the elseif below
            // because a "once" cookie would prevent if from being set
            if($this->wire('input')->cookie->tracyPanelsSticky) {
                static::$stickyPanels = array_filter(explode(',', $this->wire('input')->cookie->tracyPanelsSticky));
            }

            if($this->wire('input')->cookie->tracyPanelsOnce) {
                static::$oncePanels = array_filter(explode(',', $this->wire('input')->cookie->tracyPanelsOnce));
                static::$showPanels = static::$oncePanels;
                unset($this->wire('input')->cookie->tracyPanelsOnce);
                setcookie("tracyPanelsOnce", "", time()-3600, '/');
            }
            elseif($this->wire('input')->cookie->tracyPanelsSticky) {
                static::$showPanels = static::$stickyPanels;
            }
            else {
                static::$showPanels = $configEnabledPanels;
            }

            if(in_array('debugMode', static::$showPanels)) {
                // selectors for Debug Mode panel
                $this->wire()->addHookBefore('PageFinder::getQuery', null, function($event) {
                    $this->timerkey = Debug::timer();
                });
                $this->wire()->addHookAfter('PageFinder::getQuery', null, function($event) {
                    $event->setArgument(2, Debug::timer($this->timerkey));

                    if(method_exists('\ProcessWire\Debug', 'backtrace')) {
                        // add backtrace to allow tracking of caller
                        $trace_depth = 3;
                        $trace = Debug::backtrace();

                        // filter out expected admin sources...
                        $filtered_trace = array_filter($trace, function($v) {
                            return
                                (strpos($v['file'], '/wire/') !== 0) &&
                                (strpos($v['file'], '/site/assets/cache/') !== 0)
                                ;
                        });

                        // if there are any paths left in the trace, prepare a shorthand listing...
                        if (!empty($filtered_trace)) {
                            $first_idx = array_keys($filtered_trace)[0];
                            $trace = array_slice($trace, $first_idx, $trace_depth);
                            $filtered_trace = array_reduce($filtered_trace, function($carry, $v) use (&$first_idx) {
                                $carry .= "\n[$first_idx] " . $v['file'] . ' ' . $v['call'];
                                $first_idx++;
                                return $carry;
                            }, '');
                            $event->backtrace = $filtered_trace;
                        }
                        else {
                            $event->backtrace = '';
                        }
                    }

                    static::$pageFinderQueries[] = $event;
                });
            }

            // sort panels based on order defined in config settings
            $showPanelsOrdered = array();
            $showPanelsLookup = array_flip(static::$showPanels);
            $orderedLookup = array();
            $restrictedLookup = array_flip($this->data['restrictedUserDisabledPanels']);
            $i=0;
            // add default panels in the defined order
            foreach($configEnabledPanels as $panelName) {
                if(isset($showPanelsLookup[$panelName])) {
                    $showPanelsOrdered[$i] = $panelName;
                    $orderedLookup[$panelName] = true;
                }
                $i++;
            }
            $isRestrictedUser = (self::$validSwitchedUser || self::userHasPermission("tracy-restricted-panels") || $this->wire('user')->hasRole("tracy-restricted-panels"));
            // add once/sticky panels to the end because there is no specified order for these in config settings
            foreach(static::$allPanels as $panelName => $panelTitle) {
                if(isset($showPanelsLookup[$panelName]) && !isset($orderedLookup[$panelName])) {
                    $showPanelsOrdered[$i] = $panelName;
                    $orderedLookup[$panelName] = true;
                }
                // define disabled panels for restricted users
                if($isRestrictedUser && isset($restrictedLookup[$panelName])) {
                    static::$restrictedUserDisabledPanels[] = $panelName;
                }
                $i++;
            }
            // move Panel Selector to the end so it has access to the generation time values for all other panels
            static::$showPanels = $showPanelsOrdered;
            if(($key = array_search('panelSelector', static::$showPanels)) !== false) {
                unset(static::$showPanels[$key]);
                static::$showPanels[] = 'panelSelector';
            }

            // unhide and unlock all fields - superusers (and local / switched users) only, as its button is in the
            // superuser-only Admin Tools panel: unlocked fields become editable, which other users shouldn't get
            if($this->wire('input')->cookie->tracyUnhideUnlockFields == 1 && (static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser)) {
                $this->wire()->addHookAfter('Field::getInputfield', function(HookEvent $event) {
                    if($this->page->process !== 'ProcessPageEdit' && $this->page->process !== 'ProcessUser') return;
                    $inputfield = $event->return;
                    if($inputfield->collapsed > 0) $inputfield->label .= ' (Unhidden / Uncollapsed / Unlocked by Tracy Debugger)';
                    $inputfield->collapsed = Inputfield::collapsedNo;
                });
            }


            // ProcessWire Info panel early redirects
            // logout
            if($this->wire('input')->get->tracyLogout && static::validActionRequest()) {
                $this->wire('session')->logout();
                $this->wire('session')->redirect(rtrim(substr(str_replace(array('tracyLogout=1', 'login=1'), '', self::urlWithoutActionToken(self::inputUrl(true))), 0, -1), '?'));
            }
            // login
            if($this->wire('input')->get->tracyLogin) {
                $this->wire('session')->tracyLoginUrl = $this->httpReferer;
            }
            if($this->wire('session')->tracyLoginUrl) {
                $this->wire()->addHookAfter('Session::loginSuccess', function(HookEvent $event) {
                    $this->wire('session')->redirect($this->wire('session')->tracyLoginUrl);
                });
            }

            // refresh modules
            if($this->wire('input')->get->tracyModulesRefresh && static::validActionRequest()) {
                $this->wire('session')->tracyLastUrl = substr(str_replace('tracyModulesRefresh=1', '', self::urlWithoutActionToken(self::inputUrl(true))), 0, -1);
                $this->wire('session')->redirect($this->wire('config')->urls->admin.'module/?reset=1');
            }
            if($this->wire('input')->get->reset == 2 && $this->wire('session')->tracyLastUrl) {
                $tracyLastUrl = $this->wire('session')->tracyLastUrl;
                $this->wire('session')->remove('tracyLastUrl');
                $this->wire('session')->redirect($tracyLastUrl);
            }


            // PW VERSION SWITCHER — auto-revert cleanup
            // If PW booted successfully after a version switch, clean up the auto-revert files
            // If an auto-revert occurred (previous request had fatal error), show warning and clean up
            PwVersionSwitcher::handleAutoRevertCleanup($this);

            // PW VERSION SWITCHER
            PwVersionSwitcher::handleVersionSwitchPost($this);


            // REQUEST LOGGER
            require_once(__DIR__ . '/includes/post_processors/RequestLoggerPost.php');


            // the guest dumps setting is site-wide, so only superusers (and local / switched users) change it
            if((static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser) && ($this->data['recordGuestDumps'] || $this->wire('input')->cookie->tracyGuestDumps)) {
                $configData = $this->wire('modules')->getModuleConfigData("TracyDebugger");
                if($this->wire('input')->cookie->tracyGuestDumps) {
                    $configData['recordGuestDumps'] = $this->data['recordGuestDumps'] = 1;
                }
                else {
                    unset($configData['recordGuestDumps']);
                }
                $this->wire('modules')->saveModuleConfigData($this, $configData);
            }


            // MODULES DISABLER
            //set up backup directory/file - outside conditional so they are available for cleanup when panel is disabled
            $this->modulesDbBackupFilename = 'modulesBackup.sql';
            // superusers (and local / switched users) only: $showPanels comes from the user's own panel cookies,
            // and disabling autoload modules can switch off security ones
            if((static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser) && in_array('moduleDisabler', static::$showPanels) && $this->wire('config')->debug && $this->wire('config')->advanced) {
                // if modules DB was just restored, clear the cookie
                if($this->wire('input')->cookie->modulesRestored == 1) {
                    unset($this->wire('input')->cookie->modulesRestored);
                    setcookie("modulesRestored", "", time()-3600, "/");
                    unset($this->wire('input')->cookie->tracyModulesDisabled);
                    setcookie("tracyModulesDisabled", "", time()-3600, "/");
                    $this->wire('session')->message("Modules successfully restored");
                }

                // get array of disabable modules
                foreach($this->wire('modules') as $name => $label) {
                    $flags = $this->wire('modules')->getFlags($name);
                    $info = $this->wire('modules')->getModuleInfoVerbose($name);
                    if($info['core']) continue;
                    if($name == 'TracyDebugger') continue;
                    if(($flags & Modules::flagsAutoload) || ($flags & Modules::flagsDisabled)) {
                        static::$disabableModules[] = $name;
                    }
                }

                // the module list is in a cookie written by the panel as "<action token>|<names>", so one set by
                // another subdomain of the site is ignored (TracyDebugger::tokenCookie()); without a valid one,
                // no module flags are changed at all
                $modulesDisabledCookie = static::tokenCookie('tracyModulesDisabled');

                // if modules have been checked to disable
                if($modulesDisabledCookie) {

                    // if it doesn't already exist, backup existing modules database
                    if(!file_exists($this->tracyCacheDir . $this->modulesDbBackupFilename)) {
                        $backup = new WireDatabaseBackup($this->tracyCacheDir);
                        $backup->setDatabase($this->wire('database'));
                        $backup->setDatabaseConfig($this->wire('config'));
                        $file = $backup->backup(array('tables' => array('modules'), 'filename' => $this->modulesDbBackupFilename));

                        // the panel tells users to copy this to the site root if the site breaks, where anyone could
                        // load it, so it only runs with the key shown in the panel, and deletes that copy once used
                        $backupPath = $this->tracyCacheDir . $this->modulesDbBackupFilename;
                        $restoreModulesCode =
                        "<?php\n" .
                        "if(!isset(\$_GET['key']) || !hash_equals(" . var_export(static::restoreModulesKey(), true) . ", (string) \$_GET['key'])) {\n" .
                            "\thttp_response_code(403);\n" .
                            "\texit('Forbidden: use the URL from the Module Disabler panel, including its key.');\n" .
                        "}\n" .
                        "if(file_exists(" . var_export($backupPath, true) . ")) {\n" .
                            "\t\$db = " . $this->getRestorePdoCode() . ";\n" .
                            "\t\$sql = file_get_contents(" . var_export($backupPath, true) . ");\n" .
                            "\t\$qr = \$db->query(\$sql);\n" .
                        "}\n" .
                        "if(isset(\$qr) && \$qr) {\n" .
                            "\tsetcookie('modulesRestored', 1, time() + (24 * 60 * 60));\n" .
                            "\tif(realpath(__DIR__) !== realpath(" . var_export(rtrim($this->tracyCacheDir, '/\\'), true) . ")) @unlink(__FILE__);\n" .
                            "\theader('Location: ' . " . var_export(self::inputHttpUrl(true), true) . ");\n" .
                        "}\n" .
                        "else {\n" .
                        "\techo 'Sorry, there was a problem and the database could not be restored.';\n" .
                        "}";

                        if(!$this->wire('files')->filePutContents($this->tracyCacheDir . 'restoremodules.php', $restoreModulesCode, LOCK_EX)) {
                            throw new WireException("Unable to write file: " . $this->tracyCacheDir . 'restoremodules.php');
                        }
                    }

                    // get array of modules that have been checked to disable
                    static::$disabledModules = array_filter(explode(',', $modulesDisabledCookie));
                }
                else {
                    $this->deleteFile($this->tracyCacheDir . $this->modulesDbBackupFilename);
                    $this->deleteFile($this->tracyCacheDir . 'restoremodules.php');
                }

                // add disabled flag to requested modules (and remove it from the others), only when the panel set
                // the list; an empty list is the panel's reset, after which the cookie is cleared
                $i=0;
                if($modulesDisabledCookie === '') {
                    unset($this->wire('input')->cookie->tracyModulesDisabled);
                    setcookie("tracyModulesDisabled", "", time()-3600, '/');
                }
                foreach($modulesDisabledCookie !== null ? static::$disabableModules : array() as $name) {
                    $flags = $this->wire('modules')->getFlags($name);
                    if(in_array($name, static::$disabledModules)) {
                        if(!($flags & Modules::flagsDisabled)) {
                            $this->wire('modules')->setFlag($name, Modules::flagsDisabled, true);
                            $i++;
                        }
                    }
                    elseif($flags & Modules::flagsDisabled) {
                        $this->wire('modules')->setFlag($name, Modules::flagsDisabled, false);
                        $i++;
                    }
                }
                if($i > 0) $this->wire('session')->redirect($this->httpReferer);
            }
            else {
                $this->deleteFile($this->tracyCacheDir . $this->modulesDbBackupFilename);
                $this->deleteFile($this->tracyCacheDir . 'restoremodules.php');
            }
            // try to delete modules restore file from root
            $rootRestoreFile = $this->wire('config')->paths->root . 'restoremodules.php';
            if(file_exists($rootRestoreFile)) {
                @unlink($rootRestoreFile);
                if(is_file($rootRestoreFile)) {
                   $this->wire('session')->error('Please delete ' . $rootRestoreFile . ' from your system.');
                }
            }


            // PAGE FILES
            require_once(__DIR__ . '/includes/post_processors/PageFilesPost.php');


            // PAGE RECORDER
            require_once(__DIR__ . '/includes/post_processors/PageRecorderPost.php');


            // ADMIN TOOLS
            require_once(__DIR__ . '/includes/post_processors/AdminToolsPost.php');

            // EMAIL SENT FLAG
            require_once(__DIR__ . '/includes/post_processors/EmailSentFlagPost.php');

            // PROCESSWIRE LOGS and TRACY LOGS (delete all) - development mode only: in production mode
            // allowedTracyUser is 'production' for every visitor, guests included
            require_once(__DIR__ . '/includes/post_processors/ProcesswireLogsPost.php');
            require_once(__DIR__ . '/includes/post_processors/TracyLogsPost.php');

            // CONSOLE PANEL CODE INJECTION
            $this->insertCode('init');
            $this->wire()->addHookBefore('ProcessWire::finished', function($event) {
                $this->insertCode('finished');
            });

        }

        //convert checked location strings to constants and array_reduce to bitwise OR (|) line
        $locations = array_map('constant', $this->data['showLocation']);
        Debugger::$showLocation = array_reduce($locations, function($a, $b) { return $a | $b; }, 0);

        if(version_compare(PHP_VERSION, '7.2.0', '>=')) {
            $keys = array_values(array_filter(array_map('trim', explode(',', $this->data['keysToHide'])), 'strlen'));
            // dumps
            if(property_exists(Debugger::class, 'keysToHide')) {
                Debugger::$keysToHide = $keys;
            }
            // the BlueScreen dumps with its own list (Debugger::$keysToHide doesn't reach it), so add ours to
            // Tracy's defaults there too
            if(method_exists(Debugger::class, 'getBlueScreen')) {
                $blueScreen = Debugger::getBlueScreen();
                if(property_exists($blueScreen, 'keysToHide')) {
                    $blueScreen->keysToHide = array_values(array_unique(array_merge((array) $blueScreen->keysToHide, $keys)));
                }
            }
        }


        // START ENABLING TRACY
        // now that required classes above have been loaded, we can now exit if user is not allowed
        if(!static::$allowedTracyUser) return;

        // SET TRACY AS ENABLED
        // if we get this far, Tracy is fully enabled, so set this for checking in ready()
        $this->tracyEnabled = true;

        // override default PW core behavior that converts exceptions to string for passing to trigger_error()
        // runs in all outputModes so Tracy can intercept guest-facing exceptions in production and save bluescreen HTML
        $this->wire()->addHookBefore('Wire::trackException', function($event) {
            $event->wire()->config->allowExceptions = true;
        });

        // TRACY MODE
        if($this->data['outputMode'] == 'development' || static::$allowedTracyUser === 'development') {
            $outputMode = Debugger::DEVELOPMENT;
        }
        elseif($this->data['outputMode'] == 'production' || static::$allowedTracyUser === 'production') {
            $outputMode = Debugger::PRODUCTION;
        }
        else {
            $outputMode = Debugger::DETECT;
        }

        // back-end
        if(static::$inAdmin) {
            if(in_array('backend', $this->data['showDebugBar']) && $outputMode != Debugger::PRODUCTION) {
                Debugger::$showBar = true;
            }
            else {
                Debugger::$showBar = false;
            }
        }
        // front-end
        else {
            if(in_array('frontend', $this->data['showDebugBar']) && $outputMode != Debugger::PRODUCTION) {
                Debugger::$showBar = true;
            }
            else {
                Debugger::$showBar = false;
            }
        }

        if(property_exists(Debugger::class, 'reservedMemorySize')) Debugger::$reservedMemorySize = $this->data['reservedMemorySize'];

        // EDITOR PROTOCOL HANDLER
        // build up array of replacements to pass to Debugger::$editorMapping
        // they have to be completely separate replacements because Tracy uses strtr()
        // which won't replace the same substring more than once
        $mappingReplacements = array();
        $compilerCachePath = isset($this->wire('config')->fileCompilerOptions['cachePath']) && $this->wire('config')->fileCompilerOptions['cachePath'] != '' ? $this->wire('config')->fileCompilerOptions['cachePath'] : $this->wire('config')->paths->cache . 'FileCompiler/';
        $compilerCachePath = str_replace('/', DIRECTORY_SEPARATOR, $compilerCachePath);

        static::$useOnlineEditor = (static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser) &&
            (static::$isLocal && in_array('local', $this->data['useOnlineEditor'])) ||
            (!static::$isLocal && in_array('live', $this->data['useOnlineEditor']) ||
            (isset(static::$showPanels) && in_array('fileEditor', static::$showPanels) && $this->data['forceEditorLinksToTracy'])
        );

        if(static::$useOnlineEditor) {
            if($this->data['onlineEditor'] == 'processFileEdit' &&
                $this->wire('modules')->isInstalled('ProcessFileEdit') &&
                $this->wire('user')->hasPermission('file-edit'))
            {
                static::$onlineEditor = 'processFileEdit';
                Debugger::$editor = $this->wire('config')->urls->admin . 'setup/file-editor/?f=%file&l=%line';
                $processFileEditSettings = $this->wire('modules')->getModuleConfigData('ProcessFileEdit');
                static::$onlineFileEditorDirPath = $processFileEditSettings['dirPath'];
            }
            else {
                static::$onlineEditor = 'tracy';
                Debugger::$editor = 'tracy://?f=%file&l=%line';
                static::$onlineFileEditorDirPath = $this->wire('config')->paths->root;
            }
            $mappingReplacements[$compilerCachePath . self::stripRootPath(static::$onlineFileEditorDirPath, '')] = '';
            $mappingReplacements[static::$onlineFileEditorDirPath] = '';
        }
        else {
            Debugger::$editor = $this->data['editor'];

            if($this->data['localRootPath'] != '') {
                $mappingReplacements[$compilerCachePath] = $this->data['localRootPath'];
                $mappingReplacements[$this->wire('config')->paths->root] = $this->data['localRootPath'];
            }
            else {
                $mappingReplacements[$compilerCachePath] = $this->wire('config')->paths->root;
            }
        }

        if(DIRECTORY_SEPARATOR === '\\') {
            foreach($mappingReplacements as $from => $to) {
                $backslashed = str_replace('/', '\\', $from);
                if($backslashed !== $from && !isset($mappingReplacements[$backslashed])) {
                    $mappingReplacements[$backslashed] = $to;
                }
            }
        }

        Debugger::$editorMapping = $mappingReplacements;

        if(static::$allowedTracyUser === 'development') {

            // TRACY TOGGLER
            // if Tracy has been toggled "disabled" add enable button and then exit
            if($this->wire('input')->cookie->tracyDisabled == 1) {
                if(Debugger::$showBar && !$this->wire('config')->ajax) {
                    $this->wire()->addHook('ProcessWire::ready', function($event) {
                        if(!method_exists($event->page, 'render')) {
                            $event->page->addHookAfter('render', $this, 'addEnableButton', array('priority'=>1000));
                        }
                    });
                }
                // Tracy not enabled so exit now
                $this->tracyEnabled = false;
                return;
            }


            if(Debugger::$showBar) {

                //CUSTOM CSS & JS
                Debugger::$customCssFiles = array(
                    $this->wire('config')->paths->TracyDebugger.'styles/styles.css'
                );

                Debugger::$customJsFiles[] = $this->wire('config')->paths->TracyDebugger.'scripts/main.js';
                Debugger::$customJsFiles[] = $this->wire('config')->paths->TracyDebugger.'scripts/tinycon.min.js';
                Debugger::$customJsFiles[] = $this->wire('config')->paths->TracyDebugger.'scripts/js-loader.js';
                // always loaded, not gated on $showPanels (which varies with the sticky/once panel cookies and
                // would leave a cached bundle without it); it only polls when the Dumps Recorder panel is in the bar
                Debugger::$customJsFiles[] = $this->wire('config')->paths->TracyDebugger.'scripts/dumps-polling.js';

                // load File Editor panel if Tracy online editor is selected
                if(static::$useOnlineEditor && static::$onlineEditor == 'tracy' && !in_array('fileEditor', static::$showPanels)) {
                    array_push(static::$showPanels, 'fileEditor');
                }

                // load for any user who could open the FE / Adminer panels rather than gating on $showPanels —
                // Tracy caches the JS bundle by URL aggressively (Cache-Control: max-age=864000), and gating on
                // per-request state (showPanels varies with the sticky cookie) means a cached bundle from a
                // request without the panel stays cached for later requests where it IS enabled.
                if(static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser) {
                    Debugger::$customJsFiles[] = $this->wire('config')->paths->TracyDebugger.'scripts/php-file-tree/php_file_tree.js';
                    Debugger::$customJsFiles[] = $this->wire('config')->paths->TracyDebugger.'scripts/file-editor.js';
                    if($this->wire('modules')->isInstalled('ProcessTracyAdminer')) {
                        Debugger::$customJsFiles[] = $this->wire('config')->paths->TracyDebugger.'scripts/adminer.js';
                    }
                }

                // this needs to be loaded here (not just in Tracy Exceptions panel) so that links
                // will work even if Tracy Exceptions panel hasn't been opened yet. always loaded, not gated
                // on $showPanels, for the same reason as dumps-polling.js above
                Debugger::$customJsFiles[] = $this->wire('config')->paths->TracyDebugger.'scripts/exception-loader.js';

                // TracyDebugger's own bar JS, added to Tracy's bundle as a file (see barJsFile()). Tracy caches the
                // bundle by URL for 10 days, so nothing in it may depend on this request's cookies, session or
                // $showPanels - anything that does is decided in the browser instead.
                $barJs = '';

                if($this->showServerTypeIndicator()) {
                    $this->serverStyleInfo = $this->getServerAdminStyles();
                    $barJs .= static::barStylesJs($this->setServerAdminStyleColor());
                    if(in_array('favicon', $this->data['styleAdminType'])) $barJs .= $this->setFaviconBadge();
                }

                // load font-awesome for our panels. inAdmin normally has it via the admin template, but on a
                // bluescreen the admin template never renders, so we'd lose our icons. duplicate loads are harmless.
                // gated on who could open the File Editor (as for its JS above), not on $showPanels.
                if(static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser || !empty($this->data['customPWInfoPanelLinks'])) {
                    $barJs .= '(function(){var l = document.createElement("link"); l.id = "fontAwesomeStyles"; l.rel = "stylesheet"; l.href = ' . json_encode($this->wire('config')->urls->root . 'wire/templates-admin/styles/font-awesome/css/font-awesome.min.css') . '; document.head.appendChild(l);})();' . "\n";
                }

                $barJs .= static::barStylesJs('
                <style>
                    #tracy-debug-bar {
                        left:'.($this->data['barPosition'] == 'bottom-left' ? '0' : 'auto').' !important;
                        right:'.($this->data['barPosition'] == 'bottom-left' ? 'auto' : '0').' !important;
                    }
                    #tracy-show-button {
                        '.($this->data['barPosition'] == 'bottom-left' ? 'left:0' : 'right:0').' !important;
                    }
                    #tracy-bs {
                        z-index: '.(int) $this->data['panelZindex'].' !important;
                    }
                </style>
                ');

                // add Adminer links to fields in Page Edit
                if($this->data['adminerEditFieldLink'] && $this->wire('modules')->isInstalled('ProcessTracyAdminer') && in_array('adminer', static::$showPanels)) {
                    $this->addHookAfter('Inputfield::render', $this, 'addAdminerEditFieldLinks');
                    $this->addHookAfter('Inputfield::renderValue', $this, 'addAdminerEditFieldLinks');
                }

                // override Tracy core default zIndex for panels
                // add settings link on double-click to "TRACY" icon
                // replace "close" icon link with "hide" and "unhide" links
                // add esc key event handler to close all panels
                $this->wire()->addHookAfter('ProcessWire::ready', function($event) {
                    if(!method_exists($event->page, 'render')) {
                        $event->page->addHookAfter('render', function($event) {
                            if(!$event->return) return;
                            if(static::isFieldRenderEvent($event)) return;

                            $adminerRendererModuleId = $this->wire('modules')->getModuleID("ProcessTracyAdminerRenderer");
                            $adminerRendererUrl = $this->wire('pages')->get("process=$adminerRendererModuleId")->url;
                            $adminerModuleId = $this->wire('modules')->getModuleID("ProcessTracyAdminer");
                            $adminerUrl = $this->wire('pages')->get("process=$adminerModuleId")->url;

                            $event->return = str_replace("</body>", "<script" . static::getNonceAttr() . ">window.HttpRootUrl = '".$this->wire('config')->urls->httpRoot."'; window.AdminerUrl = '".$adminerUrl."'; window.AdminerRendererUrl = '".$adminerRendererUrl."'; window.AdminerAuthQuery = '".(static::adminerAllowed() ? static::getAdminerAuthQuery() : '')."'; window.TracyMaxAjaxRows = ".$this->data['maxAjaxRows']."; window.TracyPanelZIndex = " . ($this->data['panelZindex'] + 1) . "; window.TracyColorWarn = '" . TracyDebugger::COLOR_WARN . "'; document.addEventListener('click', function(e) { var el = e.target; while(el && el.tagName !== 'A') el = el.parentNode; if(el && el.href && /^(adminer|tracy|tracyexception):\/\//.test(el.href)) e.preventDefault(); }, true);</script></body>", $event->return);

                            $tracyWarnings = Debugger::getBar()->getPanel('Tracy:warnings') ? Debugger::getBar()->getPanel('Tracy:warnings') : Debugger::getBar()->getPanel('Tracy:errors');
                            if(!is_array($tracyWarnings->data) || count($tracyWarnings->data) === 0) {
                                if(($this->data['hideDebugBar'] && !$this->wire('input')->cookie->tracyShow) || $this->wire('input')->cookie->tracyHidden == 1) {
                                    $hideBar = '
                                        <script' . static::getNonceAttr() . '>
                                            function hideDebugBar() {
                                                if(!document.getElementById("tracy-debug-bar")) {
                                                    window.requestAnimationFrame(hideDebugBar);
                                                } else {
                                                    document.getElementById("tracy-debug").style.display = "none";
                                                }
                                            }
                                            hideDebugBar();

                                            function showShowButton() {
                                                if(!document.getElementById("tracy-show-button")) {
                                                    window.requestAnimationFrame(showShowButton);
                                                } else {
                                                    document.getElementById("tracy-show-button").style.display = "block";
                                                }
                                            }
                                            showShowButton();
                                        </script>
                                    ';
                                    $event->return = str_replace("</body>", "\n<!-- Tracy Hide Bar -->\n" . static::minify($hideBar)."\n</body>", $event->return);
                                }
                            }
                            // Recolor Warnings/Error tabs whose panel contains only deprecation notices.
                            // Done client-side so it also covers redirect and AJAX bars, whose warnings
                            // live on a separate request and are absent from the current warnings panel.
                            $recolorErrors = '
                            <script' . static::getNonceAttr() . '>
                                var tracyRecolorTries = 0;
                                function tracyRecolorDeprecationTabs() {
                                    var debugEl = document.getElementById("tracy-debug");
                                    if(!debugEl) {
                                        if(tracyRecolorTries++ < 600) window.requestAnimationFrame(tracyRecolorDeprecationTabs);
                                        return;
                                    }
                                    var warnColor = "'.self::COLOR_WARN.'";
                                    var wireColor = "'.self::COLOR_LIGHTGREY.'";
                                    function panelContent(tab) {
                                        var link = tab.closest("a");
                                        if(!link) return null;
                                        var rel = link.getAttribute("rel");
                                        if(!rel) return null;
                                        var panel = document.getElementById(rel);
                                        if(!panel) return null;
                                        return (panel.dataset && panel.dataset.tracyContent) || panel.tracyContent || panel.innerHTML || "";
                                    }
                                    function process() {
                                        var tabs = document.querySelectorAll(".tracy-WarningsTab, .tracy-ErrorTab");
                                        Array.prototype.forEach.call(tabs, function(tab) {
                                            if(tab.getAttribute("data-td-recolored")) return;
                                            var content = panelContent(tab);
                                            if(content === null) return;
                                            var holder = document.createElement("div");
                                            holder.innerHTML = tracyTrusted.html(content);
                                            var rows = holder.querySelectorAll("pre");
                                            if(!rows.length) return;
                                            var allDeprecations = true;
                                            var allWire = true;
                                            Array.prototype.forEach.call(rows, function(row) {
                                                var text = row.textContent || "";
                                                if(text.indexOf("Deprecated:") === -1) allDeprecations = false;
                                                var editor = row.querySelector("a.tracy-editor");
                                                var path = editor ? (editor.getAttribute("title") || editor.textContent) : text;
                                                if(path.indexOf("/wire/") === -1) allWire = false;
                                            });
                                            if(allDeprecations) {
                                                tab.style.backgroundColor = allWire ? wireColor : warnColor;
                                                tab.setAttribute("data-td-recolored", "1");
                                            }
                                        });
                                    }
                                    process();
                                    new MutationObserver(process).observe(debugEl, { childList: true, subtree: true });
                                }
                                tracyRecolorDeprecationTabs();
                            </script>';
                            $event->return = str_replace("</body>", "\n<!-- Tracy Recolor Errors -->\n" . static::minify($recolorErrors)."\n</body>", $event->return);

                            if(in_array('titlePrefix', $this->data['styleAdminType'])) {
                                $serverTypeMatch = $this->serverStyleInfo['serverTypeMatch'];
                                $stylesArr = $this->serverStyleInfo['styles'];
                                $type = $this->serverStyleInfo['type'];
                                if($serverTypeMatch && isset($stylesArr[$type])) {
                                    $event->return = str_replace('<title>', '<title>'.strtoupper(str_replace('*', '', $type)).' - ', $event->return);
                                }
                            }

                            if(static::getDataValue('forceIsLocal')) {

                                $isLocalWarnIcon = '
                                <script' . static::getNonceAttr() . '>
                                    function addLocalAlert() {
                                        if(!document.getElementById("tracy-debug-bar")) {
                                            window.requestAnimationFrame(addLocalAlert);
                                        } else {
                                            var debugBar = document.getElementById("tracy-debug-bar");
                                            var barul = debugBar.getElementsByTagName("ul")[0];
                                            var forcelocalli = document.createElement("li");
                                            const warningIcon = document.createElement("img");
                                            warningIcon.src  = "'.$this->wire('config')->urls->TracyDebugger.'assets/warning-icon.svg";
                                            warningIcon.style.width = "16px";
                                            warningIcon.style.height = "16px";
                                            forcelocalli.appendChild(warningIcon);
                                            forcelocalli.setAttribute("id", "local-alert");
                                            forcelocalli.setAttribute("style", "background: '.self::COLOR_WARN.'; padding: 0 5px; color: #FFFFFF");
                                            forcelocalli.setAttribute("title", "WARNING: Tracy is in ForceLocal mode. Only use this if you know what you are doing!");
                                            barul.insertBefore(forcelocalli, barul.firstChild);
                                        }
                                    }
                                    addLocalAlert();
                                </script>';

                                if(strpos($event->return, '</body>') !== false) {
                                    $event->return = str_replace('</body>', $isLocalWarnIcon . '</body>', $event->return);
                                }
                                elseif(!$this->wire('config')->ajax) {
                                    $event->return = $event->return . $isLocalWarnIcon;
                                }
                            }
                        });
                    }
                });

                $barJs .= '
                    function unhideBar() {
                        document.getElementById("tracy-debug").style.display = "block";
                        document.getElementById("tracy-show-button").style.display = "none";
                        window.Tracy.Debug.bar.restorePosition();
                        document.body.classList.add("has-tracy-debugbar");
                        document.cookie = "tracyHidden=; expires=Thu, 01 Jan 1970 00:00:01 GMT; path=/";
                        document.cookie = "tracyShow=1; path=/";
                    }

                    document.addEventListener("DOMContentLoaded", function() {
                        var showButton = document.createElement("div");
                        showButton.id = "tracy-show-button";
                        showButton.title = "Show Tracy";
                        showButton.textContent = "\u21F1";
                        showButton.addEventListener("click", unhideBar);
                        document.body.appendChild(showButton);
                    });

                    window.tracyDebuggerOnBar(function() {
                        var debugBar = document.getElementById("tracy-debug-bar");
                        var barul = debugBar.getElementsByTagName("ul")[0];
                        var toggleli = document.createElement("li");
                        toggleli.appendChild(document.createTextNode("⇲"));
                        toggleli.setAttribute("id", "hide-button");
                        toggleli.setAttribute("title", "Hide Tracy");
                        toggleli.addEventListener("click", function() {
                            document.body.classList.remove("has-tracy-debugbar");
                            document.getElementById("tracy-debug").style.display = "none";
                            document.getElementById("tracy-show-button").style.display = "block";
                            document.cookie = "tracyHidden=1; path=/";
                            document.cookie = "tracyShow=; expires=Thu, 01 Jan 1970 00:00:01 GMT; path=/";
                        });
                        barul.replaceChild(toggleli, barul.lastChild.previousElementSibling);
                        window.Tracy.Debug.bar.restorePosition();
                    });

                    window.tracyDebuggerOnBar(function() {
                        var tracyLogo = document.getElementById("tracy-debug-logo");
                        tracyLogo.setAttribute("title", tracyLogo.getAttribute("title") + "\n\nTracy Debugger for PW '.$this->getModuleInfo()['version'].'\nClick to scroll to page top\nDouble-click to visit module settings");
                        tracyLogo.addEventListener("click", function() {
                            window.scrollTo(0,0);
                        }, false);
                        tracyLogo.addEventListener("dblclick", function() {
                            window.open("'.$this->wire('config')->urls->admin.'module/edit?name=TracyDebugger","_blank");
                        }, false);
                    });

                    document.addEventListener("keydown", function(e) {
                        if((e.keyCode==27||e.charCode==27)) {
                            var panels = document.getElementsByClassName("tracy-panel");
                            if(panels.length > 0) {
                                for (var i = 0; i < panels.length; i++) {
                                    window.Tracy.Debug.panels[panels[i].id].toPeek();
                                }
                            }
                        }
                    });
                ';

                if($this->data['hideDebugBar'] && $this->showServerTypeIndicator() && in_array('custom', $this->data['styleAdminType'])) {
                    // hide server type indicator bar if debug bar is hidden by default
                    $barJs .= '
                    if(!/(^|;\\s*)tracyShow=[^;]/.test(document.cookie)) {
                        document.body.classList.add("tracyHidden");
                        document.body.classList.remove("has-tracy-debugbar");
                    }';
                }

                // remove localStorage items to prevent the panel from staying open
                $barJs .= '
                    localStorage.removeItem("tracy-debug-panel-ProcessWire-PanelSelectorPanel");
                    if(localStorage.getItem("remove-tracy-debug-panel-ProcessWire-ProcesswireInfoPanel")) {
                        localStorage.removeItem("tracy-debug-panel-ProcessWire-ProcesswireInfoPanel");
                        localStorage.removeItem("remove-tracy-debug-panel-ProcessWire-ProcesswireInfoPanel")
                    }
                    if(localStorage.getItem("remove-tracy-debug-panel-ProcessWire-RequestInfoPanel")) {
                        localStorage.removeItem("tracy-debug-panel-ProcessWire-RequestInfoPanel");
                        localStorage.removeItem("remove-tracy-debug-panel-ProcessWire-RequestInfoPanel")
                    }
                ';

                // every URL template Debugger::$editor can be set to (see EDITOR PROTOCOL HANDLER), for main.js
                // to read the mapped file of a dump's location link
                $barJs .= 'window.TracyDebuggerEditorTemplates = ' . json_encode(array(
                    (string) $this->data['editor'],
                    'tracy://?f=%file&l=%line',
                    $this->wire('config')->urls->admin . 'setup/file-editor/?f=%file&l=%line'
                )) . ';' . "\n";

                $barJs .= '
                    window.tracyDebuggerOnBar(function() {
                        if(!document.getElementById("tracy-debug-panel-ProcessWire-DumpsRecorderPanel")) {
                        localStorage.removeItem("tracy-debug-panel-ProcessWire-DumpsRecorderPanel");
                        }
                    });

                    document.addEventListener("DOMContentLoaded", function() {
                        if(!/(^|;\\s*)tracyHidden=[^;]/.test(document.cookie)) {
                            document.body.classList.add("has-tracy-debugbar");
                        }
                    });';

                // Tracy only reads $customJsFiles when it serves the bundle (?_tracy_bar=...)
                if(isset($_GET['_tracy_bar']) && ($barJsFile = $this->barJsFile($barJs))) {
                    Debugger::$customJsFiles[] = $barJsFile;
                }

            }


            // UPDATE CACHED API DATA on core version change
            $this->wire()->addHookBefore('SystemUpdater::coreVersionChange', null, function($event) {
                foreach(array('variables', 'core', 'proceduralFunctions', 'coreModules') as $type) {
                    self::getApiData($type);
                }
            });


            // populate redirect info for Request Info panel
            if(method_exists('\ProcessWire\Debug', 'backtrace')) {
                $this->wire()->addHookBefore('Session::redirect', function($event) {
                    static::$redirectInfo = Debug::backtrace()[0];
                });
            }


            // MAIL INTERCEPTOR
            // if mail panel items were cleared, clear them from the session variable
            if($this->wire('input')->cookie->tracyClearMailItems || (!in_array('mailInterceptor', static::$showPanels) && $this->wire('session')->tracyMailItems)) {
                $this->wire('session')->tracyMailItems = null;
                unset($this->wire('input')->cookie->tracyClearMailItems);
                setcookie("tracyClearMailItems", "", time()-3600, "/");
            }
            // mail panel intercept hook
            if(in_array('mailInterceptor', static::$showPanels)) {
                $this->wire()->addHookBefore('WireMail::send', $this, 'interceptEmails');
            }

            // TRACY CACHES
            // delete caches on module changes so they will be updated
            $this->wire()->addHookAfter('Modules::install', $this, 'deleteTracyCaches');
            $this->wire()->addHookAfter('Modules::uninstall', $this, 'deleteTracyCaches');
            $this->wire()->addHookAfter('Modules::moduleVersionChanged', $this, 'deleteTracyCaches');

            if(!static::$inAdmin) {
                // VALIDATOR
                if(in_array('validator', static::$showPanels)) {
                    $this->wire()->addHookAfter('ProcessWire::ready', function($event) {
                        if(!method_exists($event->page, 'render')) {
                            $event->page->addHookAfter('render', $this, 'getPageHtml', array('priority'=>1000));
                        }
                    });
                }

                // TEMPLATE RESOURCES
                if(!$this->wire('config')->ajax && (in_array('console', static::$showPanels) || in_array('templateResources', static::$showPanels))) {
                    $functions = get_defined_functions();
                    self::$initialFuncs = $functions['user'];
                    self::$initialConsts = get_defined_constants();
                    $this->wire()->addHookBefore('TemplateFile::render', function($event) {
                        // exclude template rendering from Hanna code because it breaks gathering of all template resources
                        if(!$event->object->hanna) {
                            $event->object->setAppendFilename(__DIR__ . '/includes/GetTemplateResources.php');
                        }
                    });
                }
            }


            // EVENT INTERCEPTOR
            // if event interceptor panel items were cleared, clear them from the session variable and remove cookie
            if($this->wire('input')->cookie->tracyClearEventItems || (!in_array('eventInterceptor', static::$showPanels) && $this->wire('session')->tracyEventItems)) {
                $this->wire('session')->tracyEventItems = null;
                unset($this->wire('input')->cookie->tracyClearEventItems);
                setcookie("tracyClearEventItems", "", time()-3600, "/");
            }
            // event interceptor hook
            if((static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser) && in_array('eventInterceptor', static::$showPanels) && static::tokenCookie('eventInterceptorHook')) {
                $this->hookSettings = json_decode(static::tokenCookie('eventInterceptorHook'), true);
                if(is_array($this->hookSettings) && !empty($this->hookSettings['hook'])) {
                    if(isset($this->hookSettings['when']) && $this->hookSettings['when'] == 'before') {
                        $this->wire()->addHookBefore($this->hookSettings['hook'], $this, 'interceptEvent');
                    }
                    else {
                        $this->wire()->addHookAfter($this->hookSettings['hook'], $this, 'interceptEvent');
                    }
                }
            }


            // DUMPS RECORDER
            // if dump recorder panel items were cleared, clear them from the session variable and remove cookie
            if($this->wire('input')->cookie->tracyClearDumpsRecorderItems) {
                $dumpsFile = $this->tracyCacheDir.'dumps.json';
                if(file_exists($dumpsFile)) unlink($dumpsFile);
                unset($this->wire('input')->cookie->tracyClearDumpsRecorderItems);
                setcookie("tracyClearDumpsRecorderItems", "", time()-3600, "/");
            }


            // PAGE RECORDER
            // page recorder hook
            if(in_array('pageRecorder', static::$showPanels)) {
                $this->wire()->addHookAfter('Pages::added', $this, 'recordPage');
            }


            // TRACY SETTING
            //convert checked log severity strings to constants and array_reduce to bitwise OR (|) line
            // remove E_STRICT in case it's still set from old version of Tracy - it's deprecated in PHP 8.4
            if(($key = array_search('E_STRICT', $this->data['logSeverity'])) !== false) {
                unset($this->data['logSeverity'][$key]);
            }
            $severityOptions = array_map('constant', $this->data['logSeverity']);
            Debugger::$logSeverity = array_reduce($severityOptions, function($a, $b) { return $a | $b; }, 0);

            Debugger::$maxDepth = $this->data['maxDepth'];
            Debugger::$maxLength = $this->data['maxLength'];
            if(property_exists(Debugger::class, 'maxItems')) {
                Debugger::$maxItems = $this->data['maxItems'];
            }
            if(static::$useOnlineEditor && static::$onlineEditor == 'tracy') {
                Debugger::getBlueScreen()->addPanel(function (): ?string {
                    return '<script' . TracyDebugger::getNonceAttr() . '>document.addEventListener("click", function(e) { var el = e.target; while(el && el.tagName !== "A") el = el.parentNode; if(el && el.href && el.href.indexOf("tracy://") !== -1) { e.preventDefault(); e.stopImmediatePropagation(); if(typeof tracyFileEditorLoader !== "undefined") { var q = el.href.split("?")[1]; var f = tracyFileEditorLoader.getFileLineVars(q, "f"); var l = tracyFileEditorLoader.getFileLineVars(q, "l"); tracyFileEditorLoader.loadFileEditor(f, l); tracyFileEditorLoader.addRecentlyOpenedFile(f); } } }, true);</script>';
                });
            }

            // The BlueScreen page's <style class="tracy-debug"> elements have no nonce, and a CSP without
            // 'unsafe-inline' blocks them. BlueScreen actions are rendered just before the page is output,
            // so start a buffer there that adds the nonce to them. Not when the BlueScreen is captured
            // for an AJAX request (renderToAjax): an extra buffer would break the capture, and main.js
            // adds the nonce to that markup instead.
            if($outputMode != Debugger::PRODUCTION && method_exists(Debugger::getBlueScreen(), 'addAction')) {
                Debugger::getBlueScreen()->addAction(function (): ?array {
                    static $buffering = false;
                    $nonceAttr = TracyDebugger::getNonceAttr();
                    if($buffering || $nonceAttr === '') return null;
                    foreach(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 8) as $frame) {
                        if(($frame['function'] ?? '') === 'renderToAjax') return null;
                    }
                    $buffering = true;
                    ob_start(function (string $html) use ($nonceAttr): string {
                        return str_replace('<style class="tracy-debug">', '<style class="tracy-debug"' . $nonceAttr . '>', $html);
                    });
                    return null;
                });
            }

            if($outputMode != Debugger::PRODUCTION) {
                Debugger::getBlueScreen()->addPanel(function (?\Throwable $ex): ?array {
                    static $stashed = null;
                    static $rendered = false;

                    if($ex !== null) {
                        if($stashed === null) $stashed = $ex;
                        return null;
                    }
                    if($rendered || $stashed === null) return null;
                    $rendered = true;

                    // Agent Markdown depends on Tracy 2.12+ APIs (BlueScreen::renderAgent, Helpers::jsonEncode).
                    if(!method_exists('\Tracy\BlueScreen', 'renderAgent') || !method_exists('\Tracy\Helpers', 'jsonEncode')) {
                        return null;
                    }

                    $activeBs = Debugger::getBlueScreen();
                    $tempBs = new \Tracy\BlueScreen();
                    $tempBs->maxDepth = $activeBs->maxDepth;
                    $tempBs->maxLength = $activeBs->maxLength;
                    $tempBs->maxItems = $activeBs->maxItems;
                    $tempBs->scrubber = $activeBs->scrubber;
                    $tempBs->keysToHide = $activeBs->keysToHide;
                    $tempBs->collapsePaths = $activeBs->collapsePaths;
                    $tempBs->showEnvironment = $activeBs->showEnvironment;
                    try {
                        $md = $tempBs->renderAgent($stashed);
                    } catch(\Throwable $e) {
                        return null;
                    }

                    $nonceAttr = TracyDebugger::getNonceAttr();
                    $jsonMd = str_replace('</', '<\\/', \Tracy\Helpers::jsonEncode($md, true));
                    $escapedMd = htmlspecialchars($md, ENT_QUOTES, 'UTF-8');

                    $script = '(function(){if(window.__tracyMdCopyHandlerInstalled)return;window.__tracyMdCopyHandlerInstalled=true;document.addEventListener("click",function(e){var btn=e.target.closest&&e.target.closest("[data-tracy-md-copy]");if(!btn)return;e.preventDefault();e.stopPropagation();var src=btn.parentElement&&btn.parentElement.querySelector("[data-tracy-md-source]");if(!src)return;var md;try{md=JSON.parse(src.textContent);}catch(err){console.error("tracy md-copy: JSON parse failed",err);return;}var origChildren=[];for(var i=0;i<btn.childNodes.length;i++)origChildren.push(btn.childNodes[i]);var done=function(ok){while(btn.firstChild)btn.removeChild(btn.firstChild);var svgNS="http://www.w3.org/2000/svg";var icon=document.createElementNS(svgNS,"svg");icon.setAttribute("width","14");icon.setAttribute("height","14");icon.setAttribute("viewBox","0 0 24 24");icon.setAttribute("fill","none");icon.setAttribute("stroke",ok?"#4CAF50":"#CD1818");icon.setAttribute("stroke-width","3");icon.setAttribute("stroke-linecap","round");icon.setAttribute("stroke-linejoin","round");var p=document.createElementNS(svgNS,"path");p.setAttribute("d",ok?"M5 13 L10 18 L19 6":"M6 6 L18 18 M6 18 L18 6");icon.appendChild(p);btn.appendChild(icon);setTimeout(function(){while(btn.firstChild)btn.removeChild(btn.firstChild);for(var j=0;j<origChildren.length;j++)btn.appendChild(origChildren[j]);},1200);};if(navigator.clipboard&&navigator.clipboard.writeText&&window.isSecureContext){navigator.clipboard.writeText(md).then(function(){done(true);},function(err){console.error("tracy md-copy: clipboard write rejected",err);done(false);});}else{var ta=document.createElement("textarea");ta.value=md;ta.style.cssText="position:fixed;opacity:0";document.body.appendChild(ta);ta.select();try{done(document.execCommand("copy"));}catch(err){console.error("tracy md-copy: execCommand failed",err);done(false);}document.body.removeChild(ta);}},true);})();';

                    $copyIcon = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="currentColor"><path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z"/></svg>';
                    $panelHtml = '<div class="tracy-md-copy-wrap" style="margin: 0 0 8px 0;">'
                        . '<button type="button" data-tracy-md-copy class="tracy-md-copy-btn" style="padding:4px 6px;line-height:0;cursor:pointer;background:#eee;border:1px solid #ccc;border-radius:3px;color:#555;" title="Copy bluescreen as Markdown for an AI agent">' . $copyIcon . '</button>'
                        . '<script type="application/json" data-tracy-md-source>' . $jsonMd . '</script>'
                        . '</div>'
                        . '<pre style="white-space: pre-wrap; font-size: 11px; background: #fafafa; padding: 8px; border: 1px solid #eee; max-height: 600px; overflow: auto; margin: 0;">' . $escapedMd . '</pre>'
                        . '<script' . $nonceAttr . '>' . $script . '</script>';

                    return [
                        'tab' => 'Agent Markdown',
                        'panel' => $panelHtml,
                        'collapsed' => true,
                    ];
                });
            }

            Debugger::getBlueScreen()->maxDepth = $this->data['maxDepth'];
            Debugger::getBlueScreen()->maxLength = $this->data['maxLength'];
            Debugger::getBlueScreen()->maxItems = $this->data['maxItems'];

            Debugger::$strictMode = $this->data['strictMode'] || ($this->data['strictModeAjax'] && $this->wire('config')->ajax) || $this->wire('input')->cookie->tracyStrictMode ? TRUE : FALSE;
            Debugger::$scream = $this->data['forceScream'] ? TRUE : FALSE;

        }


        // ENABLE TRACY
        if($this->tracyEnabled) {
            if($this->data['use_php_session'] === 1 && !$this->wire('modules')->isInstalled('SessionHandlerDB') && self::$tracyVersion != '2.7.x') {
                if (session_status() === PHP_SESSION_NONE) {
                    session_start();
                }
                if(method_exists(Debugger::class, 'setSessionStorage')) {
                    Debugger::setSessionStorage(new \Tracy\NativeSession);
                }
            }
            // Tracy's asset responses (?_tracy_bar=...) send their own Cache-Control, but PHP's session
            // cache limiter has already queued "Expires: 1981" and "Pragma: no-cache", which contradict it
            if(isset($_GET['_tracy_bar']) && !headers_sent()) {
                header_remove('Expires');
                header_remove('Pragma');
                // Replace Tracy's Cache-Control just before the headers go out: 'private' on all of these responses
                // (the bundle and the bar/panel content), so a shared proxy or CDN never stores them, and for the
                // bundle an hour instead of 10 days, since its URL only changes with Tracy's version, so a
                // TracyDebugger update or a settings change that feeds the bundle would reach browsers 10 days late
                $tracyBarAsset = (string) $_GET['_tracy_bar'];
                header_register_callback(function() use ($tracyBarAsset) {
                    foreach(headers_list() as $header) {
                        if(preg_match('#^Cache-Control:\s*max-age=(\d+)#i', $header, $m)) {
                            header('Cache-Control: private, max-age=' . ($tracyBarAsset === 'js' ? 3600 : (int) $m[1]));
                            break;
                        }
                    }
                });
            }
            // registered before Debugger::enable() registers Tracy's own shutdown handler, so it runs first.
            // When the Console asks (CodeProcessor.php), it takes the request's last error for the Console's
            // shutdown handler and clears it, and turns the bar off, so Tracy's handler has nothing to log
            // or render into the Console's AJAX response
            register_shutdown_function(function() {
                if(!static::$skipTracyShutdownHandler) return;
                static::$consoleLastError = error_get_last();
                error_clear_last();
                Debugger::$showBar = false;
            });
            // Tracy only calls the mailer below when it has an email address, so with only Slack alerts set up
            // the Slack channel stands in for one (the mailer doesn't use it)
            $emailAlerts = $this->data['fromEmail'] != '' && $this->data['email'] != '';
            $slackAlerts = $this->data['slackChannel'] != '' && $this->data['slackAppOauthToken'] != '';
            Debugger::enable($outputMode, $logFolder, $emailAlerts ? $this->data['email'] : ($slackAlerts ? $this->data['slackChannel'] : null));

            // Tracy's production error page, with the CSP nonce on its <style> (unless the site has its own)
            if(!Debugger::$errorTemplate) Debugger::$errorTemplate = __DIR__ . '/includes/error.500.php';

            // don't email custom (writeError()) logged errors for Console panel via CodeProcessor.php
            if($this->wire('config')->ajax && $this->wire('input')->post->tracyConsole == 1) {
                Debugger::getLogger()->mailer = null;
            }
            else {
                Debugger::getLogger()->mailer = function($value) use ($emailAlerts, $slackAlerts) {

                    $plainMessage = \Tracy\Logger::formatMessage($value);

                    if($emailAlerts) {
                        // escaped for the HTML email: exception messages can contain text from the request that caused them
                        $message = nl2br(htmlspecialchars($plainMessage, ENT_QUOTES, 'UTF-8'));

                        $m = $this->wire('mail')->new();
                        $m->from($this->data['fromEmail']);
                        foreach(explode("\n", trim($this->data['email'])) as $recipient) {
                            $m->to(trim($recipient));
                        }
                        $m->subject('Error on server: ' . $this->wire('config')->urls->httpRoot);
                        $m->bodyHTML($message . "<br /><br />Remember to <a href='".$this->wire('config')->urls->httpAdmin."?clearEmailSent=1'>clear email sent flag</a> to receive future emails.");
                        $m->send();
                    }

                    if($slackAlerts) {
                        require_once __DIR__ . '/includes/SlackLogger.php';
                        $slackLogger = new SlackLogger();
                        $slackLogger->log($plainMessage);
                    }

                };
            }

            // Persist Tracy's per-panel CSRF tokens + $input snapshots before
            // the session closes. SessionHandlerDB registers session_write_close()
            // as a shutdown function during boot, which runs BEFORE Tracy's own
            // shutdown handler renders the panels — so writes from inside
            // getPanel() (Console, File Editor, Tracy Exceptions) are silently
            // dropped. ProcessWire::finished fires before either shutdown
            // function for all session backends.
            $this->wire()->addHookAfter('ProcessWire::finished', function() {
                // only development mode has panels that use these; in production mode this would copy every
                // visitor's POST data (login passwords included) into their session
                if(static::$allowedTracyUser !== 'development') return;
                $session = $this->wire('session');
                if(!$session->tracyConsoleToken) {
                    $session->tracyConsoleToken = bin2hex(random_bytes(32));
                }
                if(!$session->tracyFileEditorToken) {
                    $session->tracyFileEditorToken = bin2hex(random_bytes(32));
                }
                // for links that trigger an action with a GET request (see actionUrl()); separate from the
                // Console's token because these URLs can end up in server logs
                if(!$session->tracyActionToken) {
                    $session->tracyActionToken = bin2hex(random_bytes(16));
                }
                $session->tracyPostData = $this->wire('input')->post->getArray();
                $session->tracyGetData = $this->wire('input')->get->getArray();
                $session->tracyWhitelistData = $this->wire('input')->whitelist->getArray();
            });
        }

        // Tracy 2.7.x + SessionHandlerDB: Bar::render() wrote to $_SESSION directly,
        // so we had to force the render before PW closed the session. Tracy 2.9+
        // uses FileSession by default (file-backed, session-independent) so the
        // workaround is not needed.
        if(self::$tracyVersion == '2.7.x' && $this->wire('modules')->isInstalled('SessionHandlerDB') && Debugger::$showBar) {
            $this->wire()->addHookAfter('ProcessWire::finished', function() {
                if(ob_get_level() == 0) ob_start();
                Debugger::getBar()->render();
                Debugger::$showBar = false;
            }, array('priority' => 9999));

            if(!$this->wire('config')->disableTracySHDBRedirectFix) {
                $this->wire()->addHookBefore('Session::redirect', function($event) {
                    $url = $event->arguments[0];
                    $http301 = isset($event->arguments[1]) ? $event->arguments[1] : true;
                    if($http301) header("HTTP/1.1 301 Moved Permanently");
                    header("Location: $url");
                });
            }
        }

        // PW VERSION SWITCHER — marker cleanup (must be at the VERY END of init)
        PwVersionSwitcher::cleanupSwitchMarker($this);

    }


    /**
     * Called when ProcessWire's API is ready
     */
    public function ready() {

        // PW VERSION SWITCHER — show auto-revert notification
        PwVersionSwitcher::showRevertNotification($this);

        // USER BAR PAGE VERSIONS
        if(!static::$inAdmin && !$this->wire('config')->ajax && $this->wire('user')->isLoggedin() && $this->wire('user')->hasPermission('tracy-page-versions') && $this->data['showUserBar'] && in_array('pageVersions', $this->data['userBarFeatures'])) {
            static::$pageVersion = $this->findPageTemplateInCookie($this->wire('input')->cookie->tracyPageVersion);
            if(static::$pageVersion && static::$pageVersion != pathinfo($this->wire('page')->template->filename, PATHINFO_BASENAME)) {
                static::$templatePath = static::$pageVersion;
            }
            elseif(static::$pageVersion != '') {
                // don't change as already set by dev template permission functionality
            }
            else {
                static::$templatePath = '';
            }

            if(static::$templatePath != '') {
                // template file
                $this->wire('page')->template->filename = static::$templatePath;
                // auto appended/prepended files
                $this->replaceAutoAppendedPreprendedTemplateFiles($this->getFileSuffix(static::$templatePath));
            }
            unset($this->wire('input')->cookie->tracyPageVersion);
            setcookie("tracyPageVersion", "", time()-3600, "/");
        }


        // USER DEV TEMPLATES
        // if user dev template enabled and required permission exists in system,
        // check if current user has a matching permission for the current page's template, or the "tracy-all-suffix" permission
        if($this->data['userDevTemplate'] && ($this->wire('permissions')->get("tracy-".$this->wire('page')->template->name."-".$this->data['userDevTemplateSuffix'])->id || $this->wire('permissions')->get("tracy-all-".$this->data['userDevTemplateSuffix'])->id)) {
            if(self::userHasPermission("tracy-".$this->wire('page')->template->name."-".$this->data['userDevTemplateSuffix']) ||
                self::userHasPermission("tracy-all-".$this->data['userDevTemplateSuffix'])
            ) {
                // template file
                $devTemplateFilename = $this->appendSuffixToFile($this->wire('page')->template->filename, $this->data['userDevTemplateSuffix']);
                if(file_exists($devTemplateFilename)) $this->wire('page')->template->filename = static::$templatePath = static::$templatePathPermission = $devTemplateFilename;
                // auto appended/prepended files
                $this->replaceAutoAppendedPreprendedTemplateFiles($this->data['userDevTemplateSuffix']);
            }
        }

        // Exit now if "enabled" not true from init()
        if(!$this->tracyEnabled) return;

        if(static::$allowedTracyUser === 'development') {

            // if it's an ajax request for the File Editor feature
            if($this->wire('config')->ajax && isset($this->wire('input')->post->filePath)) {
                require_once(__DIR__ . '/includes/GetFileDetails.php');
                return;
            }

            // if it's an ajax request from the ProcessWire Info GoTo Page ID feature
            if($this->wire('config')->ajax && isset($this->wire('input')->post->goToPage)) {
                require_once(__DIR__ . '/includes/GetPageById.php');
                return;
            }

            // CONSOLE PANEL CODE INJECTION
            $this->insertCode('ready');


            // FILE/TEMPLATE EDITOR
            require_once(__DIR__ . '/includes/post_processors/FileEditorPost.php');


            // DEBUG BAR & PANELS

            // hide debug bar from specified templates
            if(static::$inAdmin && count($this->data['hideDebugBarBackendTemplates']) > 0) {
                if($this->wire('input')->get('id') && $this->wire('page')->process == 'ProcessPageEdit') {
                    $p = $this->wire('pages')->get($this->wire('input')->get('id'));
                    if($p->id && in_array($p->template->id, $this->data['hideDebugBarBackendTemplates'])) Debugger::$showBar = false;
                }
            }
            if(!static::$inAdmin && count($this->data['hideDebugBarFrontendTemplates']) > 0) {
                $p = $this->wire('page');
                if($p->id && in_array($p->template->id, $this->data['hideDebugBarFrontendTemplates'])) Debugger::$showBar = false;
            }

        }

        // exit now if not showing debug bar or user doesn't have 'development' access
        if(Debugger::$showBar == false || static::$allowedTracyUser !== 'development') return;


        // check for any "bd_" wire variables and barDump them
        $pwVars = $this->wire('all');
        foreach($pwVars->getArray() as $key => $val) {
            if(strpos($key, 'bd_') !== false) TD::barDump($val, '$'.$key);
        }


        // LOAD SPECIFIED PANELS
        $hideInAdminLookup = array_flip(static::$hideInAdmin);
        $superUserOnlyLookup = array_flip(self::$superUserOnlyPanels);
        $restrictedDisabledLookup = !empty(static::$restrictedUserDisabledPanels)
            ? array_flip(static::$restrictedUserDisabledPanels)
            : array();
        $deferredPanelSelectorClass = null;
        foreach(static::$showPanels as $panel) {
            if(!array_key_exists($panel, static::$allPanels)) continue;
            if(static::$inAdmin && isset($hideInAdminLookup[$panel])) continue;
            if(isset($superUserOnlyLookup[$panel]) && !static::$allowedSuperuser && !self::$validLocalUser && !self::$validSwitchedUser) continue;
            // special additional check for adminer
            if($panel == 'adminer' && (!static::$allowedSuperuser || $this->wire('page')->process == 'ProcessTracyAdminer')) continue;
            if($panel == 'userSwitcher') {
                if(isset($this->data['userSwitchSession'])) $userSwitchSession = $this->data['userSwitchSession'];
                if(!static::$allowedSuperuser && (!$this->wire('session')->tracyUserSwitcherId || (isset($userSwitchSession[$this->wire('session')->tracyUserSwitcherId]) && $userSwitchSession[$this->wire('session')->tracyUserSwitcherId] <= time()))) continue;
            }
            // ignore disabled panels for restricted users
            if(isset($restrictedDisabledLookup[$panel])) continue;

            $panelName = ucfirst($panel).'Panel';
            $fullPanelClass = __NAMESPACE__ . '\\' . $panelName;
            if(file_exists(__DIR__ . '/panels/'.$panelName.'.php')) {
                require_once __DIR__ . '/panels/'.$panelName.'.php';
                // namespace migration: bridge old non-namespaced panel class
                if(!class_exists($fullPanelClass, false) && class_exists($panelName, false)) {
                    class_alias($panelName, $fullPanelClass);
                }
            }
            else {
                // external panels
                include_once static::$externalPanels[$panel];
                // namespace migration: bridge old non-namespaced external panel class
                if(!class_exists($fullPanelClass, false) && class_exists($panelName, false)) {
                    class_alias($panelName, $fullPanelClass);
                }
            }
            switch($panel) {
                case 'performance':
                    break;
                case 'panelSelector':
                    // defer so panelSelector is always last on the bar, even after force-adds below
                    $deferredPanelSelectorClass = $fullPanelClass;
                    break;
                case 'templatePath':
                    static::$templatePathOnce = $this->findPageTemplateInCookie($this->wire('input')->cookie->tracyTemplatePathOnce);
                    static::$templatePathSticky = $this->findPageTemplateInCookie($this->wire('input')->cookie->tracyTemplatePathSticky);
                    if(static::$templatePathOnce) {
                        static::$templatePath = static::$templatePathOnce;
                        unset($this->wire('input')->cookie->tracyTemplatePathOnce);
                        setcookie("tracyTemplatePathOnce", "", time()-3600, "/");
                    }
                    elseif(static::$templatePathSticky) {
                        static::$templatePath = static::$templatePathSticky;
                    }
                    elseif(static::$templatePath != '') {
                        // don't change as already set by dev template permission functionality
                    }
                    else {
                        static::$templatePath = '';
                    }

                    if(static::$templatePath != '') {
                        // template file
                        $this->wire('page')->template->filename = static::$templatePath;
                        // auto appended/prepended files
                        $this->replaceAutoAppendedPreprendedTemplateFiles($this->getFileSuffix(static::$templatePath));
                    }
                    Debugger::getBar()->addPanel(new $fullPanelClass);
                    break;
                default:
                    Debugger::getBar()->addPanel(new $fullPanelClass);
                    break;
            }
        }
        // load custom replacement Dumps panel - this is not optional/configurable
        // at the end so it has access to bd() calls in any of the other panels - helpful for debugging these panels
        $panelName = 'DumpsPanel';
        $fullPanelClass = __NAMESPACE__ . '\\' . $panelName;
        require_once __DIR__ . '/panels/'.$panelName.'.php';
        if(!class_exists($fullPanelClass, false) && class_exists($panelName, false)) {
            class_alias($panelName, $fullPanelClass);
        }
        Debugger::getBar()->addPanel(new $fullPanelClass);

        // auto-enable dumpsRecorder only when guest dumps recording is active.
        // otherwise, respect the user's panel config — if they haven't enabled
        // dumpsRecorder, the panel stays off even when dumps.json has entries.
        // (users who want cross-tab visibility should enable the panel in config.)
        if(!in_array('dumpsRecorder', static::$showPanels) && $this->data['recordGuestDumps']) {
            $panelName = 'DumpsRecorderPanel';
            $fullPanelClass = __NAMESPACE__ . '\\' . $panelName;
            static::$showPanels[] = 'dumpsRecorder';
            require_once __DIR__ . '/panels/'.$panelName.'.php';
            if(!class_exists($fullPanelClass, false) && class_exists($panelName, false)) {
                class_alias($panelName, $fullPanelClass);
            }
            Debugger::getBar()->addPanel(new $fullPanelClass);
        }

        // add panelSelector last so it sees generation-time values for all other panels
        if($deferredPanelSelectorClass !== null) {
            Debugger::getBar()->addPanel(new $deferredPanelSelectorClass);
        }


        // USER SWITCHER
        require_once(__DIR__ . '/includes/post_processors/UserSwitcherPost.php');


        // LANGUAGE SWITCHER
        require_once(__DIR__ . '/includes/post_processors/LanguageSwitcherPost.php');


        // if it's an ajax request from the Tracy Console panel snippets, then process and return
        if($this->wire('config')->ajax && $this->wire('input')->post->tracysnippets == 1) {
            require_once(__DIR__ . '/includes/ConsoleSnippets.php');
            return;
        }

    }


    /**
     * FUNCTIONS CALLED FROM HOOKS
     */


    /**
     * Whether this Page::render() hook event is a $page->render('field_name') call
     * rather than a full page render. Mirrors the field name test in Page::___render().
     * PW cores before 3.0.253 cancel Page::render hooks for field renders, so this
     * only ever matches on 3.0.253+ where those hooks now fire for field renders too.
     *
     * @param HookEvent $event
     * @return bool
     *
     */
    protected static function isFieldRenderEvent($event) {
        $arg = $event->arguments(0);
        return is_string($arg) && strlen($arg) && ctype_alnum(str_replace('_', '', $arg));
    }


    /**
     * Hook after Page::render()
     *
     * Add the User bar
     *
     * @param HookEvent $event
     *
     */
    protected function addUserBar($event) {
        if(static::isFieldRenderEvent($event)) return;
        // statics because if this hook fires again for a nested render of the same page,
        // the require_once is a no-op and both variables would otherwise be empty
        static $userBarStyles = null;
        static $userBar = null;
        if($userBarStyles === null) {
            $userBar = '';
            require_once __DIR__ . '/includes/user-bar/UserBar.php';
        }
        $return = $event->return;
        $return = str_replace("</head>", "\n<!-- Tracy User Bar -->\n" . static::minify($userBarStyles)."\n</head>", $return);
        $return = str_replace("</body>", "\n<!-- Tracy User Bar -->\n" . static::minify($userBar)."\n</body>", $return);
        $event->return = $return;
    }


    /**
     * Hook after Page::render()
     *
     * Adds Enable button to page if the Tracy Toggler has currently disabled it
     *
     * @param HookEvent $event
     *
     */
    protected function addEnableButton($event) {

        if(static::isFieldRenderEvent($event)) return;

        // DON'T add comments to injected code below because it breaks my simple minify() function
        // if Tracy temporarily toggled disabled, add enable icon link
        $enableButton = '
        <style' . static::getNonceAttr() . '>
            div#TracyEnableButton {
                bottom: 10px !important;
                '.($this->data['barPosition'] == 'bottom-left' ? 'left' : 'right').':10px !important;
                z-index: 99999 !important;
                position: fixed !important;
                width: 16px !important;
                height: 16px !important;
                margin: 0px !important;
                padding: 0px !important;
                cursor:pointer !important;
            }
            div#TracyEnableButton svg {
                width: 16px !important;
                height: 16px !important;
            }
        </style>
        <script' . static::getNonceAttr() . '>
            function enableTracy() {
                document.cookie = "tracyDisabled=; expires=Thu, 01 Jan 1970 00:00:01 GMT; path=/";
                location.reload();
            }
            document.addEventListener("DOMContentLoaded", function() {
                document.getElementById("TracyEnableButton").addEventListener("click", enableTracy);
            });
        </script>
        <div id="TracyEnableButton" title="Enable Tracy | '.number_format((microtime(true) - $this->time) * 1000, 1, '.', "\u{202f}").' ms" uk-tooltip>
            <svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
                 width="16px" height="16.6px" viewBox="199.6 129.9 16 16.6" enable-background="new 199.6 129.9 16 16.6" xml:space="preserve">
            <path fill="'.self::COLOR_NORMAL.'" d="M215.4,139.4c-0.1-0.1-0.3-0.2-0.4-0.2h-1v0c0-0.4-0.1-0.8-0.1-1.2c-0.1-0.7-0.4-1.4-0.8-2l1.5-1.5
                c0.1-0.1,0.2-0.3,0.2-0.5s-0.1-0.3-0.2-0.4c-0.1-0.1-0.3-0.2-0.4-0.2s-0.3,0.1-0.4,0.2l-1.4,1.4c-0.3-0.3-0.7-0.6-1-0.9
                c-0.1-0.1-0.3-0.2-0.4-0.3c0,0,0,0,0.1,0v0c0-0.7-0.3-1.2-0.7-1.7l0.8-1.2c0.1-0.1,0.1-0.3,0.1-0.5c0-0.2-0.1-0.3-0.3-0.4
                s-0.3-0.1-0.5-0.1c-0.2,0-0.3,0.1-0.4,0.3l-0.8,1.1c-0.5-0.3-1-0.4-1.5-0.4c-0.5,0-1,0.1-1.4,0.3l-0.7-1.1c-0.1-0.1-0.2-0.2-0.4-0.3
                s-0.3,0-0.5,0.1c-0.1,0.1-0.2,0.2-0.3,0.4s0,0.3,0.1,0.5l0.8,1.1c-0.4,0.5-0.7,1-0.7,1.7h0c0,0,0,0,0,0c-0.4,0.2-0.9,0.5-1.2,0.9
                c-0.1,0.1-0.2,0.2-0.3,0.3c0,0,0,0,0,0l-1.2-1.2c-0.1-0.1-0.3-0.2-0.4-0.2s-0.3,0.1-0.5,0.2c-0.1,0.1-0.2,0.3-0.2,0.4
                c0,0.2,0.1,0.3,0.2,0.5l1.3,1.3c-0.3,0.5-0.6,1.1-0.7,1.6c-0.2,0.6-0.2,1.2-0.2,1.8h-0.9c-0.2,0-0.3,0.1-0.4,0.2
                c-0.1,0.1-0.2,0.3-0.2,0.4c0,0.2,0.1,0.3,0.2,0.4c0.1,0.1,0.3,0.2,0.4,0.2h1.1c0.1,0.6,0.4,1.1,0.4,1.1c0.1,0.2,0.2,0.2,0.2,0.3
                c0.2,0.1,0.7,0,1-0.3c0,0,0-0.1,0-0.1c-0.1-0.3-0.1-0.6-0.1-0.8c-0.1-0.4-0.1-1-0.1-1.7c0-0.3,0.1-0.7,0.2-1
                c0.2-0.7,0.7-1.5,1.4-2.1c0.8-0.7,1.7-1.1,2.7-1.2c0.3,0,0.9-0.1,1.7,0.1c0.2,0,0.8,0.2,1.6,0.7c0.5,0.4,1,0.8,1.3,1.3
                c0.3,0.4,0.6,1.1,0.7,1.7c0.1,0.6,0.1,1.2,0,1.8c-0.1,0.6-0.3,1.2-0.7,1.7c-0.2,0.4-0.7,0.9-1.3,1.4c-0.5,0.4-1.1,0.6-1.7,0.8
                c-0.3,0.1-0.6,0.1-0.9,0.1c-0.3,0-0.7,0-0.9,0c-0.4-0.1-0.5-0.2-0.6-0.3c0,0-0.1-0.1-0.1-0.4c0-2.3,0-1.7,0-2.9c0-0.3,0-0.7,0-0.9
                c0-0.5,0.1-0.8,0.4-1.1c0.2-0.3,0.6-0.4,0.9-0.4c0.1,0,0.5,0,0.8,0.3c0.4,0.3,0.4,0.7,0.4,0.8c0.1,0.7-0.3,1.1-0.5,1.3
                c-0.2,0.1-0.4,0.2-0.5,0.3c-0.3,0.1-0.6,0.1-0.8,0.1c0,0-0.1,0-0.1,0.1l-0.1,0.5c-0.1,0.4,0.1,0.5,0.2,0.5c0.4,0.1,0.7,0.1,1,0.1
                c0.6,0,1.1-0.3,1.6-0.7c0.4-0.4,0.7-0.9,0.7-1.4c0.1-0.6,0-1.2-0.3-1.8c-0.3-0.6-0.8-1.1-1.5-1.4s-1.2-0.3-1.9-0.1l0,0
                c-0.5,0.1-0.9,0.4-1.3,0.8c-0.3,0.3-0.5,0.7-0.7,1c-0.1,0.4-0.2,0.7-0.2,1.2c0,0.3,0,0.7,0,1v2c0,0.6,0,0.7,0,1.1
                c0,0.2,0,0.5,0.1,0.7c0.1,0.3,0.3,0.6,0.4,0.7c0.2,0.2,0.4,0.4,0.7,0.5c0.6,0.2,1.3,0.3,1.9,0.3c0.4,0,0.8-0.1,1.2-0.2
                c0.8-0.2,1.6-0.5,2.3-1c0,0,0.1,0,0.1-0.1l1.9,1.9c0.1,0.1,0.3,0.2,0.4,0.2c0.2,0,0.3-0.1,0.4-0.2c0.1-0.1,0.2-0.3,0.2-0.4
                c0-0.2-0.1-0.3-0.2-0.4l-1.8-1.8c0.3-0.3,0.5-0.6,0.7-0.9c0.4-0.7,0.7-1.5,0.9-2.3h1.1c0.2,0,0.3-0.1,0.4-0.2
                c0.1-0.1,0.2-0.3,0.2-0.4C215.6,139.6,215.6,139.5,215.4,139.4L215.4,139.4z"/>
            </svg>
        </div>';

        $event->return =  str_replace("</body>", "\n<!-- Tracy Enable Button -->\n" . static::minify($enableButton)."\n</body>", $event->return);

    }


    /**
     * Hook after Page::render()
     *
     * Gets the HTML of the page for the Validator Panel
     *
     * @param HookEvent $event
     *
     */
    protected function getPageHtml($event) {
        if(static::isFieldRenderEvent($event)) return;
        static::$pageHtml = $event->return;
    }


    /**
     * Hook before WireMail::send
     *
     * Intercepts outgoing emails for the Mail Interceptor Panel
     *
     * @param HookEvent $event
     *
     */
    protected function interceptEmails($event) {
        $mailItem = array();
        $mailItems = $this->wire('session')->tracyMailItems ? $this->wire('session')->tracyMailItems : array();
        foreach(array('subject', 'from', 'fromName', 'to', 'toName', 'cc', 'ccName', 'bcc', 'body', 'bodyHTML', 'attachments', 'header', 'priority', 'dispositionNotification', 'addSignature', 'sendSingle', 'sendBulk', 'useSentLog', 'wrapText', 'default_charset', 'sender_signature', 'sender_signature_html') as $param) {
            $mailItem[$param] = $event->object->$param;
        }
        $mailItem['timestamp'] = time();
        array_push($mailItems, $mailItem);
        $this->wire('session')->tracyMailItems = $mailItems;

        $testEmail = static::tokenCookie('tracyTestEmail');
        if($testEmail) {
            $event->object->to();
            $event->object->cc();
            $event->object->bcc();
            $event->object->to($testEmail);
        }
        else {
            $event->replace = true;
        }
        $event->return = true;
    }


    /**
     * Hook after Module::install, uninstall, or version change
     *
     * Delete existing Tracy caches
     *
     * @param HookEvent $event
     *
     */
    protected function deleteTracyCaches($event) {
        // don't delete caches if it's a core module update because if you're in the admin this deletes them
        // and the system update will trigger generation of new caches anyway. Without this check, the "New Since" in the
        // API Explorer panel no longer had access to the cached API data.
        if($event->method == 'moduleVersionChanged') {
            $info = $this->modules->getModuleInfoVerbose($event->arguments[0]);
            if($info['core']) return;
        }
        $this->deleteCache('TracyApiData.*');
        $this->deleteCache('TracyApiChanges');
    }

    private function deleteCache($cache) {
        $this->wire('cache')->delete($cache);
    }

    /**
     * Fully terminate a console run: SIGKILL the PHP worker, KILL its MySQL
     * connection so any in-flight query is aborted and locks released, then
     * remove every file associated with the run.
     *
     * `wasLive` distinguishes a real running process from a stale leftover
     * (file marker still present after the process is long gone).
     *
     * Returns array('wasLive' => bool, 'killed' => bool, 'connKilled' => bool,
     * 'capturedOutput' => string) — the last being whatever d()/db() streamed
     * to the run's .partial file before it was killed, and only when
     * $returnOutput is true (callers that don't use it skip the read entirely).
     */
    private function cleanupConsoleRun($runId, $returnOutput = false) {
        $result = array('wasLive' => false, 'killed' => false, 'connKilled' => false, 'capturedOutput' => '');
        $runId = preg_replace('/[^a-zA-Z0-9_.]/', '', (string) $runId);
        if(!$runId) return $result;

        $statusDir = $this->wire('config')->paths->assets . 'TracyDebugger/console_runs/';
        $cacheDir  = $this->wire('config')->paths->cache  . 'TracyDebugger/console_runs/';
        $cachePath = $this->wire('config')->paths->cache  . 'TracyDebugger/';
        $pidFile    = $cacheDir . $runId . '.pid';
        $connIdFile = $cacheDir . $runId . '.connid';

        if(file_exists($pidFile)) {
            $fh = @fopen($pidFile, 'r');
            if($fh) {
                $result['wasLive'] = !@flock($fh, LOCK_SH | LOCK_NB);
                if(!$result['wasLive']) @flock($fh, LOCK_UN);
                @fclose($fh);
            }
            if($result['wasLive']) {
                $pid = (int) trim((string) file_get_contents($pidFile));
                if($pid > 0 && $pid !== getmypid()) {
                    if(stripos(PHP_OS, 'WIN') === 0) {
                        @exec('taskkill /F /PID ' . (int) $pid . ' 2>&1', $out, $rc);
                        @exec('tasklist /FI "PID eq ' . (int) $pid . '" 2>&1', $checkOut);
                        $stillAlive = false;
                        foreach((array) $checkOut as $line) {
                            if(strpos($line, (string)(int)$pid) !== false) { $stillAlive = true; break; }
                        }
                        $result['killed'] = !$stillAlive;
                    } else {
                        if(function_exists('posix_kill')) {
                            $rc = @posix_kill($pid, 9);
                            $err = function_exists('posix_get_last_error') ? posix_get_last_error() : 0;
                            $result['killed'] = ($rc === true || $err === 3);
                        } else {
                            @exec('kill -9 ' . (int) $pid . ' 2>&1', $out2, $rc2);
                            $result['killed'] = ($rc2 === 0);
                        }
                    }
                }
            }
        }

        if(file_exists($connIdFile)) {
            $connId = (int) trim((string) file_get_contents($connIdFile));
            if($connId > 0) {
                try {
                    $this->wire('database')->exec('KILL ' . $connId);
                    $result['connKilled'] = true;
                } catch(\Exception $e) {
                    /* "Unknown thread id" means it's already gone — same outcome */
                    if(strpos($e->getMessage(), 'Unknown thread id') !== false) {
                        $result['connKilled'] = true;
                    }
                }
            }
        }

        /* Hand back whatever d()/db() published before the kill — otherwise a
           cancel throws away everything the run produced, which is usually the
           only output the user is going to get from it. The guard allows some
           headroom over the stream cap because TD appends its truncation notice
           after the offset has already reached the cap: gating on the bare cap
           would reject exactly the truncated runs whose 2MB we most want back. */
        $partialFile = $cacheDir . $runId . '.partial';
        if($returnOutput && is_file($partialFile) && @filesize($partialFile) <= TD::CONSOLE_STREAM_MAX_BYTES + 65536) {
            $result['capturedOutput'] = (string) @file_get_contents($partialFile);
        }

        @unlink($pidFile);
        @unlink($connIdFile);
        @unlink($cacheDir . $runId . '.json');
        @unlink($cacheDir . $runId . '.partial');
        @unlink($cacheDir . $runId . '.log');
        // a CLI run that hasn't started yet won't start once its job file is gone
        @unlink($cacheDir . $runId . '.job.json');
        @unlink($statusDir . $runId . '.json');
        @unlink($cachePath . 'consoleCode_' . $runId . '.php');

        return $result;
    }

    /**
     * Hand a Console run to a separate PHP CLI process ("Run in CLI"), so it isn't subject to the web
     * server's request time limit. Called from CodeProcessor.php once the run has been validated.
     * Responds with {status: 'background'} (the panel then polls for the result) and exits.
     *
     * @param string $runId
     * @param array $sessionCache Session data CodeProcessor.php needs (the CLI process has no session)
     */
    private function startConsoleCliRun($runId, array $sessionCache) {
        Debugger::$showBar = false;
        header_remove('X-Tracy-Ajax');
        $cacheDir = $this->wire('config')->paths->cache . 'TracyDebugger/console_runs/';
        $statusDir = $this->wire('config')->paths->assets . 'TracyDebugger/console_runs/';
        $post = $_POST;
        unset($post['runCli']);
        $job = array(
            'userId' => $this->wire('user')->id,
            'post' => $post,
            'sessionCache' => $sessionCache,
            'cookies' => array('tracyCodeReturn' => (string) $this->wire('input')->cookie->tracyCodeReturn),
            // the access checks this request passed, which can depend on its IP address and session
            'allowedSuperuser' => (bool) static::$allowedSuperuser,
            'validLocalUser' => (bool) static::$validLocalUser,
            'validSwitchedUser' => (bool) static::$validSwitchedUser,
        );
        $jobFile = $cacheDir . $runId . '.job.json';
        $error = '';
        if(file_put_contents($jobFile, json_encode($job)) === false) $error = 'Unable to write the job file for the CLI process.';
        if(!$error) $error = $this->spawnConsoleCliRunner($runId);

        /* The runner deletes the job file as soon as it has loaded ProcessWire and read it, which is how we
           know it started. Wait for that so a process that never starts gives a clear error. */
        if(!$error) {
            $waitUntil = microtime(true) + 15;
            while(is_file($jobFile) && microtime(true) < $waitUntil) {
                usleep(200000);
                clearstatcache(true, $jobFile);
            }
            // unlink succeeding means the runner never picked the job up (and now won't)
            if(@unlink($jobFile)) {
                $log = is_file($cacheDir . $runId . '.log') ? trim((string) file_get_contents($cacheDir . $runId . '.log')) : '';
                $error = 'The CLI process did not start within 15 seconds.' . ($log !== '' ? ' It reported: ' . substr($log, -2000) : '');
            }
        }
        else {
            @unlink($jobFile);
        }

        if($error) {
            $error .= ' Check the "PHP CLI path" setting in the Console section of the TracyDebugger settings, or untick "Run in CLI".';
            file_put_contents($cacheDir . $runId . '.json', json_encode(array('status' => 'error', 'output' => $error, 'time' => '', 'memory' => '')));
            file_put_contents($statusDir . $runId . '.json', json_encode(array('status' => 'error')));
            echo '<div style="color:#c00">' . htmlspecialchars($error, ENT_QUOTES, 'UTF-8') . '</div>';
            exit;
        }
        header('Content-Type: application/json');
        echo json_encode(array('status' => 'background'));
        exit;
    }

    /**
     * Launch includes/ConsoleCliRunner.php as a detached background process
     *
     * @param string $runId
     * @return string Error message, or blank on success
     */
    private function spawnConsoleCliRunner($runId) {
        if(!function_exists('proc_open')) return 'Running code via CLI needs PHP\'s proc_open() function, which is disabled on this server.';
        $php = static::getPhpCliPath();
        $logFile = $this->wire('config')->paths->cache . 'TracyDebugger/console_runs/' . $runId . '.log';
        $cmd = escapeshellarg($php) . ' ' . escapeshellarg(__DIR__ . '/includes/ConsoleCliRunner.php') . ' ' . escapeshellarg($runId) . ' ' . escapeshellarg($this->wire('config')->paths->root);
        /* & with HUP ignored (what nohup does - but nohup itself refuses to run without a console on macOS)
           detaches it from this request; setsid (where available) also moves it out of the web server's
           process group so it isn't killed along with the request */
        $setsid = @is_executable('/usr/bin/setsid') ? '/usr/bin/setsid ' : '';
        $cmd = "trap '' HUP; " . $setsid . $cmd . ' > /dev/null 2>> ' . escapeshellarg($logFile) . ' &';
        $process = @proc_open($cmd, array(0 => array('file', '/dev/null', 'r'), 1 => array('file', '/dev/null', 'w'), 2 => array('file', '/dev/null', 'w')), $pipes);
        if(!is_resource($process)) return 'Unable to start the CLI process (proc_open() failed).';
        proc_close($process); // returns as soon as the shell has backgrounded the runner
        return '';
    }

    /**
     * Path to the PHP CLI binary: the "PHP CLI path" setting, or the "php" binary alongside the running PHP
     *
     * @return string
     */
    public static function getPhpCliPath() {
        $path = (string) static::getDataValue('consolePhpCliPath');
        if($path !== '') return $path;
        // PHP_BINARY is the web SAPI (php-fpm, lsphp, etc) in a web request, so look for the CLI binary next to it
        foreach(array(PHP_BINDIR . '/php', dirname(PHP_BINARY) . '/php', '/usr/local/bin/php', '/usr/bin/php') as $candidate) {
            if(@is_file($candidate) && @is_executable($candidate)) return $candidate;
        }
        return 'php'; // rely on PATH
    }

    /**
     * Run a Console job started by startConsoleCliRun(). Called by includes/ConsoleCliRunner.php in the CLI process.
     *
     * @param string $runId
     */
    public function runConsoleCliJob($runId) {
        if(PHP_SAPI !== 'cli') return;
        $runId = preg_replace('/[^a-zA-Z0-9_.]/', '', (string) $runId);
        if($runId === '' || strpos($runId, '..') !== false) return;
        $jobFile = $this->wire('config')->paths->cache . 'TracyDebugger/console_runs/' . $runId . '.job.json';
        $job = is_file($jobFile) ? json_decode((string) file_get_contents($jobFile), true) : null;
        /* removing the job file tells the web request that started us that we're running; if it has already
           removed it itself (it gave up waiting, or the run was cancelled) don't run it */
        if(!is_array($job) || !@unlink($jobFile)) return;

        $user = $this->wire('users')->get((int) $job['userId']);
        if(!$user->id) return;
        $this->wire('users')->setCurrentUser($user);
        static::$allowedSuperuser = !empty($job['allowedSuperuser']);
        static::$validLocalUser = !empty($job['validLocalUser']);
        static::$validSwitchedUser = !empty($job['validSwitchedUser']);
        static::enableCliDumps();
        static::$consoleCliJob = $job;

        // recreate the request CodeProcessor.php expects
        $_POST = is_array($job['post']) ? $job['post'] : array();
        foreach($_POST as $key => $value) $this->wire('input')->post->$key = $value;
        foreach($job['cookies'] as $key => $value) {
            if($value !== '') $this->wire('input')->cookie->$key = $value;
        }
        require_once(__DIR__ . '/includes/CodeProcessor.php');
    }

    /**
     * bd() dumps recorded in a CLI process (see enableCliDumps()), rendered like the Dumps panel
     *
     * @return string
     */
    public static function getCliDumpsHtml() {
        if(empty(static::$dumpItems)) return '';
        $out = '';
        foreach(static::$dumpItems as $item) {
            if(isset($item['title']) && $item['title'] != '') $out .= '<h2>' . \Tracy\Helpers::escapeHtml($item['title']) . '</h2>';
            $out .= $item['dump'];
        }
        static::$dumpItems = array();
        return '<div class="tracy-inner" style="height:auto !important"><div class="tracy-DumpPanel"><p><strong>bd() dumps</strong></p>' . $out . '</div></div>';
    }

    /**
     * Is the background console run with this id still executing?
     * The worker holds LOCK_EX on its .pid file for the life of the request, so if
     * we can take a shared lock the process is gone and the run is dead. PHP-FPM
     * workers persist across requests, so checking the PID itself is unreliable.
     */
    private function consoleRunIsLive($runId) {
        $runId = preg_replace('/[^a-zA-Z0-9_.]/', '', (string) $runId);
        if($runId === '') return false;
        $pidFile = $this->wire('config')->paths->cache . 'TracyDebugger/console_runs/' . $runId . '.pid';
        if(!file_exists($pidFile)) return false;
        $fh = @fopen($pidFile, 'r');
        if(!$fh) return false;
        $live = !@flock($fh, LOCK_SH | LOCK_NB);
        if(!$live) @flock($fh, LOCK_UN);
        @fclose($fh);
        return $live;
    }

    /**
     * Hook before various
     *
     * Intercepts calls to defined hook and dumps result to Dumps Panel
     *
     * @param HookEvent $event
     *
     */
    // for the event interceptor panel
    protected function interceptEvent($event) {
        $eventItem = array();
        $eventItems = $this->wire('session')->tracyEventItems ? $this->wire('session')->tracyEventItems : array();
        $eventItem['timestamp'] = time();
        $options = array();
        $options[Dumper::COLLAPSE] = true;
        $options[Dumper::DEPTH] = isset($options['maxDepth']) ? $options['maxDepth'] : $this->data['maxDepth'];
        $options[Dumper::TRUNCATE] = isset($options['maxLength']) ? $options['maxLength'] : $this->data['maxLength'];
        if(defined('Tracy\Dumper::ITEMS')) {
            $options[Dumper::ITEMS] = isset($options['maxItems']) ? $options['maxItems'] : $this->data['maxItems'];
        }
        $eventItem['object'] = Dumper::toHtml($event->object, $options);
        $eventItem['arguments'] = Dumper::toHtml($event->arguments, $options);
        array_push($eventItems, $eventItem);
        $this->wire('session')->tracyEventItems = $eventItems;
        if($this->hookSettings['return'] == 'false') {
            $event->replace = true;
            $event->return = false;
        }
    }


    /**
     * Hook after Pages::added
     *
     * Record the id of all added pages for the Page Recorder Panel
     *
     * @param HookEvent $event
     *
     */
    // for the page recorder panel
    protected function recordPage($event) {
        $p = $event->arguments(0);
        if($p->is("has_parent=".$this->wire('config')->adminRootPageID)) return;

        $configData = $this->wire('modules')->getModuleConfigData("TracyDebugger");
        $configData['recordedPages'][] = $p->id;
        $this->wire('modules')->saveModuleConfigData($this, $configData);
    }


    /**
     * LOCAL HELPER FUNCTIONS
     */


    /**
     * Get file suffix
     *
     * @param string $path Full path to file
     * @return string $suffix File's suffix
     *
     */
    private function getFileSuffix($path) {
        $path = pathinfo($path, PATHINFO_FILENAME);
        return substr($path, strrpos($path, '-') + 1);
    }


    /**
     * Append suffix to file path
     *
     * @param string $path Full path to file
     * @return string $path Full path to file with new appended extension
     *
     */
    private function appendSuffixToFile($path, $suffix) {
        $templateExt = pathinfo($path, PATHINFO_EXTENSION);
        return str_replace('.'.$templateExt, '-'.$suffix.'.'.$templateExt, $path);
    }


    /**
     * Replace auto appended / prepended Template files (_main.php, _init.php etc) with "dev" versions
     *
     * @param string $suffix Suffix to add to filename
     *
     */
    private function replaceAutoAppendedPreprendedTemplateFiles($suffix) {
        // appendeded template file
        if($this->wire('config')->appendTemplateFile) {
            $devAppendedTemplateFilename = $this->appendSuffixToFile($this->wire('config')->appendTemplateFile, $suffix);
            if(file_exists($this->wire('config')->paths->templates . $devAppendedTemplateFilename)) $this->wire('config')->appendTemplateFile = $devAppendedTemplateFilename;
        }

        // prependeded template file
        if($this->wire('config')->prependTemplateFile) {
            $devPrependedTemplateFilename = $this->appendSuffixToFile($this->wire('config')->prependTemplateFile, $suffix);
            if(file_exists($this->wire('config')->paths->templates . $devPrependedTemplateFilename)) $this->wire('config')->prependTemplateFile = $devPrependedTemplateFilename;
        }
    }

    /**
     * Delete File
     *
     * Check if file exists before unlink
     *
     * @param string $path Full path to file
     *
     */
    private function deleteFile($path) {
        if(file_exists($path)) unlink($path);
    }


    /**
     * PHP code for a PDO connection to the PW database, for the standalone restore script.
     * Uses PW's DSN (port/socket) and the PDO driver options in $config->dbOptions, so it
     * connects the way PW does, including over SSL on servers that require secure transport.
     *
     * @return string
     *
     */
    private function getRestorePdoCode() {
        $config = $this->wire('config');
        if(method_exists('\ProcessWire\WireDatabasePDO', 'dsn')) {
            $dsn = WireDatabasePDO::dsn(array(
                'name' => $config->dbName,
                'host' => $config->dbHost,
                'port' => $config->dbPort,
                'socket' => $config->dbSocket,
            ));
        }
        else {
            $dsn = "mysql:host={$config->dbHost};dbname={$config->dbName}";
        }
        // driver options have integer keys; string keys are PW settings or (PW 3.0.273+) per-type sub-arrays
        $options = array();
        $dbOptions = is_array($config->dbOptions) ? $config->dbOptions : array();
        if(isset($dbOptions['mysql']) && is_array($dbOptions['mysql'])) $dbOptions = $dbOptions['mysql'] + $dbOptions;
        foreach($dbOptions as $key => $value) {
            if(is_int($key) && is_scalar($value)) $options[] = $key . ' => ' . var_export($value, true);
        }
        return 'new PDO(' . var_export($dsn, true) . ', ' . var_export((string) $config->dbUser, true) . ', ' .
            var_export((string) $config->dbPass, true) . ', array(' . implode(', ', $options) . '))';
    }


    /**
     * Minify
     *
     * Remove line breaks and unnecessary whitespace
     *
     * @param string $str String to minify
     *
     */
    public static function minify($str) {
        return preg_replace(array('#^\s*//.+$#m', '/\/\*.*?\*\//s', '/ {2,}/','/<!--.*?-->|\t|(?:\r?\n[ \t]*)+/s'),array('', '', ' ', ''), $str);
    }

    /**
     * AdminNeo driver for the PW database: 'mysql', 'pgsql' or 'sqlite'.
     * PW versions without database dialects are always MySQL.
     */
    public static function getAdminerDriver(): string {
        $database = wire('database');
        return method_exists($database, 'dialect') ? $database->dialect()->name() : 'mysql';
    }

    /**
     * Server string for the single server passed to AdminNeo in
     * panels/Adminer/adminneo-instance.php. Shared with getAdminerAuthQuery() so the
     * server key derived from it can never drift from the configured server.
     *
     * SQLite has no server. For PostgreSQL, $config->dbSocket is the socket directory,
     * which AdminNeo's host_port() passes on to libpq as host=<dir> port=<port>.
     */
    public static function getAdminerServer(): string {
        $config = wire('config');
        $driver = self::getAdminerDriver();
        if($driver === 'sqlite') return '';
        if($driver === 'pgsql' && $config->dbSocket) {
            return $config->dbSocket . ($config->dbPort ? ':' . $config->dbPort : '');
        }
        return $config->dbHost . ($config->dbPort ? ':' . $config->dbPort : '');
    }

    /**
     * Database AdminNeo opens: the database name, or for SQLite the absolute path of the database file.
     */
    public static function getAdminerDatabase(): string {
        $config = wire('config');
        if(self::getAdminerDriver() === 'sqlite') return WireDatabaseDialectSQLite::databaseFile($config);
        return (string) $config->dbName;
    }

    /**
     * Username AdminNeo logs in with (SQLite has none).
     */
    public static function getAdminerUsername(): string {
        return self::getAdminerDriver() === 'sqlite' ? '' : (string) wire('config')->dbUser;
    }

    /**
     * AdminNeo SSL settings taken from the MySQL SSL options in $config->dbOptions, so
     * AdminNeo can reach servers that require secure transport (e.g. AWS RDS with
     * require_secure_transport=ON) the same way PW does.
     */
    public static function getAdminerSslConfig(): array {
        $options = wire('config')->dbOptions;
        if(self::getAdminerDriver() !== 'mysql' || !is_array($options)) return [];
        $map = [
            'SSL_KEY' => 'sslKey',
            'SSL_CERT' => 'sslCertificate',
            'SSL_CA' => 'sslCaCertificate',
        ];
        $sslConfig = [];
        foreach($map as $attr => $key) {
            $attr = self::getPdoMysqlAttr($attr);
            if($attr !== null && !empty($options[$attr])) $sslConfig[$key] = $options[$attr];
        }
        $verifyAttr = self::getPdoMysqlAttr('SSL_VERIFY_SERVER_CERT');
        if($verifyAttr !== null && isset($options[$verifyAttr])) {
            $sslConfig['sslTrustServerCertificate'] = !$options[$verifyAttr];
        }
        return $sslConfig;
    }

    /**
     * Value of a PDO MySQL attribute constant, e.g. 'SSL_CA'. PHP 8.4 added Pdo\Mysql::ATTR_*
     * (same values) and 8.5 deprecates PDO::MYSQL_ATTR_*, so prefer the former.
     */
    private static function getPdoMysqlAttr(string $name): ?int {
        if(defined('\Pdo\Mysql::ATTR_' . $name)) return constant('\Pdo\Mysql::ATTR_' . $name);
        if(defined('\PDO::MYSQL_ATTR_' . $name)) return constant('\PDO::MYSQL_ATTR_' . $name);
        return null;
    }

    /**
     * Query string that logs AdminNeo straight into the configured PW database.
     *
     * Without these parameters AdminNeo's ExternalLoginPlugin answers with a 302 to its own
     * auth URL, so every panel open or Setup > Adminer visit costs two full PW admin requests
     * instead of one. Prepend this to any renderer URL that does not already carry them.
     *
     * The server key mirrors AdminNeo's default (Server::getKey() in the bundled adminneo.php:
     * first 8 hex chars of md5(driver . server)) so the URLs are identical to the ones AdminNeo
     * itself generates and anything stored in history or bookmarks keeps working. If a future
     * AdminNeo update changes that formula, the symptom is an "Invalid server or credentials"
     * login page on the first panel open.
     */
    public static function getAdminerAuthQuery(): string {
        $driver = self::getAdminerDriver();
        return $driver . '=' . substr(md5($driver . self::getAdminerServer()), 0, 8) .
            '&username=' . urlencode(self::getAdminerUsername()) .
            '&db=' . urlencode(self::getAdminerDatabase());
    }

    public static function getNonceAttr(): string {
        static $nonceAttr;
        if($nonceAttr === null) {
            // Tracy 2.10 exposes getNonceAttr() only; 2.7/2.9/2.12 expose getNonce().
            if(method_exists('\Tracy\Helpers', 'getNonceAttr')) {
                $nonceAttr = \Tracy\Helpers::getNonceAttr();
            } elseif(method_exists('\Tracy\Helpers', 'getNonce')) {
                $nonce = \Tracy\Helpers::getNonce();
                $nonceAttr = $nonce ? ' nonce="' . \Tracy\Helpers::escapeHtml($nonce) . '"' : '';
            } else {
                $nonceAttr = '';
            }
        }
        return $nonceAttr;
    }

    /**
     * JS for the bar bundle that adds the CSS of these <style> blocks to the page head in a
     * <style> with the bar script's nonce, so a CSP without 'unsafe-inline' doesn't block them.
     *
     */
    private static function barStylesJs($html): string {
        preg_match_all('#<style[^>]*>(.*?)</style>#s', (string) $html, $matches);
        $css = trim(implode("\n", $matches[1]));
        if($css === '') return '';
        return '(function(){var s = document.createElement("style"), n = document.currentScript && (document.currentScript.nonce || document.currentScript.getAttribute("nonce")); s.className = "tracy-debug"; if(n) s.setAttribute("nonce", n); s.textContent = ' . json_encode($css) . '; document.head.appendChild(s);})();' . "\n";
    }

    /**
     * Path of a cache file holding this bar JS, for Debugger::$customJsFiles (Tracy reads those
     * files when it builds the bar bundle), or null if it can't be written. Named by a hash of the
     * content, so requests that build different JS never overwrite each other's file. A file in use
     * is written again at most hourly, which keeps its mtime recent, so the clean-up of files more
     * than a day old only removes variants nothing has asked for since.
     *
     */
    private function barJsFile($js) {
        $file = $this->tracyCacheDir . 'bar-' . md5($js) . '.js';
        if(is_file($file) && filemtime($file) > time() - 3600) return $file;

        $tmpFile = $file . '.' . getmypid() . '.tmp';
        if(@file_put_contents($tmpFile, $js) === false || !@rename($tmpFile, $file)) {
            @unlink($tmpFile);
            if(is_file($file)) return $file;
            $this->wire('log')->error("TracyDebugger: unable to write the bar JS file $file");
            return null;
        }
        foreach(glob($this->tracyCacheDir . 'bar-*.js') ?: array() as $oldFile) {
            if($oldFile !== $file && filemtime($oldFile) < time() - 86400) @unlink($oldFile);
        }
        return $file;
    }

    public static function formatPageStatus($val, $status) {
        $isUnpublished = $status & \ProcessWire\Page::statusUnpublished;
        $isHidden = $status & \ProcessWire\Page::statusHidden;
        $isTrash = $status & \ProcessWire\Page::statusTrash;
        return '<span style="' . ($isUnpublished ? 'text-decoration: line-through; ' : '') . ($isHidden ? 'opacity: 0.5' : '') . '">' . $val . ($isTrash ? ' 🗑︎' : '') . '</span>';
    }


    /**
     * Superuser permission check
     *
     * Actually checks if a user really has the permission
     * This works for superusers as well whereas normally they return true for any permission
     *
     * @param string|int|User Maybe User name, object, or ID. Optional user to check
     * @param string $permission Permission name
     * @return bool
     *
     */
    /**
     * May the current user use Adminer? A superuser, and if "Restrict superusers" is on, one with the
     * tracy-debugger permission, like Tracy itself (worked out here rather than from $allowedSuperuser, because
     * init() can return before that's set)
     *
     * @return bool
     */
    public static function adminerAllowed() {
        if(!wire('user')->isSuperuser()) return false;
        return !static::getDataValue('restrictSuperusers') || self::userHasPermission('tracy-debugger');
    }

    private static function userHasPermission($permission) {
        foreach(wire('user')->roles as $role) {
            foreach($role->permissions as $perm) {
                if($perm->name == $permission) return true;
            }
        }
        return false;
    }


    /**
     * Are we in the Admin (or frontend)
     *
     * Checks based on URL, so it works before ready()
     *
     * @return bool
     *
     */
    private function inAdmin() {
        if(strpos(self::inputUrl(), $this->wire('config')->urls->admin) === 0 || ($this->wire('config')->ajax && strpos($this->httpReferer, $this->wire('config')->urls->admin) !== false)) {
            return true;
        }
        else {
            return false;
        }
    }


    /**
     * Find current page template name in cookie
     *
     * @param string $cookie Cookie content
     * @return string|bool Name of Template or false
     *
     */
    /**
     * Is $file one of the files the Template Path panel and Page Versions offer for $template: a file in the
     * templates folder with the template file extension, whose name contains the template's name, that isn't
     * another template's file or a File Editor test file (-tracytemp)?
     *
     * @param string $file basename
     * @param Template $template
     * @return bool
     */
    public static function isAlternativeTemplateFile($file, Template $template) {
        $config = wire('config');
        $file = (string) $file;
        if($file === '' || $file !== basename($file) || strpos($file, '\\') !== false || strpos($file, "\0") !== false) return false;
        if(strtolower(pathinfo($file, PATHINFO_EXTENSION)) !== strtolower((string) $config->templateExtension)) return false;
        if(strpos(pathinfo($file, PATHINFO_FILENAME), $template->name) === false || strpos($file, '-tracytemp') !== false) return false;
        foreach(wire('templates') as $t) {
            if($t->id != $template->id && pathinfo($t->filename, PATHINFO_BASENAME) === $file) return false;
        }
        return is_file($config->paths->templates . $file);
    }

    private function findPageTemplateInCookie($cookie) {
        if(!$cookie) return false;
        $templateName = $this->wire('page')->template->name;
        $templateEntries = explode(',', $cookie);
        foreach($templateEntries as $templateEntry) {
            $arr = explode("|", $templateEntry, 2);
            if($arr[0] == $templateName && isset($arr[1])) {
                // the value becomes the page's template file, so only accept what the Template Path panel and
                // Page Versions offer
                return static::isAlternativeTemplateFile($arr[1], $this->wire('page')->template) ? $arr[1] : false;
            }
        }
        return false;
    }


    /**
     * Determine if server type indicator should be shown
     *
     * @return bool
     *
     */
    private function showServerTypeIndicator() {
        if(
            count($this->data['styleWhere']) > 0 &&
            ((static::$inAdmin && in_array('backend', $this->data['styleWhere'])) ||
                (!static::$inAdmin && in_array('frontend', $this->data['styleWhere'])))
        ) {
            return true;
        }
        else {
            return false;
        }
    }


    /**
     * Determine server type and return styled color
     *
     * Local or Live based on IP address and dev or staging based on subdomain
     *
     * @return array
     *
     */
    private function getServerAdminStyles() {
        $serverTypeMatch = false;
        $stylesArr = array();

        foreach(explode("\n", $this->data['styleAdminColors']) as $serverType) {
            preg_match_all("/([^\|]+)\|([^\|]+)/", $serverType, $p);
            if(isset($p[1][0]) && isset($p[2][0])) $stylesArr[$p[1][0]] = $p[2][0];
        }

        foreach($stylesArr as $type => $color) {
            if(strpos($this->wire('config')->urls->httpRoot, str_replace('*', '', $type)) !== false) {
                $serverTypeMatch = true;
                break;
            }
        }

        if(!$serverTypeMatch && static::$isLocal) {
            $serverTypeMatch = true;
            $type = 'local';
        }

        return array(
            'serverTypeMatch' => $serverTypeMatch,
            'styles' => $stylesArr,
            'type' => $type
        );
    }


    /**
     * Set the favicon server type badge
     *
     * Local or Live based on IP address and dev or staging based on subdomain
     *
     * @return string Javacript code
     *
     */
    private function setFaviconBadge() {

        $serverTypeMatch = $this->serverStyleInfo['serverTypeMatch'];
        $stylesArr = $this->serverStyleInfo['styles'];
        $type = $this->serverStyleInfo['type'];

        if($serverTypeMatch && isset($stylesArr[$type])) {
            return '
                Tinycon.setOptions({
                    background: "'.$stylesArr[$type].'",
                    fallback: true
                });
                Tinycon.setBubble("'.substr(trim(strtoupper(str_replace('*', '', $type)), '.'), 0, 2).'");
            ';
        }
        else {
            return;
        }

    }


    /**
     * Output debug bar badge or custom (sidebar by default) server type indicator

     *
     * @return string style definition
     *
     */
    private function setServerAdminStyleColor() {

        $serverTypeMatch = $this->serverStyleInfo['serverTypeMatch'];
        $stylesArr = $this->serverStyleInfo['styles'];
        $type = $this->serverStyleInfo['type'];

        if($serverTypeMatch && isset($stylesArr[$type])) {
            $out = '';
            if(in_array('custom', $this->data['styleAdminType'])) {
                $out .= '
                    <style>
                        '. str_replace(array('[color]', '[type]'), array($stylesArr[$type], str_replace('*', '', $type)), $this->data['styleAdminElements']) . '
                    </style>
                ';
            }
            if(in_array('default', $this->data['styleAdminType'])) {
                $out .= '
                    <style>
                        #tracy-debug-logo::before {
                            content: "'.str_replace('*', '', $type).'";
                            background: '.$stylesArr[$type].';
                            color: #ffffff;
                            padding: 0 8px;
                            text-align: center;
                            font-family: sans-serif;
                            font-weight: 600;
                            text-transform: uppercase;
                            z-index: 999999;
                            font-size: 14px;
                            height: auto;
                            line-height: 22px;
                            display: inline-flex;
                            align-items: center;
                            vertical-align: middle;
                            pointer-events: none;
                        }
                    </style>
                ';
            }

            return $out;

        }
        else {
            return;
        }

    }

    /**
     * Insert console code at runtime into init, ready, or finished
     *
     * @param string $when | init, ready, or finished
     *
     */
    private function insertCode($when) {
        if((!static::$allowedSuperuser && !self::$validLocalUser && !self::$validSwitchedUser) ||
            $this->wire('config')->ajax ||
            $this->wire('input')->cookie->tracyCodeError ||
            !static::tokenCookie('tracyIncludeCode', 'tracyConsoleToken'))
                return;

        $options = json_decode(static::tokenCookie('tracyIncludeCode', 'tracyConsoleToken'), true);
        if(!is_array($options) || !isset($options['when']) || $options['when'] !== $when) return;

        // populate API variables, eg so $page equals $this->wire('page')
        $pwVars = $this->wire('all');
        foreach($pwVars->getArray() as $key => $value) {
            $$key = $value;
        }
        $page = $this->wire('pages')->get((int)$options['pid']);
        $consoleCodeFile = $this->tracyCacheDir . 'consoleCode.php';
        if(file_exists($consoleCodeFile)) {
            require_once($consoleCodeFile);
        }
        else {
            unset($_COOKIE['tracyIncludeCode']);
            $this->wire('input')->cookie->remove('tracyIncludeCode');
        }
    }


    /**
     * attach logRequests via hook
     *
     * @param HookEvent $event
     * @return void
     */
    public function logRequests(HookEvent $event) {

        if(static::isFieldRenderEvent($event)) return;

        $page = $event->object;

        // exits
        if(!isset($this->data['requestLoggerPages']) || !in_array($page->id, $this->data['requestLoggerPages'])) return;
        if(!in_array($_SERVER['REQUEST_METHOD'], $this->data['requestMethods'])) return;

        // log this request
        $data = $page->getRequestData();
        $data = json_decode(json_encode($data), true);
        if(!empty($data)) {
            // the log can be read by any Tracy user later, so don't store credentials from the logged
            // request (login passwords, session cookies, auth headers, tokens)
            $parsedInputBefore = isset($data['inputParsed']) ? $data['inputParsed'] : null;
            foreach(array('headers', 'post', 'get', 'inputParsed') as $key) {
                if(isset($data[$key]) && is_array($data[$key])) $data[$key] = static::hideSensitiveData($data[$key]);
            }
            foreach(array('url', 'httpUrl') as $key) {
                if(isset($data[$key])) $data[$key] = static::hideSensitiveUrlParams($data[$key]);
            }
            if(isset($data['headers']) && is_array($data['headers'])) {
                foreach($data['headers'] as $name => $value) {
                    if(strtolower((string) $name) === 'referer' && is_string($value)) $data['headers'][$name] = static::hideSensitiveUrlParams($value);
                }
            }
            if(isset($data['input']) && $data['input'] !== '') {
                if(is_array($data['inputParsed'])) {
                    // rewrite the raw body only if something was hidden, so it otherwise stays byte-for-byte as sent
                    if($data['inputParsed'] !== $parsedInputBefore) $data['input'] = json_encode($data['inputParsed'], JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
                }
                else {
                    parse_str($data['input'], $parsedInput);
                    if($parsedInput && static::hideSensitiveData($parsedInput) !== $parsedInput) {
                        $data['input'] = http_build_query(static::hideSensitiveData($parsedInput));
                    }
                }
            }
            $data['html'] = $event->return;
            $this->wire('cache')->save("tracyRequestLogger_id_{$data['id']}_page_{$page->id}", $data);

            // do the cleanup to limit entries to max logs setting
            $allData = $this->wire('cache')->get("tracyRequestLogger_id_*_page_{$page->id}");
            if(count($allData) > $this->data['requestLoggerMaxLogs']) {
                reset($allData);
                $this->wire('cache')->delete(key($allData));
            }
        }
    }

    /**
     * Does $key look like it holds a credential: does it contain pass, pwd, secret, token, cookie, session,
     * authorization, apikey / api_key or signature, is it auth, pw, key or sig, or is it in the "Keys to hide"
     * setting?
     *
     * @param string|int $key
     * @return bool
     */
    public static function isSensitiveKey($key) {
        static $keysToHide = null;
        if($keysToHide === null) $keysToHide = array_filter(array_map('strtolower', array_map('trim', explode(',', (string) static::getDataValue('keysToHide')))));
        $lowerKey = strtolower((string) $key);
        return in_array($lowerKey, $keysToHide, true)
            || in_array($lowerKey, array('auth', 'pw', 'key', 'sig'), true)
            || (bool) preg_match('/pass|pwd|secret|token|cookie|session|authorization|api[-_]?key|signature/', $lowerKey);
    }

    /**
     * $url with the values of credential-like query string parameters (see isSensitiveKey()) replaced
     *
     * @param string $url
     * @return string
     */
    public static function hideSensitiveUrlParams($url) {
        $url = (string) $url;
        $queryStart = strpos($url, '?');
        if($queryStart === false) return $url;
        $fragment = '';
        $hashPos = strpos($url, '#', $queryStart);
        if($hashPos !== false) {
            $fragment = substr($url, $hashPos);
            $url = substr($url, 0, $hashPos);
        }
        $pairs = explode('&', substr($url, $queryStart + 1));
        $changed = false;
        foreach($pairs as $i => $pair) {
            $name = urldecode(strstr($pair, '=', true) !== false ? strstr($pair, '=', true) : $pair);
            $name = preg_replace('/\[.*$/', '', $name);
            if($name !== '' && strpos($pair, '=') !== false && static::isSensitiveKey($name)) {
                $pairs[$i] = strstr($pair, '=', true) . '=*****';
                $changed = true;
            }
        }
        return $changed ? substr($url, 0, $queryStart + 1) . implode('&', $pairs) . $fragment : $url . $fragment;
    }

    /**
     * Copy of $data with the values of credential-like keys (see isSensitiveKey()) replaced, at any depth
     *
     * @param array $data
     * @return array
     */
    public static function hideSensitiveData(array $data) {
        foreach($data as $key => $value) {
            if(static::isSensitiveKey($key)) {
                $data[$key] = '*****';
            }
            elseif(is_array($value)) {
                $data[$key] = static::hideSensitiveData($value);
            }
        }
        return $data;
    }

    /**
     * get a standardized array or object of the current request
     *
     * @param HookEvent $event
     * @return void
     */
    public function getRequestData($event) {
        $page = $event->object;
        if(isset($event->arguments[0]) && $event->arguments[0] !== false) {
            // get all logged requests for $page
            if($event->arguments[0] === 'all') {
                $data = $this->_getRequestLoggerData($page->id, true);
            }
            // get logged request by ID
            elseif(!is_bool($event->arguments[0])) {
                $data = $this->_getRequestLoggerData($event->arguments[0]);
            }
            // get last logged request for $page
            elseif($event->arguments[0] === true) {
                $data = $this->_getRequestLoggerData($page->id);
            }

            // remove logged entries for PW 404 page if they don't have the same URL as current page
            if(!empty($data)) {
                foreach($data as $id => $datum) {
                    if($page->id === $this->wire('config')->http404PageID && !self::$inAdmin && $datum['httpUrl'] !== ($this->wire('config')->https ? "https" : "http") . "://".$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI']) {
                        unset($data[$id]);
                    }
                }
            }
        }
        // get current request for $page
        else {
            $input = file_get_contents('php://input');
            $data = array(
                'id' => uniqid(),
                'requestMethod' => $_SERVER['REQUEST_METHOD'],
                'remoteHost' => isset($_SERVER['REMOTE_HOST']) ? $_SERVER['REMOTE_HOST'] : null,
                'remoteAddress' => $_SERVER['REMOTE_ADDR'],
                'time' => time(),
                'url' => $this->wire('input')->url(true),
                // get url via server variables
                // the pw built in httpUrl method replaces the actual host with one of the hosts in $config
                'httpUrl' => ($this->wire('config')->https ? "https" : "http") . "://".$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI'],
                'page' => $page->id,
                'html' => null,
                'headers' => $this->getallheaders(),
                'post' => $_POST,
                'get' => $_GET,
                'input' => $input,
                'inputParsed' => self::isJson($input) ? json_decode($input, true) : null
            );
        }

        if(isset($event->arguments[1]) && $event->arguments[1] === true) {
            // intentionally blank - don't modify $data from being array
        }
        elseif($this->data['requestLoggerReturnType'] == 'object') {
            $data = json_decode(json_encode($data), false);
        }

        $event->return = $data;
    }


    public function addAdminerEditFieldLinks($event) {

        $inputfield = $event->object;
        $p = $inputfield->hasPage;

        if(!$p || !$p->id || $inputfield->type === 'hidden') {
            return;
        }

        $appendedMarkup = $inputfield->appendMarkup;

        if($f = $inputfield->hasField) {

            if(!is_object($f)) {
                return;
            }

            if(strpos($f->type, "FieldtypeFieldset") === 0 || strpos($f->type, "FieldtypeRuntime") === 0) {
                return;
            }

            $adminerIcon = '
            <svg xmlns="http://www.w3.org/2000/svg" viewBox="304.4 284.4 11.7 16" height="13px" width="10px">
                <path fill="#2C3D4F" d="M304.4 294.8v2.3c.3 1.3 2.7 2.3 5.8 2.3s5.7-1 5.9-2.3v-2.3c-1 .8-3.1 1.4-6 1.4-2.8 0-4.8-.6-5.7-1.4zM310.7 291.9h-1.2c-1.7-.1-3.1-.3-4-.7-.4-.2-.9-.4-1.1-.6v2.4c.7.8 2.9 1.5 5.8 1.5 3 0 5.1-.7 5.8-1.5v-2.4c-.3.2-.7.5-1.1.6-1.1.4-2.5.6-4.2.7zM310.1 285.6c-3.5 0-5.5 1.1-5.8 2.3v.7c.7.8 2.9 1.5 5.8 1.5s5.1-.7 5.8-1.5v-.6c-.3-1.3-2.3-2.4-5.8-2.4z"/>
            </svg>
            ';

            if(is_iterable($p->$f) && ((is_array($p->$f) && count($p->$f) > 1) || (!is_array($p->$f) && $p->$f->count > 1))) {
                $adminerQuery = 'select=field_'.$f->name.'&columns%5B0%5D%5Bfun%5D=&columns%5B0%5D%5Bcol%5D=&where%5B0%5D%5Bcol%5D=pages_id&where%5B0%5D%5Bop%5D=%3D&where%5B0%5D%5Bval%5D='.$p->id.'&where%5B01%5D%5Bcol%5D=&where%5B01%5D%5Bop%5D=%3D&where%5B01%5D%5Bval%5D=&order%5B0%5D';
            }
            else {
                $adminerQuery = 'edit=field_'.$f->name.'&where%5Bpages_id%5D='.$p->id;
            }

            $link = '';
            // don't add link again unless it's a repeater field
            if(strpos($appendedMarkup, 'adminer_EditFieldLink') === false || $inputfield instanceof InputfieldRepeater) {
                $link = '<div class="wrap_adminer_EditFieldLink" style="display: none"><a tabindex="-1" class="adminer_EditFieldLink" title="Edit '.($f->label ? $f->label : $f->name).' in Adminer (SHIFT+Click for full Adminer)" href="adminer://?'.$adminerQuery.'">'.$adminerIcon.'</a></div>';
            }

            $inputfield->appendMarkup = $inputfield->appendMarkup . $link;

        }
    }


    /**
     * get logged request data
     *
     * @param int $pid
     * @param bool $all
     * @return $data
     */
    private function _getRequestLoggerData($id, $all = false) {
        // $id is an integer, so it's a page ID
        if(is_int($id)) {
            $data = $this->wire('cache')->get("tracyRequestLogger_id_*_page_$id");
        }
        // it's a logged request ID
        else {
            $data = wire('cache')->get("tracyRequestLogger_id_$id*");

        }
        if(!empty($data)) {
            if(!$all) {
                $data = end($data);
            }
            return $data;
        }
        return array();
    }


    /**
     * get logged request data
     *
     * Use this instead of PHP's getallheaders() because it is not available with PHP-FPM and nginx
     * Even when it is available, the case of keys is inconsistent so use this modified from: https://github.com/ralouphie/getallheaders
     * as it standardizes the case of returned keys
     *
     * @return $headers
     */
    private function getallheaders() {
        $headers = array();
        $addHeaders = array('CONTENT_LENGTH', 'CONTENT_TYPE', 'CONTENT_MD5');
        $removeHeaders = array('HTTP_MOD_REWRITE');
        foreach($_SERVER as $name => $value) {
            if(!in_array($name, $removeHeaders) && (substr($name, 0, 5) == 'HTTP_' || in_array($name, $addHeaders))) {
                $name = str_replace(' ', '-', ucwords(strtolower(str_replace('_', ' ', str_replace('HTTP_', '', $name)))));
                $headers[$name] = $value;
            }
        }
        if (!isset($headers['Authorization'])) {
            if (isset($_SERVER['REDIRECT_HTTP_AUTHORIZATION'])) {
                $headers['Authorization'] = $_SERVER['REDIRECT_HTTP_AUTHORIZATION'];
            } elseif (isset($_SERVER['PHP_AUTH_USER'])) {
                $basic_pass = isset($_SERVER['PHP_AUTH_PW']) ? $_SERVER['PHP_AUTH_PW'] : '';
                $headers['Authorization'] = 'Basic ' . base64_encode($_SERVER['PHP_AUTH_USER'] . ':' . $basic_pass);
            } elseif (isset($_SERVER['PHP_AUTH_DIGEST'])) {
                $headers['Authorization'] = $_SERVER['PHP_AUTH_DIGEST'];
            }
        }
        return $headers;
    }


    /**
     * PUBLIC STATIC HELPER FUNCTIONS
     */

    public static function isAjax() {
        return isset($_SERVER['HTTP_X_TRACY_AJAX']) && preg_match('#^\w{10,15}$#D', $_SERVER['HTTP_X_TRACY_AJAX']);
    }


    /**
     * Validate a Tracy AJAX request's CSRF defense (Console, File Editor).
     *
     * Accepts the request if the submitted token still matches the session
     * token OR the request is verifiably same-origin. These tokens are baked
     * into the panel HTML at render time, so they go stale whenever the
     * session changes under an already-open tab (expiry, logout/login, user
     * switch) — the same-origin fallback keeps the panel working in those
     * cases without weakening CSRF protection on any request that carries an
     * Origin or Referer header.
     *
     * @param string $sessionToken Token stored in the session
     * @param string $csrfToken Token submitted with the request
     * @return boolean
     */
    public static function validTracyRequest($sessionToken, $csrfToken) {
        if($csrfToken !== '' && hash_equals((string)$sessionToken, (string)$csrfToken)) {
            return true;
        }
        return self::sameOriginRequest();
    }


    /**
     * Is this GET action request (see actionUrl()) from TracyDebugger's own link: does it carry the session's
     * action token? Only before the session has a token (the first page after login, whose links were rendered
     * without one) does a same-origin request count instead, because same-site content (an <img> in a page
     * body, say) also sends a same-origin Referer
     *
     * @return boolean
     */
    public static function validActionRequest() {
        $sessionToken = (string) wire('session')->tracyActionToken;
        if($sessionToken !== '') return hash_equals($sessionToken, (string) wire('input')->get->tracyToken);
        return self::sameOriginRequest();
    }

    /**
     * HTML-escaped URL of the current page with $param=1 and the action token added, for links that trigger an
     * action with a GET request (checked with validActionRequest())
     *
     * @param string $param
     * @return string
     */
    public static function actionUrl($param) {
        $url = self::urlWithoutActionToken(self::inputUrl(true));
        $url .= (strpos($url, '?') !== false ? '&' : '?') . $param . '=1';
        $token = (string) wire('session')->tracyActionToken;
        if($token !== '') $url .= '&tracyToken=' . $token;
        return htmlspecialchars($url, ENT_QUOTES, 'UTF-8');
    }

    /**
     * Put an .htaccess denying all web access in $dir (if it doesn't have one): for folders under site/ that hold
     * files the web server would otherwise serve as-is, like Console snippets saved without a .php extension
     *
     * @param string $dir
     */
    public static function denyWebAccess($dir) {
        $htaccess = rtrim($dir, '/\\') . '/.htaccess';
        if(is_file($htaccess) || !is_dir($dir)) return;
        @file_put_contents($htaccess, "# TracyDebugger: not for the web\n<IfModule mod_authz_core.c>\n    Require all denied\n</IfModule>\n<IfModule !mod_authz_core.c>\n    Order allow,deny\n    Deny from all\n</IfModule>\n");
    }

    /**
     * Key that the generated restoremodules.php requires (?key=), shown in the Module Disabler panel's
     * instructions. It doesn't depend on the backup, so the key shown before any module is disabled is still the
     * one that works once the backup exists. Derived with the site's secret userAuthSalt, or, if a site has none,
     * a random secret kept in TracyDebugger's cache folder, so it can't be guessed
     *
     * @return string
     */
    public static function restoreModulesKey() {
        $cachePath = wire('config')->paths->cache . 'TracyDebugger/';
        $secret = (string) wire('config')->userAuthSalt;
        if($secret === '') {
            $secretFile = $cachePath . '.restoremodules-secret';
            if(!is_file($secretFile)) @file_put_contents($secretFile, bin2hex(random_bytes(32)), LOCK_EX);
            $secret = (string) @file_get_contents($secretFile);
        }
        return substr(hash_hmac('sha256', $cachePath . 'restoremodules.php', $secret), 0, 24);
    }

    /**
     * Value of a cookie that TracyDebugger's panel JS writes as "<token>|<value>", where <token> is one of the
     * session's Tracy tokens, or null if the prefix doesn't match. Used for cookies that change what the server
     * does (send all mail to an address, run the last Console code, intercept a hook): a cookie can also be set
     * by another subdomain of the site ("cookie tossing"), which can't know the token
     *
     * @param string $name
     * @param string $tokenName session variable holding the token
     * @return string|null
     */
    public static function tokenCookie($name, $tokenName = 'tracyActionToken') {
        $value = isset($_COOKIE[$name]) ? (string) $_COOKIE[$name] : '';
        $token = (string) wire('session')->$tokenName;
        $separator = strpos($value, '|');
        if($token === '' || $separator === false || !hash_equals($token, substr($value, 0, $separator))) return null;
        return substr($value, $separator + 1);
    }

    /**
     * The Dumps Recorder's entries (dumps.json, shared by all users) that the current user may see: superusers
     * (and local / switched users) see all; other Tracy users their own and guests' dumps
     *
     * @param mixed $entries
     * @return array
     */
    public static function visibleRecordedDumps($entries) {
        if(!is_array($entries)) return array();
        if(static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser) return $entries;
        $userName = wire('user')->name;
        return array_values(array_filter($entries, function($entry) use ($userName) {
            $entryUser = is_array($entry) && isset($entry['user']) ? (string) $entry['user'] : '';
            return $entryUser === $userName || $entryUser === 'guest';
        }));
    }

    public static function urlWithoutActionToken($url) {
        return preg_replace(array('/([?&])tracyToken=[^&#]*&/', '/[?&]tracyToken=[^&#]*/'), array('$1', ''), (string) $url);
    }

    /**
     * Is the current request verifiably same-origin?
     *
     * Returns true only when an Origin or Referer header is present and its
     * host (including any non-standard port) matches $config->httpHost.
     * Returns false when neither header is present — so the caller falls back
     * to token validation — and when the host does not match.
     *
     * @return boolean
     */
    public static function sameOriginRequest() {
        $expectedHost = strtolower((string)wire('config')->httpHost);
        if($expectedHost === '') return false;

        foreach(array('HTTP_ORIGIN', 'HTTP_REFERER') as $header) {
            if(empty($_SERVER[$header])) continue;
            $host = parse_url($_SERVER[$header], PHP_URL_HOST);
            if(!$host) return false;
            $port = parse_url($_SERVER[$header], PHP_URL_PORT);
            return strtolower($host . ($port ? ':' . $port : '')) === $expectedHost;
        }
        return false;
    }

    /**
     * is the provided string a valid json string?
     *
     * @param string $string
     * @return boolean
     */
    public static function isJson($string) {
        json_decode($string);
        return (json_last_error() == JSON_ERROR_NONE);
    }


    /**
     * Remove ProcessWire variables from get_defined_vars() call
     *
     * @param array $vars Variables
     * @return array Variables with PW vars removed
     *
     */
    public static function templateVars($vars) {

        $pwVars = array('fuel','options');
        foreach(wire('fuel') as $key => $value) {
            if(!is_object($value)) continue;
            $pwVars[] = $key;
        }

        $nonPwVars = $vars;
        foreach($vars as $key => $var) {
            if(is_object($var) || is_array($var)) {
                if(in_array($key, $pwVars)) unset($nonPwVars[$key]);
            }
        }

        unset($nonPwVars['templateVars']);
        unset($nonPwVars['pwVars']);
        unset($nonPwVars['key']);
        unset($nonPwVars['value']);
        unset($nonPwVars['p']);
        unset($nonPwVars['ps']);
        unset($nonPwVars['_filename']);
        unset($nonPwVars['functions']);

        return $nonPwVars;

    }


    /**
     * Format human friendly file size and color based on thresholds
     *
     * @param string $bytes File size in bytes
     * @return string Formatted size with units and colored font
     *
     */
    public static function human_filesize($bytes, $color = true) {
        if($color === true) {
            if($bytes >= 500000) {
                $color = self::COLOR_ALERT;
            }
            elseif($bytes < 500000 && $bytes > 100000) {
                $color = self::COLOR_WARN;
            }
            else {
                $color = self::COLOR_LIGHTGREY;
            }
        }
        else {
            $color = self::COLOR_LIGHTGREY;
        }

        if($bytes == 0) {
            return('<span style="color:'.self::COLOR_LIGHTGREY.'">0 Bytes</span>');
        }
        else {
            $filesizename = array("&nbsp;Bytes", "&nbsp;KB", "&nbsp;MB", "&nbsp;GB", "&nbsp;TB", "&nbsp;PB", "&nbsp;EB", "&nbsp;ZB", "&nbsp;YB");
            return '<span style="color:'.$color.'">' . round($bytes/pow(1024, ($i = floor(log($bytes, 1024)))), 1) . $filesizename[$i] . '</span>';
        }
    }


    /**
     * Format human friendly time and color based on thresholds
     *
     * @param string $seconds Time in seconds
     * @return string Formatted time in milliseconds with units and colored font
     *
     */
    public static function formatTime($seconds, $color = true) {
        if($color === true) {
            if($seconds >= 1) {
                $color = self::COLOR_ALERT;
            }
            elseif($seconds < 1 && $seconds > 0.1) {
                $color = self::COLOR_WARN;
            }
            else {
                $color = self::COLOR_LIGHTGREY;
            }
        }
        else {
            $color = self::COLOR_LIGHTGREY;
        }

        return '<span style="color:'.$color.'">'.round(($seconds*1000), 2) . ' ms</span>';
    }


    /**
    *
    * Replace all backslashes with forward slashes
    *
    * @param string $path
    * @return string
    *
    */
    public static function forwardSlashPath($path) {
        if(DIRECTORY_SEPARATOR != '/') $path = str_replace(DIRECTORY_SEPARATOR, '/', $path);
        return $path;
    }


    /**
     * Strip the site root path from an absolute path.
     *
     * @param string $path The absolute file path
     * @param string $prefix What to replace the root with (default '/')
     * @return string
     */
    public static function stripRootPath($path, $prefix = '/') {
        $root = wire('config')->paths->root;
        $path = str_replace('\\', '/', (string) $path);
        if(DIRECTORY_SEPARATOR === '\\') {
            return preg_replace('#^' . preg_quote($root, '#') . '#i', $prefix, $path);
        }
        return str_replace($root, $prefix, $path);
    }


    /**
     * Insert generated time and size for a panel
     *
     * @param string $panel Panel name
     * @param $seconds Time in seconds
     * @param $bytes Size in bytes
     * @return string Formatted panel dom size and generation time with units and colored font
     *
     */
    public static function generateTimeSize($panel, $seconds, $bytes) {
        self::$panelGenerationTime[$panel]['time'] = $seconds;
        self::$panelGenerationTime[$panel]['size'] = $bytes;
        return '<span class="tracy-time-size">'.static::formatTime($seconds).'<span style="color: '.self::COLOR_NORMAL.';">,</span> '.static::human_filesize($bytes).'</span>';
    }


    /**
     * Insert link to panel's module settings section
     *
     * @param string $hashLink Hash link to panel
     * @return string Formatted link to panel settings
     *
     */
    public static function generatePanelSettingsLink($hashLink) {
        return '
        <span class="tracy-panel-settings-link">
            <a title="Panel Settings" href="'.wire('config')->urls->admin.'module/edit?name=TracyDebugger#'.$hashLink.'">
                <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" x="0px" y="0px" width="16px" height="16px" viewBox="0 0 369.793 369.792" style="enable-background:new 0 0 369.793 369.792;" xml:space="preserve">
                    <path d="M320.83,140.434l-1.759-0.627l-6.87-16.399l0.745-1.685c20.812-47.201,19.377-48.609,15.925-52.031L301.11,42.61     c-1.135-1.126-3.128-1.918-4.846-1.918c-1.562,0-6.293,0-47.294,18.57L247.326,60l-16.916-6.812l-0.679-1.684     C210.45,3.762,208.475,3.762,203.677,3.762h-39.205c-4.78,0-6.957,0-24.836,47.825l-0.673,1.741l-16.828,6.86l-1.609-0.669     C92.774,47.819,76.57,41.886,72.346,41.886c-1.714,0-3.714,0.769-4.854,1.892l-27.787,27.16     c-3.525,3.477-4.987,4.933,16.915,51.149l0.805,1.714l-6.881,16.381l-1.684,0.651C0,159.715,0,161.556,0,166.474v38.418     c0,4.931,0,6.979,48.957,24.524l1.75,0.618l6.882,16.333l-0.739,1.669c-20.812,47.223-19.492,48.501-15.949,52.025L68.62,327.18     c1.162,1.117,3.173,1.915,4.888,1.915c1.552,0,6.272,0,47.3-18.561l1.643-0.769l16.927,6.846l0.658,1.693     c19.293,47.726,21.275,47.726,26.076,47.726h39.217c4.924,0,6.966,0,24.859-47.857l0.667-1.742l16.855-6.814l1.604,0.654     c27.729,11.733,43.925,17.654,48.122,17.654c1.699,0,3.717-0.745,4.876-1.893l27.832-27.219     c3.501-3.495,4.96-4.924-16.981-51.096l-0.816-1.734l6.869-16.31l1.64-0.643c48.938-18.981,48.938-20.831,48.938-25.755v-38.395     C369.793,159.95,369.793,157.914,320.83,140.434z M184.896,247.203c-35.038,0-63.542-27.959-63.542-62.3     c0-34.342,28.505-62.264,63.542-62.264c35.023,0,63.522,27.928,63.522,62.264C248.419,219.238,219.92,247.203,184.896,247.203z" fill="'.self::COLOR_LIGHTGREY.'"/>
                </svg>
            </a>
        </span>';
    }


    /**
     * Generate Panel footer
     *
     * @param string $panel Panel name
     * @param $seconds Time in seconds
     * @param $bytes Size in bytes
     * @param string $settingsHashLink Hash link to panel
     * @return string Formatted footer
     *
     */
    public static function generatePanelFooter($panel, $seconds, $bytes, $settingsHashLink = null) {
        $out = '<div class="tracy-panel-footer">';
        if($settingsHashLink) $out .= self::generatePanelSettingsLink($settingsHashLink);
        $out .= self::generateTimeSize($panel, $seconds, $bytes);
        $out .= '</div>';
        return $out;
    }

    /**
     * Create editor path
     *
     * Adjust to consider localRootPath and onlineEditor settings
     *
     * @param string $path Full path to remote version of file
     * @return string Full path to local version of file
     *
     */
    public static function createEditorLink($file, $line, $linkText, $title = null) {
        if(strpos($file, '..') !== false) return;
        $file = str_replace("%file", $file, str_replace("%line", $line, Debugger::$editor));
        $file = static::forwardSlashPath($file);
        if(static::$useOnlineEditor) $file = str_replace(static::$onlineFileEditorDirPath, '', $file);
        elseif(self::getDataValue('localRootPath') != '') $file = str_replace(wire('config')->paths->root, self::getDataValue('localRootPath'), $file);
        // $linkText is HTML (callers pass icons); the title and URL are escaped
        return '<a '.($title ? 'title="'.htmlspecialchars((string) $title, ENT_QUOTES, 'UTF-8').'"' : '').' href="'.htmlspecialchars((string) $file, ENT_QUOTES, 'UTF-8').'">'.$linkText.'</a>';
    }


    public static function removeCompilerFromPath($path) {
        $compilerCachePath = isset(wire('config')->fileCompilerOptions['cachePath']) && wire('config')->fileCompilerOptions['cachePath'] != '' ? wire('config')->fileCompilerOptions['cachePath'] : wire('config')->paths->cache . 'FileCompiler/';
        return str_replace($compilerCachePath, wire('config')->paths->root, $path);
    }


    /**
     * Getter function to get a $data index value from module settings
     *
     * @param string $property Property name
     * @return mixed Value of property
     *
     */
    /**
     * URL of one of TracyDebugger's own CSS or JS files, versioned so browsers and CDNs fetch an update's copy:
     * ?v=<module version>, or with versionAssetFilenames on, the file's modification time in its name
     * (console-panel.1792537113.js), which a rewrite rule in the site's .htaccess maps back to the file
     *
     * @param string $file path relative to the module's folder, eg. scripts/console-panel.js
     * @return string
     */
    public static function assetUrl($file) {
        $url = wire('config')->urls->TracyDebugger . $file;
        $path = wire('config')->paths->TracyDebugger . $file;
        if(static::getDataValue('versionAssetFilenames') && is_file($path)) {
            return preg_replace('/\.(css|js)$/', '.' . filemtime($path) . '.$1', $url);
        }
        return $url . '?v=' . static::getModuleInfo()['version'];
    }

    public static function getDataValue($property) {
        if(!is_string(self::$_data->$property) || is_array(self::$_data->$property) || is_int(self::$_data->$property) || $property == 'consoleCodePrefix') {
            return self::$_data->$property;
        }
        else {
            return trim(self::$_data->$property ?? '');
        }
    }


    /**
     * Get the list of user page ids a UserSwitcher session is permitted to switch to,
     * applying the configured userSwitcherSelector / userSwitcherRestricted / userSwitcherIncluded
     * filters. Used by both the panel (to render the dropdown) and the post-processor
     * (to validate the destination of a switch POST).
     *
     * @return array list of user page ids (ints)
     */
    public static function getSwitcherSelectableUsers() {
        $wire = wire();
        $ids = array();

        if(method_exists($wire->pages, 'findRaw')) {
            // include 'roles' so we can filter out users who have only the auto-applied
            // guest role (i.e. no real assigned role) — matches the panel's dropdown filter
            $findRawFields = ['id', 'roles'];
            $findRawSelector = 'templates_id=' . implode('|', $wire->config->userTemplateIDs)
                . ', has_parent=' . implode('|', $wire->config->usersPageIDs)
                . ', objects=0, nulls=0, sort=name, check_access=0, status<' . Page::statusUnpublished;

            if(self::getDataValue('userSwitcherSelector')) {
                $rows = $wire->pages->findRaw($findRawSelector . ', ' . self::getDataValue('userSwitcherSelector'), $findRawFields);
            }
            elseif(self::getDataValue('userSwitcherRestricted') && count(self::getDataValue('userSwitcherRestricted')) > 0) {
                $rows = $wire->pages->findRaw($findRawSelector . ', roles!=' . implode(', roles!=', self::getDataValue('userSwitcherRestricted')), $findRawFields);
            }
            elseif(self::getDataValue('userSwitcherIncluded') && count(self::getDataValue('userSwitcherIncluded')) > 0) {
                $rows = $wire->pages->findRaw($findRawSelector . ', roles=' . implode('|', self::getDataValue('userSwitcherIncluded')), $findRawFields);
            }
            else {
                $rows = $wire->pages->findRaw($findRawSelector, $findRawFields);
            }
            foreach($rows as $row) {
                if(!is_array($row) || !isset($row['id'])) continue;
                $roles = isset($row['roles']) && is_array($row['roles']) ? $row['roles'] : [];
                if(count($roles) > 1) $ids[] = (int) $row['id'];
            }
        }
        else {
            if(self::getDataValue('userSwitcherSelector')) {
                $users = $wire->users->find(self::getDataValue('userSwitcherSelector'));
            }
            elseif(self::getDataValue('userSwitcherRestricted') && count(self::getDataValue('userSwitcherRestricted')) > 0) {
                $users = $wire->users->find('roles!=' . implode(', roles!=', self::getDataValue('userSwitcherRestricted')));
            }
            elseif(self::getDataValue('userSwitcherIncluded') && count(self::getDataValue('userSwitcherIncluded')) > 0) {
                $users = $wire->users->find('roles=' . implode('|', self::getDataValue('userSwitcherIncluded')));
            }
            else {
                $users = $wire->users->find('');
            }
            $users = $users->sort('name');
            foreach($users as $u) {
                if($u->roles && count($u->roles) > 1) $ids[] = (int) $u->id;
            }
        }

        return $ids;
    }


    /**
     * Is the current debug bar standard or one of the additional (AJAX, redirect) ones
     *
     * Determine if Tracy is loading an additional panel - via AJAX, or a redirect panel
     * In this case we don't want to add most of our custom panels to the new bar because they don't change
     *
     * @return bool
     *
     */
    public static function isAdditionalBar() {
        $isRedirect = preg_match('#^Location:#im', implode("\n", headers_list()));
        if(static::isAjax() || $isRedirect) {
            return static::isAjax() ? 'ajax' : 'redirect';
        }
        else {
            return false;
        }
    }

    /**
     * Check IP Address again allowed address / pattern
     *
     * @return array Single key/value with module settings defined IP address and whether the user's address is allowed
     *
     */
    public static function checkIpAddress() {

        $ipAddress = static::getDataValue('ipAddress');
        $ipAddressAllowed = null;

        if($ipAddress != '') {
            if(strpos($ipAddress, '/') === 0) $ipAddressAllowed = (bool) @preg_match($ipAddress, $_SERVER['REMOTE_ADDR']); // regex IPs
                else $ipAddressAllowed = $ipAddress === $_SERVER['REMOTE_ADDR']; // exact IP match
        }
        return array('ipAddress' => $ipAddress, 'ipAddressAllowed' => $ipAddressAllowed);
    }


    /**
     * Is User allowed and what access do they have
     *
     * This considers the Tracy output mode, the user's "tracy-debugger" permissions,
     * superuser status, and IP address if relevant
     *
     * @return string|bool String is 'development' or 'production'. Bool is only for false
     *
     */
    /**
     * Does this request match the browser fingerprint recorded when the User Switcher session started? Checked
     * where development access is granted to a switched user, so a copied session cookie doesn't carry it to
     * another browser or network; on a mismatch the switcher session is ended. Like UserSwitcherPost.php, this
     * follows $config->sessionFingerprint (with it off, both sides are empty and match)
     *
     * @return bool
     */
    protected static function userSwitcherFingerprintOk() {
        $session = wire('session');
        if(!method_exists($session, 'getFingerprint')) return true;
        $storedFp = $session->tracyUserSwitcherFp;
        if($storedFp !== null && hash_equals((string) $storedFp, (string) $session->getFingerprint())) return true;
        $session->remove('tracyUserSwitcherId');
        $session->remove('tracyUserSwitcherFp');
        return false;
    }

    /**
     * Capture dumps in a CLI process that is doing work for a user whose web request had Tracy development
     * access (eg. an AdminActions action run via CLI so it isn't cut off by a host's request time limit).
     *
     * After calling this, bd()/bdb() calls are recorded in TracyDebugger::$dumpItems (each with 'title' and
     * 'dump' HTML) and d()/db() output HTML instead of plain text, so the caller can return them to the browser.
     * The caller is responsible for only calling this when the user it is acting for is allowed to see dumps.
     *
     * @return bool False if not running under CLI or Tracy isn't enabled
     */
    public static function enableCliDumps() {
        if(PHP_SAPI !== 'cli' || !static::getDataValue('enabled') || !class_exists('\Tracy\Debugger')) return false;
        static::$allowedTracyUser = 'development';
        static::$cliHtmlDumps = true;
        return true;
    }

    public static function allowedTracyUser() {

        $outputMode = static::getDataValue('outputMode');
        if($outputMode == 'detect') {
            $outputMode = static::$isLocal ? 'development' : 'production';
        }

        if(static::getDataValue('userSwitchSession') !== null) $userSwitchSession = static::getDataValue('userSwitchSession');

        if(static::$allowedSuperuser && static::getDataValue('superuserForceDevelopment') == 1 ||
            (static::$isLocal && static::getDataValue('guestForceDevelopmentLocal') == 1)) {
                self::$validLocalUser = true;
                return 'development';
        }
        elseif(wire('session')->tracyUserSwitcherId && (isset($userSwitchSession[wire('session')->tracyUserSwitcherId]) && $userSwitchSession[wire('session')->tracyUserSwitcherId] > time()) && static::userSwitcherFingerprintOk()) {
            self::$validSwitchedUser = true;
            return 'development';
        }
        elseif($outputMode == 'production') {
            return 'production';
        }
        else {
            $checkIpAddress = static::checkIpAddress();
            if($checkIpAddress['ipAddress'] != '' && self::userHasPermission('tracy-debugger')) {
                return $checkIpAddress['ipAddressAllowed'] ? 'development' : false;
            }
            elseif(self::userHasPermission('tracy-debugger') || static::$allowedSuperuser) {
                if(static::$isLocal) self::$validLocalUser = true;
                return 'development';
            }
            else {
                return false;
            }
        }
    }


    /**
     * Detects if local by IP address.
     * @param  string|array  IP addresses or computer names whitelist detection
     * @return bool
     */
    public static function isLocal($list = null) {

        if(static::getDataValue('forceIsLocal')) {
            return static::getDataValue('forceIsLocal');
        }
        else {
            return Debugger::detectDebugMode($list = null);
        }
    }


    /*
    * This is a replacement for the url method from WireInput
    * There is this issue (https://github.com/processwire/processwire/pull/46)
    * but also the problem that $input->queryString() fails in init() because WireInput's $getVars isn't populated yet
    *
    * @param  bool Return with queryString or not
    * @return string URL of page with or without query string
    *
    */
    public static function inputUrl($withQueryString = false) {

        $url = '';
        /** @var Page $page */
        $page = wire('page');
        $config = wire('config');
        $sanitizer = wire('sanitizer');
        $input = wire('input');

        $info = isset($_SERVER['REQUEST_URI']) ? parse_url($_SERVER['REQUEST_URI']) : null;

        if($page && $page->id) {
            // pull URL from page
            $url = $page->url();
            $segmentStr = $input->urlSegmentStr();
            $pageNum = $input->pageNum();
            if(strlen($segmentStr) || $pageNum > 1) {
                if($segmentStr) $url = rtrim($url, '/') . '/' . $segmentStr;
                if($pageNum > 1) $url = rtrim($url, '/') . '/' . $config->pageNumUrlPrefix . $pageNum;
                if($info !== null) {
                    if(isset($info['path']) && !empty($info['path']) && substr($info['path'], -1) == '/') $url .= '/'; // trailing slash
                }
                if($pageNum > 1) {
                    if($page->template->slashPageNum == 1) {
                        if(substr($url, -1) != '/') $url .= '/';
                    } else if($page->template->slashPageNum == -1) {
                        if(substr($url, -1) == '/') $url = rtrim($url, '/');
                    }
                } else if(strlen($segmentStr)) {
                    if($page->template->slashUrlSegments == 1) {
                        if(substr($url, -1) != '/') $url .= '/';
                    } else if($page->template->slashUrlSegments == -1) {
                        if(substr($url, -1) == '/') $url = rtrim($url, '/');
                    }
                }
            }

        } else if($info !== null) {
            // page not yet available, attempt to pull URL from request uri
            if(isset($info['path'])) {
                $parts = explode('/', $info['path']);
                $charset = $config->pageNameCharset;
                $i = 0;
                foreach($parts as $i => $part) {
                    if($i > 0) $url .= "/";
                    $url .= ($charset === 'UTF8' ? $sanitizer->pageNameUTF8($part) : $sanitizer->pageName($part, false));
                }
            }
            if(isset($info['path']) && !empty($info['path']) && substr($info['path'], -1) == '/') {
                $url = rtrim($url, '/') . '/'; // trailing slash
            }
        }

        if($withQueryString && $info !== null) {
            $queryString = isset($info['query']) ? $info['query'] : '';

            if(strlen($queryString)) {
                $url .= "?$queryString";
            }
        }

        return $url;
    }

    /*
    * This is a replacement for the httpUrl method from WireInput
    */
    public static function inputHttpUrl($withQueryString = false) {
        return wire('input')->scheme() . '://' . wire('config')->httpHost . self::inputUrl($withQueryString);
    }


    public static function tailCustom($filepath, $lines = 1, $adaptive = true) {

        // Open file
        $f = @fopen($filepath, "rb");
        if ($f === false) return false;

        // Sets buffer size, according to the number of lines to retrieve.
        // This gives a performance boost when reading a few lines from the file.
        if (!$adaptive) $buffer = 4096;
        else $buffer = ($lines < 2 ? 64 : ($lines < 10 ? 512 : 4096));

        // Jump to last character
        fseek($f, -1, SEEK_END);

        // Read it and adjust line number if necessary
        // (Otherwise the result would be wrong if file doesn't end with a blank line)
        if (fread($f, 1) != "\n") $lines -= 1;

        // Start reading
        $output = '';
        $chunk = '';

        // While we would like more
        while (ftell($f) > 0 && $lines >= 0) {

            // Figure out how far back we should jump
            $seek = min(ftell($f), $buffer);

            // Do the jump (backwards, relative to where we are)
            fseek($f, -$seek, SEEK_CUR);

            // Read a chunk and prepend it to our output
            $output = ($chunk = fread($f, $seek)) . $output;

            // Jump back to where we started reading
            fseek($f, -mb_strlen($chunk, '8bit'), SEEK_CUR);

            // Decrease our line counter
            $lines -= substr_count($chunk, "\n");

        }

        // While we have too many lines
        // (Because of buffer size we might have read too many)
        while ($lines++ < 0) {

            // Find first newline and remove all text before that
            $output = substr($output, strpos($output, "\n") + 1);

        }

        // Close file and return
        fclose($f);
        return trim($output);

    }


    /**
     * Get API data by type
     *
     * @param string type: variables | core | coreModules | siteModules | hooks
     * @return array api data
     *
     */
    public static function getApiData($type) {
        if(!isset(self::$allApiData[$type])) {
            require_once __DIR__ . '/includes/PwApiData.php';
            $tracyPwApiData = new TracyPwApiData();
            self::$allApiData[$type] = $tracyPwApiData->getApiData($type);
        }
        return self::$allApiData[$type];
    }


    /**
     * Build the site-wide part of the Console panel's autocomplete list: API variables with
     * their methods/properties, plus procedural functions.
     *
     * Served by the tracyAutocomplete endpoint rather than inlined into the Console panel,
     * because with descriptions enabled this is ~200KB of JSON that was previously added to
     * every page load whether or not the console was ever opened. Only the page-specific
     * entries (the current page's fields) stay inline in the panel.
     *
     * @return array
     */
    public static function getConsoleApiAutocomplete() {
        $showDescription = self::getDataValue('codeShowDescription');
        $items = array();

        foreach(self::getApiData('variables') as $key => $vars) {
            $apiVar = wire($key);
            foreach($vars as $name => $params) {
                $item = array();
                if(strpos($name, '()') !== false) {
                    $item['name'] = '$' . $key . '->' . str_replace('___', '', $name)
                        . ($apiVar && method_exists($apiVar, $name) ? '()' : '');
                    $item['meta'] = 'PW method';
                }
                else {
                    $item['name'] = '$' . $key . '->' . str_replace('___', '', $name);
                    $item['meta'] = 'PW property';
                }
                if($showDescription) $item['docHTML'] = self::consoleAutocompleteDoc($params);
                $items[] = $item;
            }
        }

        foreach(self::getApiData('proceduralFunctions') as $vars) {
            foreach($vars as $name => $params) {
                $item = array('name' => $name . '()', 'meta' => 'PW function');
                if($showDescription) $item['docHTML'] = self::consoleAutocompleteDoc($params);
                $items[] = $item;
            }
        }

        return $items;
    }


    /**
     * Description + signature shown alongside a Console autocomplete entry
     *
     * @param array $params
     * @return string
     */
    protected static function consoleAutocompleteDoc($params) {
        $description = isset($params['description']) ? $params['description'] : '';
        $signature = isset($params['params']) && !empty($params['params'])
            ? '(' . implode(', ', $params['params']) . ')' : '';
        return $description . "\n" . $signature;
    }


    /**
     * Cache key for the autocomplete data above — changes whenever the data could have,
     * so it can be used both as the endpoint's ETag and as a cache-busting URL parameter.
     *
     * @return string
     */
    public static function getConsoleApiAutocompleteKey() {
        return substr(md5(implode('|', array(
            self::getModuleInfo()['version'],
            (string) wire('config')->version,
            (string) self::getDataValue('codeShowDescription'),
        ))), 0, 12);
    }


    public static function arrayDiffAssocMultidimensional(array $array1, array $array2) {
        $difference = [];
        foreach($array1 as $key => $value) {
            if(is_array($value)) {
                if(!array_key_exists($key, $array2)) {
                    $difference[$key] = $value;
                }
                elseif (!is_array($array2[$key])) {
                    $difference[$key] = $value;
                }
                else {
                    $multidimensionalDiff = self::arrayDiffAssocMultidimensional($value, $array2[$key]);
                    if (count($multidimensionalDiff) > 0) {
                        $difference[$key] = $multidimensionalDiff;
                    }
                }
            }
            else {
                if (!array_key_exists($key, $array2) || $array2[$key] !== $value) {
                    $difference[$key] = $value;
                }
            }
        }
        return $difference;
    }


    public function __destruct() {

        // if using Test mode in File Editor on regular files, then immediately replace loaded file with backed up version
        // this is here instead of ProcessWire::finished because this works if test version has fatal error
        // the cookie is "<action token>|<path>" (set by FileEditorPost.php), so one set by another subdomain of the
        // site can't make this restore a backup over a file
        $testFileEditorPath = static::tokenCookie('tracyTestFileEditor');
        if($testFileEditorPath !== null && (static::$allowedSuperuser || self::$validLocalUser || self::$validSwitchedUser)) {
            $rootPath = str_replace('\\', '/', $this->wire('config')->paths->root);
            $editorPath = str_replace('\\', '/', (string) ($this->wire('input')->post->fileEditorFilePath ?: $testFileEditorPath));
            $resolvedFilePath = str_replace('\\', '/', (string) realpath($rootPath . $editorPath));
            if($resolvedFilePath === '') {
                $resolvedFilePath = str_replace('\\', '/', (string) realpath($editorPath));
            }
            $isWindows = DIRECTORY_SEPARATOR === '\\';
            $prefixOk = $isWindows ? (stripos($resolvedFilePath, $rootPath) === 0) : (strpos($resolvedFilePath, $rootPath) === 0);
            $tracyCacheDirNorm = str_replace('\\', '/', $this->tracyCacheDir);
            if($resolvedFilePath !== '' && $prefixOk) {
                $relPath = $isWindows ? substr($resolvedFilePath, strlen($rootPath)) : str_replace($rootPath, '', $resolvedFilePath);
                $resolvedCachePath = str_replace('\\', '/', (string) realpath($tracyCacheDirNorm . $relPath));
                $cachePrefixOk = $isWindows ? (stripos($resolvedCachePath, $tracyCacheDirNorm) === 0) : (strpos($resolvedCachePath, $tracyCacheDirNorm) === 0);
                if($resolvedCachePath !== '' && $cachePrefixOk && file_exists($resolvedCachePath)) {
                    copy($resolvedCachePath, $resolvedFilePath);
                    unlink($resolvedCachePath);
                }
            }
        }

        // delete temporary template file after it's been rendered
        // this is from the File Editor panel
        if(isset($this->tempTemplateFilename) && file_exists($this->tempTemplateFilename)) unlink($this->tempTemplateFilename);

        // PW VERSION SWITCHER — perform file swap
        // Guard: PwVersionSwitcher is required inside init(); if __destruct runs
        // before init (e.g. early boot failure), the class isn't loaded and there's
        // no swap state to act on anyway.
        if(class_exists(__NAMESPACE__ . '\\PwVersionSwitcher', false)) {
            PwVersionSwitcher::performFileSwap($this);
        }
    }


    /**
     * Prepare an individual link for the Links panel
     *
     * @param string $link
     * @return string
     *
     */
    protected function prepLink($link) {
        $http = new WireHttp();
        $link_parts = explode('|', $link);
        $url = trim($link_parts[0]);
        $title = isset($link_parts[1]) ? trim($link_parts[1]) : '';
        $url = str_replace($this->wire('config')->urls->httpRoot, '/', $url);
        if($title == '' && preg_match('#^(https?://|/)#i', $url)) {
            // fetch the page's title, but only from an http(s) URL or a path on this site
            $fullUrl = strpos($url, 'http') === 0 ? $url : rtrim($this->wire('config')->urls->httpRoot, '/') . '/' . ltrim($url, '/');
            $html = $http->get($fullUrl);
            libxml_use_internal_errors(true);
            $dom = new \DOMDocument();
            $dom->loadHTML($html);
            $list = $dom->getElementsByTagName('title');
            libxml_use_internal_errors(false);
            $title = $list->length ? str_replace('|', ':', $list->item(0)->textContent) : $url;
        }
        return $url . ' | ' . $title;
    }

    /**
     * Return an InputfieldWrapper of Inputfields used to configure the class
     *
     * @param array $data Array of config values indexed by field name
     * @return InputfieldsWrapper
     *
     */
    public function getModuleConfigInputfields(array $data) {

        // if link info is in POST then add it to the Links panel (the panel's form sends a CSRF token)
        $link = $this->wire('input')->post->link;
        if($link && $this->wire('session')->CSRF->hasValidToken()) {
            $link = $this->prepLink($link);
            $tracyConfig = $this->wire('modules')->getModuleConfigData($this);
            if(!isset($tracyConfig['linksCode'])) $tracyConfig['linksCode'] = '';
            $tracyConfig['linksCode'] .= "\n" . $link;
            // calling with underscores because we don't need hooks to run again
            // note that ___saveModuleConfigData() calls the hookable saveConfig(), so it only
            // bypasses hooks on PW < 3.0.16 where saveConfig() doesn't exist
            if(method_exists($this->wire('modules'), '___saveConfig')) {
                $this->wire('modules')->___saveConfig($this, $tracyConfig);
            }
            else {
                $this->wire('modules')->___saveModuleConfigData($this, $tracyConfig);
            }
            // redirect back to where the user submitted the link from
            $this->wire('session')->redirect($this->httpReferer);
        }

        // if customPHP code was changed then session var was set to tell us to redirect to url with hash
        if($this->wire('session')->scrolltoCustomPhp === 1) {
            $this->wire('session')->remove('scrolltoCustomPhp');
            $this->wire('session')->redirect($this->inputUrl(true).'#wrap_Inputfield_customPhpCode');
        }

        // TracyDebugger's settings decide who gets the debug bar and its Console, and two of them run PHP code
        // (the Custom PHP panel and User Bar custom features), but PW lets any user with module-admin edit a
        // module's settings. So only superusers get the fields: others get this notice, and with no fields on
        // the form, saving it changes nothing
        if(!$this->wire('user')->isSuperuser()) {
            $wrapper = new InputfieldWrapper();
            $f = $this->wire('modules')->get('InputfieldMarkup');
            $f->label = __('TracyDebugger settings', __FILE__);
            $f->value = '<p>' . __('Only superusers can view or change the TracyDebugger settings.', __FILE__) . '</p>';
            $wrapper->add($f);
            return $wrapper;
        }

        // load JS & CSS files for config settings
        $this->wire('config')->styles->append(static::assetUrl('styles/config.css'));
        $this->wire('config')->scripts->append(static::assetUrl('scripts/ace-editor/ace.js'));
        $this->wire('config')->scripts->append(static::assetUrl('scripts/config.js'));

        // convert PW Info panel custom links from path back to ID for the InputfieldPageListSelectMultiple field.
        // values may be IDs (legacy state, never re-saved after install) or paths (post-save, export-portable).
        if(isset($data['customPWInfoPanelLinks'])) {
            $customPWInfoPanelLinkIds = array();
            foreach($data['customPWInfoPanelLinks'] as $val) {
                if(is_int($val) || ctype_digit((string) $val)) {
                    $customPWInfoPanelLinkIds[] = (int) $val;
                }
                elseif(method_exists($this->wire('pages'), 'getByPath')) {
                    $customPWInfoPanelLinkIds[] = $this->wire('pages')->getByPath($val, array('getID' => true, 'useHistory' => true));
                }
                // fallback for PW < 3.0.6 when getByPath method did not exist
                else {
                    $customPWInfoPanelLinkIds[] = $this->wire('pages')->get($val)->id;
                }
            }
            $data['customPWInfoPanelLinks'] = $customPWInfoPanelLinkIds;
        }


        if($this->wire('input')->post->submit_save_module) {
            unset($this->wire('input')->cookie->tracyModulesDisabled);
            setcookie("tracyModulesDisabled", "", time()-3600, '/');
            unset($this->wire('input')->cookie->tracyDisabled);
            setcookie("tracyDisabled", "", time()-3600, '/');
        }

        $data = array_merge(self::getDefaultData(), $data);

        $wrapper = new InputfieldWrapper();

        // Various Links
        $fieldset = $this->wire('modules')->get("InputfieldMarkup");
        $fieldset->label = __(' ', __FILE__);
        $fieldset->value = '
        <p><strong><img src="https://adrianbj.github.io/TracyDebugger/img/icon.svg" style="display:inline; vertical-align: middle; margin:0 15px 0 0; width: 50px" />Tracy Debugger for ProcessWire v'.$this->getModuleInfo()['version'].'</strong></p>
        <p style="margin-left:55px"><i class="fa fa-fw fa-lg fa-book"></i> <a href="https://adrianbj.github.io/TracyDebugger">TracyDebugger for ProcessWire Docs</a> and <a href="https://tracy.nette.org/">Nette Tracy Docs</a><p>
        <p style="margin-left:55px"><i class="fa fa-fw fa-lg fa-github"></i> <a href="https://github.com/adrianbj/TracyDebugger">Star on Github</a></p>
        <p style="margin-left:55px"><img class="fa fa-fw" style="display:inline; vertical-align: middle; margin:0 4px" src="https://adrianbj.github.io/TracyDebugger/icons/processwire-info.svg"> <a href="http://modules.processwire.com/modules/tracy-debugger/">Recommend in the Modules Directory</a></strong></p>
        <p style="margin-left:55px"><i class="fa fa-fw fa-lg fa-life-ring"></i> <a href="https://processwire.com/talk/forum/58-tracy-debugger/">Forum Support Thread</a></p>
        <p style="margin-left:55px">
            <iframe src="https://github.com/sponsors/adrianbj/button" title="Sponsor adrianbj" height="35" width="116" style="border: 0;"></iframe>
        </p>
        ';
        if(isset($this->wire('config')->tracy) && is_array($this->wire('config')->tracy)) {
            $fieldset->value .= '<p style="margin-top:35px"><i class="fa fa-fw fa-lg fa-exclamation-triangle"></i> You have specified various Tracy settings in <code>$config->tracy</code> that override settings here.</p>';
            $fieldset->value .= '<table class="uk-table uk-table-small uk-table-striped uk-width-1-2@m"><head><tr><th>Setting</th><th>Value</th></tr>';
            foreach($this->wire('config')->tracy as $k => $v) {
                if($v === true) {
                    $v = 'true';
                }
                elseif($v === false) {
                    $v = 'false';
                }
                $fieldset->value .= '<tr><td>'.$k.'</td><td>'.(is_array($v) ? implode(', ', $v) : $v).'</td></tr>';
            }
            $fieldset->value .= '</table>';
        }

        $wrapper->add($fieldset);

        // Quick links
        $f =
        $this->wire('modules')->get('InputfieldMarkup');
        $f->id = 'tracy-quick-links';
        $f->label = __('Quick links', __FILE__);
        $f->value = '<ul></ul>';
        $wrapper->add($f);

        // Main Setup
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'mainSetup');
        $fieldset->label = __('Main setup', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'enabled');
        $f->label = __('Enable Tracy Debugger', __FILE__);
        $f->description = __('Uncheck to completely disable all Tracy Debugger features.', __FILE__);
        $f->columnWidth = 33;
        $f->attr('checked', $data['enabled'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'use_php_session');
        $f->label = __('Use Native PHP Session', __FILE__);
        $f->description = __('Check to use native PHP session instead of temporary files.', __FILE__);
        $f->notes = __('Use this if you are having problems with Tracy\'s AJAX and Redirect bars not showing. IMPORTANT: Do not use this option together with the SessionHandlerDB module.', __FILE__);
        $f->columnWidth = 34;
        $f->attr('checked', $data['use_php_session'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldSelect");
        $f->attr('name', 'outputMode');
        $f->label = 'Output mode';
        $f->description = __('The DETECT option automatically switches from DEVELOPMENT to PRODUCTION mode based on whether the IP of the site is publicly accessible or not.', __FILE__);
        $f->notes = __('In PRODUCTION mode, all errors and dumps etc are logged to file. Nothing is displayed in the browser. In DEVELOPMENT mode, the debug bar is displayed for authorized users - superusers and those with the `tracy-debugger` permission. All other users will be forced into PRODUCTION mode, regardless of this setting.', __FILE__);
        $f->columnWidth = 33;
        $f->required = true;
        $f->addOption('detect', 'DETECT');
        $f->addOption('development', 'DEVELOPMENT');
        $f->addOption('production', 'PRODUCTION');
        if($data['outputMode']) $f->attr('value', $data['outputMode']);
        $fieldset->add($f);

        // Access Permissions
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'accessPermission');
        $fieldset->label = __('Access permission', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'superuserForceDevelopment');
        $f->label = __('Force superusers into DEVELOPMENT mode', __FILE__);
        $f->description = __('Check to force DEVELOPMENT mode for superusers even on live sites.', __FILE__);
        $f->notes = __('By default, the Output Mode setting\'s DETECT option will force a site into PRODUCTION mode when it is live, which hides the DebugBar and sends errors and dumps to log files. However, with this checked, superusers will always be in DEVELOPMENT mode.', __FILE__);
        $f->columnWidth = 33;
        $f->attr('checked', $data['superuserForceDevelopment'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'guestForceDevelopmentLocal');
        $f->label = __('Force guest users into DEVELOPMENT mode on localhost', __FILE__);
        $f->description = __('Check to force DEVELOPMENT mode for guests when server detected as localhost.', __FILE__);
        $f->notes = __('By default, guest users will always be in PRODUCTION mode (no debug bar). However, with this checked, they will always be in DEVELOPMENT mode on localhost, with the full debug bar including the Console, which runs PHP code. WARNING - "localhost" means the request comes from 127.0.0.1 / ::1 without an X-Forwarded-For or Forwarded header, so behind a reverse proxy on the same server that doesn\'t add one of those headers, every visitor counts as local. Only use this on a machine that nobody else can reach.', __FILE__);
        $f->columnWidth = 34;
        $f->attr('checked', $data['guestForceDevelopmentLocal'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'forceIsLocal');
        $f->label = __('Force isLocal check to always return true', __FILE__);
        $f->description = __('Check to force isLocal.', __FILE__);
        $f->notes = __('WARNING - Only use this if you know what you are doing! Combined with the previous setting, every guest on a live site gets the full debug bar, including the Console, which runs PHP code.', __FILE__);
        $f->columnWidth = 33;
        $f->attr('checked', $data['forceIsLocal'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'ipAddress');
        $f->label = __('Restrict non-superusers', __FILE__);
        $f->description = __('IP Address that non-superusers need to use TracyDebugger. Enter IP address or a PCRE regular expression to match IP address of user, eg. /^123\.456\.789\./ would match all IP addresses that started with 123.456.789.', __FILE__);
        $f->columnWidth = 50;
        $f->notes = __('Non-superusers are already blocked unless they have the `tracy-debugger` permission. But once a user has been given the permission, this option restricts access to the listed IP address. Highly recommended for debugging live sites that you have manually set into DEVELOPMENT mode.', __FILE__);
        if($data['ipAddress']) $f->attr('value', $data['ipAddress']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'restrictSuperusers');
        $f->label = __('Restrict superusers', __FILE__);
        $f->description = __('If checked, only superusers with the `tracy-debugger` permission will have access to Tracy.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['restrictSuperusers'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        // Miscellaneous Settings
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'miscellaneous');
        $fieldset->label = __('Miscellaneous', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'strictMode');
        $f->label = __('Strict mode', __FILE__);
        $f->description = __('Check to enable strict mode which displays notices and warnings like errors.', __FILE__);
        $f->columnWidth = 33;
        $f->attr('checked', $data['strictMode'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'strictModeAjax');
        $f->label = __('Strict mode AJAX only', __FILE__);
        $f->description = __('Check to enable strict mode only for AJAX calls.', __FILE__);
        $f->notes = __('Because Tracy intercepts notices and warnings, these will no longer be returned with the AJAX response which may result in a "success" response, rather than "failure". Notices and warnings from an AJAX call will be displayed in the AJAX bar\'s Errors panel, but you still might prefer this option as it provides a more prominent indication of failure.', __FILE__);
        $f->showIf="strictMode!='1'";
        $f->columnWidth = 34;
        $f->attr('checked', $data['strictModeAjax'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'forceScream');
        $f->label = __('Force scream', __FILE__);
        $f->description = __('Check to force "scream" of mode which disables the @ (silence/shut-up) operator so that notices and warnings are no longer hidden.', __FILE__);
        $f->notes = __('This is disabled when Strict Mode is enabled because of a bug? [https://forum.nette.org/en/25569-strict-and-scream-modes-together](https://forum.nette.org/en/25569-strict-and-scream-modes-together) in the core Tracy package.', __FILE__);
        $f->showIf="strictMode!='1', strictModeAjax!='1'";
        $f->columnWidth = 33;
        $f->attr('checked', $data['forceScream'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'showLocation');
        $f->label = 'Show location';
        $f->description = __('Shows the location of dump() and barDump() calls.', __FILE__);
        $f->notes = __('LOCATION_SOURCE adds tooltip with path to the file, where the function was called.'."\n".'LOCATION_LINK adds a link to the file which can be opened directly.'."\n".'LOCATION_CLASS adds a tooltip to every dumped object containing path to the file, in which the object\'s class is defined.');
        $f->addOption('Tracy\Dumper::LOCATION_SOURCE', 'LOCATION_SOURCE');
        $f->addOption('Tracy\Dumper::LOCATION_LINK', 'LOCATION_LINK');
        $f->addOption('Tracy\Dumper::LOCATION_CLASS', 'LOCATION_CLASS');
        $f->columnWidth = 50;
        if($data['showLocation']) $f->attr('value', $data['showLocation']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'debugInfo');
        $f->label = __('Use debugInfo() magic method', __FILE__);
        $f->description = __('If a `__debugInfo()` method has been defined, it will be used instead of dumping the full object.', __FILE__);
        $f->notes = __('This results in a smaller, cleaner dump, but you may miss some information. You can override this with the `debugInfo => true/false` option when calling `d()`, `bd()`, etc. Note that this also affects the output in the Request Info panel\'s Field List & Values section.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['debugInfo'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        if(version_compare(PHP_VERSION, '7.2.0', '>=')) {
            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'keysToHide');
            $f->label = __('Keys to hide', __FILE__);
            $f->description = __('Keys to redact in dumps and bluescreens.', __FILE__);
            $f->notes = __('Enter keys separated by commas.'."\nDefault: ".self::getDefaultData()['keysToHide'], __FILE__);
            if($data['keysToHide']) $f->attr('value', $data['keysToHide']);
            $fieldset->add($f);
        }

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'maxDepth');
        $f->label = __('Maximum nesting depth', __FILE__);
        $f->description = __('Set the maximum nesting depth of dumped arrays and objects.', __FILE__);
        $f->notes = __('Default: 3. Warning: making this too large can slow your page load down or even crash your browser.', __FILE__);
        $f->columnWidth = 33;
        $f->attr('value', $data['maxDepth']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'maxLength');
        $f->label = __('Maximum string length', __FILE__);
        $f->description = __('Set the maximum displayed strings length.', __FILE__);
        $f->notes = __('Default: 150', __FILE__);
        $f->columnWidth = 34;
        $f->attr('value', $data['maxLength']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'maxItems');
        $f->label = __('Maximum number of items', __FILE__);
        $f->description = __('Set the maximum number of items displayed.', __FILE__);
        $f->notes = __('Default: 100', __FILE__);
        $f->columnWidth = 33;
        $f->attr('value', $data['maxItems']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'collapse');
        $f->label = __('Collapse top array/object', __FILE__);
        $f->description = __('Set how big are collapsed', __FILE__);
        $f->notes = __('Default: 14', __FILE__);
        $f->columnWidth = 50;
        $f->attr('value', $data['collapse']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'collapse_count');
        $f->label = __('Collapse array/object', __FILE__);
        $f->description = __('Set how big are collapsed', __FILE__);
        $f->notes = __('Default: 7', __FILE__);
        $f->columnWidth = 50;
        $f->attr('value', $data['collapse_count']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'maxAjaxRows');
        $f->label = __('Maximum number of AJAX rows in debug bar', __FILE__);
        $f->description = __('After number is exceeded, the first one will be recycled.', __FILE__);
        $f->notes = __('Default: 3. Note that you will need to do a hard browser reload for this setting to take effect.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('value', $data['maxAjaxRows']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'reservedMemorySize');
        $f->label = __('Reserved memory size', __FILE__);
        $f->description = __('If you are getting memory exhaustion errors on Tracy\'s bluescreen, try increasing this value.', __FILE__);
        $f->notes = __('Default: 500000', __FILE__);
        $f->columnWidth = 50;
        $f->attr('value', $data['reservedMemorySize']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'referencePageEdited');
        $f->label = __('Reference page being edited', __FILE__);
        $f->description = __('When editing a page in the admin, the Request Info Panel will show details of the page being edited, and the Consol Panel will assign the $page variable to the page being edited.', __FILE__);
        $f->notes = __('Highly recommended unless you have a reason not to do this.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['referencePageEdited'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'linksNewTab');
        $f->label = __('Open links in new tab', __FILE__);
        $f->description = __('Makes links open in a new browser tab.', __FILE__);
        $f->notes = __('This is used by links such as those in the Captain Hook and API Explorer panels.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['linksNewTab'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'versionAssetFilenames');
        $f->label = __('Version CSS and JS in the filename', __FILE__);
        $f->description = __('Put each file\'s modification time in its name (console-panel.1792537113.js) instead of adding ?v=. For a CDN that ignores query strings, which would otherwise keep serving the old files after an update.', __FILE__);
        $f->notes = __('Needs this rule in the site\'s .htaccess, before ProcessWire\'s own rewrite rules, or TracyDebugger\'s CSS and JS files (including the Ace editor) return 404:', __FILE__) . "\n`RewriteRule ^(.+)\\.(\\d{10,})\\.(js|css)$ $1.$3 [L]`";
        $f->attr('checked', $data['versionAssetFilenames'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        // Error Logging Settings
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'errorLogging');
        $fieldset->label = __('Error logging', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'logSeverity');
        $f->label = 'Log severity';
        $f->description = __('If you want Tracy to log PHP errors like E_NOTICE or E_WARNING with detailed information (HTML report), set them here.', __FILE__);
        $f->notes = __('These only affect log file content, not onscreen debug info.');
        $f->addOption('E_ERROR', 'E_ERROR');
        $f->addOption('E_WARNING', 'E_WARNING');
        $f->addOption('E_PARSE', 'E_PARSE');
        $f->addOption('E_NOTICE', 'E_NOTICE');
        $f->addOption('E_CORE_ERROR', 'E_CORE_ERROR');
        $f->addOption('E_CORE_WARNING', 'E_CORE_WARNING');
        $f->addOption('E_COMPILE_ERROR', 'E_COMPILE_ERROR');
        $f->addOption('E_COMPILE_WARNING', 'E_COMPILE_WARNING');
        $f->addOption('E_USER_ERROR', 'E_USER_ERROR');
        $f->addOption('E_USER_WARNING', 'E_USER_WARNING');
        $f->addOption('E_USER_NOTICE', 'E_USER_NOTICE');
        $f->addOption('E_RECOVERABLE_ERROR', 'E_RECOVERABLE_ERROR');
        $f->addOption('E_DEPRECATED', 'E_DEPRECATED');
        $f->addOption('E_USER_DEPRECATED', 'E_USER_DEPRECATED');
        $f->addOption('E_ALL', 'E_ALL');
        if($data['logSeverity']) $f->attr('value', $data['logSeverity']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldEmail");
        $f->attr('name', 'fromEmail');
        // Chrome ignores autocomplete="off" and its heuristics autofill any email field regardless of name/value,
        // so render the field readonly (Chrome won't autofill a readonly field) and drop readonly on focus so it stays editable
        $f->attr('autocomplete', 'tracy-' . bin2hex(random_bytes(8)));
        $f->attr('readonly', 'readonly');
        $f->attr('onfocus', "this.removeAttribute('readonly');");
        $f->label = __('Email errors "From"', __FILE__);
        $f->description = __('Receive emails from this address when an error occurs.', __FILE__);
        $f->columnWidth = 33;
        if($data['fromEmail']) $f->attr('value', $data['fromEmail']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldTextarea");
        $f->attr('name', 'email');
        $f->label = __('Email errors "To"', __FILE__);
        $f->description = __('Receive emails at this address when an error occurs.', __FILE__);
        $f->notes = __('You can supply multiple addresses, one per line.', __FILE__);
        $f->columnWidth = 34;
        if($data['email']) $f->attr('value', $data['email']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'clearEmailSent');
        $f->label = __('Clear "email sent" flag', __FILE__);
        $f->description = __('Check and save settings to remove the "email-sent" file so that you will start receiving new error emails.', __FILE__);
        $f->columnWidth = 33;
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'slackChannel');
        $f->label = __('Slack Channel', __FILE__);
        $f->description = __('Post to this Slack channel when an error occurs.', __FILE__);
        $f->columnWidth = 50;
        if($data['slackChannel']) $f->attr('value', $data['slackChannel']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'slackAppOauthToken');
        $f->label = __('Slack App Oauth Token', __FILE__);
        $f->columnWidth = 50;
        if($data['slackAppOauthToken']) $f->attr('value', $data['slackAppOauthToken']);
        $fieldset->add($f);

        // Debug Bar and Panel Settings
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'debugBarAndPanels');
        $fieldset->label = __('Debug bar and panels', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'showDebugBar');
        $f->label = __('Show debug bar', __FILE__);
        $f->description = __('Show the debug bar.', __FILE__);
        $f->columnWidth = 50;
        $f->addOption('frontend', 'Frontend');
        $f->addOption('backend', 'Backend');
        if($data['showDebugBar']) $f->attr('value', $data['showDebugBar']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'hideDebugBarModals');
        $f->label = __('No debug bar in ...', __FILE__);
        $f->columnWidth = 50;
        $f->addOption('regularModal', 'Regular Modal');
        $f->addOption('inlineModal', 'Inline Modal');
        $f->addOption('overlayPanels', 'Overlay Panels');
        $f->addOption('formBuilderIframe', 'Form Builder iframe');
        if($data['hideDebugBarModals']) $f->attr('value', $data['hideDebugBarModals']);
        $fieldset->add($f);

        $templateOptions = array();
        foreach($this->wire('templates') as $t) {
            $templateOptions[$t->id] = $t->name;
        }

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'hideDebugBarFrontendTemplates');
        $f->label = __('No debug bar in selected frontend templates', __FILE__);
        $f->description = __('Disable the debug bar on pages with the selected templates.', __FILE__);
        $f->columnWidth = 50;
        foreach($templateOptions as $id => $name) {
            $f->addOption($id, $name);
        }
        if($data['hideDebugBarFrontendTemplates']) $f->attr('value', $data['hideDebugBarFrontendTemplates']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'hideDebugBarBackendTemplates');
        $f->label = __('No debug bar in selected backend templates', __FILE__);
        $f->description = __('Disable the debug bar when editing pages with the selected templates.', __FILE__);
        $f->columnWidth = 50;
        foreach($templateOptions as $id => $name) {
            $f->addOption($id, $name);
        }
        if($data['hideDebugBarBackendTemplates']) $f->attr('value', $data['hideDebugBarBackendTemplates']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'hideDebugBar');
        $f->label = __('Hide debug bar by default', __FILE__);
        $f->description = __('Hide the debug bar by default on page load.', __FILE__);
        $f->notes = __('This results in the bar being hidden (unless an error is reported), and replaced with a small "show bar" ⇱ icon.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['hideDebugBar'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'showPanelLabels');
        $f->label = __('Show panel labels', __FILE__);
        $f->description = __('Show the labels next to each panel.', __FILE__);
        $f->notes = __('Unchecking this will make the debugger bar much more compact.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['showPanelLabels'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldRadios");
        $f->attr('name', 'barPosition');
        $f->label = __('Bar Position', __FILE__);
        $f->notes = __('You will need to do a hard reload in your browser for these changes to take effect.', __FILE__);
        $f->columnWidth = 50;
        $f->addOption('bottom-right', 'Bottom Right');
        $f->addOption('bottom-left', 'Bottom Left');
        if($data['barPosition']) $f->attr('value', $data['barPosition']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'panelZindex');
        $f->label = __('Starting z-index for panels', __FILE__);
        $f->description = __('Adjust if you find panels are below/above elements that you don\'t want.', __FILE__);
        $f->notes = __('Default: 100', __FILE__);
        $f->columnWidth = 50;
        if($data['panelZindex']) $f->attr('value', $data['panelZindex']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'frontendPanels');
        $f->label = __('Frontend panels', __FILE__);
        $f->description = __('Determines which panels are shown in the Debug Bar on the frontend. Sort to match order of panels in Debugger Bar.', __FILE__);
        $f->columnWidth = 50;
        foreach(static::$allPanels as $name => $label) {
            $f->addOption($name, $label);
        }
        if($data['frontendPanels']) $f->attr('value', $data['frontendPanels']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'backendPanels');
        $f->label = __('Backend panels', __FILE__);
        $f->description = __('Determines which panels are shown in the Debug Bar on the backend. Sort to match order of panels in Debugger Bar.', __FILE__);
        $f->notes = __('Note that '.implode(', ', static::$hideInAdmin).' are intentionally missing from this list because they have no use in the backend.', __FILE__);
        $f->columnWidth = 50;
        foreach(static::$allPanels as $name => $label) {
            if(!in_array($name, static::$hideInAdmin)) {
                $f->addOption($name, $label);
            }
        }
        if($data['backendPanels']) $f->attr('value', $data['backendPanels']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'restrictedUserDisabledPanels');
        $f->label = __('Disabled panels for restricted users', __FILE__);
        $f->description = __('Check the panels that should NOT be shown to users with the `tracy-restricted-panels` role or permission.', __FILE__);
        $f->notes = __('Unchecked panels will still only be shown to restricted users if they are selected in the Front/Back-end options above.', __FILE__);
        $f->optionColumns = 3;
        foreach(static::$allPanels as $name => $label) {
            $f->addOption($name, $label);
        }
        if($data['restrictedUserDisabledPanels']) $f->attr('value', $data['restrictedUserDisabledPanels']);
        $fieldset->add($f);


        // Panel Selector Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'panelSelectorPanel');
        $fieldset->label = __('Panel Selector panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'nonToggleablePanels');
        $f->label = __('Non-toggleable panels', __FILE__);
        $f->description = __('Selected panels will NOT be toggleable in the Panel Selector.', __FILE__);
        $f->optionColumns = 3;
        foreach(static::$allPanels as $name => $label) {
            $f->addOption($name, $label);
        }
        if($data['nonToggleablePanels']) $f->attr('value', $data['nonToggleablePanels']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'panelSelectorTracyTogglerButton');
        $f->label = __('Add Disable/Enable (Toggler) Tracy button to Panel Selector.', __FILE__);
        $f->description = __('This allows you to disable/enable Tracy from the Panel Selector.', __FILE__);
        $f->attr('checked', $data['panelSelectorTracyTogglerButton'] == '1' ? 'checked' : '');
        $fieldset->add($f);


        // Editor Protocol Handler
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'editorLinks');
        $fieldset->label = __('Editor links', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'editor');
        $f->label = __('Editor protocol handler', __FILE__);
        $f->description = __('Sets the Tracy `Debugger::$editor` variable. Enter the appropriate address to open your code editor of choice.'."\n".'This approach only works for OSX. For more instructions on Windows and Linux alternatives, [read here](https://pla.nette.org/en/how-open-files-in-ide-from-debugger).'."\n\n**Protocol handler helpers**\n[VSCode](https://github.com/shengyou/vscode-handler)\n[Sublime Text](https://github.com/saetia/sublime-url-protocol-mac)\n[PHP Storm](https://github.com/aik099/PhpStormProtocol)\n".' For other editors/IDEs, Google "protocol handler editorname".', __FILE__);
        $f->notes = __("`vscode://file/%file:%line`\n`subl://open/?url=file://%file&line=%line`\n`phpstorm://open?file=%file&line=%line`\n Initially configured for VSCode - change to work with your favorite editor.", __FILE__);
        $f->columnWidth = 50;
        if($data['editor']) $f->attr('value', $data['editor']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'localRootPath');
        $f->label = __('Local root path', __FILE__);
        $f->description = __('Maps editor links from site root to local path.', __FILE__);
        $f->notes = __('An example path on MacOS might be: /Users/myname/Sites/sitefolder/', __FILE__);
        $f->columnWidth = 50;
        if($data['localRootPath']) $f->attr('value', $data['localRootPath']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'useOnlineEditor');
        $f->label = __('Use online editor for links', __FILE__);
        $f->description = __('This will open links in an online editor (Tracy File Editor or ProcessFileEdit) instead of your code editor.', __FILE__);
        $f->notes = __('You can choose which editor after selecting at least one of these.', __FILE__);
        $f->columnWidth = 50;
        $f->addOption('live', 'Live');
        $f->addOption('local', 'Local');
        if($data['useOnlineEditor']) $f->attr('value', $data['useOnlineEditor']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldRadios");
        $f->attr('name', 'onlineEditor');
        $f->label = __('Online editor', __FILE__);
        $f->description = __('Which online editor to use: Tracy File Editor or [ProcessFileEdit (Files Editor)](http://modules.processwire.com/modules/process-file-edit/).', __FILE__);
        if($this->wire('modules')->isInstalled('ProcessFileEdit')) {
            $f->notes = __('Process File Edit is installed, but you may want to adjust its [settings]('.$this->wire('config')->urls->admin.'module/edit?name=ProcessFileEdit)', __FILE__);
        }
        else {
            $f->notes = __('Process File Edit is NOT installed - you need to install it for the option to appear.', __FILE__);
        }
        $f->columnWidth = 50;
        $f->showIf = "useOnlineEditor.count>0";
        $f->requiredIf = "useOnlineEditor.count>0";
        $f->addOption('tracy', 'Tracy File Editor');
        if($this->wire('modules')->isInstalled('ProcessFileEdit')) $f->addOption('processFileEdit', 'ProcessFileEdit');
        if($data['onlineEditor']) $f->attr('value', $data['onlineEditor']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'forceEditorLinksToTracy');
        $f->label = __('Force editor links to use Tracy File Editor', __FILE__);
        $f->description = __('Even if neither of the "Use Online Editor for Links" options are checked, if the File Editor Panel is enabled, all links will be sent to it.', __FILE__);
        $f->notes = __("RECOMMENDED: This is a handy option if you generally want links to use your code editor, but want the option to use the File Editor occasionally.\nYou can enable it (once or sticky) from the Panel selector on the debug bar without the need to change the above settings.", __FILE__);
        $f->attr('checked', $data['forceEditorLinksToTracy'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        // Console Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'consolePanel');
        $fieldset->label = __('Console panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldRadios");
        $f->attr('name', 'snippetsPath');
        $f->label = __('Snippets path', __FILE__);
        $f->description = __('Directory where snippets will be saved to / loaded from', __FILE__);
        $f->notes = __('Default: templates', __FILE__);
        $f->addOption('templates', $this->wire('config')->urls->templates.'TracyDebugger/snippets/');
        $f->addOption('assets', $this->wire('config')->urls->assets.'TracyDebugger/snippets/');
        if($data['snippetsPath']) $f->attr('value', $data['snippetsPath']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'consoleBackupLimit');
        $f->label = __('Maximum number automatically named backups', __FILE__);
        $f->description = __('The maximum number of automatically named backups that will be retained before pruning the oldest.', __FILE__);
        $f->notes = __('Default: 25.', __FILE__);
        $f->attr('value', $data['consoleBackupLimit']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'consolePhpCliPath');
        $f->label = __('PHP CLI path', __FILE__);
        $f->description = __('Path to the PHP command line binary used when "Run in CLI" is ticked in the Console panel. That runs the code in a separate PHP CLI process, so a long script isn\'t cut off by a web server or proxy request time limit. Leave blank to detect it.', __FILE__);
        $f->notes = __('Needs PHP\'s proc_open() function and a Linux/macOS server. Changes the code makes to $session are not kept.', __FILE__) . ($data['consolePhpCliPath'] ? '' : ' ' . sprintf(__('Detected: %s', __FILE__), static::getPhpCliPath()));
        $f->attr('value', $data['consolePhpCliPath']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldSelect");
        $f->attr('name', 'consoleTabsTheme');
        $f->label = __('Tabs Theme', __FILE__);
        $f->columnWidth = 33;
        $f->addOption('dark-theme', 'Dark');
        $f->addOption('light-theme', 'Light');
        $f->addOption('kiwi-theme', 'Kiwi');
        $f->required = true;
        if($data['consoleTabsTheme']) $f->attr('value', $data['consoleTabsTheme']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldTextarea");
        $f->attr('name', 'consoleCodePrefix');
        $f->label = __('Code prefix', __FILE__);
        $f->description = __('Code block that should be added to each snippet stored on disk.', __FILE__);
        $f->noTrim = true;
        if($data['consoleCodePrefix']) $f->attr('value', $data['consoleCodePrefix']);
        $fieldset->add($f);

        // File Editor Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'fileEditorPanel');
        $fieldset->label = __('File Editor panel', __FILE__);
        $fieldset->description = __("These settings don't affect links opened via the Editor Protocol Handler. They only affect browsing directly from the File Editor folder/file selector sidebar.");
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldMarkup");
        $f->attr('name', 'fileEditorNote');
        $f->showIf = "useOnlineEditor.count>0, onlineEditor!=processFileEdit";
        $f->value = __('Because you are using Tracy File Editor for the editor links, the File Editor Panel will be enabled, even if you don\'t have it selected in the Frontend/Backend Panel selections above.', __FILE__);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldSelect");
        $f->attr('name', 'fileEditorBaseDirectory');
        $f->label = __('Base directory', __FILE__);
        $f->description = __('A more specific selection results in better performance in the File Editor Panel.', __FILE__);
        $f->columnWidth = 50;
        $f->addOption('root', 'Root');
        $f->addOption('site', 'Site');
        $f->addOption('templates', 'Templates');
        $f->required = true;
        if($data['fileEditorBaseDirectory']) $f->attr('value', $data['fileEditorBaseDirectory']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'fileEditorAllowedExtensions');
        $f->label = __('Allowed extensions', __FILE__);
        $f->description = __('Comma separated list of extensions that can be opened in the editor. Fewer extensions results in better performance in the File Editor Panel.', __FILE__);
        $f->notes = __('Initially configured for: php, module, js, css, txt, log, htaccess', __FILE__);
        $f->columnWidth = 50;
        if($data['fileEditorAllowedExtensions']) $f->attr('value', $data['fileEditorAllowedExtensions']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'fileEditorExcludedDirs');
        $f->label = __('Excluded directories', __FILE__);
        $f->description = __('Comma separated list of directories that will be excluded from the tree.', __FILE__);
        $f->notes = __('Initially configured for: site/assets', __FILE__);
        if($data['fileEditorExcludedDirs']) $f->attr('value', $data['fileEditorExcludedDirs']);
        $fieldset->add($f);

        // Code Editor settings
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'codeEditorSettings');
        $fieldset->label = __('Code editor settings', __FILE__);
        $fieldset->description = __("These settings apply to the Console panel and the File Editor panel", __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldSelect");
        $f->attr('name', 'aceTheme');
        $f->label = __('Theme', __FILE__);
        $f->columnWidth = 33;
        $themes = array();
        foreach (new \DirectoryIterator(wire('config')->paths->$this.'scripts/ace-editor/') as $file) {
            if($file->isFile()) {
                $baseName = $file->getBasename('.js');
                if(strpos($baseName, 'theme-') !== false) {
                    array_push($themes, str_replace('theme-', '', $baseName));
                }
            }
        }
        asort($themes);
        foreach($themes as $theme) {
            $f->addOption($theme);
        }
        $f->required = true;
        if($data['aceTheme']) $f->attr('value', $data['aceTheme']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'codeFontSize');
        $f->label = __('Font size', __FILE__);
        $f->description = __('In pixels.', __FILE__);
        $f->notes = __('If you change the font size you must also set the "Line height" to an appropriate value relative to the font size.', __FILE__);
        $f->columnWidth = 34;
        $f->required = true;
        if($data['codeFontSize']) $f->attr('value', $data['codeFontSize']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'codeLineHeight');
        $f->label = __('Line height', __FILE__);
        $f->description = __('In pixels.', __FILE__);
        $f->notes = __('You must set this to an appropriate value relative to the font size.', __FILE__);
        $f->columnWidth = 33;
        $f->required = true;
        if($data['codeLineHeight']) $f->attr('value', $data['codeLineHeight']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldSelect");
        $f->attr('name', 'codeShowInvisibles');
        $f->label = __('Show Invisibles', __FILE__);
        $f->description = __('Show invisible characters like spaces, CR, and LF.', __FILE__);
        $f->columnWidth = 33;
        $f->addOption(1, 'True');
        $f->addOption(0, 'False');
        $f->required = true;
        if(isset($data['codeShowInvisibles'])) $f->attr('value', $data['codeShowInvisibles']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'codeTabSize');
        $f->label = __('Tab size', __FILE__);
        $f->description = __('Number of spaces (or equivalent tab width).', __FILE__);
        $f->columnWidth = 34;
        $f->required = true;
        if($data['codeTabSize']) $f->attr('value', $data['codeTabSize']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldSelect");
        $f->attr('name', 'codeUseSoftTabs');
        $f->label = __('Use Soft Tabs', __FILE__);
        $f->description = __('Uses spaces rather than actual (hard) tabs.', __FILE__);
        $f->columnWidth = 33;
        $f->addOption(1, 'True');
        $f->addOption(0, 'False');
        $f->required = true;
        if(isset($data['codeUseSoftTabs'])) $f->attr('value', $data['codeUseSoftTabs']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'pwAutocompletions');
        $f->label = __('ProcessWire autocompletions', __FILE__);
        $f->description = __('Adds PW methods, properties, and page fields to the editor autocompletions.', __FILE__);
        $f->notes = __('This add approximately 200KB to the payload of the Console and File Editor panels.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['pwAutocompletions'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'codeShowDescription');
        $f->label = __('Show description', __FILE__);
        $f->description = __('This will show the first line from the doc comment as a note connected to autocomplete matches.', __FILE__);
        $f->notes = __('Unchecking this reduces the autocomplete payload to approximately 100KB.', __FILE__);
        $f->columnWidth = 50;
        $f->showIf = "pwAutocompletions=1";
        $f->attr('checked', $data['codeShowDescription'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldURL");
        $f->attr('name', 'customSnippetsUrl');
        $f->label = __('Custom autocompletion snippets URL', __FILE__);
        $f->description = __("Link to snippets file for serving autocompletions in Console and File Editor panels. Can be local or remote, eg. a Github Gist file.\nTracy comes with two default autocompletions: `pwfind` and `pwforeach`. Type `pw` to see available options.", __FILE__);
        $f->notes = __('If Github gist, you must use a service such as [https://cdn.statically.io/gist/](https://cdn.statically.io/gist) or [https://gist.githubusercontent.com/](https://gist.githubusercontent.com/)', __FILE__);
        if($data['customSnippetsUrl']) $f->attr('value', $data['customSnippetsUrl']);
        $fieldset->add($f);

        // ProcessWire Info Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'processwireInfoPanel');
        $fieldset->label = __('ProcessWire Info panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'processwireInfoPanelSections');
        $f->label = __('Panel sections', __FILE__);
        $f->description = __('Which sections to include in the ProcessWire Info panel.', __FILE__);
        $f->columnWidth = 50;
        foreach(static::$processWireInfoSections as $name => $label) {
            $f->addOption($name, $label);
        }
        if($data['processwireInfoPanelSections']) $f->attr('value', $data['processwireInfoPanelSections']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldPageListSelectMultiple");
        $f->attr('name', 'customPWInfoPanelLinks');
        $f->label = __('Custom links', __FILE__);
        $f->description = __('Choose pages you would like links to.', __FILE__);
        $f->notes = __('To provide links to items under the Setup menu, navigate to Admin > Setup >', __FILE__);
        $f->columnWidth = 50;
        if($data['customPWInfoPanelLinks']) $f->attr('value', $data['customPWInfoPanelLinks']);
        // stored JSON holds paths (for export portability) but the field POSTs page IDs.
        // convert IDs back to paths right after processInput so ProcessModule's stored-vs-submitted
        // comparison reads paths==paths and stops flagging customPWInfoPanelLinks as updated on no-op saves.
        $f->addHookAfter('processInput', function($event) {
            $field = $event->object;
            $ids = $field->attr('value');
            if(!is_array($ids) || empty($ids)) return;
            $paths = array();
            foreach($ids as $id) {
                if(!is_int($id) && !ctype_digit((string) $id)) {
                    $paths[] = $id;
                    continue;
                }
                if(method_exists($this->wire('pages'), 'getPath') && version_compare($this->wire('config')->version, '3.0.73', '>=')) {
                    $paths[] = $this->wire('pages')->getPath((int) $id);
                }
                else {
                    $paths[] = $this->wire('pages')->get((int) $id)->path;
                }
            }
            $field->attr('value', $paths);
        });
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'showPWInfoPanelIconLabels');
        $f->label = __('Show icon labels', __FILE__);
        $f->description = __('Shows labels next to each icon for the two "Links" sections.', __FILE__);
        $f->notes = __('Nice for clarity, but takes up more space.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['showPWInfoPanelIconLabels'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'pWInfoPanelLinksNewTab');
        $f->label = __('Open links in new tab', __FILE__);
        $f->description = __('Makes links open in a new browser tab.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['pWInfoPanelLinksNewTab'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        // Adminer Panel
        if($this->wire('modules')->isInstalled('ProcessTracyAdminer')) {
            $fieldset = $this->wire('modules')->get("InputfieldFieldset");
            $fieldset->attr('name+id', 'adminerPanel');
            $fieldset->label = __('Adminer panel', __FILE__);
            $wrapper->add($fieldset);

            $f = $this->wire('modules')->get("InputfieldCheckbox");
            $f->attr('name', 'adminerStandAlone');
            $f->label = __('Standalone mode', __FILE__);
            $f->description = __('Load Setup > Adminer in standalone mode.', __FILE__);
            $f->notes = __('Adminer won\'t be embedded in PW admin via iframe.', __FILE__);
            $f->columnWidth = 33;
            $f->attr('checked', $this->data['adminerStandAlone'] == '1' ? 'checked' : '');
            $fieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldCheckbox");
            $f->attr('name', 'adminerEditFieldLink');
            $f->label = __('Field edit links', __FILE__);
            $f->description = __('Add adminer links to each field in the page edit interface.', __FILE__);
            $f->notes = __('Will only appear when Adminer panel is enabled', __FILE__);
            $f->columnWidth = 34;
            $f->attr('checked', $this->data['adminerEditFieldLink'] == '1' ? 'checked' : '');
            $fieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldSelect");
            $f->attr('name', 'adminerThemeColor');
            $f->label = __('Theme color', __FILE__);
            $f->addOption('blue', 'Blue');
            $f->addOption('green', 'Green');
            $f->addOption('orange', 'Orange');
            $f->addOption('purple', 'Purple');
            $f->addOption('red', 'Red');
            $f->required = true;
            $f->columnWidth = 33;
            if($this->data['adminerThemeColor']) $f->attr('value', $this->data['adminerThemeColor']);
            $fieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'adminerJsonMaxLevel');
            $f->label = __('JSON max level', __FILE__);
            $f->description = __('Max. level in recursion. 0 means no limit.', __FILE__);
            $f->notes = __('Default: 3', __FILE__);
            $f->required = true;
            $f->columnWidth = 25;
            if($this->data['adminerJsonMaxLevel']) $f->attr('value', $this->data['adminerJsonMaxLevel']);
            $fieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldCheckbox");
            $f->attr('name', 'adminerJsonInTable');
            $f->label = __('JSON In Table', __FILE__);
            $f->description = __('Whether to apply JSON preview in selection table.', __FILE__);
            $f->notes = __('Default: true', __FILE__);
            $f->columnWidth = 25;
            $f->attr('checked', $this->data['adminerJsonInTable'] == '1' ? 'checked' : '');
            $fieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldCheckbox");
            $f->attr('name', 'adminerJsonInEdit');
            $f->label = __('JSON In Edit', __FILE__);
            $f->description = __('Whether to apply JSON preview in edit form.', __FILE__);
            $f->notes = __('Default: true', __FILE__);
            $f->columnWidth = 25;
            $f->attr('checked', $this->data['adminerJsonInEdit'] == '1' ? 'checked' : '');
            $fieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'adminerJsonMaxTextLength');
            $f->label = __('JSON max text length', __FILE__);
            $f->description = __('Maximal length of string values. Longer texts will be truncated with ellipsis sign. 0 means no limit.', __FILE__);
            $f->notes = __('Default: 200', __FILE__);
            $f->required = true;
            $f->columnWidth = 25;
            if($this->data['adminerJsonMaxTextLength']) $f->attr('value', $this->data['adminerJsonMaxTextLength']);
            $fieldset->add($f);

            $aiFieldset = $this->wire('modules')->get("InputfieldFieldset");
            $aiFieldset->attr('name+id', 'adminerAiFieldset');
            $aiFieldset->label = __('AI SQL assistants', __FILE__);
            $aiFieldset->description = __('Optional AI-assisted SQL generation in Adminer\'s SQL command. Each provider activates only when its API key/URL is filled in.', __FILE__);
            $aiFieldset->notes = __('Beware: the database structure (CREATE TABLE statements, no row data) is sent to the configured provider with each request.', __FILE__);
            $aiFieldset->collapsed = Inputfield::collapsedYes;
            $fieldset->add($aiFieldset);

            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'adminerGeminiApiKey');
            $f->attr('type', 'password');
            $f->label = __('Gemini API key', __FILE__);
            $f->description = __('Google Gemini API key. Leave blank to disable.', __FILE__);
            $f->notes = __('Get one at https://aistudio.google.com/apikey', __FILE__);
            $f->columnWidth = 50;
            if($this->data['adminerGeminiApiKey']) $f->attr('value', $this->data['adminerGeminiApiKey']);
            $aiFieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'adminerGeminiModel');
            $f->label = __('Gemini model', __FILE__);
            $f->description = __('Gemini model name.', __FILE__);
            $f->notes = __('Default: gemini-3.1-flash-lite. See https://ai.google.dev/gemini-api/docs/models', __FILE__);
            $f->columnWidth = 50;
            if($this->data['adminerGeminiModel']) $f->attr('value', $this->data['adminerGeminiModel']);
            $aiFieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'adminerClaudeApiKey');
            $f->attr('type', 'password');
            $f->label = __('Claude API key', __FILE__);
            $f->description = __('Anthropic Claude API key. Leave blank to disable.', __FILE__);
            $f->notes = __('Get one at https://platform.claude.com/settings/keys', __FILE__);
            $f->columnWidth = 50;
            if($this->data['adminerClaudeApiKey']) $f->attr('value', $this->data['adminerClaudeApiKey']);
            $aiFieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'adminerClaudeModel');
            $f->label = __('Claude model', __FILE__);
            $f->description = __('Claude model name.', __FILE__);
            $f->notes = __('Default: claude-opus-5-5. See https://platform.claude.com/docs/en/about-claude/models/overview', __FILE__);
            $f->columnWidth = 50;
            if($this->data['adminerClaudeModel']) $f->attr('value', $this->data['adminerClaudeModel']);
            $aiFieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'adminerOpenWebUiApiUrl');
            $f->label = __('Open WebUI API URL', __FILE__);
            $f->description = __('Base URL of an Open WebUI / OpenAI-compatible chat endpoint. Leave blank to disable.', __FILE__);
            $f->notes = __('e.g. http://127.0.0.1:8080', __FILE__);
            $f->columnWidth = 34;
            if($this->data['adminerOpenWebUiApiUrl']) $f->attr('value', $this->data['adminerOpenWebUiApiUrl']);
            $aiFieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'adminerOpenWebUiModel');
            $f->label = __('Open WebUI model', __FILE__);
            $f->description = __('Model name as shown in Open WebUI.', __FILE__);
            $f->notes = __('Default: gpt-oss:120b', __FILE__);
            $f->columnWidth = 33;
            if($this->data['adminerOpenWebUiModel']) $f->attr('value', $this->data['adminerOpenWebUiModel']);
            $aiFieldset->add($f);

            $f = $this->wire('modules')->get("InputfieldText");
            $f->attr('name', 'adminerOpenWebUiApiKey');
            $f->attr('type', 'password');
            $f->label = __('Open WebUI bearer token', __FILE__);
            $f->description = __('Optional bearer token. Leave blank if the endpoint is public.', __FILE__);
            $f->columnWidth = 33;
            if($this->data['adminerOpenWebUiApiKey']) $f->attr('value', $this->data['adminerOpenWebUiApiKey']);
            $aiFieldset->add($f);
        }

        // API Explorer Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'apiExplorerPanel');
        $fieldset->label = __('API Explorer panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'apiExplorerShowDescription');
        $f->label = __('Show description', __FILE__);
        $f->description = __('This will show the first line from the doc comment in its own column.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['apiExplorerShowDescription'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'apiExplorerToggleDocComment');
        $f->label = __('Toggle method doc comment', __FILE__);
        $f->description = __('This will toggle the entire doc comment block if you click on the method column.', __FILE__);
        $f->notes = __('This significantly increases the size of this panel.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['apiExplorerToggleDocComment'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'apiExplorerModuleClasses');
        $f->label = __('Module classes', __FILE__);
        $f->description = __('Select module classes that you also want diplayed.', __FILE__);
        $f->notes = __('These options will significantly increase the size of this panel.', __FILE__);
        $f->addOption('coreModules', 'Core modules');
        $f->addOption('siteModules', 'Site modules');
        if($data['apiExplorerModuleClasses']) $f->attr('value', $data['apiExplorerModuleClasses']);
        $fieldset->add($f);

        // Captain Hook Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'captainHookPanel');
        $fieldset->label = __('Captain Hook panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'captainHookShowDescription');
        $f->label = __('Show description', __FILE__);
        $f->description = __('This will show the first line from the doc comment in its own column.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['captainHookShowDescription'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'captainHookToggleDocComment');
        $f->label = __('Toggle method doc comment', __FILE__);
        $f->description = __('This will toggle the entire doc comment block if you click on the method column.', __FILE__);
        $f->notes = __('This significantly increases the size of this panel.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['captainHookToggleDocComment'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        // Request Info Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'requestInfoPanel');
        $fieldset->label = __('Request Info panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'requestInfoPanelSections');
        $f->label = __('Panel sections', __FILE__);
        $f->description = __('Which sections to include in the Request Info panel.', __FILE__);
        $f->columnWidth = 50;
        $f->notes = __('The three "Object" options will significantly increase the size of this panel.', __FILE__);
        foreach(static::$requestInfoSections as $name => $label) {
            $f->addOption($name, $label);
        }
        if($data['requestInfoPanelSections']) $f->attr('value', $data['requestInfoPanelSections']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'imagesInFieldListValues');
        $f->label = __('Show image thumbnails in Field List & Values section', __FILE__);
        $f->description = __('This will load all image thumbnails for the page, along with the dimensions & size details.', __FILE__);
        $f->notes = __('This can significantly increase the size of this panel and rendering time if the page has lots of images.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['imagesInFieldListValues'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        // Debug Mode Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'debugModePanel');
        $fieldset->label = __('Debug Mode panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'debugModePanelSections');
        $f->label = __('Panel sections', __FILE__);
        $f->description = __('Which sections to include in the Debug Mode panel.', __FILE__);
        $f->columnWidth = 50;
        foreach(static::$debugModeSections as $name => $label) {
            $f->addOption($name, $label);
        }
        if($data['debugModePanelSections']) $f->attr('value', $data['debugModePanelSections']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'alwaysShowDebugTools');
        $f->label = __('Show debug mode tools even if $config->debug = false.', __FILE__);
        $f->description = __('If checked, the debug tools will be displayed regardless of whether debug mode is enabled.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['alwaysShowDebugTools'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        // Diagnostics Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'diagnosticsPanel');
        $fieldset->label = __('Diagnostics panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'diagnosticsPanelSections');
        $f->label = __('Panel sections', __FILE__);
        $f->description = __('Which sections to include in the Diagnostics panel.', __FILE__);
        $f->notes = __('The "Filesystem Files" option may significantly increase the generation time for this panel.', __FILE__);
        foreach(static::$diagnosticsSections as $name => $label) {
            $f->addOption($name, $label);
        }
        if($data['diagnosticsPanelSections']) $f->attr('value', $data['diagnosticsPanelSections']);
        $fieldset->add($f);

        // Dumps Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'dumpsPanel');
        $fieldset->label = __('Dumps panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'dumpPanelTabs');
        $f->label = __('Dump Tabs', __FILE__);
        $f->description = __('Select and order the tabs you want when dumping ProcessWire objects via dump/barDump methods.', __FILE__);
        $f->notes = __('The first item will be open by default.', __FILE__);
        foreach(static::$dumpPanelTabs as $name => $label) {
            $f->addOption($name, $label);
        }
        if($data['dumpPanelTabs']) $f->attr('value', $data['dumpPanelTabs']);
        $fieldset->add($f);

        // ToDo Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'todoPanel');
        $fieldset->label = __('TODO panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldTextarea");
        $f->attr('name', 'todoIgnoreDirs');
        $f->label = __('Ignore directories', __FILE__);
        $f->description = __('Comma separated list of terms used to match folders to be ignored when scanning for ToDo items.', __FILE__);
        $f->notes = __('Default: git, svn, images, img, errors, sass-cache, node_modules', __FILE__);
        $f->columnWidth = 50;
        if($data['todoIgnoreDirs']) $f->attr('value', $data['todoIgnoreDirs']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'todoAllowedExtensions');
        $f->label = __('Allowed extensions', __FILE__);
        $f->description = __('Comma separated list file extensions to be scanned for ToDo items.', __FILE__);
        $f->notes = __('Default: php, module, inc, txt, latte, html, htm, md, css, scss, less, js', __FILE__);
        $f->columnWidth = 50;
        if($data['todoAllowedExtensions']) $f->attr('value', $data['todoAllowedExtensions']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'todoScanAssets');
        $f->label = __('Scan site assets', __FILE__);
        $f->description = __('Check to allow the ToDo to scan the /site/assets directory. Otherwise it will only scan /site/templates.', __FILE__);
        $f->notes = __('If you check this, you should add files, logs, cache, sessions and other relevant terms to the `Ignore Directories` field.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['todoScanAssets'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'todoScanModules');
        $f->label = __('Scan site modules', __FILE__);
        $f->description = __('Check to allow the ToDo to scan the /site/modules directory. Otherwise it will only scan /site/templates.', __FILE__);
        $f->notes = __('Not recommended unless you are a regular module developer.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['todoScanModules'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldTextarea");
        $f->attr('name', 'todoSpecifiedDirectories');
        $f->label = __('Specified directories', __FILE__);
        $f->description = __('Line break separated directories to be scanned for ToDo items.', __FILE__);
        $f->notes = __('For example `site/classes` or `site/modules/MyModuleName`', __FILE__);
        if($data['todoSpecifiedDirectories']) $f->attr('value', $data['todoSpecifiedDirectories']);
        $fieldset->add($f);

        // Log & Exceptions Panels
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'logExceptionsPanels');
        $fieldset->label = __('Log and Exceptions panels', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'excludedPwLogFiles');
        $f->label = __('Excluded PW log files', __FILE__);
        $f->description = __('Select log files to be excluded', __FILE__);
        $f->notes = __('Useful if you have logs that are written to regularly on user interaction that are overwhelming more useful alert/warning/error logs.', __FILE__);
        $f->columnWidth = 50;
        $f->setAsmSelectOption('sortable', false);
        foreach($this->wire('log')->getLogs() as $k => $v) {
            $f->addOption($k);
        }
        if($data['excludedPwLogFiles']) $f->attr('value', $data['excludedPwLogFiles']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'excludedTracyLogFiles');
        $f->label = __('Excluded Tracy log files', __FILE__);
        $f->description = __('Select log files to be excluded', __FILE__);
        $f->notes = __('Useful if you have logs that are written to regularly on user interaction that are overwhelming more useful alert/warning/error logs.', __FILE__);
        $f->columnWidth = 50;
        $f->setAsmSelectOption('sortable', false);
        if(!class_exists(TracyLogsPanel::class)) {
            require_once($this->config->paths->siteModules . 'TracyDebugger/panels/TracyLogsPanel.php');
        }
        foreach((new TracyLogsPanel())->getLogs() as $k => $v) {
            $f->addOption($k);
        }
        if($data['excludedTracyLogFiles']) $f->attr('value', $data['excludedTracyLogFiles']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'numLogEntries');
        $f->label = __('Number of log entries', __FILE__);
        $f->description = __('Set the number of log entries to be displayed for the Tracy and ProcessWire log viewer panels.', __FILE__);
        $f->notes = __('Default: 100', __FILE__);
        $f->columnWidth = 50;
        $f->attr('value', $data['numLogEntries']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'numExceptions');
        $f->label = __('Number of exceptions', __FILE__);
        $f->description = __('Set the number of exceptions to be displayed for the Tracy Exceptions panel.', __FILE__);
        $f->notes = __('Default: 25', __FILE__);
        $f->columnWidth = 50;
        $f->attr('value', $data['numExceptions']);
        $fieldset->add($f);

        // Template Resources Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'templateResourcesPanel');
        $fieldset->label = __('Template Resources panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'variablesShowPwObjects');
        $f->label = __('Show content of ProcessWire objects', __FILE__);
        $f->description = __('Shows the full ProcessWire object contents, rather than arrays of values. Only recommended for specific debugging purposes.', __FILE__);
        $f->notes = __('Checking this will significantly increase the size of this panel if you have any variables set to ProcessWire objects.', __FILE__);
        $f->attr('checked', $data['variablesShowPwObjects'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        // Links Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'linksPanel');
        $fieldset->label = __('Links panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldTextarea");
        $f->attr('name', 'linksCode');
        $f->label = __('Links code', __FILE__);
        $f->description = __('One link per line. Optionally add label for link.', __FILE__);
        $f->notes = __('eg. https://www.google.com | Google Search', __FILE__);
        if($data['linksCode']) $f->attr('value', $data['linksCode']);
        $fieldset->add($f);

        // Custom PHP Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'customPhpPanel');
        $fieldset->label = __('Custom PHP panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldTextarea");
        $f->attr('name', 'customPhpCode');
        $f->label = __('Custom PHP code', __FILE__);
        $f->description = __('Use this PHP code block to return any output you want.', __FILE__);
        $f->notes = __('eg. return \'<a href="https://developers.google.com/speed/pagespeed/insights/?url=\'.$page->httpUrl.\'">Google PageSpeed</a>\';', __FILE__);
        if($data['customPhpCode']) $f->attr('value', $data['customPhpCode']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldMarkup");
        $f->attr('name', 'customPhpCodeSave');
        $f->value = '<span class="pw-button-dropdown-wrap"><button id="Inputfield_submit_save_module_copy" class="ui-button ui-widget ui-corner-all pw-button-dropdown-main ui-state-default" name="submit_save_module" value="Submit" type="submit" data-from_id="Inputfield_submit_save_module"><span class="ui-button-text">Submit</span></button><button type="button" id="pw-dropdown-toggle-Inputfield_submit_save_module_copy" class="ui-button ui-widget ui-corner-all ui-button-text-only pw-dropdown-toggle-click pw-dropdown-toggle pw-button-dropdown-toggle ui-state-default" role="button" aria-disabled="false" data-pw-dropdown=".pw-button-dropdown-1" data-from_id="pw-dropdown-toggle-Inputfield_submit_save_module"><span class="ui-button-text"><i class="fa fa-angle-down"></i></span></button></span><br />';
        $f->notes = __('Note: this is just an extra Submit button to make iterations of the customPHP code quicker to make. It works exactly the same as the main ones on this page.', __FILE__);
        $fieldset->add($f);

        // User Switcher Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'userSwitcherPanel');
        $fieldset->label = __('User Switcher panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldMarkup");
        $f->label = __(' ', __FILE__);
        $f->value = '<p>These options can be useful if you use the User system to store frontend "members" and the system has a lot of users.<br />Do not use more than one of the following three options for limiting the list of users.</p>';
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'userSwitcherSelector');
        $f->label = __('Selector', __FILE__);
        $f->description = __('Use this to determine which users will be available.', __FILE__);
        if($data['userSwitcherSelector']) $f->attr('value', $data['userSwitcherSelector']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'userSwitcherRestricted');
        $f->label = __('Excluded Roles', __FILE__);
        $f->description = __('Users with selected roles will not be available from the list of users to switch to.', __FILE__);
        $f->columnWidth = 50;
        $f->setAsmSelectOption('sortable', false);
        foreach($this->wire('roles') as $role) {
            $f->addOption($role->id, $role->name);
        }
        if($data['userSwitcherRestricted']) $f->attr('value', $data['userSwitcherRestricted']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'userSwitcherIncluded');
        $f->label = __('Included Roles', __FILE__);
        $f->description = __('Only users with these selected roles will be available from the list of users to switch to. If none selected, then all will be available unless the excluded roles is populated.', __FILE__);
        $f->columnWidth = 50;
        $f->setAsmSelectOption('sortable', false);
        foreach($this->wire('roles') as $role) {
            $f->addOption($role->id, $role->name);
        }
        if($data['userSwitcherIncluded']) $f->attr('value', $data['userSwitcherIncluded']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'userSwitcherUserLabel');
        $f->label = __('User label field', __FILE__);
        $f->description = __('Use this to determine which user field(s) will be used to identify users in the selection interace.', __FILE__);
        $f->notes = __('Default: `{name} ({email})`', __FILE__);
        if($data['userSwitcherUserLabel']) $f->attr('value', $data['userSwitcherUserLabel']);
        $fieldset->add($f);

        // requestLogger Panel
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'requestLoggerPanel');
        $fieldset->label = __('Request Logger panel', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'requestMethods');
        $f->label = __('Request methods', __FILE__);
        $f->description = __('Which request methods to log.', __FILE__);
        $f->notes = __('It may be useful to disable GET so that normal page visits are ignored.', __FILE__);
        $f->addOption('GET');
        $f->addOption('POST');
        $f->addOption('PUT');
        $f->addOption('DELETE');
        $f->addOption('PATCH');
        $f->columnWidth = 33;
        if($data['requestMethods']) $f->attr('value', $data['requestMethods']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldInteger");
        $f->attr('name', 'requestLoggerMaxLogs');
        $f->label = __('Maximum number of logged requests', __FILE__);
        $f->description = __('Number of requests to be kept for each page.', __FILE__);
        $f->columnWidth = 34;
        $f->attr('value', $data['requestLoggerMaxLogs']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldRadios");
        $f->attr('name', 'requestLoggerReturnType');
        $f->label = __('Output type', __FILE__);
        $f->description = __('This determines whether the logged data is returned as an object or an array.', __FILE__);
        $f->addOption('array', 'Array');
        $f->addOption('object', 'Object');
        $f->columnWidth = 33;
        if($data['requestLoggerReturnType']) $f->attr('value', $data['requestLoggerReturnType']);
        $fieldset->add($f);

        // Server Type Indicator
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'serverTypeIndicator');
        $fieldset->label = __('Server type indicator', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'styleWhere');
        $f->label = __('Where', __FILE__);
        $f->description = __('Add indicator based on server IP address and/or subdomain.', __FILE__);
        $f->columnWidth = 30;
        $f->addOption('backend', 'Backend');
        $f->addOption('frontend', 'Frontend');
        if($data['styleWhere']) $f->attr('value', $data['styleWhere']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldTextarea");
        $f->attr('name', 'styleAdminColors');
        $f->label = __('Indicator colors', __FILE__);
        $f->showIf = "styleWhere.count>0";
        $f->description = __('Use "type|#color" entries to define indicator styling for each server type. "local" is determined by IP address. Other types are detected based on their existence in subdomain or TLD (eg. dev.mysite.com or mysite.dev), dependant on whether you include the period after (dev.﹡) or before (﹡.dev).', __FILE__);
        $f->notes = __("**DEFAULT**\nlocal|#FF9933\n*.local|#FF9933\ndev.*|#FF9933\n*.test|#FF9933\nstaging.*|#8b0066\n*.com|#009900", __FILE__);
        $f->columnWidth = 70;
        if($data['styleAdminColors']) $f->attr('value', $data['styleAdminColors']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'styleAdminType');
        $f->label = __('Indicator type', __FILE__);
        $f->showIf = "styleWhere.count>0";
        $f->description = __('Choose custom if you want complete control', __FILE__);
        $f->notes = __('You will need to do a hard reload in your browser for these changes to take effect.', __FILE__);
        $f->addOption('default', 'Indicator on debug bar');
        $f->addOption('custom', 'Custom - control with CSS');
        $f->addOption('titlePrefix', 'Add prefix page title');
        $f->addOption('favicon', 'Favicon badge');
        $f->columnWidth = 30;
        if($data['styleAdminType']) $f->attr('value', $data['styleAdminType']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldTextarea");
        $f->attr('name', 'styleAdminElements');
        $f->label = __('Custom indicator CSS', __FILE__);
        $f->showIf = "styleWhere.count>0, styleAdminType='custom'";
        $f->description = __('Use [color] and [type] shortcodes to add indicator based on server type.', __FILE__);
        $f->notes = __("**DEFAULT**\nbody::before {\n&nbsp;&nbsp;&nbsp;&nbsp;content: \"[type]\";\n&nbsp;&nbsp;&nbsp;&nbsp;background: [color];\n&nbsp;&nbsp;&nbsp;&nbsp;position: fixed;\n&nbsp;&nbsp;&nbsp;&nbsp;left: 0;\n&nbsp;&nbsp;&nbsp;&nbsp;bottom: 100%;\n&nbsp;&nbsp;&nbsp;&nbsp;color: #ffffff;\n&nbsp;&nbsp;&nbsp;&nbsp;width: 100vh;\n&nbsp;&nbsp;&nbsp;&nbsp;padding: 0;\n&nbsp;&nbsp;&nbsp;&nbsp;text-align: center;\n&nbsp;&nbsp;&nbsp;&nbsp;font-family: sans-serif;\n&nbsp;&nbsp;&nbsp;&nbsp;font-weight: 600;\n&nbsp;&nbsp;&nbsp;&nbsp;text-transform: uppercase;\n&nbsp;&nbsp;&nbsp;&nbsp;transform: rotate(90deg);\n&nbsp;&nbsp;&nbsp;&nbsp;transform-origin: bottom left;\n&nbsp;&nbsp;&nbsp;&nbsp;z-index: 999999;\n&nbsp;&nbsp;&nbsp;&nbsp;font-family: sans-serif;\n&nbsp;&nbsp;&nbsp;&nbsp;font-size: 11px;\n&nbsp;&nbsp;&nbsp;&nbsp;height: 13px;\n&nbsp;&nbsp;&nbsp;&nbsp;line-height: 13px;\n&nbsp;&nbsp;&nbsp;&nbsp;pointer-events: none;\n}\n", __FILE__);
        $f->columnWidth = 70;
        if($data['styleAdminElements']) $f->attr('value', $data['styleAdminElements']);
        $fieldset->add($f);

        // User DEV Template
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'userDevTemplate');
        $fieldset->label = __('User dev template', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'userDevTemplate');
        $f->label = __('Enable user dev template', __FILE__);
        $f->description = __('If user has a permission named to match the page template with the set suffix, the page will be rendered with that template file rather than the default.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['userDevTemplate'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'userDevTemplateSuffix');
        $f->label = __('User dev template suffix', __FILE__);
        $f->description = __('Template file suffix. eg "dev" will render the homepage with the "home-dev.php" template file if the user has a matching permission (prefixed with "tracy"), eg. `tracy-home-dev`. You can also use `tracy-all-dev` to enable for all templates if the files exist.', __FILE__);
        $f->columnWidth = 50;
        if($data['userDevTemplateSuffix']) $f->attr('value', $data['userDevTemplateSuffix']);
        $fieldset->add($f);

        // User Bar
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'userBar');
        $fieldset->label = __('User Bar', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'showUserBar');
        $f->label = __('Show user bar', __FILE__);
        $f->description = __('This bar is shown to logged in users without permission for the Tracy debug bar (typically all non-superusers).', __FILE__);
        $f->columnWidth = 33;
        $f->attr('checked', $data['showUserBar'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'showUserBarTracyUsers');
        $f->label = __('Show user bar for Tracy users', __FILE__);
        $f->showIf = "showUserBar=1";
        $f->description = __('Also show the bar to users with Tracy debug bar permission.', __FILE__);
        $f->notes = __('Be sure to position this bar somewhere other than bottom right so it doesn\'t conflict with the debug bar.', __FILE__);
        $f->columnWidth = 34;
        $f->showIf = "showUserBar=1";
        $f->attr('checked', $data['showUserBarTracyUsers'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldAsmSelect");
        $f->attr('name', 'userBarFeatures');
        $f->label = __('Features', __FILE__);
        $f->showIf = "showUserBar=1";
        $f->description = __('Determines which features are shown on the User Bar.', __FILE__);
        $f->notes = __('The Page Versions function requires that the user has the `tracy-page-versions` permission.', __FILE__);
        $f->columnWidth = 33;
        foreach(static::$userBarFeatures as $name => $label) {
            $f->addOption($name, $label);
        }
        if($data['userBarFeatures']) $f->attr('value', $data['userBarFeatures']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldTextarea");
        $f->attr('name', 'userBarCustomFeatures');
        $f->label = __('Custom features', __FILE__);
        $f->showIf = "showUserBar=1";
        $f->description = __('Use this PHP code block to return any output you want.', __FILE__);
        $f->notes = __('eg. return \'<a href="https://developers.google.com/speed/pagespeed/insights/?url=\'.$page->httpUrl.\'" target="_blank"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" x="0px" y="0px" viewBox="0 0 452.555 452.555" style="enable-background:new 0 0 452.555 452.555;" xml:space="preserve" width="16px" height="16px"><path d="M404.927,209.431h47.175c-3.581-49.699-23.038-94.933-53.539-130.611l-33.715,33.715l-23.275-23.296l33.758-33.78     C339.826,24.353,294.527,4.206,244.591,0.194v48.923h-32.917V0C161.22,3.236,115.296,22.8,79.165,53.668l35.57,35.549     l-23.296,23.296L55.804,76.878C24.332,112.858,4.12,158.804,0.475,209.452h50.864v32.917H0.453     C8.93,359.801,106.646,452.555,226.256,452.555s217.347-92.754,225.846-210.186h-47.197L404.927,209.431L404.927,209.431z      M228.133,362.217c-24.116,0-43.659-19.522-43.659-43.681c0-17.839,10.742-33.176,26.144-39.928l16.394-151.707l4.034,0.043     l14.927,151.729c15.229,6.881,25.863,22.045,25.863,39.863C271.857,342.695,252.27,362.217,228.133,362.217z" fill="\'.$iconColor.\'"/></svg></a>\';', __FILE__);
        if($data['userBarCustomFeatures']) $f->attr('value', $data['userBarCustomFeatures']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldSelect");
        $f->attr('name', 'userBarTopBottom');
        $f->label = __('Top / Bottom', __FILE__);
        $f->showIf = "showUserBar=1";
        $f->columnWidth = 50;
        $f->addOption('top', 'Top');
        $f->addOption('bottom', 'Bottom');
        if($data['userBarTopBottom']) $f->attr('value', $data['userBarTopBottom']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldSelect");
        $f->attr('name', 'userBarLeftRight');
        $f->label = __('Left / Right', __FILE__);
        $f->showIf = "showUserBar=1";
        $f->columnWidth = 50;
        $f->addOption('left', 'Left');
        $f->addOption('right', 'Right');
        if($data['userBarLeftRight']) $f->attr('value', $data['userBarLeftRight']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'userBarBackgroundColor');
        $f->label = __('Background color', __FILE__);
        $f->showIf = "showUserBar=1";
        $f->description = __('Leave blank for transparent/none', __FILE__);
        $f->notes = __('eg. #FFFFFF', __FILE__);
        $f->columnWidth = 33;
        if($data['userBarBackgroundColor']) $f->attr('value', $data['userBarBackgroundColor']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'userBarBackgroundOpacity');
        $f->label = __('Background opacity', __FILE__);
        $f->showIf = "showUserBar=1";
        $f->notes = __('0 to 1', __FILE__);
        $f->columnWidth = 34;
        if($data['userBarBackgroundOpacity']) $f->attr('value', $data['userBarBackgroundOpacity']);
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldText");
        $f->attr('name', 'userBarIconColor');
        $f->label = __('Icon color', __FILE__);
        $f->showIf = "showUserBar=1";
        $f->notes = __('eg. #666666', __FILE__);
        $f->columnWidth = 33;
        if($data['userBarIconColor']) $f->attr('value', $data['userBarIconColor']);
        $fieldset->add($f);

        // Method Shortcuts
        $fieldset = $this->wire('modules')->get("InputfieldFieldset");
        $fieldset->attr('name+id', 'methodShortcuts');
        $fieldset->label = __('Method shortcuts', __FILE__);
        $wrapper->add($fieldset);

        $f = $this->wire('modules')->get("InputfieldCheckbox");
        $f->attr('name', 'enableShortcutMethods');
        $f->label = __('Enable shortcut methods', __FILE__);
        $f->description = __('Uncheck to not define any of the shortcut methods. If you are not going to use these in your templates, unchecking means that they will not be defined which may reduce possible future name clashes. If in doubt, uncheck and use the full methods:'."\n".'TD::addBreakpoint()'."\n".'TD::barDump()'."\n".'TD::barDumpBig()'."\n".'TD::debugAll()'."\n".'TD::dump()'."\n".'TD::dumpBig()'."\n".'TD::log()'."\n".'TD::templateVars()'."\n".'TD::timer()', __FILE__);
        $f->notes = __('If this, or one of the shortcut methods is not enabled, but is called in your templates, all users will get a "call to undefined function" fatal error, so please be aware when using the shortcut methods in your templates if they are not enabled here.', __FILE__);
        $f->columnWidth = 50;
        $f->attr('checked', $data['enableShortcutMethods'] == '1' ? 'checked' : '');
        $fieldset->add($f);

        $f = $this->wire('modules')->get("InputfieldCheckboxes");
        $f->attr('name', 'enabledShortcutMethods');
        $f->label = __('Enabled shortcuts', __FILE__);
        $f->description = __('Uncheck any shortcuts/aliases to methods that you do not want available.', __FILE__);
        $f->notes = __('Useful if any of these functions/methods are defined elswhere in your site and you are getting a "previously declared" fatal error.', __FILE__);
        $f->showIf = "enableShortcutMethods=1";
        $f->columnWidth = 50;
        $f->addOption('addBreakpoint', 'addBreakpoint() for TD::addBreakpoint()');
        $f->addOption('bp', 'bp() for TD::addBreakpoint()');
        $f->addOption('barDump', 'barDump() for TD::barDump()');
        $f->addOption('bd', 'bd() for TD::barDump()');
        $f->addOption('barEcho', 'barEcho() for TD::barEcho()');
        $f->addOption('be', 'be() for TD::barEcho()');
        $f->addOption('barDumpBig', 'barDumpBig() for TD::barDumpBig()');
        $f->addOption('bdb', 'bdb() for TD::barDumpBig()');
        $f->addOption('debugAll', 'debugAll() for TD::debugAll()');
        $f->addOption('da', 'da() for TD::debugAll()');
        $f->addOption('dump', 'dump() for TD::dump()');
        $f->addOption('d', 'd() for TD::dump()');
        $f->addOption('dumpBig', 'dumpBig() for TD::dumpBig()');
        $f->addOption('db', 'db() for TD::dumpBig()');
        $f->addOption('l', 'l() for TD::log()');
        $f->addOption('templateVars', 'templateVars() for TD::templateVars()');
        $f->addOption('tv', 'tv() for TD::templateVars()');
        $f->addOption('timer', 'timer() for TD::timer()');
        $f->addOption('t', 't() for TD::timer()');
        if($data['enabledShortcutMethods']) $f->attr('value', $data['enabledShortcutMethods']);
        $fieldset->add($f);


        // core calls Modules::saveConfig() and no longer calls the deprecated saveModuleConfigData()
        // alias, so hook saveConfig() which is reached regardless of which method the caller used
        // fallback to saveModuleConfigData() for PW < 3.0.16 when saveConfig() did not exist
        $saveConfigMethod = method_exists($this->wire('modules'), '___saveConfig') ? 'saveConfig' : 'saveModuleConfigData';

        $this->wire('modules')->addHookBefore($saveConfigMethod, null, function($event) {

            if($event->arguments[0] !== 'TracyDebugger') return;
            // saveConfig() also supports saving a single property: saveConfig($class, $property, $value)
            if(!is_array($event->arguments[1])) return;
            if(!$this->wire('input')->post->customPWInfoPanelLinks[0] && $this->wire('input')->post->linksCode == '') return;

            $data = $event->arguments[1];

            // convert PW Info panel custom links page IDs into paths so we can export settings to another PW site
            $customPWInfoPanelLinkPaths = array();
            $customPWInfoPanelLinks = $this->wire('input')->post->customPWInfoPanelLinks;
            if(method_exists($this->wire('pages'), 'getPath') && version_compare($this->wire('config')->version, '3.0.73', '>=')) {
                foreach(explode(',',$customPWInfoPanelLinks[0]) as $pid) {
                    array_push($customPWInfoPanelLinkPaths, $this->wire('pages')->getPath($pid));
                }
            }
            // fallback for PW < 3.0.6 when getPath method did not exist
            else {
                foreach(explode(',',$customPWInfoPanelLinks[0]) as $pid) {
                    array_push($customPWInfoPanelLinkPaths, $this->wire('pages')->get($pid)->path);
                }
            }
            $data['customPWInfoPanelLinks'] = $customPWInfoPanelLinkPaths;

            // links panel link conversion
	        $existingConfig = $this->wire('modules')->getModuleConfigData($this);
	        $existingLinks = isset($existingConfig['linksCode']) ? $existingConfig['linksCode'] : '';
	        $savedLinks = isset($data['linksCode']) ? $data['linksCode'] : '';
	        if($savedLinks !== $existingLinks) {
		        // make URLs in links panel root relative and get titles if not supplied
		        $allLinks = array();
		        foreach(explode("\n", $savedLinks) as $link) {
			        $finalLink = $this->prepLink($link);
			        $allLinks[] = $finalLink;
		        }
		        $data['linksCode'] = implode("\n", $allLinks);
	        }

            $event->arguments(1, $data);
        });

        $this->wire('modules')->addHookAfter($saveConfigMethod, null, function($event) {
            if($event->arguments[0] !== 'TracyDebugger') return;
            if(!is_array($event->arguments[1])) return;
            $data = $event->arguments[1];

            // if custom php panel code was changed, then scroll down to that setting field after saving
            if($data['customPhpCode'] != $this->data['customPhpCode']) $this->wire('session')->scrolltoCustomPhp = 1;

            // if certain settings are changed we need to delete the cached copy
            $changedSettings = array(
                'TracyApiData.*' => array(
                    'codeShowDescription',
                    'apiExplorerShowDescription',
                    'apiExplorerToggleDocComment',
                    'apiExplorerModuleClasses',
                    'captainHookShowDescription',
                    'captainHookToggleDocComment'
                )
            );
            foreach($changedSettings as $cache => $settings) {
                $deleteCache = false;
                foreach($settings as $setting) {
                    if($data[$setting] != $this->data[$setting]) {
                        $deleteCache = true;
                        break;
                    }
                }
                if($deleteCache) $this->deleteCache($cache);
            }

        });

        foreach(static::$externalPanels as $name => $path) {
            $className = ucfirst($name) . 'Panel';
            $fullClassName = __NAMESPACE__ . '\\' . $className;
            if(!class_exists($fullClassName)) {
                include_once $path;
                // namespace migration: bridge old non-namespaced external panel class
                if(!class_exists($fullClassName, false) && class_exists($className, false)) {
                    class_alias($className, $fullClassName);
                }
            }
            $externalPanel = new $fullClassName;
            if(method_exists($externalPanel, 'addSettings')) {
                $externalPanelSettings = $externalPanel->addSettings();
                $wrapper->add($externalPanelSettings);
            }
        }

        return $wrapper;

    }


    public function ___upgrade($fromVersion, $toVersion) {

        // move old snippets from Tracy module settings DB table to filesystem
        if(isset($this->data['snippets'])) {
            $snippetsPath = $this->wire('config')->paths->site.$this->data['snippetsPath'].'/TracyDebugger/snippets/';
            if(!file_exists($snippetsPath)) wireMkdir($snippetsPath, true);
            foreach(json_decode($this->data['snippets']) as $snippet) {
                $this->wire('files')->filePutContents($snippetsPath.$snippet->name.'.php', urldecode($snippet->code));
                touch($snippetsPath.$snippet->name.'.php', substr($snippet->modified, 0, -3));
            }
            $configData = $this->wire('modules')->getModuleConfigData("TracyDebugger");
            unset($configData['snippets']);
            $this->wire('modules')->saveModuleConfigData($this, $configData);
        }

        // make sure the ProcessTracyAdminerRenderer module is installed
        if($this->wire('modules')->isInstalled('ProcessTracyAdminer') && !$this->wire('modules')->isInstalled('ProcessTracyAdminerRenderer')) {
            $this->wire('modules')->install('ProcessTracyAdminerRenderer');
        }

        // the old default Gemini model has been shut down by Google, so move sites still on it to the new default
        $configData = $this->wire('modules')->getModuleConfigData("TracyDebugger");
        if(isset($configData['adminerGeminiModel']) && $configData['adminerGeminiModel'] === 'gemini-2.5-flash') {
            $configData['adminerGeminiModel'] = 'gemini-3.1-flash-lite';
            $this->data['adminerGeminiModel'] = 'gemini-3.1-flash-lite';
            $this->wire('modules')->saveModuleConfigData($this, $configData);
        }

        // initial save of default data so it's available to Adminer in case settings aren't manually saved
        $data = wire('modules')->getModuleConfigData('TracyDebugger');
        if(!isset($data['adminerThemeColor'])) {
            $this->wire('modules')->saveModuleConfigData($this, $this->data);
        }
    }


    public function ___install() {
        // initial save of default data so it's available to Adminer in case settings aren't manually saved
        $data = wire('modules')->getModuleConfigData('TracyDebugger');
        if(!isset($data['adminerThemeColor'])) {
            $installData = $this->data;
            // convert customPWInfoPanelLinks default IDs to paths so JSON stores the export-portable form from the outset
            if(!empty($installData['customPWInfoPanelLinks']) && is_array($installData['customPWInfoPanelLinks'])) {
                $paths = array();
                foreach($installData['customPWInfoPanelLinks'] as $id) {
                    if(!is_int($id) && !ctype_digit((string) $id)) {
                        $paths[] = $id;
                        continue;
                    }
                    if(method_exists($this->wire('pages'), 'getPath') && version_compare($this->wire('config')->version, '3.0.73', '>=')) {
                        $paths[] = $this->wire('pages')->getPath((int) $id);
                    }
                    else {
                        $paths[] = $this->wire('pages')->get((int) $id)->path;
                    }
                }
                $installData['customPWInfoPanelLinks'] = $paths;
            }
            $this->wire('modules')->saveModuleConfigData($this, $installData);
        }
    }

}