Install
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
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 + Bby 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
- Download the plugin ZIP file
- Go to Plugins → Add New → Upload Plugin
- Choose the downloaded ZIP file and click Install Now
- Click Activate Plugin
Manual Installation
- Upload the
rebarfolder to/wp-content/plugins/ - 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:
- On the
wphook, Rebar checksis_admin_bar_showing()— the same logic core uses — so its visibility matches the native bar exactly. - It removes the native bar's render callbacks and the 32px page offset, and dequeues the
admin-barCSS/JS. It does not disable the toolbar object itself, so every node other plugins register is preserved. - At
wp_footerit re-firesadmin_bar_menuand 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. - 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_menuare 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
- Website: angelcruz.dev
- GitHub: @abr4xas
🙏 Acknowledgments
- The Next.js dev indicator, for the interaction inspiration
- The WordPress community
Made with ❤️ by Angel Cruz