WPGB Facets Styler

Style WP Grid Builder facet controls through additional Bricks editor controls. This is an integration with the native WPGB facet element, not a standalone filtering engine or a replacement for WP Grid Builder.

Setup and First Use


  1. Install and activate WP Grid Builder and its Bricks integration. Configure a working grid/query and facet in WP Grid Builder first.
  2. Open Bricks → BricksUltimate → Misc. Under WP Grid Builder Facets Styler, enable individual element styler and save.
  3. Reopen Bricks, add or select the WPGB facet element, and connect it to the intended grid/query using its native integration settings.
  4. Use the added control groups for the actual facet type, such as Checkboxes, Dropdown, Search, Buttons, or Range Slider.
  5. Style default, selected, hover, focus, and disabled states where relevant.
  6. Test filtering, resets, AJAX updates, and mobile layout on the frontend.

Controls and Settings


ControlPurpose and usage
Container / Content spacingAdjusts the wrapper and facet content spacing.
TitleControls facet-title typography, background, border, margin, and padding.
Checkboxes / Radio / DropdownStyles selection controls and their labels/counts as offered.
Search / Buttons / Submit-ResetControls input and action appearance without changing the underlying filtering rules.
Hierarchy / Number / Range SliderUse the group matching the configured facet type; appearance alone does not create that facet.
Rating Picker / A-Z IndexSpecialized styling for supported WPGB control output.
Global stylerThe backend currently labels global styling coming soon. Use the verified individual element styler rather than treating that label as a completed global feature.

Responsibilities and Dependencies


WP Grid Builder owns facet definitions, indexing, query linkage, result filtering, and its AJAX lifecycle. BU adds CSS-oriented controls to the facet element. If a facet does not filter correctly, fix that configuration before styling it. The backend setting is shown when the Bricks integration plugin is active.

States, Accessibility, and Consistency


Keep selected states visible beyond color alone, preserve focus outlines, and ensure range thumbs and checkboxes remain usable on touchscreens. Style counts and disabled values intentionally so unavailable choices are not mistaken for active ones. Avoid broad custom CSS that overrides all WPGB states after the styler generates its scoped rules.

Practical Example


Create a product category checkbox facet with WP Grid Builder. Confirm filtering works, then enable the BU individual styler and style the title, checkbox labels, counts, and checked state to match the shop sidebar.

Troubleshooting


  • Styler setting absent: confirm the WPGB Bricks integration is active.
  • Controls absent: enable individual element styler and reopen the editor.
  • Looks correct but does not filter: check WPGB indexing and target query.
  • Selected state disappears: inspect custom CSS and disabled/checked styles.

Related Documentation