The Results widget may be used on pages other than your designated foundation Results page.
In such cases, you can use the Results widget with a filter, to preset search criteria so that the widget shows specific properties on a landing page.
IMPORTANT
Do not use your designated "search results" foundation page as a "display widget".
It's important that you keep the Results widget on your designated "results" page WITHOUT any filter.
Create new pages and add the Results widget to these new pages if you want to use it as a Display Widget.
Not suitable for SEO.
The Results widget does not generate indexable listings results. This is because the Results widget executes any specified "search" in JavaScript after the page has loaded and so search engines will not see the content. For SEO benefits (with WordPress or PHP) use the "Featured List" or "Featured Gallery" widgets.
Only one instance per page.
The Results widget includes a map and so can only be used ONCE on a page with any other widget using the map.
Preservation of Filter and Modified Criteria
When the Results widget first loads, any preset criteria specified in a filter will be used as the initial criteria to show properties.
However, the search fields, criteria and 'Filter' button options are part of the Results widget, so a user will be able to modify, add and remove any criteria.
As criteria are adjusted, these then become the 'current criteria', which replaces criteria specified in any widget filter.
The 'current criteria' will be preserved if the page reloads.
Clicking the "Reset Form" option in the Filters panel will clear all values in all fields. This action will NOT re-apply the original filter.
See the Results widget reference page for more details of Variants, Dimensions and Parameters
Preset Criteria Filter
A filter can be added to the widget to preset criteria specify the listings you want displayed.
See examples below.
- filter= (optional)
Specify a Filter comprising search parameters.
Using a Filter with the widget is optional, but allows you to completely specify the types of properties you want to display using any available MLS criteria. (e.g. Foreclosures in Arvada, Listings between 300,000 to 400,000 in Denver, etc.)
See Search Filters and How to Use Search Filters for more help on these parameters.
Examples
[mbb_widget id="MBBv3_ListingResults" filter="city:denver+price_min:200000"]
<div id="MBBv3_ListingResults" filter="city:denver+price_min:200000"></div>