How do I add the Recent Sales plugin to a page?

The Recent Sales plugin can be added to a page using the visual editor to generate a shortcode.

Begin by selecting the Recent Sales icon from the Visual editor.

Here are the options that are available to us when we open the Recent Sales dialogue.

Once we have filled out all the necessary fields, select “ Insert” and the text field of the Visual Editor will be populated with a shortcode that reflects the choices that we made in the settings dialogue.

Shortcodes

For more advanced options, here is a quick explanation of the shortcode parameters.

Market:

DO NOT EDIT THIS PARAMETER The MLS market to search for recent sales.

Valid Parameters:
* The MLS market we are attempting to query.

Polygon:

DO NOT EDIT THIS PARAMETER This will always be generated by the plugin with the correct polygon parameter when we fill out the “Enter Locations” field in the settings. The Polygon refers to the code that represents the shape to query for recent sales.

Valid Parameters:
* The only valid parameters are internally generated by the plugin.

Polyname:

DO NOT EDIT THIS PARAMETER- This will always be generated by the plugin with the correct `polyname when we fill out the “Enter Locations” field in the settings. The Polyname refers to the plain-text name of the shape to query the recent sales.

Valid Parameters:
* The only valid parameters are internally generated by the plugin.

Price:

This parameter will set a price range for the plugin to search, e.g. price="500000:800000" will return sold listings from $500,000 to $800,000.

Valid Parameters:
* Any valid integer statement.

Beds:

This parameter will tell the plugin to narrow down the number of recent sales by how many bedrooms the listing had- e.g. beds="5-" will return sold listings that had less than 5 baths.

Valid Parameters:
* Any valid integer statement.

Baths:

This parameter will tell the plugin to narrow down the number recent sales by how many bathrooms the listing had- e.g. baths="3" will return sold listings that had 3 baths.

Valid Parameters:
* Any valid integer statement.

Year Built:

This parameter will tell the plugin to narrow down the number recent sales by how many baths the listing had- e.g. yearbuilt="1999+" will return sold listings that had been built before 1999.

Valid Parameters:
* Any year(s) as a valid integer statement.

Size (Sq Ft of Home):

This parameter will tell the plugin to narrow down the number of recent sales by the size of sold home itself (the square footage)- e.g. size="2000+" will return sold listings that were larger than 2,000 square feet.

Valid Parameters:
* Any valid integer statement.

Lot Size (Acres):

This parameter will tell the plugin to narrow down the number recent sales by the size of lot of the sold listing- e.g. lotsize="1000-" will return sold listings that had less than a 1,000 square foot lot.

Valid Parameters:
* Any valid integer statement.

Lookback Number of Days:

This parameter will tell the plugin how far to look back for sold listings- e.g. days=90 will return sold listings that have been sold in the past 90 days.

Valid Parameters:
* Any valid positive integer.

Sort By:

This parameter will tell the plugin what criteria to sort the returned sold properties by- e.g. sortfield=price will return sold listings sorted by the price of the listing sold for.

Valid Parameters:
* price will sort the listings by price.
* saledate will sort the listings by the day they sold.
* distance will sort the listings by distance (only compatible with radius search).

Limit:

This parameter will tell the plugin how many of the returned sold properties to display. E.g. limit=150 will show 150 of the sold listings.

Valid Parameters:
* Any valid positive integer.

Hide Search Form:

This parameter will tell the plugin whether or not to display the sear
ch form that is shown by default above the map.
Valid Parameters:
true will hide the search form.false will show the search form.

Example

[recent_sales market="carets" polygon="$337aec169b64ca28ae95db835cf33392" polynames="San Diego" beds="2:4" baths="3-" days="365" sortfield="saledate" sortorder="desc"]

Widget

All of the same fields that exist in the Recent Sales settings dialogue as accessed through the Visual Editor.