=== Plugin Name === Contributors: SimplyRETS Tags: rets, idx, real estate listings, real estate, listings, rets listings, simply rets, simple rets, rets feed, simple idx, idx feed Requires at least: 3.0.1 Tested up to: 4.1.1 Stable tag: 1.2.0 License: GPLv3 License URI: http://www.gnu.org/licenses/gpl-3.0.html Show your Real Estate listings on your Wordpress site. SimplyRETS provides a very simple set up and full control over your listings. == Description == The SimplyRETS plugin allows you integrate your live Real Estate listings directly on your Wordpress site with little to no hassle. This plugin requires a plan with [SimplyRETS](https://simplyrets.com), but demo listing data is provided for you to test out and make sure the plugin does what you're looking for. Getting started with the SimplyRETS plugin is as easy as installing it and creating a new page! In order to get your properties on your site, there are only a couple of things you need: * You must be a current member of an MLS provider. This is who we get your properties from (which we'll take care of). * You must have an active plan with [SimplyRETS](https://simplyrets.com). We offer a wide variety of plans to accommodate most situations. Visit our website for me details on pricing and how to get started. The SimplyRETS plugin generates accurate and correct HTML and does *not* use iframes or ever take your visitors away from your site - which we've learned is essential for materializing online leads. The power is put back in your hands by giving you full control of which of your listings to show, and on which pages. The plugin also provides you extensions on many standard Wordpress features: * A custom 'Rets Listings' page type for creating pages with listing results. * Sidebar and footer widgets for Featured Listings, Search, etc. * Plenty of short-codes for splicing your listings into any page or post. * Filters for searches, custom pages, etc. SimplyRETS provides the fastest and most up-to-date solution for embedding your listings on your site. SimplyRETS will update as frequently as every hour (or as frequent as your MLS provider allows). This means that you're ahead of the competition and can have the fastest possible response time for dealing with interested prospects. This plugin is fast!. You don't have to worry about slowing down your website by pulling lots of data on every page load. The SimplyRETS plugin is optimized to only load on the correct pages, and to only load the listings you choose. By doing this, you are able to keep visitors on your site to look at more properties. If you offer the fastest searching solution in your city, why would they go any where else? SimplyRETS uses the RETS (Real Estate Standards Organization) protocol and has 100% coverage and compatibility with the RETS standard. This allows you to be on the leading technical edge and provides you with many advantages of IDX (internet data exchange) including response speed, compatibility across multiple MLS areas, and up-time. So while your competition is working on getting properties on their site, you can install the SimplyRETS Wordpress plugin and spend more time actually selling! == Installation == You can simply install this plugin a couple of different ways: = Wordpress Plugin Directory = 1. If you usually install plugins via the Wordpress Dashboard 'Add Plugins' page, you can just search for 'SimplyRETS' and click install! = Install from the .zip: = 1. Download the `.zip` file 1. In your Wordpress dashboard, go to `Plugins -> Add New`. Choose `Upload a New Plugin` and upload the `.zip` file. = Manual install from .zip: = 1. Download the `.zip` file and extract it into your sites `wp-content/plugins` directory 1. Be sure to extract it into a directory called `wp-content/plugins/simply-rets/`. = Activating = Once you have the plugin installed via one of the methods above, you can go to the Plugins page of your Wordpress site and click `activate` on SimplyRETS. Once successfully activated, you can start using the demo listings, or enter your SimplyRETS credentials to start getting your listings! == Frequently Asked Questions == = Can I use this plugin for free? = Yes! The SimplyRETS Wordpress plugin comes with free demo listings that you can use on your site. Mostly, this should be used for testing the plugin to make sure it fits your needs. To show *your* listings on your site, you will need an active plan with [SimplyRETS](https://simplyrets.com). = Can I use my existing Wordpress theme? = Yes! The SimplyRETS plugin generates widely compatible and responsive HTML for your pages. It has tested on and made to work with many different types of Wordpress themes. If you find a theme that this plugin does not work with, let us know! The plugin does *not* use iFrame, but generates and embeds the HTML directly on your site, which means that your visitors get the best experience possible when browsing your listings. = Is it possible to use my own CSS or change the styling? = Absolutely! The plugin comes with very versatile CSS, but you may want to add your own style and personal touch to it. We've created a very simple set of CSS classes and ID's for you to use to change the styles. You can start by installing one of the many custom CSS Wordpress plugins, or if you're using a Child Theme, you can put it directly in your child-custom.css/style.css. You can find the SimplyRETS Style Documentation in the Documentation section of the website: [SimplyRETS Style Documentation](https://docs.simplyrets.com). = How do I show *my* listings through this plugin? = Once you've decided that the plugin does what you need it to do, you can contact us at [the SimplyRETS website](https://simplyrets.com#home-contact). We'll get you signed up and provide you with an API username and password. Starting to use your real listings is as easy as plugging the API credentials into the Wordpress Admin settings page (`Settings -> SimplyRETS`) and hitting save! If the credentials are valid, your listings will start to show automatically. If they are invalid, the test data will continue to be used. = How often are the listings refreshed? = SimplyRETS will keep the most up-to-date listings on your site. We will refresh the feed as often as the MLS provider allows, which is usually in the the 1-2 hour range. = Do I have to be signed up with an MLS provider? = Yes. In order for us to get your listings to you, we need to get them from your MLS provider, We'll handle all the dirty work for getting that set up, and you can worry about the important things like making more sales! = I want to only show my listings, and not my whole office. Is that possible? = The SimplyRETS plugins provides 'filters' for all the listings on your site. For example, if you create a new SimplyRETS page, you can add an Agent Filter on that page which will take your Agent MLS Id. Then when that page is loaded, only listings tied to that Agent MLS Id will be shown. = How long can I use the test data? = You can use the test data for as long as you need! The only restriction for the test data is that you must make less than 1,000 requests a day. Other than that, keep in mind that the test data listings are *not* real properties, but it does provide the same fields that we will get from your MLS provider. == Screenshots == 1. SimplyRETS settings page for entering API credentials 2. The SimplyRETS custom page type creation pages. Here you can show different types of listings with the available 'page filters' and add any short codes, like a search form. 3. A client side page with multiple listing results embedded. 4. A single listing details page complete with an image gallery, contect button, and sidebar widget. 5. The SimplyRETS Featured Listing sidebar widget in action. (default 2015 theme) 6. This screenshot shows the search form short-code and a featured listing sidebar widget. == Changelog == = 1.2.0 = * Add graphical shortcode/page builder got creating listing shortcodes * Add support for listing limit and pagination for multiple pages of listings * Add support for agent ID query parameter in shortcode & custom post type * Add more styling and clean up text in admin settings panel * better error handling * other fixes and improvements = 1.1.5 = * Automatically save test credentials when plugin is activated to make it easier to get started. = 1.1.4 = * Add option for hiding Listing Date and Listing Last Modified fields = 1.1.3 = * Fixes php warning on new SimplyRETS Pages * Other fixes to prevent errrors and warnings * Added testing suite!! = 1.1.2 = * Patch for search results or shortcode with a single listing response = 1.1.1 = * Better handling of data fields that might not always have a value * Fix for search results with only one result = 1.1.0 = * Add a new Search Form sidebar/footer Widget * Add a new Random listing widget * Implement Contact Page link setting for linking to the sites contact page from single properties * improve keyword search * improve error handling * improvements and bug fixes to admin panel and settings * Add better default property image for listings with no images * search form min/max inputs are number boxes now * Grammar/text fixes and improvements * Improve API authentication and set up content versions for stability (using cURL) = 1.0.3 = * patched php optional warning argument = 1.0.2 = * enhance default markup and css to be compatible with a wider range of themes = 1.0.1 = * Better image cdn link handling = 1.0.0 = * Initial Launch == Upgrade Notice == = 1.2.0 = * This update should fully support backwards compatiblity, but if you notice problem update to the latest version. = 1.1.3 = * This update fixes a visible warning on new SimplyRETS post pages = 1.1.0 = * There are many new updates and features added to this release. A lot of the API authentication has improved, so old clients need to be updated. See the changelog for a complete list. = 1.0.3 = * If you were experiencing any error outputs on your site (mostly GoDadddy host), this update will resolve the issue. = 1.0.0 = * Launch == Documentation == There is much more documentation for both the SimplyRETS API, and the SimplyRETS Wordpress plugin. You can dig into all of that on the Documentation page of the SimplyRETS site: [SimplyRETS Documentation](https://docs.simplyrets.com) = For Developers = If you're interested in building your own Plugin or Application, SimplyRETS offers several different API's specifically geared towards developers. We provide JSON, XML, HTML, and Websockets API's to access the same data you see in this plugin, as well as other services like Database population and analytics. The API's are simple, and the documentation is robust - so you can spend more time developing your application than worrying about how to get the correct listings from your MLS provider. Visit the SimplyRETS website for more details and a full list of services: [SimplyRETS Features](https://simplyrets.com)