The Search widget (sometimes referred to as the 'advanced search form widget') displays a search form that provides access to nearly all the MLS criteria for your MLS.
Ths widget is mobile- and container-responsive. The layout will adjust for device sizes and will and fit into most spaces on a webpage.
AVOID CONFLICTS
The Search Widget cannot be loaded on any page with:
- another Search widget
- a Quick Search widget
- a Results Widget
Key Features
Area Search
This field provides a search and select function. It will find matches for City, Neighborhood or Zip. For some MLS, this may also include Area or Region.
Search Nearby (enabled if your website uses HTTPS)
Clicking the navigation arrow button at the start of the form, will replace the Area search with the 'Search Nearby' function.
More Filters
The More Filters panel will show all the advanced search options.
You can add the search form widget to any number of pages.
Layout and Size
- Uses container queries for dynamic adaptation to any placement context
- More versatile than standard "mobile responsive" approaches (adapts to container, not just screen size)
- Ensures consistent user experience across all digital environments
- Minimum width: Designed for mobile
- Maximum width: 1200px
Colors and Background
- Widget Themes can be used to apply predefined, or your own, color schemes.
- Background is always transparent.
Parameters
1. id='MBBv3_SearchForm' (required)
This defines the widget to be a Search Widget
Examples:
The Search Widget can be displayed using the following widget code:
<div id="MBBv3_SearchForm"></div>
[mbb_widget id="MBBv3_SearchForm"]
2. Pre-set Search Values using filter=".."
Applying a Filter to the Search Widget (as part of the widget / shortcode) will pre-set search values.
For example, your MLS may have "residential" properties as one or more property types, but rather than hope that consumers find those values in the search fields, you want to pre-set these.
So, to achieve this, add the appropriate filter to the search widget. Read about Filters
Don't forget, for IDX rules compliance, IF YOU DO preset search form values, you probably should put a header above the search form to say "Search for Residential Properties" so it's clear to the consumer what the form will show them.
NOTE Any filter specified in the page URL will replace and override the filter set on the widget. Therefore, we suggest that you send custom search links to your general purpose 'results' page
For example, to pre-set the price range on the search form to be 400k to 900k:
<div id="MBBv3_SearchForm" filter="price_min:400000+price_max:900000"></div>
[mbb_widget id="MBBv3_SearchForm" filter="price_min:400000+price_max:900000"]
3. Show the "More Filters" panel when Widget Loads
To load the Search Widget with the More Filters panel immediately being displayed, use this filter.
- filter="show-options:true"
For example:
<div id="MBBv3_SearchForm" filter="show-options:true"></div>
[mbb_widget id="MBBv3_SearchForm" filter="show-options:true"]
4. Hide the "My Account" Options (login etc) bar
The horizontal bar above the Search Form displays the My Account login panel with links for "Searches and Alerts, Favorite Properties, Recent Properties, Register, Login"
This bar is presented by default.
If you wish, you can hide this using the following filter option:
- filter="login-panel:false"
For example:
<div id="MBBv3_SearchForm" filter="login-panel:false"></div>
[mbb_widget id="MBBv3_SearchForm" filter="login-panel:false"]
Notes on Searching
The Buying Buddy Search methods always search for ACTIVE (regardless of sub status). There is no support for searching by sub status.
(i.e. you cannot search for properties that are active / backup).
The results set will include all properties that have a main status of ACTIVE regardless of sub status
NOTE: SOLD and UNDER CONTRACT status can be displayed (if the data is available in your MLS IDX feed) by using Display Widgets with an appropriate filter
Lead Capture Settings
The Lead Capture settings in your Buying Buddy account Settings area will determine how many times the Search Widget can be used.
If you would like to limit the search criteria your website visitors can choose from before being required to register, or the number of times that can search before having to register, see Customize Lead Capture Settings.
Flow
Below is a visual example of a search sequence on your website:
- A Search will go to your "results" page and show results using the Results Widget.
- Clicking on "View Details" for a property will go to your "details" page and show property details using the Property Details Widget
