Title: GetRETS
Author: joshtimitek
Published: <strong>2016 年 12 月 8 日</strong>
Last modified: 2017 年 3 月 12 日

---

搜尋外掛

![](https://ps.w.org/getrets/assets/banner-772x250.png?rev=1555109)

這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。

![](https://ps.w.org/getrets/assets/icon-256x256.png?rev=1555109)

# GetRETS

 由 [joshtimitek](https://profiles.wordpress.org/joshtimitek/) 開發

[下載](https://downloads.wordpress.org/plugin/getrets.1.0.4.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/getrets/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/getrets/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/getrets/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/getrets/#developers)

 [技術支援](https://wordpress.org/support/plugin/getrets/)

## 外掛說明

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]<h3>Extending Via CSS</h3>
    ```

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<h3>Extending Via JavaScript</h3>
    ```

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
    ```

## 螢幕擷圖

 * [[
 * Settings – GetRETS
 * [[
 * Create your own search page using the [getrets-search] shortcode
 * [[
 * Take advantage of the advanced listing search search widget
 * [[
 * View listing searches natively in your site like any other post
 * [[
 * View a detailed post for listings with detailed information and photos

## 安裝方式

#### 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

## 常見問題集

  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!

## 使用者評論

![](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/) 2016 年 12 月 15 日

Shameless plug! It’s now online and works great!

 [ 閱讀全部 1 則使用者評論 ](https://wordpress.org/support/plugin/getrets/reviews/)

## 參與者及開發者

以下人員參與了開源軟體〈GetRETS〉的開發相關工作。

參與者

 *   [ joshtimitek ](https://profiles.wordpress.org/joshtimitek/)

[將〈GetRETS〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/getrets)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/getrets/)、查看
[SVN 存放庫](https://plugins.svn.wordpress.org/getrets/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/getrets/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/getrets/)。

## 變更記錄

#### 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.

## 中繼資料

 *  版本 **1.0.4**
 *  最後更新 **9 年前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 4.6.1 或更新版本 **
 *  已測試相容的 WordPress 版本 **4.7.33**
 *  語言
 * [English (US)](https://wordpress.org/plugins/getrets/)
 * 標籤:
 * [IDX](https://tw.wordpress.org/plugins/tags/idx/)[MLS](https://tw.wordpress.org/plugins/tags/mls/)
   [real-estate](https://tw.wordpress.org/plugins/tags/real-estate/)[realty](https://tw.wordpress.org/plugins/tags/realty/)
   [RETS](https://tw.wordpress.org/plugins/tags/rets/)
 *  [進階檢視](https://tw.wordpress.org/plugins/getrets/advanced/)

## 評分

 5 星，滿分為 5 星

 *  [  1 個 5 星使用者評論     ](https://wordpress.org/support/plugin/getrets/reviews/?filter=5)
 *  [  0 個 4 星使用者評論     ](https://wordpress.org/support/plugin/getrets/reviews/?filter=4)
 *  [  0 個 3 星使用者評論     ](https://wordpress.org/support/plugin/getrets/reviews/?filter=3)
 *  [  0 個 2 星使用者評論     ](https://wordpress.org/support/plugin/getrets/reviews/?filter=2)
 *  [  0 個 1 星使用者評論     ](https://wordpress.org/support/plugin/getrets/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/getrets/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/getrets/reviews/)

## 參與者

 *   [ joshtimitek ](https://profiles.wordpress.org/joshtimitek/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/getrets/)