=== Havenlytics – Real Estate Plugin with Advanced Search, Maps & Property Builder ===
Contributors: havenlytics
Donate link: https://havenlytics.com
Tags: real estate, listings, agency, property, directory plugin
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4 
Stable tag: 2.2.0
License: GPLv2 or later 
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Build modern real estate websites with advanced search, filters, maps, and a drag-and-drop property builder. Fast, flexible, and scalable.

== Description ==

Build fast, modern real estate websites in minutes with Havenlytics.

Havenlytics is a powerful WordPress real estate plugin designed for agents, agencies, and developers. Create, manage, and showcase property listings with advanced AJAX search, smart filters, interactive maps, and a visual drag-and-drop builder — all without coding.

Whether you're building a small property site or a large-scale listing platform, Havenlytics gives you full control over layouts, performance, and user experience.

Trusted by growing real estate websites worldwide.

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

= Perfect For =

- Real estate agencies  
- Property listing websites  
- WordPress developers  
- Freelancers building client sites  

== 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? =

👉 Built for Real Estate  
Designed specifically for property listings — not a generic directory plugin.

👉 Drag & Drop Property Builder  
Create and customize layouts visually without writing code.

👉 Fast AJAX Search & Filters  
Deliver instant results with advanced filtering and smooth UX.

👉 Scalable & High Performance  
Optimized for speed and large property datasets.

👉 Developer-Friendly  
Includes REST API, hooks, and template overrides.

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

= Core Features =

✅ Drag & Drop Property Builder  
Design and customize property cards with full visual control.

✅ AJAX Search & Smart Filtering  
Fast, real-time search with advanced filtering options.

✅ Interactive Maps Integration  
Display properties using maps with markers, clustering, and location search.

✅ Media & Gallery System  
Support for images, videos, virtual tours, and embedded content.

✅ Document Management  
Attach PDFs, brochures, floor plans, and more.

✅ Performance Dashboard & Cache System  
Monitor and optimize performance easily.

✅ Template Override System  
Developers can fully customize layouts via theme overrides.

✅ REST API Support  
Integrate with external apps and automate workflows.

✅ SEO-Friendly Structure  
Optimized markup and fast loading for better search visibility.

✅ Shortcodes & Layout Control  
Display listings anywhere using simple shortcodes.

= Additional Features =

- Responsive grid & list layouts  
- Mortgage calculator  
- Property view counter  
- Featured listings  
- Popup media modals  
- Social sharing integration  


= 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 ==

Easily display real estate property listings using Havenlytics shortcodes.

📺 Tutorial Video:  
[youtube https://www.youtube.com/watch?v=DJ2IYECJ_YA]

= [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/property-search/](https://demo.havenlytics.com/property-search/)


== 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! Visit: https://havenlytics.com/

== Screenshots ==
1. Advanced Filter Property Search
2. Property Grid Shortcode
3. Property Lists Shortcode
4. Manage Search Fields 
5. Property Installing Setup 
6. Property Ajax Map Search Result
7. Single Property Gallery Carousel with Popup
8. Single Property Popup Video with Popup Modal
9. Single Property map
10. Property Builder 
11. Property Builder field
12. Havenlytics Cache Management
13. Havenlytics Settings - Light Mode 
14. Havenlytics Settings - Dark Mode

== Changelog ==

= 2.2.0 (2026-05-14) =
* **New:** Multiple map providers - Leaflet (OpenStreetMap) or Google Maps with auto fallback when quota exceeded
* **New:** Google Maps setup UI with API requirements checklist, quota info, and quick enable links
* **New:** Map marker color customization and enhanced map controls (fullscreen, zoom, scroll wheel)
* **New:** Complete Preloader System with Grid/List support and bidirectional view sync
* **New:** 10+ animation styles for property cards, filter sidebar, top search, view controls, and load more
* **New:** Professional map loading animation with pulse, ripple, and progress bar effects
* **New:** Enhanced Google Maps marker with custom pin design and home icon
* **New:** Property Builder reference keys system for reliable group field retrieval
* **New:** Property Import Wizard - Step 2 (Location) and Step 3 (Media) fields are now read-only with demo data pre-filled
* **Improvement:** Settings sync between Search Property and Preloader tabs
* **Improvement:** Professional read-only field styling with lock indicators for better UX
* **Improvement:** Property Import Wizard now stores reference keys for all group fields
* **Fix:** List view preloader now works correctly when Default Property View is set to List
* **Fix:** Google Maps custom markers no longer cut off or misaligned
* **Fix:** Consistent popup styling across both Google Maps and Leaflet
* **Fix:** Map data retrieval from Property Builder auto-generated field names
* **Fix:** Single property map now respects admin map provider setting
* **Fix:** Demo data consistency for address, map, video, and gallery fields during import

= 2.1.5 (2026-04-30) =
* **Fix:** JavaScript error in property search functionality.

= 2.1.4 (2026-04-29) =
* **Fix:** Emergency property search filter currency issue.
* **Improvement:** Replaced browser alerts with custom modal for required field validation.

= 2.1.3 (2026-04-28) =
* **New:** Custom price label per property with toggle switch (numeric/label pricing)
* **New:** Dynamic price label management in Currency Settings (Create, Edit, Delete)
* **Improvement:** Automatic migration system with backup/rollback for existing price fields
* **Improvement:** Replaced direct DB queries with WordPress options API and caching
* **Improvement:** Enhanced accessibility (ARIA labels for gallery, carousel, breadcrumbs)
* **Fix:** Migration compatibility for existing installations

= 2.1.2 (2026-04-22) =
* **Fix:** Emergency property search drag and drop builder settings taxonomy field issue.

= 2.1.1 (2026-04-20) =
* **Added:** 50+ new Property Grid and Property List shortcode variations
* **Added:** Department, price range, bedrooms, bathrooms, location, status, features, tags, and badges filters
* **Added:** Custom ordering, pagination control, results bar positioning, and CSS class options
* **Enhanced:** Shortcodes UI with organized collapsible sections

= 2.1.0 (2026-04-17) =

**New Features:**
* **New:** Drag & Drop Search Builder
* **New:** Editable price, number, and field controls
* **New:** Taxonomy Term Manager
* **New:** Top Search Fields configuration
* **New:** Dynamic Sidebar Filters
* **New:** Field Configuration Modal

**Improvements:**
* **Improved:** Search UX and flexibility
* **Improved:** Property ID field locked
* **Improved:** Empty input validation with error indicators
* **Improved:** Dark mode support for modals

**Fixes:**
* **Fixed:** Default filter fields on first install
* **Fixed:** Reset settings restores defaults
* **Fixed:** Modal positioning issues

= 2.0.6 (2026-04-15) =

**Bug Fixes:**
* **Fix:** Resolved Leaflet map not loading on single property pages due to missing JavaScript dependencies
* **Fix:** Improved coordinate detection for single property maps across multiple meta key locations
* **Fix:** Enhanced map asset enqueuing to only load when property has valid coordinates

**Improvements:**
* **Improvement:** Added multiple fallback methods for retrieving latitude/longitude values in location card template
* **Improvement:** Added debug logging support for map initialization troubleshooti

= 2.0.5 (2026-04-11) =

**New Features:**
* **New:** Appsero SDK integration for optional, consent-based telemetry and usage insights
* **New:** Privacy policy disclosure for data collection compliance
* **New:** Setup Wizard admin notice for new installations with zero properties
* **New:** One-click "Run the Setup Wizard" from WordPress admin dashboard
* **New:** Dismissible welcome notice with skip option

= 2.0.4 (2026-04-08) =

* Updated support section to use official WordPress.org forums
* Minor readme improvements

= 2.0.3 (2026-04-7) =

**Major Features:**
* **New:** Dynamic Settings System with real-time CSS variable generation
* **New:** Global Color & Typography Settings for complete frontend customization
* **New:** Currency Management System with support for 160+ world currencies
* **New:** Advanced Container Width Controls with responsive breakpoint management
* **New:** Professional Color Picker with portal positioning and reset to default functionality
* **New:** Dynamic CSS caching system integrated with existing Cache Manager

**Settings Panel Enhancements:**
* **New:** Redesigned Currency Settings tab with thousand/million/billion formatting options
* **New:** Misc Settings tab for Gutenberg editor, user reviews, favorites, and social sharing
* **New:** Search Property & Search Result dropdown tabs with layout controls
* **New:** Improved Select Dropdown component with auto-positioning (opens up/down based on viewport)
* **New:** Tab Action Buttons component for consistent save/reset experience across all tabs
* **New:** Real-time settings preview with instant CSS variable updates
* **Improvement:** All settings fields now use standardized naming for better organization
* **Improvement:** Dropdown tabs now properly save and reset with parent group data
* **Improvement:** Color Picker now uses React Portal to prevent overflow clipping
* **Fix:** Resolved duplicate toast notifications on save/reset operations
* **Fix:** Fixed dropdown menu cutoff issues in nested containers
* **Fix:** Corrected settings persistence for currency and misc dropdown tabs

**Frontend Enhancements:**
* **New:** Dynamic CSS injection system for real-time style updates
* **New:** Responsive container width system with 8 breakpoint controls (XS to 4K)
* **New:** Currency formatting with proper symbol display for 160+ currencies
* **New:** Price formatting options (comma, dot, space separators)
* **New:** Large number formatting with K, M, B suffixes
* **New:** Price on Call text options (Price on Call, Fixed Price, Guide Price, Offers Over)
* **Improvement:** Enhanced price formatting function with full currency settings integration
* **Improvement:** CSS variables now available throughout frontend for complete design control

= 2.0.2 (2026-03-31) =
* **New:** Enhanced Property Import Wizard with automatic builder reset before import
* **New:** Dynamic field detection for video, gallery, map, and document group fields
* **Fix:** Property video fields now properly populate with YouTube data during import
* **Fix:** Property documents repeater fields now correctly save with icon, label, and URL
* **Fix:** Map location fields now properly import latitude and longitude coordinates
* **Fix:** Gallery fields now correctly save titles and image IDs
* **Improvement:** Added REST API integration for builder reset functionality
* **Improvement:** Better error handling and logging during import process
* **Improvement:** Updated cache admin interface with shortcode cache clearing options

= 2.0.1 (2026-03-25) =
* Updated readme and added FAQ section

= 2.0.0 (2026-03-23) =

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

= 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

== Support ==

Need help? Please use the official support forum:
https://wordpress.org/support/plugin/havenlytics/


== Privacy Policy ==

Havenlytics – WP Real Estate & Property Listings Directory uses the [Appsero](https://appsero.com/) SDK to collect limited telemetry data only after user consent.

Appsero does not collect any data by default. Data collection starts only when a user opts in via the admin notice.

No sensitive data (such as passwords, personal data, or content) is collected.

We do not sell or share data with third parties. Users can opt out at any time.

Read [Appsero Privacy Policy](https://appsero.com/privacy-policy/)