PRO block. A search and filter UI for archive and query pages. Block ID: get-fund/filter-bar.
For the full reference, see the Filter Bar Pro feature page.
Why use this
When a site hosts many fundraising pages, visitors need a way to search for specific ones or browse by organisation, creator, event, or category. The Filter Bar provides that UI without requiring a custom search implementation.
What it does
The block renders up to five filter controls (search, organisation, creator, event, category) that read their options from the REST endpoint get-fund/v1/filter-options. When a visitor interacts with a control, the block updates the listing on the page live, without a full reload, and reflects the state in the URL. It works on the Fundations, Events, and Organisations archives.
Requirements
- Active Fundations Pro license
How to use it
- Add the Filter Bar block to an archive or listing page, above the Query Loop.
- Toggle which controls to show.
- Set label texts and style options in the inspector.
Settings and options
| Option | Attribute | Type | Default | Description |
|---|---|---|---|---|
| Show search | showSearch | boolean | true | Text search field |
| Show organisation | showOrganisation | boolean | true | Organisation filter dropdown |
| Show creator | showCreator | boolean | true | Creator filter dropdown |
| Show event | showEvent | boolean | true | Event filter dropdown |
| Show category | showCategory | boolean | true | Category filter dropdown (only renders when Categories are enabled) |
| Search / control labels | searchLabel, orgLabel, creatorLabel, eventLabel, categoryLabel | string | — | Custom label per control |
| Border radius | borderRadius | number | 50 | Control corner rounding |
| Border color | borderColor | string | #e5e7eb | Control border color |
| Background color | backgroundColor | string | #ffffff | Control background color |
| Text color | textColor | string | #374151 | Control text color |
| Placeholder color | placeholderColor | string | #9ca3af | Placeholder / icon color |
What you can and cannot do
- The filter bar requires the Fundations REST API endpoint to be accessible. Ensure REST API access is not blocked by security plugins or server configuration.
- The category control only appears when Categories are enabled in Fundations settings.
- Requires Fundations Pro.
Troubleshooting
Filters do not update the listing: Confirm the REST API is accessible by checking {siteurl}/wp-json/get-fund/v1/filter-options in a browser. If it returns an error, check for security plugin rules blocking REST requests. Also confirm the Query Loop on the page targets a supported post type (get_fund_action, get_fund_event, or get_fund_org).
The category control is missing: Categories must be enabled under Fundations > Settings > Wizard. See Categories.