Title: GetRETS Author: joshtimitek Published: December 8, 2016 Last modified: March 12, 2017 --- Search plugins ![](https://ps.w.org/getrets/assets/banner-772x250.png?rev=1555109) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/getrets/assets/icon-256x256.png?rev=1555109) # GetRETS By [joshtimitek](https://profiles.wordpress.org/joshtimitek/) [Download](https://downloads.wordpress.org/plugin/getrets.1.0.4.zip) * [Details](https://wordpress.org/plugins/getrets/#description) * [Reviews](https://wordpress.org/plugins/getrets/#reviews) * [Installation](https://wordpress.org/plugins/getrets/#installation) * [Development](https://wordpress.org/plugins/getrets/#developers) [Support](https://wordpress.org/support/plugin/getrets/) ## Description Instantly add real estate listing data to your website. This WordPress plugin will allow your listings, from multiple feeds, to appear within your site as native content, treated just like other content on your website. All of this is done through an integration with GetRETS® from timitek, llc. ### Advanced Listing Search Widget #### About GetRETS integrates with the default WordPress search immediately out of the box after setup. However, if you would like to enable a more advanced search, the GetRETS plugin also includes a Search Widget, which once enabled, will allow visitors to your site to specify additional constraints to search listings by. In addition to the generic keyword search, the following constraints are made available; * Minimum Price * Maximum Price * Residential Listings * Land Listings * Commercial Listings #### Enabling * From the WordPress administration dashboard, select **Appearance** – **Widgets**. * From the **Available Widgets** section, select **GetRETS Search**. * Based on the theme you have installed, select the sidebar / area where you want your widget to be displayed at on your site. * Click the **Add Widget** button * You may customize the title to be used for the for the widget. #### Finally Now your sites visitors can perform more advanced listing searches! ### Shortcodes #### Advanced Search In addition to the the search widget, the GetRETS plugin provides a `[getrets_search]` shortcode for you to use in a post or page to create a more customized search page. This short code provides a search form with the same advanced searching functionality as the widget. #### How To Use Place the following line in any page / post. ``` [getrets_search]

Extending Via CSS

``` The post content detail elements are marked up with several CSS classes that can be used to customize the look and feel of the listing details post. #### Main Content ``` getrets-content ``` This is class used for the main div that surrounds all of the content for the listing details post. #### Sections Each of the 4 sections are wrapped in a div that has it’s own class. * Details – `getrets-details` * Description – `getrets-description` * Features – `getrets-features` * Photos – `getrets-features` #### Titles ``` getrets-title ``` This is the title for each of the 4 sections. * Details * Description * Features * Photos #### Detail Entries ``` getrets-detail ``` Each entry in the **Details** section has a div around it with the `getrets-detail` class applied to it. #### Labels / Values ``` getrets-label getrets-value ``` This `getrets-label` class is applied to each label used for each detail item in the Details section, as well as the **Provided By:** label. Likewise, the `getrets-value` class is applied to each value after the label. #### Photos ``` getrets-photo ``` Each photo has the `getrets-photo` class applied to it. #### Further Details For further information examine the markup at; ``` wp-content/plugins/getrets/views/frontend/content.php

Extending Via JavaScript

``` In addition to extending the the listing details post via custom styles in your theme, you can also extend functionality via JavaScript. #### listingLoaded Function Each listing detail post will attempt to inject listing detail information and a list of images for the listing into a global function if your theme enables it. To take advantage of this create a public function with the following syntax, that will be called when a listing detail post is displayed. ``` /** * Function that is called by GetRETS when a listing * detail post is loaded. * * listing - JSON object representing the details * of the listing * images - an array of image urls associated * with this listing */ function listingLoaded(listing, images) { alert(listing.description); } ``` #### Element Attributes Each element that is rendered is also rendered with an intuitive id to make it easy to allow for DOM manipulation. For further information examine the markup at; ``` wp-content/plugins/getrets/views/frontend/content.php ``` ## Screenshots [⌊Settings - GetRETS⌉⌊Settings - GetRETS⌉[ Settings – GetRETS [⌊Create your own search page using the [getrets-search] shortcode⌉⌊Create your own search page using the [getrets-search] shortcode⌉[ Create your own search page using the [getrets-search] shortcode [⌊Take advantage of the advanced listing search search widget⌉⌊Take advantage of the advanced listing search search widget⌉[ Take advantage of the advanced listing search search widget [⌊View listing searches natively in your site like any other post⌉⌊View listing searches natively in your site like any other post⌉[ View listing searches natively in your site like any other post [⌊View a detailed post for listings with detailed information and photos⌉⌊View a detailed post for listings with detailed information and photos⌉[ View a detailed post for listings with detailed information and photos ## Installation #### From Within WordPress 1. From the WordPress administration dashboard, select **Plugins** – **Add New**. 2. Search for **GetRETS**. 3. Click the **Activate** button. #### Alternate Install (With Zip File) **Note** – It might be necessary to provide ftp information for this method. 1. Download the ***.zip** file. 2. From the WordPress administrators dashboard, select **Plugins** – **Add New**. 3. Click the **Upload Plugin** button. 4. Upload the ***.zip** file that was previously downloaded. 5. After uploading, activate the plugin. #### Manual Installation 1. Download the ***.zip** file. 2. Extract the contents of the ***.zip** into the `wp-content/plugins` directory of your WordPress installation. #### Setup **Note** – Ensure the Plugin has been activated in the WordPress administration dashboard before continuing. Access the **GetRETS** settings from the WordPress administrators dashboard. From the WordPress administration dashboard, select **Settings** – **GetRETS**. There are two settings for you to configure. **Customer Key**: The customer key is the unique key assigned to you from [www.timitek.com](http://www.timitek.com). **Cache Settings**: By default, GetRETS will pre-fetch and cache all of your listings from the MLS systems. It will maintain this cache for you automatically and allow you to fetch your listing details even if your MLS system is offline. It is not recommended that you disable this, however, you can optionally disable the cache and have all of your listings fetched directly from the MLS system on each request. Some MLS systems do not allow this sort of traffic, and you must be sure this is what you want to do before checking this box. **Show Thumbnail**: Some WordPress templates will show a featured image tied to a post. When a template with this feature enabled is used, having GetRETS also display a thumbnail, might be a bit redundant. By unchecking this box GetRETS will not present a thumbnail associated with the listing on the search results. #### Congratulations You have successfully installed GetRETS and visitors to your site can immediately start using your site to search for realty listings using the regular ## FAQ Why should I use this plugin? * Because it’s easy, just install it and plug in your customer key and it works right out of the box! * Because you care about your search engine rankings. The listings appear natively within your site so they will appear as original content on your site. * Because there isn’t anything you have to maintain. No database, no IDX, no fuss! ## Reviews ![](https://secure.gravatar.com/avatar/4c62feaf405864359c9160d997bc5736065cf398448c370c8f5e48eb1e38c089? s=60&d=retro&r=g) ### 󠀁[Kick Off Post – It’s working great!](https://wordpress.org/support/topic/kick-off-post-its-working-great/)󠁿 [joshtimitek](https://profiles.wordpress.org/joshtimitek/) December 15, 2016 Shameless plug! It’s now online and works great! [ Read all 1 review ](https://wordpress.org/support/plugin/getrets/reviews/) ## Contributors & Developers “GetRETS” is open source software. The following people have contributed to this plugin. Contributors * [ joshtimitek ](https://profiles.wordpress.org/joshtimitek/) [Translate “GetRETS” into your language.](https://translate.wordpress.org/projects/wp-plugins/getrets) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/getrets/), check out the [SVN repository](https://plugins.svn.wordpress.org/getrets/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/getrets/) by [RSS](https://plugins.trac.wordpress.org/log/getrets/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Return listings in search results * View listing details as a custom post type * Advanced search shortcode * Advanced search widget * Listing detail post rendered with CSS classes and JavaScript hooks #### 1.0.1 Added support for cUrl as backup for use in working with API when allow_url_fopen is not enabled #### 1.0.2 Removed duplicate ID’s from search result excerpt #### 1.0.3 Fix for php versions before 5.5 (no empty checks) – Line 118 of GetRETS.php. ## Meta * Version **1.0.4** * Last updated **9 years ago** * Active installations **Fewer than 10** * WordPress version ** 4.6.1 or higher ** * Tested up to **4.7.33** * Tags * [IDX](https://wordpress.org/plugins/tags/idx/)[MLS](https://wordpress.org/plugins/tags/mls/) [real-estate](https://wordpress.org/plugins/tags/real-estate/)[realty](https://wordpress.org/plugins/tags/realty/) [RETS](https://wordpress.org/plugins/tags/rets/) * [Advanced View](https://wordpress.org/plugins/getrets/advanced/) ## Ratings 5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/getrets/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/getrets/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/getrets/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/getrets/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/getrets/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/getrets/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/getrets/reviews/) ## Contributors * [ joshtimitek ](https://profiles.wordpress.org/joshtimitek/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/getrets/)