The Gallery Display widget can show a set of properties based on a predefined FILTER.

v3-gallery-widget

This widget is mobile responsive and will expand to fill any container / space made available in your website page design. Widget Themes can be used to apply predefined, or your own, color schemes. Minimum width: Designed for mobile. Maximum width: Unlimited.

Parameters

This widget has a fixed height for each row.

  • id="MBBv3_FeaturedGallery" (required) This defines the widget to be a Gallery Display Widget.
  • filter= (optional) A single filter parameter can be applied with any or all of the parameters below all appended. Specify the Filter. 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.) as well as control various aspects of how the widget displays.
    • filter={idx/mls criteria} Use and combine any FIELD NAMES and VALUES from the IDX data set for your MLS. Learn more.
    • filter="columns:x" (where x can be 1,2,3,4,5). Determines the number of properties in a row. Use filter="limit:y" to determine total number of properties shown. Tie this to the number of columns, for example, if you have 3 columns then make the limit a factor of 3 e.g. 3,6,9,12 etc.
    • filter="carousel:true" Transforms the Gallery Widget into a 1-row animated carousel. The height and widget of each property display is fixed, i.e. the The filter values for columns and limits are ignored. The carousel will then fill the space available.The minimum width is 275px - this will show one property at a time.
    • filter="delay:XXXX" Sets the speed of the carousel in milliseconds. The default is 2500. E.g. filter="carousel:true+delay:2500"
    • filter="limit:n" (optional) If the applied Search Filter returns more properties than the "limit", then pagination will occur showing the "limit" number on each panel. Pagination controls will be displayed at the foot of the widget.
    • filter="order:{ } (optional) Use the "order" parameter to determine the sort order of properties displayed.
    • filter="nolistingshide:{class} (optional) This filter is especially useful where you want to display your own listings but want to hide the widget and any heading if there are NO listings. Without this option, if there are no listings, then your website could well be displaying a panel such as "See My Listings!"  ... and below this it would show "0 listings" from the widget. So, with this filter you can add a <div> wrapper with a specified class around the whole display which will be hidden if there are no listings. as shown in this example:
<div class="mylistings">
<h2>My Featured Listings<h2>
<div id="MBBv3_FeaturedGallery" filter="agent_id:12345+nolistingshide:mylistings"></div>
</div>
<div class="mylistings">
<h2>My Featured Listings<h2>
[mbb_widget id="MBBv3_FeaturedGallery" filter="agent_id:12345+nolistingshide:mylistings"]

See Search Filters and How to Use Search Filters for more help on these parameters.

Examples

The default Gallery Display Widget

<div id="MBBv3_FeaturedGallery"></div>

If you are using the WordPress MBB Plugin, then the short code is like this:

[mbb_widget id="MBBv3_FeaturedGallery"]

Defaults

If no Search Filter is applied, the Gallery Display widget will display your listings (based on your MLS Agent ID). See How to Use Search Filters.

Admin