=== Bricks Navigator === Contributors: srikat Tags: bricks, bricks builder, admin bar Donate link: https://www.paypal.me/sridharkatakam Requires at least: 6.0 Tested up to: 6.9.4 Stable tag: 1.1.8 Requires PHP: 8.0 License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html Adds quick links in the WordPress admin bar for users of Bricks theme. == Description == === Main function === This plugin adds a handy "Bricks" menu item in the WP admin bar for directly editing Pages and Templates with Bricks, as well as quickly navigating to various areas within the site and external sites relevant for the users of [Bricks Builder theme](https://bricksbuilder.io/). A very useful feature is being able to directly view the list of all Templates and Pages and edit any of them with Bricks directly with a single click without going to Templates and Pages list screens first. The admin bar can also be enabled in Bricks editor pages via the plugin's settings page at Bricks → Bricks Navigator. Links to Bricks-specific plugins' settings page are also provided. Links to community sites, internal and external Bricks links can be enabled in the plugin's settings page. A "new tab" icon is provided for site-specific menu items added by the plugin to open that menu item in a new tab. All external links open in a new tab. Built for the Bricks community by Sridhar Katakam of [BricksLabs](https://brickslabs.com/). Performance Notice: The free version loads all templates and pages in the menu and works best for smaller sites (up to ~20 templates and ~50 pages). For larger sites with extensive content, consider upgrading to our upcoming Pro version for better performance. Note that this only applies for admins and other logged-in users for whom the WP toolbar shows. === Auto-select Class === Provides a checkbox so that when an element with a CSS class is selected in the editor, the first unlocked class in the classes panel is automatically activated. === CSS Editor (Beta) === An inline collapsible CSS editor panel in the Bricks element panel with two-way binding between CSS and controls. Editable CSS maps back to layout controls; unmappable properties are stored in the element's Custom CSS field. === BEM Classes (Beta) === A BEM class action on each structure panel layer to assign global classes in BEM format with a checkbox to move ID styles to the class. === CSS Variables Context Menu (Beta) === Right-click any CSS value input in the Bricks editor to insert a CSS variable from your registered custom properties - with live preview on hover. === Class Tooltip (Beta) === Hold Shift or Cmd/Ctrl while hovering over any element in the Bricks structure panel to see a tooltip listing all active CSS global classes applied to that element. Saves time when writing custom CSS — no need to click elements one by one just to check which classes are applied. === Keyboard Shortcuts === Adding common elements in Bricks editor is now a single key-press away. - S: Section - C: Container - B: Block - H: Heading - T: Basic Text - I: Image - L: Text Link - W: Wrap with Block - R: Rich Text - D: Div Alt+H: Toggle :hover == Installation == === Automatic Installation === Search for `bricks navigator` from within your WordPress plugins' Add New page and install. === Manual Installation === 1. Click on the `Download` button to download the plugin. 2. Upload the entire `brickslabs-bricks-navigator` folder to the `/wp-content/plugins/` directory. 3. Activate the plugin through the `Plugins` menu in WordPress. == Screenshots == 1. Screenshot showing the sub menu of Settings. 2. Screenshot showing 1-click direct link to edit the hovered Template directly with Bricks in a new tab. 3. Screenshot showing 1-click direct link to edit the hovered Page directly with Bricks. 4. Screenshot showing the plugin's settings page. 5. Screenshot showing 'Add BEM classes' button when a structure panel layer is hovered. 6. Screenshot showing BEM Classes dialog. 7. Screenshot showing contextual menu (with live preview on hover) for the builder controls. 8. Screenshot showing class tooltip when an element in the structure panel is held down with Shift or Cmd/Ctrl key. == Changelog == = 1.1.8 ( May 21, 2026 ) = * Added Class Tooltip enhancement (Beta): hold Shift or Cmd/Ctrl while hovering over any element in the Bricks structure panel to instantly see a tooltip listing all active CSS global classes on that element — no need to select elements one by one. * Modernized all JavaScript files to ES6+ syntax: arrow functions, `const`/`let`, optional chaining (`?.`), nullish coalescing (`??`), template literals, `for...of`, destructuring, and spread across all six enhancement modules. = 1.1.7 ( May 20, 2026 ) = * Improved CSS Variables Context Menu: added "All / Rel" toggle button to switch between relevant-only and all variables; preference is persisted to localStorage so custom design system users only set it once. * Improved CSS Variables Context Menu: auto-fallback to all variables when category filtering returns no results, ensuring custom-prefixed CSS variables like `--utopia-space-xs` and `--brand-color-primary` are never silently hidden. * Improved CSS Variables Context Menu: added unanchored regex patterns for color (`-color-`, `-clr-`), spacing (`-space-`, `-spacing-`, `-gap-`), and font-size (`-step-`) to correctly classify custom-prefixed variables into their categories. * Fixed Auto-select Class: replaced `hasOwnProperty` check with `Array.isArray` to prevent a TypeError crash when `_cssGlobalClasses` exists on an element but is not an array (e.g. after a malformed JSON import). * Fixed Keyboard Shortcuts: native `