Download the PHP package statenweb/idx-broker-featured-properties without Composer

=== IDX Broker Featured Properties === Contributors: matstars, statenweb Donate link: https://statenweb.com/donate Tags: IDX Broker Requires at least: 4.0 Tested up to: 4.9.4 Stable tag: 1.0.8 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Curate properties from IDX Broker

== Description ==

Note You must have an IDX Broker account and API key to use this plugin

Adds the ability to curate your IDX Broker properties.

Please note that this plugin makes use of a 3rd party service to retrieve IDX Broker data. You must have an IDX Broker account + API to use this service. This means that a request is made to third party servers requesting data using your API Key. See https://developers.idxbroker.com/idx-broker-api/ for more information.

Simple usage:

Getting started (required for all use cases):

• Download, install and activate the plugin.
• After installing Go to Settings > IDX Broker Featured Properties and add your API Key.

Curating your featured properties globally

• Follow steps in Getting started above
• You can now see all of your properties (including supplemental) -- you can select which properties you want as featured (by checking them) and reorder them. Use the API to retrieve the property objects.
• Use the API call ibfp_get_featured_properties() to retrieve a listing of property objects. Use them as you see fit!

Curating your featured properties by post

• Follow steps in Getting started above

• You now can programmatically, via a filter, enable the meta box to appear on post edit screens, either by post type as a whole or programmatically based on context, see two examples:

• Use the API call ibfp_get_featured_properties( [ 'post_id' => '$post_id ] ) to retrieve a listing of property objects for a particular post id. Use them as you see fit!

Release Notes

• 1.0.8 Featured::get() defaults to return a blank array if no properties exist

• 1.0.7 Expose ibfp/raw-data to allow filtering of returned data from IDX Broker at the request level

• 1.0.6 If none are selected for homepage, return all

• 1.0.5 Fix bugs in the widget from 1.0.4, add language regarding 1.0.4 in widget itself

• 1.0.4 If no properties are selected in a widget, use all properties

• 1.0.3 Add isset check for array keys to fix warnings Add translation and filters to titles of settings pages

• 1.0.2 Fix for enqueue issue

• 1.0.1 Enqueue everywhere on admin so that overriding filters work Fix bug with css Some formatting

• 1.0.0 Add in a widget, change the way that ibfp_get_featured_properties() works, breaking changes ahoy!

• 0.0.9 Fix for bug when a single post is saved without any properties

• 0.0.8 Fix warning if no featured properties have been curated already

• 0.0.7 Fix bug with IDX_Broker_Featured_Properties\Properties\Featured::get() to accept a post id parameter

• 0.0.6 Handle properties a bit cleaner (always use \IDX_Broker_Featured_Properties\Properties\Featured::get()) Cleanly handle if a property is delisted from IDX Broker

• 0.0.5 Fix composer validation

• 0.0.4 Added the ability to curate on single posts

• 0.0.3 Fix for notification if bad API key is entered, fix for situation where API key changes Clean up the API request, remove unnecessary old code, up cache length to 10 minutes Fix some issues with outputting if IDX API does not have specific types of properties

• 0.0.2 add in readme

• 0.0.1 initial release

Roadmap

Things I'd like to add in the future:

• Ability to create customizable carousels with featured properties.

• Translations

== Installation ==

This section describes how to install the plugin and get it working.

1. Upload the plugin files to the /wp-content/plugins/idx-broker-featured-properties directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Use the Settings->IDX Broker Featured Properties screen to add your API Key
4. You can now see all of your properties (including supplemental) -- you can select which properties you want as featured (by checking them) and reorder them. Use the API to retrieve the property objects.