=== WPCasa - Real Estate for WordPress ===
Contributors: wpsight, kybernetikservices
Plugin URI: https://wordpress.org/plugins/wpcasa/
Donate link: https://www.paypal.com/donate/?hosted_button_id=SYJNVSP2BKTQ4
Tags: real estate, listings, property, rental, realtor
Requires at least: 6.2
Requires PHP: 7.2
Tested up to: 7.0
Stable tag: 1.5.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Flexible WordPress plugin to create professional real estate websites and manage property listings with ease. WPCasa is a worthy choice for single agents and portals.

== Description ==

WPCasa is a **real estate** WordPress solution that provides an intuitive way to manage property listings and create first-class real estate websites. No coding required.
User-friendly intuitive interface. Clean design. Flexible functionality.

* Website: [wpcasa.com](https://wpcasa.com)
* Demo: [try.wpcasa.com](https://try.wpcasa.com)
* Documentation: [docs.wpcasa.com](https://docs.wpcasa.com/)
* Add-Ons: [wpcasa.com/add-ons](https://wpcasa.com/add-ons)
* Themes: [wpcasa.com/themes](https://wpcasa.com/themes)
* GitHub: [github.com/wpsight/wpcasa](https://github.com/wpsight/wpcasa)

> Check out our latest themes [WPCasa Madrid](https://wpcasa.com/downloads/wpcasa-madrid), [WPCasa Oslo](https://wpcasa.com/downloads/wpcasa-oslo/)
and [WPCasa London](https://wpcasa.com/downloads/wpcasa-london).

= Main features =

* Quick Setup
* Awesome Listing management
* Demo data available for import at https://docs.wpcasa.com/article/import-example-data/
* Create unlimited number of listing details of type: flexible, m2, sq ft, sq yd, acre(s)
* Manage rental periods per month, per week, per year and per day.
* Google Map support
* Sorting by price, date, title
* Customizable location, categories, types, statuses, features, amenities
* Customizable property labels (featured, hot, openhouse) with [WPCasa Listing Labels](https://wpcasa.com/downloads/wpcasa-listing-labels/)
* Saved wishlists with [WPCasa Listing Favorites](https://wpcasa.com/downloads/wpcasa-favorites/)
* Mortgage calculator with [WPCasa Mortgage Calculator](https://wpcasa.com/downloads/wpcasa-mortgage-calculator/)
* Multilingual support (WPML compatible, dedicated Polylang support with our [free add-on](https://wordpress.org/plugins/wpcasa-polylang/))
* Energy certificate available with [WPCasa Energy Efficiency](https://wpcasa.com/downloads/wpcasa-energy-efficiency/)
* Support for several contact form plugins (e.g. Contact Form 7, Ninja Forms)
* Full search widget, extendable with our free add-on [WPCasa Advanced Search](https://wordpress.org/plugins/wpcasa-advanced-search/)
* Unlimited currencies
* RTL CSS (full support for right-to-left languages)
* Easy use with [shortcodes](https://docs.wpcasa.com/article/category/shortcodes/)
* Compatible with all WordPress themes
* Individually expandable, according to your own needs
* Developer-friendly with many hooks and [full documentation](https://docs.wpcasa.com/)
* Collection of [useful snippets](https://docs.wpcasa.com/article/category/snippets/)
* Continuous development
* Fully GDPR compliant
* and much, much more...

= Easy as WordPress =

WPCasa Real Estate fully integrates with the familiar and easy-to-use interface that ships with WordPress. You'll be a PRO.

= Flexible & Extendable =

With our custom themes and add-ons you can create modular a powerful real estate tool tailored to your special needs.

= Advanced Property Search =

The heart of a real estate website is a decent search. Using the advanced filters your clients will find any listing in seconds.

= Intuitive Listing Editor =

Adding property details, locations, image galleries and more is a breeze using our intuitive WPCasa listing editor.

= Works Out of the Box =

Using the existing shortcodes or the powerful template system you can use WPCasa with any WordPress theme out there.

= Admin Property Management =

You can manage great numbers of listings using the well-organized property list with filters and bulk actions.

= Integrated Maps =

Select the location of your properties through the map in the editor, display the location of each property on a single listing map, or showcase all of your listings on the overall listings map.

= Intuitive Options =

Setup date format, measurement units, listing details and much more via the intuitive and easy-to-understand admin interface

= Developer Friendly =

WPCasa comes with readable & well-documented code with loads of actions, filters and templates for developers to hook in.

= Translation Ready =

The real estate business is international. And so is WPCasa. The plugin and all our add-ons and themes are translation-ready. You can show your listings in multiple languages.

= Translations =

The translations are handled on WordPress.org. Please be part of the community and help to translate WPCasa on [GlotPress](https://translate.wordpress.org/projects/wp-plugins/wpcasa/). Thank you!

= Other Features =

* Handy shortcodes
* Template system
* Theme compatibility
* Comprehensive plugin settings
* Custom agent user roles
* Google Maps integration
* Listing print view
* Responsive elements
* schema.org mirco formats
* Extensive functions API
* RTL CSS

= Custom Post-Type =

* Listings (listing)

= Custom Taxonomies =

* Locations (location)
* Listing Types (listing-type)
* Features (feature)
* Categories (listing-category)

== Import Example Data ==

We provide you with a complete set of sample data of listings, including media files. For installation instructions, please follow our [detailed documentation](https://docs.wpcasa.com/article/import-example-data/).

== What's Next ==

Other useful [free add-ons](https://wordpress.org/plugins/search/WPCasa/) for WPCasa

WPCasa Advanced Search
WPCasa All Import
WPCasa Contact Form 7
WPCasa Gravity Forms
WPCasa Listings Map
WPCasa Ninja Forms
WPCasa Polylang
WPCasa Pricing Tables
WPCasa List Agents
WPCasa Migration Tool (NEW)

More useful [Pro add-ons](https://wpcasa.com/downloads/category/add-ons/) for WPCasa

WPCasa Dashboard
WPCasa Listing PDF
WPCasa Featured Listings
WPCasa Listing Labels
WPCasa Favorites
WPCasa Currency Converter
WPCasa Expire Listings
WPCasa Energy Efficiency (NEW)
WPCasa Mortgage Calculator (NEW)

= WPCasa Native Themes =

Check out our [WPCasa themes](https://wpcasa.com/downloads/category/themes/) for your real estate website:

upTown Real Estate (free)
WPCasa Madrid
WPCasa Oslo
WPCasa London
WPCasa Sylt
WPCasa Bahia
WPCasa Elviria

== Installation ==

= Automatic Installation =

Automatic installation is the easiest way to install WPCasa. Log into your WordPress admin and go to _WP-Admin > Plugins > Add New_.

Then type "WPCasa" in the search field and click _Install Now_ once you've found the plugin.

= Manual Installation =

If you prefer to install the plugin manually, you need to download it to your local computer and upload the unzipped plugin folder to the `/wp-content/plugins/` directory of your WordPress installation. Then activate the plugin on _WP-Admin > Plugins_.

= Getting Started =

Once you have installed and activated WPCasa you will find a new page called "Listings" with the `[wpsight_listings]` shortcode. Add your listings on _WP-Admin > Listings > Add New, and they will be listed on that page.

For more information about how to get started please [read our documentation](https://docs.wpsight.com/).

== Frequently Asked Questions ==

= Which shortcodes are included? =

* `[wpsight_listings]`: Displays a list of your latest properties
* `[wpsight_listings_search]`: Displays the property search form
* `[wpsight_listing]`: Displays a single listing
* `[wpsight_listing_teasers]`: Displays a list of property teasers
* `[wpsight_listing_teaser]`: Displays a single property teaser
* `[wpsight_listings_map]`: Displays a Map with all your listings as markers if they have a location assigned

For more information about shortcodes please [read our documentation](https://docs.wpcasa.com/article/shortcodes/).

= Where can I change currency, measurements, etc.? =

You can fit general plugin settings to your needs on _WP-Admin > WPCasa > Settings > [tab] Listings_. Things like listing ID prefix, measurement unit, currency, standard listing details, rental periods and more can be set here.

= Is WPCasa free? =

Yes, the core features are free. Additionally, we offer free and paid add-ons and themes exclusively built for WPCasa.

= Does WPCasa support the block editor (aka Gutenberg)? =

Let's say yes, but don't expect blocks to build your pages. With WPCasa 1.4.0 we have added block editor support (which needs to be enabled in the WPCasa settings) which allows you to use all WPCasa related data in the block editor. This allows you to create your own output with the loop block, for example.
However, you can still use our [shortcodes](https://docs.wpcasa.com/article/category/shortcodes/) with the block editor.

= Does WPCasa include a listing gallery? =

Yes and no. WPCasa provides the data structure for an image gallery for listings. However, WPCasa does not have a gallery for output in the frontend. The reason is that the theme usually provides galleries. We want to avoid having to load the code for different galleries on one page. The developer of the theme must therefore ensure compatibility with WPCasa and can then activate the addition of images for the gallery. Otherwise, only the featured image can be added to the listing.

= Do you use a third Party or external service? =

We do not use any third Party providers or external services, but on the backend pages `WPCasa > Add-Ons`, `WPCasa > Themes` and `WPCasa > Licenses` we load some information from our URL wpcasa.com. This is just to provide you with the latest information for further downloads. So that you have the opportunity to adapt WPCasa to your needs. We do not collect personal information or track your behavior. It's just about providing you with better service. If you do not want this, please do not open the mentioned pages! WPCasa also works without you having to visit the sites.

= Why do you use external services?  =

We do call Google Maps when you view the listing map where we have placed the listings on it. For this you have to add your Google Maps key.
We call [goqr.me](https://goqr.me/) when you print a listing. This service allows us to add a QR code on the last page.

= Where is the *.pot file for translating the plugin in any language? =

The translations are handled on WordPress.org. Please be part of the community and help to translate WPCasa on [GlotPress](https://translate.wordpress.org/projects/wp-plugins/wpcasa/). Thank you!

= Is WPCasa running with PHP 8+? =

Yes. Since version 1.2.12 we call WPCasa PHP 8+ compatible. Not optimized, but runs fine with PHP 8+ (which is what we've noticed so far).
In the future, we will improve the codebase to gradually adopt and optimize it for PHP 8.

= How can I contribute? =

If you find WPCasa an interesting project, please feel free to have a look at our [GitHub repo](https://github.com/wpsight/wpcasa).

== Screenshots ==

1. Listings archive
2. Single listing
3. Listing teasers
4. Property search form (horizontal)
5. Property search form (vertical)
6. Plugin settings
7. Property Management

== Contributors ==
This is a list of contributors to WPCasa.
Many thanks to all of them for contributing and making WPCasa even better.

[Mrinal Haque](https://profiles.wordpress.org/mrinal013/)
[Kybernetik Services](https://www.kybernetik-services.com/?utm_source=wordpress_org&utm_medium=plugin&utm_campaign=wpcasa&utm_content=readme)
[Joe Hana](https://wordpress.org/support/users/joehana/)
[Fabian Marz](https://github.com/fabianmarz)
[mistercode](https://wordpress.org/support/users/mistercode/)
[Luiz Bills](https://github.com/luizbills)
[Walter Barcelos](https://walterbarcelos.com)
[Leonardo Lima de Vasconcellos](https://www.devhouse.com.br/)
[Laura Vanoni](www.simboliweb.it)
[Nicola Turato](https://www.linkedin.com/in/nicolaturato)
Andrea Manzato
[Danijel Cukarić](https://pistacio.hr)
[Dennis Onstenk](https://citymakelaardij.nl)
[Systemo](https://systemo.biz)
[Adrian Mocanu](https://www.bitopia.ro)
[Jana Mičeková](https://www.jmsupport.sk)
[Simon Rimkus](https://github.com/simonrimkus)

== Changelog ==
= 1.5.2 =
* NEW: Added promotional message for translation.
* TWEAK: Added redirect to about page after an update.

= 1.5.1 =
* NEW: max_nr attribute for 'wpsight_listings' shortcode to limit listings output without pagination ( check also the [documentation](https://docs.wpcasa.com/article/shortcode-wpsight_listings/) ).
* FIX: Fixed warning 'open_basedir' restriction when no listing was found.
* TWEAK: Improved RTL (right-to-left) on WPCasa settings pages in WordPress backend.
* TWEAK: Added notice when editing agent information on user page.

= 1.5.0 =
* NEW: Added the option to also delete the listings media files when a listing is deleted.
* NEW: Added an admin notice for outdated WPCasa themes that require an update to keep the single listing location output working.
* NEW: Added an admin notice inviting users to [review WPCasa](https://wordpress.org/plugins/wpcasa/#reviews) on WordPress.org.
* NEW: Added helpful links to the plugin row meta on the plugins overview screen.
* NEW: Added new logo.
* FIX: Added WPCasa user roles on activation and remove them on deactivation.
* TWEAK: Changed call of itemscope itemtype from http to https
* TWEAK: Load Google Maps API only when an API key is available.
* TWEAK: Improved Google Maps API loading with async callback handling for listing maps.
* TWEAK: Improved message handling for discontinued WPCasa add-ons.
* TWEAK: Introduced uninstall.php to remove all WPCasa data when uninstalling the plugin.
* TWEAK: Improved PHP 8 compatibility.

= 1.4.3 =
* FIX: Not showing message when no listing available (thanks to @DAnn2012 on github)
* TWEAK: Badge for new add-ons on add-on page

= 1.4.2 =
* FIX: Vulnerable to cross site scripting (XSS) with shortcodes 'wpsight_listings_map' reported by Muhammad Yudha - DJ on Patchstack - Thank you for that!
* FIX: Vulnerable to API code injection reported by mikemyers from Wordfence - Thank you for that!
* FIX: Deprecated message "Creation of dynamic property"
* FIX: "Trying to access array offset on false" on settings page

= 1.4.1 =
* FIX: The license page may show an error under certain circumstances

= 1.4.0 =
* NEW: Added basic compatibility with the block editor and REST API endpoints for listings and all related taxonomies.
* NEW: Added energy efficiency diagram to page printout. Requires [WPCasa Energy Efficiency](https://wpcasa.com/downloads/wpcasa-energy-efficiency).
* NEW: Added color selector for use on the settings page, as with [WPCasa Featured Listing](https://wpcasa.com/downloads/wpcasa-featured-listing) and [WPCasa Listing Labels](https://wpcasa.com/downloads/wpcasa-listing-labels).
* NEW: Added note if the updater class for paid plugins is missing.
* TWEAK: Twitter renamed to X.
* TWEAK: Translation settings improved and missing strings for translation added.
* FIX: Textdomain WPCasa was loaded too early.
* FIX: Message if no image is assigned to an agent.
* FIX: Vulnerability for Cross Site Scripting (XSS) fixed (thanks to Patchstack).

= 1.3.2 =
* TEWAK: Text improvements

= 1.3.1 =
* TWEAK: Added string translation for listing details
* UPDATE: CMB2 updated to 2.11.0
* FIX: Fixed authenticated stored XSS (Thanks to Vlad Nikandrov)

= 1.3.0 =
* NEW: Added input field for longitude and latitude to manually set the location of the listing
* NEW: Switch to using language files from [GlotPress](https://translate.wordpress.org/projects/wp-plugins/wpcasa/).
* NEW: Sanitize price before saving and remove
* NEW: A decimal separator has been added in preparation for upcoming functions that require a decimal separator.
* NEW: Option to select Swiss Franc currency symbol between 'SFr.' and 'CHF'. Default 'CHF'
* TWEAK: The settings for thousands separator are more flexible, now. Countries that do not use commas or periods are now also covered.
* TWEAK: Improved use of singular and plural string translation
* TWEAK: Minified JS files for increase page load
* TWEAK: Improved PHP 8 compatibility
* FIX: Added missing file needed for [WPCasa Dashboard](https://wpcasa.com/downloads/wpcasa-dashboard/) to show the map
* FIX: Fixed some notice when debug mode is activated
* FIX: Fixed SQL error on media page when `WP_DEBUG` is activated
* FIX: Fixed insecure direct object references (IDOR) (Thanks to Patchstack)

= 1.2.13 =
* FIX: QR code on listing single page was not working anymore. Switched from Google to the free QR Code Generator (goqr.me)[https://goqr.me]

= 1.2.12 =
* TWEAK: Compatible with PHP 8+
* FIX: Listing Map styling of listing in popup box

= 1.2.11 =
* NEW: Added upgrade notice on WordPress plugin page
* TWEAK: Updated plugin header with file-level PHPDoc DocBlock
* TWEAK: Ensure compatibility with WordPress 6.5
* FIX: Listing Map settings didn't save new value
* FIX: In some cases, toggling the Listing Map link did not work
* FIX: Removed unwanted extra character after description on listing single page

= 1.2.10.1 =
* FIX: Search form stopped working for some non-WPCasa themes

= 1.2.10 =
* FIX: Improved title escaping for compatibility with [WPCasa Listing Labels](https://wpcasa.com/downloads/wpcasa-listing-labels/)
* FIX: Load WPCasa CSS on all pages, not just on the single listing pages
* TWEAK: Minimization of all CSS to improve the loading speed of the page

= 1.2.9.2 =
* FIX: Improved html escaping on listing page for compatibility with [WPCasa Listing Labels](https://wpcasa.com/downloads/wpcasa-listing-labels/)

= 1.2.9.1 =
* FIX: Additional classes for listings were no longer taken into account

= 1.2.9 =
* TWEAK: Fixed guideline violation
* TWEAK: Optimized code base
* TWEAK: Bumped required WordPress version to 6.2
* TWEAK: Removed server info panel in favor of Site Health tools
* TWEAK: Improved speed of database query to get listings
* TWEAK: Improved WPCasa about page
* FIX: Listing filter with 'wpsight_exclude_unavailable' stopped working
* FIX: Issue of not assigning default value after activation in checkbox
* FIX: Apply and separate listing map default
* UPDATE: Updated cmb2 to 2.10.1

= 1.2.8 - 2021/10/28 =
* TWEAK: Optimized code base

= 1.2.7 - 2021/10/28 =
* TWEAK: Sanitized input fields and data
* TWEAK: Modifications to the Newsletter Panel in WPCasa Settings.
* UPDATE: Updated CMB2 to 2.9.0

= 1.2.6 - 2021/07/20 =
* NEW: Added German Formal Translation
* NEW: Added filter wpsight_listing_text_not_available to customize the informal text when a listing is not available
* TWEAK: Improved embedment of previously integrated functionality from WPCasa Listings Map and WPCasa Admin Map UI
* TWEAK: Data for Javascript gets now provided through wp_add_inline_script instead of wp_localize_script
* TWEAK: Improved data escaping
* UPDATE: Updated swiper.js to 6.7.5

= 1.2.5 - 2021/02/09 =
* FIX: Fixed admin license page issue
* TWEAK: Ensure compatibility with latest version of WordPress

= 1.2.4 - 2020/05/26 =
* FIX: Fixed licenses activation

= 1.2.3 - 2020/04/01 =
* TWEAK: Add ability to disable listing map displaying

= 1.2.2 - 2020/03/31 =
* FIX: Fixed reinitialize map coordinates in some cases when dev mode is true

= 1.2.1 - 2020/03/23 =
* FIX: Fixed map functionality after deleting WPCasa Listing Map plugin

= 1.2.0 - 2020/03/20 =
* NEW: Complete revamp of the WPCasa Admin UI
* NEW: Integration of WPCasa Admin Map UI
* NEW: Integration of WPCasa Listings Map
* NEW: Ability to restore settings to default
* NEW: Ability to delete all data
* NEW: Added recommends items
* TWEAK: Improved license algorithm
* TWEAK: Updated file/folder structure
* TWEAK: Improved map searching algorithm
* TWEAK: Multiple plugin activation
* TWEAK: Tested up to WordPress 5.3.2
* FIX: Fixed bulk listing edit
* UPDATE: Update CMB2 to 2.6.0

= 1.1.0 - 2019/09/02 =
* Tested up to WordPress 5.2
* Added Italian Translation
* Added French Translation
* Added Croatian Translation
* Added Dutch Translation
* Added Russian Translation
* Added Romanian Translation
* Added Slovak Translation
* Added Farsi Translation
* Added Brazilian Real currency symbol
* Added option to query for available/unavailable items
* Added filter 'wpsight_geolocation_args' for improved geolocation args control
* Added filter 'wpsight_listing_single_output' for improved single listing output control
* Improved PHP Compatibility
* Improved 'wpsight_get_currency' filter hook
* Improved Currency Symbol Display
* Improved Listing Details Label Display by including the ':' with CSS
* Changed default order for listing type and location in search form
* Fixed 'edit_listings' capability was set twice in class-wpsight-agents.php
* Fixed reference conditional tag to corresponding query
* Fixed rental period was returned as NULL
* Fixed PHP Error caused by not properly checking if $var is an array
* Fixed notice caused by missing array on listing details
* Various other minor fixes

= 1.0.6.1 =
* Tested up to WordPress 4.5.3
* Added option to enter Google Maps API key

= 1.0.6 =
* Tested up to WordPress 4.5
* Add Brazilian Portuguese language files
* Fix typo in German language files
* Make sure $_GET values in listings search are escaped correctly
* Make sure wpsight_exclude_unavailable filter works correctly
* Make sure default rental periods are set correctly
* Rebuild custom agent profiles fields using CMB2 meta boxes
* Minor updates in German and Spanish language files

= 1.0.5 =
* Add Spanish language files

= 1.0.4.1 =
* Add wpsight_profile_agent_update_post_meta filter for WPCasa Polylang

= 1.0.4 =
* Improve maybe_update_gallery()
* Add missing string in German translation
* Add property management plugin screenshot

= 1.0.3.1 =
* Hotfix to avoid fatal error with wpsight_taxonomies() in v1.0.3 and some themes

= 1.0.3 =
* Hide listing label when label is empty
* Hide rental periods when label is empty
* Fix default handling in wpsight_get_option()
* Minor code cosmetics

= 1.0.2 =
* Add wpsight_get_option filter hook
* Make location fields visible in dashboard
* Add helper function wpsight_taxonomies()
* Correct WPSight_Geocode class name

= 1.0.1 =
* Fix custom query pagination (offset must be set or empty string)
* Fix CMB2 group fields handling through wpsight_meta_boxes filter

= 1.0.0 =
* Initial release

== Upgrade Notice ==
= 1.5.0 =
Recommended update with a new feature to delete listing media files when removing a listing, improved Google Maps API loading, and safer role setup on activation and deactivation.

= 1.4.1 =
With this version we are starting to add basic compatibility with block editor (aka Gutenberg). It includes also new REST API endpoints for listings and all associated taxonomies. You can control this new feature on the settings page.
In addition, we have renamed Twitter to X to match the official wording and we have fixed an issue on the license page.

= 1.4.0 =
With this version we are starting to add basic compatibility with block editor (aka Gutenberg). It includes also new REST API endpoints for listings and all associated taxonomies. You can control this new feature on the settings page.
In addition, we have renamed Twitter to X to match the official wording.

= 1.3.0 =
We have changed the loading of the language files of [GlotPress](https://translate.wordpress.org/projects/wp-plugins/wpcasa/). This means that the language files included in the plugin are no longer available. If you find that the WPCasa output is now in English instead of your local language, please go to [GlotPress](https://translate.wordpress.org/projects/wp-plugins/wpcasa/) and translate WPCasa into your local language. This way the community can benefit from your translation, just as you benefit from WPCasa.
Please note: WordPress 6.6 has dropped support for PHP 7.0 and 7.1, so in the upcoming updates we will also drop PHP support for older and unsecure PHP versions up to PHP 7.1. If you would like to benefit from further WPCasa updates from the end of 2024, please keep in mind that you must be running at least PHP 7.2 on your server.

= 1.2.13 =
We have fixed the non-functioning QR code on the single page and made sure that WPCasa works correctly with WordPress 6.6.

= 1.2.12 =
This version is now compatible with PHP8+ and we fixed a styling issue with the popup of Listings Map.
Please note: WordPress 6.6 will drop support for PHP 7.0 and 7.1, so in the upcoming updates we will also start dropping PHP support for older and unsecure PHP versions up to PHP 7.1. If you would like to benefit from further WPCasa updates from the end of 2024, please keep in mind that you must be running at least PHP 7.2.
