WP Manifestindependent plugin directory
manifest / admin / rebar

Rebar

Replaces the WordPress admin toolbar on the frontend with an organized floating panel, inspired by the Next.js dev indicator.

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/abr4xas/rebar/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
rebar

Rebar

A calmer toolbar for the front end of your site. Rebar hides WordPress's native admin bar on the front end and replaces it with a tidy floating panel — inspired by the Next.js dev indicator, but built for everyone who logs in: owners, editors, shop managers, and developers alike. 🧰

🎯 Overview

The default WordPress toolbar stretches across the top of every front-end page and dumps every link — core and third-party — into one flat, ever-growing strip. Rebar takes that same information and reorganizes it into a small floating button in the bottom-left corner that opens a clean, drill-down panel.

Nothing is hardcoded: Rebar reads the live admin-bar node tree, so it always shows exactly what WordPress core and your active plugins register — just organized into friendly groups instead of a cluttered bar. wp-admin is left completely untouched.

✨ Key Features

  • 🎈 Floating panel, not a bar — a small button (FAB) in the corner opens a focused, drill-down panel. No more toolbar covering your header.
  • 🗂️ Curated groups — core items are sorted into friendly sections: Site, New, This page, Activity, and Account.
  • 🔌 Automatic "Plugins" drawer — anything a third-party plugin adds to the toolbar is collected into a tidy drawer, never lost.
  • 🪞 Reflects the real toolbar — reads the live node tree, so it mirrors exactly what core and your plugins register.
  • 🎨 Matches your color scheme — adapts to each user's WordPress admin color scheme automatically.
  • 👤 Account card — shows the signed-in user's avatar beside their name.
  • 🔢 Readable status — count items show the full phrase (e.g. "3 Comments in moderation"), and a badge on the button surfaces things that need attention.
  • 🧩 Handles plugin widgets — toggles and controls that plugins inject into the toolbar (like an ON/OFF switch) stay clickable and legible, with clear on/off coloring.
  • ⌨️ Keyboard friendly — toggle with a shortcut (Shift + B by default), remembers its open state, and is fully accessible (Esc to close, focus trap, respects reduced motion).
  • 🔒 Same visibility as core — honors login state and the per-user "Show Toolbar when viewing site" preference.
  • ⚙️ Zero configuration — activate it and it works. Developer filters are there when you want them.

📋 Requirements

  • WordPress 7.0 or higher
  • PHP 8.1 or higher

🚀 Installation

Via WordPress Admin

  1. Download the plugin ZIP file
  2. Go to Plugins → Add New → Upload Plugin
  3. Choose the downloaded ZIP file and click Install Now
  4. Click Activate Plugin

Manual Installation

  1. Upload the rebar folder to /wp-content/plugins/
  2. Activate the plugin through the Plugins menu in WordPress

That's it. There is nothing to configure — visit any front-end page while logged in and you'll see the floating button in the bottom-left corner.

🧭 How It Works

Rebar never invents links. It lets WordPress build its normal toolbar data, suppresses only the native rendering, and draws its own panel from the captured node tree.

sequenceDiagram
    participant WP as WordPress
    participant R as Rebar
    participant U as User
    WP->>R: Toolbar data is built ($wp_admin_bar)
    R->>R: Suppress native render + dequeue its assets
    R->>WP: Re-fire admin_bar_menu (so plugins still register)
    WP-->>R: Full node tree
    R->>R: Sort nodes into groups + Plugins drawer
    R->>U: Render floating button & drill-down panel
    U->>R: Click button → open panel → drill into a group

Under the hood:

  1. On the wp hook, Rebar checks is_admin_bar_showing() — the same logic core uses — so its visibility matches the native bar exactly.
  2. It removes the native bar's render callbacks and the 32px page offset, and dequeues the admin-bar CSS/JS. It does not disable the toolbar object itself, so every node other plugins register is preserved.
  3. At wp_footer it re-fires admin_bar_menu and friends, reads the node tree, sorts it into curated groups (by known core IDs) plus a flat "Plugins" drawer for everything else, and renders the panel.
  4. A small vanilla-JS layer toggles the window, navigates panels, traps focus, wires the shortcut, and remembers the open state in localStorage.

🧱 The Panel

Section What it contains
Site Site name, Customize, Site Editor
New The "New content" menu (posts, pages, media…)
This page Edit / view links for whatever you're currently viewing
Activity Comments awaiting moderation, and available updates (when there are any)
Plugins Everything third-party plugins add to the toolbar
Account Avatar, profile link, and log out — pinned to the footer

A search box sits at the top of the panel, and a badge on the floating button flags items that need attention.

🛠️ Developer Filters

Rebar is zero-config, but fully customizable:

Filter Type Purpose
rebar_should_show bool Take over (or bail out of) the current request.
rebar_curated_layout array Redefine the curated groups and which core nodes feed them.
rebar_account_node string Node ID used for the account footer.
rebar_ignored_ids array Node IDs to drop entirely.
rebar_badge_count int The value shown on the floating button's badge.
rebar_palette array Override the resolved color palette.
rebar_keyboard_shortcut array Change the toggle shortcut (key + modifiers).
rebar_show_search bool Show or hide the search box.

Example — change the toggle shortcut to Alt + T:

add_filter( 'rebar_keyboard_shortcut', function ( $shortcut ) {
    return array(
        'key'      => 'T',
        'shiftKey' => false,
        'altKey'   => true,
        'ctrlKey'  => false,
        'metaKey'  => false,
    );
} );

Example — only show Rebar to administrators:

add_filter( 'rebar_should_show', function ( $show ) {
    return $show && current_user_can( 'manage_options' );
} );

Example — drop a noisy third-party node:

add_filter( 'rebar_ignored_ids', function ( $ids ) {
    $ids[] = 'some-plugin-node-id';
    return $ids;
} );

🗂️ Project Structure

rebar/
├── assets/
│   ├── css/
│   │   └── rebar.css
│   └── js/
│       └── rebar.js
├── includes/
│   ├── class-rebar.php            # Orchestrator: decides to take over, suppresses native bar, renders
│   ├── class-rebar-nodes.php      # Builds the structured tree from the flat node map
│   ├── class-rebar-layout.php     # Maps core node IDs → curated groups
│   ├── class-rebar-colors.php     # Admin color scheme → CSS variables
│   └── class-rebar-renderer.php   # Emits the floating button and drill-down panels
├── languages/
│   └── rebar.pot
├── rebar.php                      # Plugin bootstrap
├── README.md
└── readme.txt

🔒 Security & Output

Every link, nonce, and title Rebar renders is passed through the appropriate escaping function (esc_url, esc_attr, wp_kses_post). Media that plugins inject into their toolbar titles (images, inline SVGs, icon glyphs) is stripped at the source, so a third-party icon can never render oversized or break the layout.

📝 Changelog

1.0.5

  • 🧩 Scripts and styles other plugins enqueue from admin_bar_menu are printed again (the panel now renders before the footer scripts).
  • 🎯 Clicking outside the panel no longer moves focus to the floating button, and restoring the open state on page load no longer steals focus.
  • 📝 Plugin widgets keep their form controls (inputs, selects, textareas).
  • 🔗 Parent nodes with their own link keep it as the first row of their sub-panel.
  • 📏 The native bar's <html> margin is removed reliably, including theme-provided callbacks.
  • 🏷️ Links honor the node's meta (class, tabindex, lang, dir, onclick, html) like the native bar.
  • 🔔 The badge also counts available updates.
  • ♿ Dropped the incomplete menu roles; the panel is a modal dialog.
  • 🖼️ Nested icon spans in node titles no longer break the row label.
  • 🌐 The saved panel state is stored per site on multisite.

1.0.4

  • 📖 Added a detailed README.md — overview, how it works, developer filters, project structure, and FAQ.

1.0.3

  • 🧩 Node titles carrying a plugin's own control (e.g. an ON/OFF toggle) now render as a self-contained, clickable widget row instead of a broken, unstyled link.
  • 🟢 On/off state toggles are colored — green when on, red when off — so the current state is obvious even without the plugin's own script.
  • 🖼️ Media injected into a toolbar node title (images, inline SVGs, icon-glyph wrappers) is stripped at the source, so third-party icons no longer render oversized.
  • 👤 The Account panel now shows the signed-in user's avatar beside their name (profile card).
  • 🔢 Count rows (Activity → comments, updates) show the full phrase (e.g. "0 Comments in moderation") instead of just a bare number.
  • 🛡️ Hardened output escaping across the renderer and removed the discouraged manual textdomain load.

1.0.0

  • ✨ Initial release.

❓ FAQ

Does this affect wp-admin?

No. Rebar only touches the front end. The dashboard toolbar is completely untouched.

Will I lose the links my other plugins add to the toolbar?

No. Anything a plugin registers on the toolbar is collected automatically into the Plugins drawer, so nothing disappears.

Why don't I see plugin X in the panel?

Because plugin X doesn't add anything to the front-end toolbar. Rebar only shows what's actually there — many plugins (WooCommerce included) register their toolbar items only inside wp-admin, or not at all.

Who can see the panel?

The same people who'd see the native toolbar: logged-in users, subject to the per-user "Show Toolbar when viewing site" preference. Rebar honors is_admin_bar_showing() exactly.

Can I change the keyboard shortcut?

Yes — use the rebar_keyboard_shortcut filter (see above). The default is Shift + B.

Is it accessible?

Yes. The panel closes on Esc, traps focus while open, exposes proper roles/labels, includes screen-reader text, and respects prefers-reduced-motion.

📄 License

This plugin is licensed under the GPLv2 or later.

Copyright (C) 2026 Angel Cruz

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

👨‍💻 Author

Angel Cruz — @abr4xas

🙏 Acknowledgments

  • The Next.js dev indicator, for the interaction inspiration
  • The WordPress community

Made with ❤️ by Angel Cruz