=== Easy Property Listings ===
Author URI: http://www.realestateconnected.com.au
Plugin URI: http://easypropertylistings.com.au
Contributors: mervb1
Donate link: http://easypropertylistings.com.au/support-the-site/
Tags: real estate, property, listings, rental, commercial, business, rural, land, residential, property listings, property management, realtor, broker, australia, wp-property, wp property, wp rentals, wp-realestate, wp real estate, multisite, property, Merv Barrett, real estate connected
Requires at least: 3.3
Tested up to: 4.1
Stable Tag: 2.0.3
License: GNU Version 2 or Any Later Version
Fast. Flexible. Forward-thinking solution for real estate agents using WordPress. Built for scale, extendible and works with any WordPress theme.
== Description ==
Easy Property Listing is one of the most dynamic and feature rich Real Estate plugin for WordPress available on the market today. But who cares for features, we know you care about what benefits those features present to you. We totally understand that and below you will find out why you should be using Easy Property Listing to manage your listings on your real estate website:
* Ease of use and quick setup means you spend less time developing and more about with getting properties on your website.
* Multiple listing types are supported because we know not everyone is a residential properties specialist. You can list commercial and rural properties just as easily.
* Easy Property Listing is highly customizable to such an extent that you will barely know if you looked at some of the websites running the plugin here.
* You have the freedom to display property price as a price range or a fixed price giving you the flexibility to attract buyers with various budgets falling within your desired range.
* It does not matter what theme you use for your site, Easy Property Listing 99% of all WordPress themes.
* This plugin is location independent and whether you are selling properties in Miami Beach or Russia, you can list the properties in the local currency.
* This is more than just a listing plugin, you can also have your sales agent profiles next to the properties for sale with their contact details. This makes it so much easier for a client to find a property they want and then make a viewing appointment all from the same page on your website.
* This Real Estate plugin for has been designed to complement your skill and design and to set you free to do what you do best.
* Developers save time because it's pre-configured to support every country, in any market.
* Fast. Flexible. Forward-thinking solution for real estate agents using WordPress.
= Features: =
* Author Box and Widget: Easy to customise, multiple agents, tabbed and extendible. Supports video, bio, social media links and much more.
* Listing Widget to easily add properties anywhere to your theme. Dozens of options with random, ordered and offset and no code.
* Search Widget: Supports tabs, location, land, price, address and more. It's all here, search everything. Its super-fast.
* Extend with Advanced Mapping extension that handles hundreds of listings, dozens of options added with a simple shortcode.
* iCal calendar appointment support for inspection times. Just click and add to your calendar.
* Geo-locate the property coordinates with a press of a button and display Google Maps.
* Works with any theme and popular frameworks like Genesis and iThemes Builder.
* Buttons for multiple floor plans, and multiple external links.
* Support for Under Offer and no price listings, you name it, it works.
* Currency support for non-dollar currencies
* Extensible with many [add-ons](http://easypropertylistings.com.au/extensions/?utm_source=readme&utm_medium=description_tab&utm_content=extensions_link&utm_campaign=epl_extensions)
= Developer Features: =
* Over 50 custom meta fields per listing type. Everything is pre-configured saving hundreds of hours. Want more, add more all extendible.
* Build better real estate websites faster with advanced extensions saving you even more time. Flexible and forward-thinking.
* Separate post types for each listing type; property, rental, land, rural, business, commercial, commercial land.
* Lightbox support, just add your favourite plugin that uses link="file on the gallery short code.
* Create your own custom templates using standard WordPress and included functions.
* Minimal CSS styling so it will integrate with any theme
* Developer friendly with dozens of actions and filters
* Custom labels for everything and full translation support
* Supports REAXML, JUPIX and worldwide MLS systems
More information at [Easy Property Listings.com.au](http://easypropertylistings.com.au/extensions/?utm_source=readme&utm_medium=description_tab&utm_content=extensions_link&utm_campaign=epl_extensions).
**Follow this plugin on [GitHub](https://github.com/easypropertylistings/Easy-Property-Listings)**
**Advanced Mapping** [Advanced Map](http://easypropertylistings.com.au/extensions/advanced-mapping/) Create a beautiful map showcasing your listings with a powerful shortcode.
**Listing Alerts** [Listing Alerts](http://easypropertylistings.com.au/extensions/advanced-mapping/) Schedule email alerts to subscribers with HTML email support and customisable messages.
= Link listings with other types of content =
With add-ons for [Listing Templates](http://easypropertylistings.com.au/extensions/listing-templates/), [Suburb/City Profiles](http://easypropertylistings.com.au/extensions/suburb-profiles/), [Testimonials](http://easypropertylistings.com.au/extensions/testimonial-manager/), and [Staff Directory](http://easypropertylistings.com.au/extensions/staff-directory/), [Awards](http://easypropertylistings.com.au/extensions/awards/), [Business Directory](http://easypropertylistings.com.au/extensions/business-directory/), [FeedSync REAXML](http://easypropertylistings.com.au/extensions/feedsync/), and more, Easy Property Listings can enhance your listings by dynamically linking content and you offering opportunities to build a deep real estate website.
= Languages =
Easy Property Listings needs help for translation:
1. English (and British English)
2. Italian (Rough translation, if you can assist please do)
3. Dutch
4. Russian
5. French
6. Finnish
Would you like to help translate the plugin into more languages? [Join our Translations Forum](http://easypropertylistings.com.au/support/forum/translations/).
== Installation ==
1. Upload plugin zip contents to wp-contents/plugin directory and activate the plugin.
2. Go to Easy Property Listings > Settings and enable your listing types and press save.
3. Customise your labels, tweak the display, all in minutes from Easy Property Listings > Setting page.
4. Add a listing as you would a post. Check the help guide inside the plugin. Dashboard > Easy Property Listings > Help. These instructions are also accessible to authors.
5. Create blank pages for each listing type you enable so you can easily add the archive page to your WordPress menus
6. Insert short codes, add widgets, read the guide.
7. For detailed setup instructions, visit the official [Documentation](http://easypropertylistings.com.au/documentation/) page.
== Frequently Asked Questions ==
= How do I setup my WordPress theme to work with Easy Property Listings 2.0 =
In order for correct integration with your WordPress theme please follow these instructions [WordPress Theme configuration instructions](http://easypropertylistings.com.au/section/theming/).
These instructions are also located inside the plugin. Visit Dashboard > Easy Property Listings > Help > Getting Started > Setup your theme to work with the plugin
= How do I Show My List of Listings? =
The easiest way to display the archive page for your listing:
1. Create a blank page for each listing type you enable called; property, rental, land, business, rural, commercial, commercial-land. You can rename them after.
2. Now these pages will display listings of that type as long as you have added one.
= Is there a sample import file I can use to setup a demo real estate web site? =
Yes! Simply go to Tools > Import and install the WordPress Importer, then navigate to wp-content/plugins/easy-property-listing/assets/ and select the sample-property-import.xml file. This will create several sample properties for you, make sure the "property" type is activated.
= Getting a 404 error? =
To get rid of the 404 error when viewing a listing, you need to re-save your permalink structure. Go to Settings > Permalinks and click "Save Changes".
= How do I use the advanced author box on posts and pages? =
Place the php function on your single.php template in your theme <?php do_action( 'epl_single_author' ); ?>
= Can I add integrations for third party real estate applications like 1Form or Inspect Real Estate? =
Yes, through the addition of one or more of the add-on integrations, you can quickly integrate third party buttons to listings. The add-on gateways currently available:
* [1form](http://easypropertylistings.com.au/extensions/1form/)
* [Inspect Real Estate](http://easypropertylistings.com.au/extensions/inspect-real-estate/)
== Screenshots ==
1. Archive Page Display with Listing Widgets
2. Admin view of Property listing type
3. Custom fields configured for a Property Listing type
4. User Profile options for author box
5. Search Widget adapts to child theme style
6. Home open shortcode and Multi Author widget
== Changelog ==
= 2.0.3: February 9, 2015 =
* Fix: Manually entered inspection time corrected from pM to PM
* New: French translation (Thanks to Thomas Grimaud)
* New: Finnish translation (Thanks to Turo)
= 2.0.2: February 2, 2015 =
* Fix: Added fall-back diff() function which is not present in PHP 5.2 or earlier used with the New label.
* Fix: Some Labels in settings were not saving correctly particularly the search widget labels.
* Fix: Restored missing author profile contact form tab on author box.
* Tweak: Added CSS version to admin CSS and front end CSS.
= 2.0.1: January 29, 2015 =
* Fix: Attempted Twenty 15 CSS Fix but causes issues with other themes. Manual fix: Copy CSS from style-front.css to correct, margins and grid/sorter.
* Fix: Restored Display of Inspection Label for properties with scheduled inspection times.
* Fix: Search Widget security fix and performance improvements.
= 2.0: January 27, 2015 =
* New: Extension validator.
* New: Depreciated listing-meta.php into compatibility folder.
* New: Depreciated author-meta.php into compatibility folder.
* New: Global variables: $property, $epl_author and $epl_settings.
* New: Added filters for fields and groups in /lib/meta-boxes.php
* New: Property custom meta re-written into class. This was the big change to 2.0 where we completely re-wrote the output of the meta values which are now accessible using global $property variable and easy template actions.
* New: Property meta can now can be output using new actions for easy and quick custom template creation.
* New: Reconstructed templates for single, archive & author pages
* Tweak: Removed unused price script
* Fix: Fixed warning related to static instance in strict standard modes
* New: API for extensions now support WordPress editor with validation.
* New: jQuery date time picker formatting added to improve support for auction and sold listing, support for 30+ languages support.
* New: Inspection time auto-formats REAXML date eg "13-Dec-2014 11:00am to 11:45am" and will no longer show past inspection times.
* New: Inspection time support multiple dates written one per line.
* Tweak: CSS improved with better commenting and size reduction.
* New: Dashboard widget now lists all listing status so at a glance you can see your property stock.
* New: Display: To enable grid, list and sorter your custom archive-listing.php template requires the new action hook 'epl_template_before_property_loop' before the WordPress loop.
* New: Display: Utility hook action hook added 'epl_template_after_property_loop' for future updates.
* New: Display: List and grid view with optional masonry effect.
* New: Display: Sorter added for price high/low and date newest/oldest.
* New: Auction Date formats nicely. EG "Auction Saturday 28th December at 2:00pm".
* New: Tabbed extensions page support in admin for advanced extensions like "Listing Alerts".
* New: Multiple author support in Author Box.
* New: Search Widget - Supports multiple listing types, hold Ctrl to enable tabbed front end display.
* New: Search Widget - Labels are configurable from the Display settings allowing you to set for example: "Property" to "Buy" and "Rental" to "Rent" and use a single widget to search multiple types.
* New: Search Widget and shortcode supports search by property ID, post Title, Land Area and Building Area.
* New: Search Widget - removed extra fields from land, added labels for each property type to be shown as tab heading in search widget
* Fix: Search Widget - Optimized total queries due to search widget from 1500 + to ~40
* New: Author variables accessible using new CLASS.
* New: Search short code supports array of property types.
* New: REAXML date format function to format date correctly when using WP All Import Pro. Usage [epl_feedsync_format_date({./@modTime})].
* New: REAXML Unit and lot formatting function for usage in the title when using WP All Import Pro. Usage [epl_feedsync_filter_sub_number({address[1]/subNumber[1]})].
* New: Global $epl_settings settings variable adds new default values on plugin update.
* New: Display: Added customisable label for rental Bond/Deposit.
* New: Template functions completely re-written and can now be output using actions.
* New: Added NEW sticker with customisable label and ability to set how long a listing displays the new label.
* Tweak: Compatibility fixes
* New: Bar Graph API added.
* New: Graph in admin allows you to set the max bar graph value. Default are (2,000,000 sale) and (2,000 rental).
* New: Graph visually displays price and status.
* New: Price graph now appears in admin pages quickly highlighting price and status visually.
* New: Meta Fields: Support for unit number, lot number (land).
* New: South African ZAR currency support.
* Fix: Corrected Commercial Features ID Spelling
* Tweak: YouTube video src to id function is replaced with better method which handles multiple YouTube video formats including shortened & embedded format
* New: Adding Sold Date processing
* Tweak: Updated shortcode templates
* Tweak: Global $epl_author.
* Tweak: Fixed content/ into EPL_PATH_TEMPLATES_CONTENT
* New: Support for older extensions added
* New: Extension offers in menus general tab
* Tweak: Renamed user profile options section to "Easy Property Listings: Author Box Profile".
* Tweak: Added better Bond/Deposit for rentals labels.
* Fix: Deprecated author-meta.php in compatibility folder, class-author-meta.php has been created which will be used in place of author-meta.php & its variables in all author templates
* New: Added template functions for author meta class, modified templates lib/templates/content/content-author-box-simple-card.php lib/templates/content/content-author-box-simple-grav.php lib/templates/content/content-author-box.php to use the template functions based on author meta class instead of variables from author-meta.php
* New: author-meta.php depreciated and moved to compatibility directory. Variables globally available using $epl_author variable.
* Tweak: listing-meta.php depreciated and moved to compatibility directory. Variables globally available with $property variable.
* Tweak: Added "Listing not Found" to default templates when search performed with no results.
* Tweak: Improved Google maps address output for addresses containing # and /.
* Fix: Listing Pages now have better responsive support for small screen devices like iPhone.
* Fix: Default templates for Genesis and TwentyTwelve now show "Listing Not Found" when a search result returns empty.
* Fix: Purged translations in epl.pot file.
* Fix: Search Widget and short code drastically reduces database queries.
* New: Templates are now able to be saved in active theme folder /easypropertylistings and edited. Plugin will use these first and fall back to plugin if not located in theme folder.
* Fix: Extensions Notification and checker updated
* New: updated author templates to use new author meta class
* Fix: Added prefix to CSS tab-content class. Now epl-tab-content for compatibility.
* New: Update user.php
* Tweak: Improved internal documentation and updated screens.
* Tweak: Improved descriptions on author pages.
* Tweak: Better permalink flushing on activation, deactivation and install.
* Tweak: Extensive changes to admin descriptions and labels.
* Tweak: Optimising the php loading of files and scripts.
* New: Define EPL_RUNNING added for extensions to check if plugin is active.
* New: New options added to setting array when plugin is updated.
* New: Old functions and files moved to plug-in /compatibility folder to ensure old code still works.
* New: Meta Location Label.
* New: Service banners on settings page.
* New: Saving version number so when updating new settings are added.
* New: iCal functionality for REAXML formatted inspection dates. Futher improvements coming for manual date entry.
* New: Extensions options pages now with tabs for easier usage.
* New: Added ID classes to admin pages and meta fields.
* New: Filters to adjust land and building sizes from number to select fields.
* Tweak: Moved old extensions options page to compatibility folder so older extensions still work as expected.
* New: Search Widget - Added filter for land min & max fields in listing search widget
* New: Search Widget - Added filter for building min & max fields in listing search widget
* Fix: For session start effecting certain themes
* New: Land sizes now allow up to 5 decimal places
* New: Search Widget - Custom submit label
* New: Search Widget - Can search by title in property ID / Address field
* New: Added Russian Translation
= 1.2.1: September 23, 2014 =
* Fix: Search Widget not working on page 2 of archive page in some instances.
* Fix: Property feature list Toilet and New Construction now display in list when ticked.
* Fix: EPL - Listing widget was not displaying featured listings.
* Fix: Allowed to filter by commercial_listing_type in [listing_category] shortcode.
* Fix: Updated templates to display Search Results when performing search.
* Fix: No longer show Bond when viewing rental list in admin.
* Fix: Open for inspection sticker now appears on rental properties.
* New: Added initial Dutch translation.
= 1.2: September 8, 2014 =
* New: Plug in Activation process flushes permalinks.
* New: Plug in deactivation flushes permalinks.
* New: Shortcode [listing_search]
* New: Shortcode [listing_feature]
* New: Shortcode [listing_open] replaces [home_open] shortcode. Retained [home_open] for backward compatibility, however adjust your site.
* New: Listing shortcodes allow for default template display if registered by adding template="slim" to the shortcode.
* New: Translation support now correctly loads text domain epl.
* New: Added translation tags to all test elements for better translation support.
* New: Updated source epl.pot translation file for translations.
* New: Added very rough Italian translation.
* New: Wrapped Featured image in action to allow for easy removal and/or replacement.
* New: Added new CSS classes to widgets for consistent usage.
* New: Added options to hide/ show various options to EPL - Listing widget: Property Headline, Excerpt, Suburb/Location Label, Street Address, Price, Read More Button.
* New: Added customisable "Read More" label to EPL - Listing widget.
* New: Added excerpt to EPL - Listing widget.
* New: Added options to remove search options from EPL - Listing Search widget.
* New: Added consistent CSS classes to shortcodes for responsive shortcode.
* New: Date processing function for use with WP All Import when importing REAXML files. Some imports set the current date instead of the date from the REAXML file. Usage in WP All Import Post Date is: [epl_feedsync_format_date({./@modTime})]
* New: Added additional CSS classes to template files.
* New: Added WordPress editor support in admin for use with extensions.
* New: Added textarea support in admin for use with extensions.
* New: Filters added for all select options on add listing pages which allows for full customisation through simple function.
* New: Added rent period, Day, Daily, Month, Monthly to rental listing types.
* New: Added property_office_id meta field.
* New: Added property_address_country meta field.
* New: Added filter epl_listing_meta_boxes which allows additional meta boxes to be added through filter.
* New: Added mini map to listing edit screen. Will display mini map in address block when pressing green coordinates button.
* Tweak: Admin CSS tweaks to define sections in admin.
* Tweak: Added additional CSS classes to admin menu pages to extensions can be better distinguished when installed and activated.
* Tweak: Added defaults to widgets to prevent errors when debug is on.
* Tweak: Allowed for decimal in bathrooms to allow for 1/2 baths eg 1.5.
* Fix: Undefined errors when debug is active.
* Fix: CSS for TwentyThirteen style CSS using .sidebar container.
* Fix: CSS for responsive shortcode.
* Fix: Registering custom template actions now works correctly.
* Fix: Changed property not found wording when using search widget and listing not found.
* Fix: Updated admin columns for commercial_land listing type to match other listing type.
* Fix: Swapped bedrooms/bathroom label on hover.
= 1.1.1: July 7, 2014 =
* New: Internationalisation support to enable customizing of post types: slug, archive, rewrite, labels, listing categories for meta_types.
* New: Created filters for listing meta select fields: property_category, property_rural_category, property_commercial_category, property_land_category
* New: Created filters for each of the seven custom post types: labels, supports, slug, archive, rewrite, seven custom post types
* New: Shortcode [listing_category] This shortcode allows for you to output a list of listings by type and filter them by any available meta key and value.
* Tweak: Updated search widget for filtered property_categories
* Fix: Listing categories were showing key, now showing value.
* Fix: Settings were not showing up after saving, second refresh required setting variable to reload.
= 1.1: June 27, 2014 =
* First official release!