=== Houzez Off-Plan Search ===
Contributors: yourname
Tags: houzez, real estate, property search, off-plan
Requires at least: 5.0
Tested up to: 6.4
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds an off-plan property search page with AJAX filtering for the Houzez theme.

== Description ==

Houzez Off-Plan Search is a WordPress plugin that extends the Houzez real estate theme with a shortcode-based off-plan property search functionality.

Features:
* Three taxonomy filters: Community (property_area), Projects (property_developers), and Developer (property_developers)
* AJAX-powered search with no page reload
* Selectable card styles (v1-v7) via shortcode attributes
* Grid view only (no list view)
* Automatically filters properties by "off-plan" status
* Only shows developers/projects that have off-plan properties
* Responsive design
* Can be used anywhere via shortcode

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/houzez-offplan-search` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Ensure the Houzez theme is installed and active
4. Add the shortcode `[houzez_offplan_search]` to any page, post, or widget
5. Use shortcode attributes to customize card style and other options

== Frequently Asked Questions ==

= Does this plugin require the Houzez theme? =

Yes, this plugin requires the Houzez theme to be installed and active.

= How do I change the card style? =

Use the `card_style` attribute in the shortcode. For example:
`[houzez_offplan_search card_style="v5"]`

Available card styles: v1, v2, v3, v4, v5, v6, v7 (default: v7)

= Can I use list view? =

No, this plugin only supports grid view to match the design requirements.

= How do I use the shortcode? =

Basic usage:
`[houzez_offplan_search]`

With custom card style:
`[houzez_offplan_search card_style="v5"]`

With custom posts per page:
`[houzez_offplan_search posts_per_page="12"]`

With custom columns (2, 3, or 4):
`[houzez_offplan_search columns="3"]`
`[houzez_offplan_search columns="4"]`

Hide filters:
`[houzez_offplan_search show_filters="no"]`

Hide sort options:
`[houzez_offplan_search show_sort="no"]`

Combine attributes:
`[houzez_offplan_search card_style="v3" posts_per_page="15" columns="3" show_sort="no"]`

= What taxonomies are used? =

The plugin filters by:
* property_area (Community)
* property_developers (Projects and Developer)
* property_status (must be "off-plan")

== Changelog ==

= 1.0.0 =
* Initial release
* Off-plan search page template
* Three taxonomy filters with AJAX
* Card style selection (v1-v7)
* Grid view only

== Upgrade Notice ==

= 1.0.0 =
Initial release of the plugin.

