=== Havenlytics – Real Estate & Property Listings ===
Contributors: Havenlytics
Donate link: https://havenlytics.com
Tags: property listing, real estate, property management, WP plugin, real estate plugin
Requires at least: 5.0  
Tested up to: 6.8
Requires PHP: 7.2  
Stable tag: 1.0.2
License: GPLv2 or later 
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A property listing plugin for WordPress that allows users to easily manage and display property listings.

== Description ==

Havenlytics is a powerful real estate and property listing plugin for WordPress that helps you showcase properties with beautiful grid and list views. With advanced filtering, sorting, and display options, it's perfect for real estate agencies, property managers, and individual agents.

= Key Features =
- Display properties in grid or list view
- Advanced filtering by price, bedrooms, bathrooms, status, and type
- Customizable display options (show/hide elements)
- Responsive design that works on all devices
- Pagination support
- Multiple shortcode options for maximum flexibility
- Custom templates for complete design control

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/havenlytics` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Use the shortcodes to display properties on your pages

== Shortcodes ==

= Grid View =
Display properties in a responsive grid layout:

`[havenlytics_grid]`

= List View =
Display properties in a vertical list layout:

`[havenlytics_list]`

= Shortcode Attributes =
Both shortcodes support the following attributes:

* `posts_per_page` (number) - Number of properties to show per page (default: 3)
* `orderby` (string) - Sort by: 'date', 'title', 'price', or 'rand' (default: 'date')
* `order` (string) - Sort order: 'ASC' or 'DESC' (default: 'DESC')
* `category` (string) - Comma-separated category slugs to filter by
* `status` (string) - Comma-separated status values (for_sale, for_rent, etc.)
* `type` (string) - Comma-separated property types (single_family, condo, etc.)
* `min_price` (number) - Minimum price filter
* `max_price` (number) - Maximum price filter
* `bedrooms` (number) - Minimum bedrooms filter
* `bathrooms` (number) - Minimum bathrooms filter
* `featured` (string) - Show only featured properties: 'yes' or 'no'
* `excerpt_length` (number) - Number of words in excerpt (default: 20 for grid, 30 for list)
* `show_price` (string) - Show price: 'yes' or 'no' (default: 'yes')
* `show_beds` (string) - Show bedrooms: 'yes' or 'no' (default: 'yes')
* `show_baths` (string) - Show bathrooms: 'yes' or 'no' (default: 'yes')
* `show_sqft` (string) - Show square footage: 'yes' or 'no' (default: 'yes')
* `show_excerpt` (string) - Show excerpt: 'yes' or 'no' (default: 'yes')
* `show_location` (string) - Show location: 'yes' or 'no' (default: 'yes')

== Usage Examples ==

= Basic Grid =
`[havenlytics_grid posts_per_page="6"]`

= Filtered List =
`[havenlytics_list 
   posts_per_page="4"
   status="for_sale"
   type="single_family,condo"
   min_price="200000"
   max_price="500000"
   bedrooms="2"
   show_sqft="no"
]`

= Sorted by Price =
`[havenlytics_grid orderby="price" order="ASC"]`

= Minimal Display =
`[havenlytics_list show_excerpt="no" show_baths="no"]`

== Frequently Asked Questions ==

= How do I change the layout? =
Use either the `[havenlytics_grid]` or `[havenlytics_list]` shortcode depending on your preferred layout.

= Can I customize the design? =
Yes! You can override the templates by placing files in your theme's `havenlytics/templates/` directory.

= How do I filter properties? =
Use the various filter attributes like `status`, `type`, `min_price`, etc. in the shortcode.

== Screenshots ==
1. Property Grid View
2. Property List View
3. Shortcode examples
4. Filtered results example

== Changelog ==

= 1.0.0 =
* Initial release of Havenlytics plugin
* Grid and list view shortcodes
* Advanced filtering and sorting options
* Customizable display settings

== Upgrade Notice ==

= 1.0.0 =
Initial release of Havenlytics plugin.

== License ==
GNU General Public License v2 or later