The Search widget should be placed on a "search" page in your website so that you can test your foundation page setup.
The Search widget displays a standard search form that provides access to nearly all the MLS criteria for your MLS.
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.
The More Filters panel will show all the advanced search options.
This widget is mobile responsive and will expand to fill any container / space made available in your website page design.
You can add the search form widget to any number of pages.
- Minimum width: Designed for mobile
- Maximum width: Unlimited
Colors and Background
- Widget Themes can be used to apply predefined, or your own, color schemes.
- Background is always transparent.
1. id='MBBv3_SearchForm' (required)
This defines the widget to be a Search Widget
The Search Widget can be displayed using the following widget code:
The default :
If you are using the WordPress MBB Plugin, then the short code is like this:
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.
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.
<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:
<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.
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