=== Havenlytics – WP Real Estate & Property Listings Directory ===
Contributors: havenlytics
Donate link: https://havenlytics.com
Tags: real estate, property listings, property management, property search, real estate directory
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4 
Stable tag: 2.0.1
License: GPLv2 or later 
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Powerful WordPress real estate plugin with listings, AJAX search, maps, galleries, drag-and-drop builder, ready for AI features.

== Description ==

Havenlytics transforms WordPress into a powerful real estate management platform. Designed for agents, agencies, and property managers, it lets you create, manage, and showcase property listings with advanced features like AJAX search, interactive maps, galleries, and a drag-and-drop Property Builder. Fully responsive and SEO-friendly, Havenlytics helps buyers find properties quickly while giving you complete control over layouts, listings, and workflows.

📘 Documentation: [https://havenlytics.com/documentation/](https://havenlytics.com/documentation/)  
🚀 Live Demo: [https://demo.havenlytics.com/](https://demo.havenlytics.com/)  
🌐 Official Website: [https://havenlytics.com/](https://havenlytics.com/)  

== Havenlytics Setup Wizard – Complete Property Setup Guide ==

📺 Watch the step-by-step tutorial:  
[youtube https://www.youtube.com/watch?v=kLe3GFtoL-8&t=17s]

= Why Havenlytics? =

📺 Watch Demo Video:  
[youtube https://www.youtube.com/watch?v=2LQrba9rIrg]

👉 **Purpose-Built for Real Estate**  
Unlike generic directory plugins, Havenlytics is designed specifically for property listings. Every feature is tailored for real estate — including bedroom/bathroom filters, property maps, document management, and video tours.

👉 **High Performance & Speed**  
Enjoy lightning-fast loading with intelligent caching. Listings load instantly, searches return results in milliseconds, and your users experience smooth browsing even with large datasets.

👉 **Complete Control Without Coding**  
Customize everything visually using the Property Builder. Drag, drop, reorder, and control visibility without writing a single line of code.

👉 **Built for Scalability**  
Whether you manage 10 or 10,000 properties, Havenlytics scales effortlessly with optimized database handling, cleanup tools, and REST API support.

= Core Features at a Glance =

✅ **Visual Property Builder:**  
Design beautiful and fully customizable property cards using an intuitive drag & drop builder. Add unlimited fields, rearrange elements, and create grid or list layouts that match your brand perfectly.

✅ **AJAX Search & Smart Filtering:**  
Deliver instant search results without page reloads. Advanced filtering options help users quickly find exactly what they’re looking for.

✅ **Interactive Maps Integration:**  
Display properties using Leaflet-powered maps with marker clustering and address autocomplete for enhanced user experience.

✅ **Advanced Document Management:**  
Attach PDFs, brochures, EPCs, floor plans, virtual tours, and more. Includes icon selection and automatic URL type detection.

✅ **Flexible Media & Gallery System:**  
Create stunning galleries with repeater fields, drag-and-drop ordering, and support for images, videos, and embedded media.

✅ **Performance Dashboard & Cache System:**  
Monitor cache usage, view performance metrics, and clear caches easily to maintain optimal speed.

✅ **Template Override System:**  
Developers can fully customize layouts by overriding templates within their theme.

✅ **REST API Support:**  
Integrate with external applications and automate property management workflows programmatically.

✅ **SEO-Friendly Structure:**  
Clean permalinks, optimized markup, and fast loading ensure better search engine visibility.

✅ **Shortcodes & Layout Control:**  
Display property grids, lists, and search forms anywhere using simple shortcodes.

✅ **Additional Features Include:**
- Responsive Grid & List layouts
- Mortgage calculator
- Property view counter
- Featured listings
- Popup modals for media
- Social media integration
- Multi-CPT ready architecture
- Database cleanup tools


= What Makes Havenlytics Different =

👉 **Lightweight & Clean Code**  
No unnecessary bloat — just focused, efficient real estate functionality for better performance and stability.

👉 **Developer-Friendly**  
Includes 50+ hooks, filters, and a complete REST API for maximum extensibility.

👉 **User-Centered Experience**  
Intuitive UI for both admins and users, making property management simple and effective.

== 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. Navigate to "Havenlytics" in your admin menu to configure settings
4. Use the shortcodes to display properties on your pages

== Automatically Created Pages ==

The following pages will be automatically created upon plugin activation (if not already present):

- Property Grid — Havenlytics
- Property Lists — Havenlytics
- Property Search — Havenlytics

== Shortcodes ==

= [hvnly_property_grid] =
Display properties in a responsive grid layout.
Live Demo: [https://demo.havenlytics.com/property-grid/](https://demo.havenlytics.com/property-grid/)

= [hvnly_property_lists] =
Display properties in a vertical list layout.  
Live Demo: [https://demo.havenlytics.com/property-lists/](https://demo.havenlytics.com/property-lists/)


= [hvnly_property_search] =
Display advanced property search with filters.
Live Demo: [https://demo.havenlytics.com/](https://demo.havenlytics.com/)


== Frequently Asked Questions ==

= How do I change the layout? =

Use either the [hvnly_property_grid] or [hvnly_property_lists] or [hvnly_property_search] shortcode depending on your preferred layout. You can also customize layouts through the Property Builder in the admin area.

= Can I customize the design? =

Yes! You can override templates by placing files in your theme's havenlytics/ directory, or use the visual Property Builder to customize without code.

= How do I add custom fields? =

Use the Property Builder's "Add Property Form" tab to drag and drop custom fields into your property submission form.

= How do I create property documents? =

Add a "Property Documents" group in your property form builder. This creates a repeater field where you can add multiple documents with icons, labels, and URLs.

= Does it support maps? =

Yes! Havenlytics includes Leaflet maps with marker clustering. You can add multiple map groups per property with address autocomplete.

= Is it mobile responsive? =

Absolutely. All templates are fully responsive and work beautifully on phones, tablets, and desktops.

= How do I clear the cache? =

Go to Havenlytics → Cache Dashboard. You can clear specific caches (search, sidebar, terms) or clear everything with one click.

= Can developers extend it? =

Yes! Havenlytics includes 50+ action hooks and filters, a complete REST API, and an extensible field types system.

= Can I hire your development team? =

Yes, our team is available for hire. If you need custom features, integrations, or dedicated development support, feel free to contact us at hireteam@havenlytics.com.

== Screenshots ==
1. Advanced Filter Property Search
2. Property Grid Shortcode
3. Property Lists Shortcode
4. Property Installing Setup 
5. Property Ajax Map Search Result
6. Single Property Gallery Carousel with Popup
7. Single Property Popup Video 
8. Single Property map
9. Property Builder 
10. Property Builder field
11. Havenlytics Cache Management
12. Havenlytics settings
13. Havenlytics Report and analytics

== Changelog ==

= 2.0.1 (2026-03-25) =
* Add more info in plugin readme file.

= 2.0.0 (2026-03-23) =

**Major Release:** Complete rewrite with new architecture

**NEW**: Visual Property Builder with drag-and-drop interface

**NEW**: Advanced caching system with performance dashboard

**NEW**: Document management with icon selector and URL type detection

**NEW**: Multiple map groups per property with autocomplete

**NEW**: Gallery repeater fields with drag-and-drop ordering

**NEW**: Video fields with thumbnail support

**NEW**: REST API endpoints for property management

**NEW**: Database cleanup and optimization tools

**NEW**: Shortcode cache invalidation system

**NEW**: View count tracking and analytics

**NEW**: Template override system with better documentation

**NEW**: AJAX filtering with URL state persistence

**NEW**: Multiple map group conflicts

**IMPROVED**: Mobile responsiveness across all components

**IMPROVED**: Performance optimization with compression

**FIXED**: Gallery field ID collisions

**FIXED**: Document field saving issues

= 1.0.13 (2025-08-12) =
* Fix: Editor font issue in backend

= 1.0.12 (2025-08-02) =
* Fix: Pagination handling for homepage

= 1.0.11 (2025-07-28) =
* Minor code fixes
* Enhancement: Property price formatting

= 1.0.10 (2025-07-27) =
* Minor Owl Carousel JS bug fix

= 1.0.9 (2025-07-27) =
* Added frontend chart widget
* Dynamic canvas rendering using Chart.js
* Improved i18n and UI enhancements

= 1.0.8 (2025-07-26) =
* Property view counter
* Automatic page creation
* Mortgage calculator

= 1.0.7 (2025-07-23) =
* Fixed responsive UI issues
* Organized modal templates
* Added `ABSPATH` check
* Featured property filter support

= 1.0.6 (2025-07-22) =
* Dynamic featured properties in carousel
* Enable/disable "Featured Property" per listing
* Automatic pagination dots

= 1.0.5 (2025-07-13) =
* Feedback form link
* Documentation improvements
* Performance and security tweaks
* Preview for PDF/image fields
* Iframe integration for brochure/EPC/virtual tours
* Custom popup modals for amenities

= 1.0.4 =
* UI/UX improvements

= 1.0.3 =
* Frontend improvements with Bootstrap
* Improved responsiveness
* Optimized layout and accessibility
* Clean HTML output
* Minor CSS fixes

= 1.0.2 =
* Initial release: Grid & list view, filtering, customizable settings

= 1.0.0 =
* Initial release: Grid & list view, filtering, customizable settings

== Upgrade Notice ==

= 2.0.0 =
Major version upgrade with new Property Builder, advanced caching, document management, and REST API. Backward compatible with existing templates and shortcodes.

== System Requirements ==

WordPress 6.0 or higher
PHP 7.4 or higher (8.0+ recommended)
MySQL 5.6 or higher
Modern browser with JavaScript enabled

== Support ==

📧 Email: [support@havenlytics.com](mailto:support@havenlytics.com)  
🌐 Website: [https://havenlytics.com](https://havenlytics.com)  
📘 Documentation: [https://havenlytics.com/documentation/](https://havenlytics.com/documentation/)  
🔗 WordPress.org: [https://wordpress.org/plugins/havenlytics/](https://wordpress.org/plugins/havenlytics/)

== License ==

GNU General Public License v2 or later - http://www.gnu.org/licenses/gpl-2.0.html
This program is free software; you can redistribute and/or modify it under the terms of the GPL v2 or later.