=== IDX Broker Wordpress Plugin ===
Author: IDX Broker
Contributors: idxco, highjump76
Author URL: http://www.idxbroker.com
Tags: rets, ftp, idx, idx broker, idx plugin, idx wordpress plugin, wordpress plugin, real estate wordpress, real estate, idx widget, wordpress mls, wordpress idx, RETS, MLS, idxbroker, idx feed, agent, integrated idx
Tested up to: 3.3.2
Stable tag: 1.5.3

IDX Broker Plugin for Designers and REALTORS&reg;	 

== Description ==

<h3>Powerful, IDX search tools for REALTORS&reg; and IDX Developers.</h3>
<br />
<ul>
<li><strong>Never framed, always indexable.</strong> The only Plugin that includes full IDX functionality including <a href="http://www.idxbroker.com/features/Force-or-Request-Registration">sophisticated lead capture options.</a></li> 
<li>You will convert more sales with a <strong>professionally hosted</strong> IDX solution that supports your website content with the tools that you need to compete.</li>
<li>We will never post a 301 redirect or any redirect on a live listing page. Ever. All IDX hosted pages are indexable and can be displayed on your own custom subdomain if you are worried about losing "credit" for the content.</li>
<li>Includes custom links with unlimited keyword capabilities. IDX Broker doesn't restrict you to use the same results URL keywords as every other Agent or Broker using that Plugin. Create unique content around your IDX pages for better SEO!</li>
<li>Works with all the major premium real estate themese and the majority of free themes as well.</li>
<li>One click update. The IDX Broker Plugin will automatically pull in your custom IDX links.</li>
<li>IDX Broker lets you easily add quick search, featured showcase, slideshows, lead logins, lead signup, custom links, and several more Widgets to your sidebar. Simply drag and drop!</li>
<li>Copy and paste IDX Broker Widget script into any page or post in order to feature certain listings, areas, etc.</li>
<li>Post to Facebook, Pinterest and more - from any details page. <a href="http://www.idxbroker.com/features/Social-Media-Sharing-Tools">Share your listings</a> or let others share and use ShareThis to track results.</li>
<li>Install an mobile search icon onto your visitors' iOS mobile device when they download the <a href="http://www.idxbroker.com/features/Mobile-IDX-MLS-for-the-iPad-and-iPhone">iPhone/iPad App</a>.</li>  
<li>Excellent Support. Just view some of our <a href="http://www.idxbroker.com/idx_testimonials.php">testimonials.</a></li>
</ul>

<h3>Integrated IDX Examples</h3>

<a href="http://greatpropertyforsale.com/" target="_blank">View an Integrated IDX website</a> that uses the IDX Broker Plugin. Note how the website uses www. as the custom subdomain. This is recommended for new websites only. Websites that already have a lot of pages indexed under the www. subdomain should use search., listings., or some other subdomain keyword.<br />

<a href="http://www.idxbroker.com/idx_examples/idx-wordpress-examples.php" target="_blank">View additional WordPress examples</a>. These clients have chosen to purchase their site from an Approved Reseller/Designer, or they have built their own WordPress site. 

<h3>This plugin is very simple.</h3> 

<ul>
<li>Enter your client ID, subdomain, and password and this information will be stored by the plugin. The plugin will use these credentials to keep your custom link information up-to-date.</li>
<li>Click a default page name (map search, basic search, etc.), save, and the plugin will add those pages to your navigation.</li>
<li>Build a custom neighborhood or other link in IDX Broker. Open your plugin admin screen and all of your links will automatically appear. Check the neighborhood pages that you wish to add.</li>
<li>Drag and drop various predefined Widgets into your sidebar. Or, copy Widget javascript from IDX Broker into your built-in WordPress HTML/text Widget to customize your sidebar Widgets.</li>
</ul>

<h3>General Terms of Use</h3> 

This IDX plugin is supported by MLS/IDX feeds. This means that your MLS governs the IDX results and details page display and disclaimers. IDX, Inc. manages all the necessary MLS paperwork. IDX Broker will automatically display the correct MLS/IDX disclaimers to ensure compliance with the MLS(s) & Board(s) that provides you with your IDX feed. 

== Installation ==

1. Download and extract the IDX Broker plugin. You may also install directly by going to your WP-Admin page and then Plugins > Add New. Search for 'idxbroker' under new plugins and click to install directly.
2. Upload the uncompressed folder to your `/wp-content/plugins/` directory.
3. Activate the plugin through the Plugins menu in WordPress.
4. You will need to have an active <a href="http://www.idxbroker.com">IDX Broker</a> account for the Plugin to work. Once you do, go to the IDX Broker Plugin page within WordPress. Enter your CID, Password, and IDX Broker Subdomain and click the 'Save Changes' button.
5. Your plugin will now pull your IDX Broker account information into Wordpress. Use the IDX Broker Plugin Admin page to add Widgets, menu links, and neighborhood/subdivision landing pages (Custom Links), and more.

== Frequently Asked Questions ==

= What is IDX? =
Internet Data Exchange, or IDX, is a type of data feed provided by your MLS. This data feed typically (but not always) mirrors the data available on your MLS's website. IDX Broker&reg; connects to this data feed automatically, maps the necessary fields, and then adds forms, scripts, etc, giving you a way to add html links and widgets to you website(s). 

= Do I need an IDX Broker account in order to use this plugin? =
Yes. IDX Broker manages your IDX feed by building forms, results, and property details pages that match your website or blog design. All IDX feeds require approval from a local board or MLS. If you are not a member of a local board or MLS, or your MLS does not provide an IDX data feed, then you will be unable to add IDX Broker plugin functionality to your WordPress site. <a href="http://www.idxbroker.com/idx_mls_coverage.php">Read more about our MLS coverage.</a> Note that some MLS's may charge you a separate fee for access to your IDX feed. 

= Does IDX Broker require a long-term contract? =
No. IDX Broker requires a month-to-month agreement only. There are three monthly account levels - Agent ($39.99+), Team ($49.99+), and Office($78.99+). 

= What can I expect if I decide to get my IDX feed through IDX Broker? =
When you sign up for a new account, IDX, Inc sends you any necessary MLS paperwork (if required). Once you have signed the necessary paperwork, you will need to fax that back to us and we will then forward your paperwork to the MLS for approval. Approval can take anywhere from 3-10 days. Once approved, we will activate your account, integrate your site's design into IDX pages, and send you IDX Broker login credentials so that you can add links and Widgets to your site or blog.  

= How many blogs/websites can I integrate with IDX Broker? =
Features provided by this Plugin - Widgets, links, and custom links may be placed onto any WordPress website or blog, regardless of MLS approval status. The reason for this is because all Widgets, links, and custom links point back to the original IDX-approved website. Each IDX Broker account requires MLS approval of one site for IDX display. Your search results and details pages must match this approved site. 

= Does IDX Broker offer lead capture functionality? =
Yes. IDX Broker provides you with a sign up Widget, sign up links, a lead manager page, a customizable sign up form, and provides you with 'teaser' registration options. 
 
== Screenshots ==

1. Search Link and iPhone App sidebar Widgets. - 'screenshot-1.png'
2. Embedded Quick Search and Custom Link sidebar Widgets. - 'screenshot-2.png'
3. Search Links Added to Navigation.  - 'screenshot-3.png'
4. More Links Added to Navigation. - 'screenshot-4.png'
5. Plugin Admin Page. 'screenshot-5.png'
6. IDX Widget Admin - myAgent iPhone App. 'screenshot-6.png'
7. Real-time Design Integration Setup. - 'screenshot-7.png'

== Upgrade Notice ==

= 1.5.1 =

Switched custom link data pull so that it uses an object rather than array (limited).

= 1.5.0 =

Major revision; moved queries to wpdb method, added version tracking to client header, moved to WP API http connect method. 

= 1.4.1 =

Security update

= 1.4.0 =

Replaced deprecated WP function call. Error check to remove warning when no custom links created. Missing icons and logo from images folder. Moved custom links connection settings to work with WP API.Fixed bug that was dropping the last custom link from the array. 

= 1.3.9 =

Brought compatibility to 3.2+. Resolved false error codes and warnings that appear when server settings do not allow XML file access (custom links). Fixed Agent URL bug. Resolved JS errors that sometimes display when a Widget is first added to the sidebar. Updated SOAP services files. Resolved error when CID is more than four characters. 

= 1.3.8 =

Minor bug update.

= 1.3.7 =

Adding fallback to web services curl if simple xml fails.  Recommended upgrade.

= 1.3.5 =

Small Patch to resove php error.  To add more reliability to the plugin we moved to an XML feed for custom links from our server.  As a result you may see duplicates in your pages generated from custom links.  Please remove the duplicates in your 'pages' admin and import your custom links again.

= 1.3.4 =

Switched from web services to an xml feed for better reliability for custom link aquisition.  Highly recommended upgrade.

= 1.3.3 =

Cleaned up admin UI, replaced php shortcodes, replaced myAgent widget link, added additional help links, resized quick search widget, embedded additional knowledgebase links.  

= 1.3.2 =

Added sitemap, user login, and other links to the standard link options. Provided additional help for people confused about what to enter in subdomain field. 

= 1.3.1 =

Bug fixes ajax scripts that would spin out and never let options page submit.

= 1.3 =

Bug fixes for very large custom link lists. Added Select/Deselect all functionality on link lists.

= 1.2.9 =

Essential update to fix page links to function namespace errors and help links added.

= 1.2.8 =

Plugin has been streamlined and optimized after its initial development.  Wrapper features have updgraded were no file permissions, or copy and paste is needed in order to take advantage of the full integration feature.  Simply add your tags, set a few settings in the IDX Broker Admin, and your pages are automatically wrapped for you.  No need to update your wrapper, it's dyanamically loaded each time someone hits one of your pages.  The "Property Manager Signup" widget has been added, so that your visitor can sign up for automatic email updates that match searches that they preform on your site.  An essential upgrade!

= 1.2.7 =

Advanced feature now detects tags, read/write settings for folders, and provides copy/paste of header and footer content if security settings do not allow for the locally stored live wrapper files.

<strong>Important Note to Advanced Developers: If you currently use the live wrapper files, all updates will force you to manually modify the CHMOD settings for your /wrapper/ folder and the header.php and footer.php files contained there. Please review <a href="http://www.idxbroker.com/support/kb/questions/301/">this knowledgebase article</a> for more information about how to manage live wrappers when you update the IDX Broker plugin. Note that this is due to WordPress security requirements. This logic applies to any plugin that writes files to your local WordPress installation. 

= 1.2.5 =

Adds another option for wrapper generation.  Some Worpress Server configurations will not allow for the include files, this version will generate the static code to copy and paste into the IDX Broker Middlware.

= 1.2.3 =

Better front end error reporting to reduce confusion on cid missing error

= 1.2.2 =

Cleaned up options page and options registration scripts for forward WP compatibility and MU compatibility.

= 1.2 =

Allows automatic header and footer include generation for the IDX Broker system.


== Changelog ==

= 1.5.3 =

Fixed similar error to v1.5.2 when WP cannot connect to pull in custom links. 

= 1.5.2 =

Fixed error when WP cannot connect to pull in custom links. 

= 1.5.1 =

Switched custom link data pull so that it uses an object rather than array (limited).

= 1.5.0 =

Major revision; moved queries to wpdb method, added version tracking to client header, moved to WP API http connect method. 

= 1.4.1 =

Security update

= 1.4.0 =

Replaced deprecated WP function call. Error check to remove warning when no custom links created. Fixed URL in help icon CSS. Fixed bug that was dropping the last custom link from the array. 

= 1.3.9 =

Brought compatibility to 3.2+. 
Resolved false error codes and warnings that appear when server settings do not allow XML file access (custom links). 
Fixed Agent URL bug. 
Resolved JS errors that sometimes display when a Widget is first added to the sidebar. 
Updated SOAP services files. 
Resolved error when CID is more than four characters. 

= 1.3.8 =

Minor bug update.

= 1.3.7 =

Adding fallback to web services curl if simple xml fails. Recommended upgrade.

= 1.3.5 =

Small Patch to resove php error.

= 1.3.4 =

Switched from web services to an xml feed for better reliability for custom link aquisition.  Highly recommended upgrade.

= 1.3.3 =

Bug fix for php shortcodes and resized quick search widget.  

= 1.3.2 =

Bug fix for extra div tag on widest QS form, labeling on General Settings updated in admin.

= 1.3.1 =

Bug fixes ajax scripts that would spin out and never let options page submit.

= 1.3 =

Bug fixes for very large custom link lists. Added Select/Deselect all functionality on link lists.

= 1.2.9 =

Page links to function namespace errors, added help icons and links.

= 1.2.8 =

Wrapper class removed, added "Property Manager Signup" widget, custom link code optimized for large volume.

= 1.2.7 =

Wrapper update options are now avaliable depending on detection of requirements.  Wrapper functions moved off into it's own class.

= 1.2.6 =

Custom links error sending output before header. Corrected

= 1.2.5 =

Wrapper option added, you can now generate your header and footer to copy and paste into the IDX Broker Middleware.

= 1.2.3 =

Better front end error reporting to reduce confusion on cid missing error

= 1.2.2 =

Cleaned up options page and options registration scripts for forward WP compatibility and MU compatibility.

= 1.2.1 =

Added the ability to add custom links into the main navigation.
Cleaned up admin styling.
Added custom link cleaning.
Better commenting on code.
Better function division.

= 1.2 =

Added automatic header and footer generation

= 1.1.0.2 =

Commented out password field (for future use), added more system links in the system links widget.

= 1.1 =

Added custom links widget from web services pull.
Added other widgets to bring plugin to 1.1 spec

= 1.01 = 

Added error checking on missing domain entry and malformed or missing CID, with error messages on widget placement/configuration page.
Added wildcard search form widget to list of available tools.
Added more format options to Quick Search Form.
Added myAgent badge widget.

= 1.0 =

Currently in Beta Testing as of 4/29/10
