// ----------------------------------------------------------------- // 2️⃣ Helper: inject CSS into the document head. // ----------------------------------------------------------------- const injectStyle = (css) => const styleEl = document.createElement('style'); styleEl.textContent = css; document.head.appendChild(styleEl); ;

// UI elements – each entry becomes a button. // `action` can be a string (function name) or a direct function. items: [ label: '🔧 Reload Config', tooltip: 'Pull fresh config from the server', action: () => fetchConfig() , label: '🗑️ Clear Cache', tooltip: 'Empty localStorage & sessionStorage', action: () => localStorage.clear(); sessionStorage.clear(); alert('Cache cleared'); , { label: '⚙️ Debug Mode', tooltip: 'Toggle console.debug output', toggle: true, stateKey: 'debugMode', // saved in localStorage action: (newState) => { console.debug = newState ? console.log : () => {}; localStorage.setItem('debugMode', newState); } } ] };

<script src="/js/hd-admin-inserter.js"></script> If you are using a bundler, import '/js/hd-admin-inserter.js'; works just as well. 5.2. Ensure the user role is exposed The default visibilityFn looks for window.currentUser.role . Add something like:

// Append to the chosen mount point. const mountEl = document.querySelector(cfg.mountPoint); if (!mountEl) console.error('HD Admin Inserter: mount point not found:', cfg.mountPoint); return; mountEl.appendChild(toolbar); ;

| Feature | Description | |---------|-------------| | | Adds a pre‑styled admin toolbar (buttons, toggles, status lights) to any page at runtime. | | Role‑based visibility | Shows the toolbar only to users whose session token matches a whitelist (e.g., admin , superuser ). | | Config‑driven | All labels, icons, and callbacks are defined in a simple JSON object, making it easy to extend without touching the core script. | | Zero‑dependency | Pure vanilla JS (no jQuery, React, etc.) – perfect for legacy dashboards or micro‑frontends. | | Pastebin‑friendly | Designed to be copy‑pasted into a <script> tag or imported as an external file from a raw Pastebin link. |

// ----------------------------------------------------------------- // 3️⃣ Helper: create a button element from an item definition. // ----------------------------------------------------------------- const createButton = (item) => ;

// ----------------------------------------------------------------- // 4️⃣ Core: build and mount the toolbar. // ----------------------------------------------------------------- const mountToolbar = (config = {}) => const cfg = ...DEFAULT_CONFIG, ...config ;

// Build container. const toolbar = document.createElement('div'); toolbar.id = 'hd-admin-toolbar';