=== Havenlytics – Real Estate Plugin with Advanced Search, Maps & Property Builder ===
Contributors: havenlytics
Donate link: https://havenlytics.com
Tags: real estate, listings, agency, property, agents
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4 
Stable tag: 3.0.3
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, agent/agency archives, Elementor widgets, and a drag-and-drop property builder.

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

= Be Part of Our Ecosystem = 

👉 [Join Havenlytics Facebook Community](https://facebook.com/groups/havenlytics/)   
👉 [Subscribe to Our YouTube Channel](https://www.youtube.com/@havenlytics)  
👉 [Need Help? Contact Support](https://havenlytics.com/support/)


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

✅ Elementor Integration
Three dedicated Elementor widgets under the **Havenlytics** category — Property Archive, Property Agents, and Property Agency — with responsive layouts, AJAX search, style controls, and global settings sync.

✅ Agent & Agency Management
Agent profiles, agency taxonomies, availability badges (Available, Busy, Away, Offline), property assignment, and archive pages with grid/list views.

✅ Drag & Drop Search Builder
Create advanced property search forms and sidebar filters without writing code.

✅ Property Import Wizard
Quickly import and configure property listings using a guided setup process with media, maps, and custom field support.

✅ 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.

✅ Email Notifications & Templates  
Centralized Email settings tab for transactional emails — import success notifications, customizable sender details, merge tags, and an extensible template system for future agent and account emails.

✅ 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 properties, agents, and agencies anywhere using shortcodes — with 50+ property variations and copy-ready examples in **Settings → Shortcodes**.

= Additional Features =

- Responsive grid, list, and map layouts  
- Contact Agent inquiry forms with email notifications and admin inbox  
- Agent availability status with contact form gating for offline agents  
- Global property share popup (platform list driven from settings)  
- WordPress sidebar widgets — mortgage calculator, featured/related properties, agent card  
- Property view counter  
- Popup media modals  
- Social sharing integration  
- Branded transactional emails (import success, inquiry notifications)

= How to configure Email notifications =

1. Go to Havenlytics → Settings → Email
2. Set your global sender name and email address (optional — defaults to site name and admin email)
3. Customize the Property Import Success subject and message using merge tags
4. On the Property Import wizard, keep **Email Notifications** checked to receive a success email when import completes

Contact Agent inquiry emails are configured separately under Havenlytics → Settings → Contact Agent.

= How to Use Elementor Widgets =

1. Install and activate Elementor (Free or Pro)
2. Edit any page with Elementor
3. In the Elementor panel, open the **Havenlytics** category or search for **HVN**
4. Drag the desired widget onto your page
5. Customize content and style controls, then publish

== Elementor Widgets ==

All Havenlytics Elementor widgets appear under the **Havenlytics** widget category. Search for **HVN** in the Elementor panel to find them quickly.

= HVN: Property Archive =

Full property listing archive — same system as the property grid/list/search shortcodes.

**Content controls:**
* Show/hide filter sidebar and top search bar
* Default view — grid, list, or map
* Sidebar position (left or right)
* Grid columns (1–4)
* Properties per page, order by (date, title, price, random)
* Featured-only filter
* Default filters — department, min/max price, bedrooms, bathrooms

**Style controls:**
* Brand and secondary colors (CSS variables)

**Behavior:**
* AJAX filtering, pagination, and load more
* Inherits global Havenlytics search and preloader settings
* Multiple widget instances supported per page

= HVN: Property Agents =

Agent archive matching the native `/property-agents/` page — search, grid/list toggle, pagination, and agent cards with availability badges.

**Content controls:**
* Show/hide header, title, and subtitle
* Show/hide search and view controls
* Agents per page (1–48)
* Grid columns (1–4)
* Default view — grid or list
* Order by name or date added (asc/desc)

= HVN: Property Agency =

Agency archive matching the native `/property-agencies/` page — same card layout and controls as the agents widget, for agency taxonomy listings.

**Content controls:**
* Show/hide header, title, and subtitle
* Show/hide search and view controls
* Agencies per page (1–48)
* Grid columns (1–4)
* Default view — grid or list
* Order by name or date added (asc/desc)

**Tip:** Prefer shortcodes for simple page content, or Elementor widgets when you need visual layout control alongside other Elementor sections.

== WordPress Sidebar Widgets ==

Havenlytics also registers classic WordPress widgets for single property sidebars (Appearance → Widgets):

* **Havenlytics: Featured Properties** — highlight selected listings
* **Havenlytics: Property Agent** — agent card for the current property
* **Havenlytics: Mortgage Calculator** — interactive calculator with tax, insurance, HOA, and PMI options
* **Havenlytics: Related Properties** — similar listings on single property pages

These are not Elementor widgets — add them to the **Havenlytics - Single Property Sidebar** widget area or your theme's sidebar.

= 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 shortcodes or Elementor widgets to display properties, agents, and agencies on your pages

== Automatically Created Pages ==

The following pages are automatically created on plugin activation (if not already present):

- Property Grid — Havenlytics (`/property-grid/`)
- Property Lists — Havenlytics (`/property-lists/`)
- Property Search — Havenlytics (`/property-search/`)
- Agents — Havenlytics (`/property-agents/`)
- Agency — Havenlytics (`/property-agencies/`)

Each page is pre-filled with the matching shortcode. You can rebuild or replace content with Elementor widgets from the **Havenlytics** category.

== Shortcodes ==

Easily display real estate listings, agents, and agencies using Havenlytics shortcodes.

Copy-ready examples and 50+ property variations are available under **Havenlytics → Settings → Shortcodes**.

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

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

Supports extensive attributes — department, price range, bedrooms, bathrooms, location, status, columns, pagination, default view, and custom CSS class. See **Settings → Shortcodes** for all variations.

= Agent & Agency Shortcodes =

= [hvnly_property_agents] =
Display the agents archive (same layout as `/property-agents/`) with search, grid/list toggle, pagination, and availability badges.  
Auto-created page slug: `property-agents`

**Common attributes:** `posts_per_page`, `columns` (1–4), `orderby` (title|date), `order` (ASC|DESC), `show_header`, `title`, `subtitle`, `show_search`, `show_view_controls`, `default_view` (grid|list), `class`

**Examples:**
* `[hvnly_property_agents columns="3"]`
* `[hvnly_property_agents default_view="list" show_search="no"]`
* `[hvnly_property_agents show_header="no" class="my-agents-archive"]`

**Legacy alias:** `[hvnly_agents]`

= [hvnly_property_agencies] =
Display the agencies archive (same layout as **HVN: Property Agency** Elementor widget) with search, grid/list toggle, and pagination.  
Auto-created page slug: `property-agencies`

**Common attributes:** same as `[hvnly_property_agents]` above.

**Examples:**
* `[hvnly_property_agencies columns="2"]`
* `[hvnly_property_agencies default_view="list"]`
* `[hvnly_property_agencies show_header="no" class="my-agencies-archive"]`

**Legacy alias:** `[hvnly_agencies]`


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

= Does Havenlytics work with Elementor? =

Yes. Havenlytics includes three Elementor widgets — **HVN: Property Archive**, **HVN: Property Agents**, and **HVN: Property Agency** — under the Havenlytics category. They support responsive layouts, AJAX filtering, style controls, and integration with global Havenlytics settings. The mortgage calculator is available as a WordPress sidebar widget, not an Elementor widget.

= How do I display agents or agencies on a page? =

Use `[hvnly_property_agents]` or `[hvnly_property_agencies]` shortcodes, or drag **HVN: Property Agents** / **HVN: Property Agency** Elementor widgets onto your page. Copy-ready examples are in **Havenlytics → Settings → Shortcodes**. Auto-created pages are available at `/property-agents/` and `/property-agencies/` after activation.

= How does Contact Agent work? =

Enable Contact Agent under **Havenlytics → Settings → Contact Agent**. Visitors can submit inquiries from property and agent pages. Admins receive email notifications; inquiries are stored under **Havenlytics → Inquiries**. Agents marked **Offline** hide the contact form automatically.

= Does Havenlytics send email notifications? =

Yes. Havenlytics includes a dedicated **Email** settings tab for transactional emails. When you complete the Property Import wizard with **Email Notifications** enabled, the admin who ran the import receives a branded success email. Contact Agent inquiry, auto-reply, and admin reply emails are configured under **Contact Agent** settings.

= 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
15. Elementor Widget - HVN Property Archive
16. Elementor Widget - HVN Property Agents
17. Elementor Widget - HVN Property Agency
18. Single Agent Profile Page
19. Property Agent Inquiries Form


== Changelog ==

= 3.0.3 - 2026-06-15 =

* **New:** HVN: Property Agency Elementor widget — agency archive with search, grid/list views, and pagination (mirrors `[hvnly_property_agencies]` shortcode).
* **New:** `[hvnly_property_agencies]` shortcode and auto-created Agency page (`/property-agencies/`).
* **New:** Agent & agency shortcodes documented in **Settings → Shortcodes** with copy-ready examples and legacy alias fields.
* **New:** Agent availability status — Available, Busy, Away, and Offline with admin control, frontend badges, and contact form gating for offline agents.
* **New:** Demo import agent ecosystem — Pexels CDN stock photos for agent avatars and agency logos; availability status seeded from import demo data.
* **New:** Leaflet map markers — modern animated pins with staggered drop-in; numbered stack badge only when multiple properties share the exact same coordinates (distinct locations always show separate markers).
* **New:** Map troubleshooting — optional debug logging via `?hvnly_map_debug=1` or Havenlytics debug mode; clearer empty-map messages (no results vs. missing coordinates).
* **New:** Global property share popup — one modal for all listing cards; platform list driven from settings; copy-link and auto-close timer.
* **Improvement:** Property map AJAX — expanded coordinate resolution (Property Builder meta, legacy keys, active map pointers, and meta scan fallbacks).
* **Improvement:** Map assets — Leaflet/Google scripts load in the correct order before the map controller; map params localized on the map script handle.
* **Improvement:** Frontend CSS Phase 1 — property card overlay/footer styles moved to a dedicated embed stylesheet; view controls and map container styles scoped to search/archive chrome.
* **Improvement:** Share modal assets load only where property cards show share icons (archive, taxonomy, shortcode, Elementor, agent/agency listings) — not site-wide.
* **Fix:** Map view “Map Unavailable” on archives and Elementor when properties had valid coordinates but meta keys did not match legacy resolver paths.
* **Fix:** Share popup not opening — footer markup and JS enqueued reliably; removed Elementor CSS rule that hid the overlay on live pages.
* **Fix:** Share icon styling missing on agency single property listings (`.hvnly-property-grid-list-share` selectors and stylesheet enqueue on agency taxonomy pages).
* **Fix:** Property card overlay, footer badges, and view controls layout after CSS extraction (4-context selector groups for archive, shortcode, agent, and agency embeds).
* **Fix:** Property Location map tab empty when the map preview field lacked `metaKey`; MapField now renders all map-type preview fields reliably.
* **Fix:** Map view “Request timed out” on slower hosts — map AJAX timeout raised to 30s; builder map groups cached per request; Leaflet registered before admin map field scripts.
* **Fix:** Property Builder preloader white flash — static boot preloader shows immediately and hides when configuration is ready.
* **Fix:** `[hvnly_property_agencies]` shortcode rendered empty pages — registration and asset loading restored.
* **Fix:** Agent metabox parse error that prevented agency taxonomy registration and broke agent custom field metaboxes.
* **New:** Agent Management — agent profiles, property assignment, and redesigned agent widget layouts.
* **New:** HVN: Property Agents Elementor widget — agent archive with search, grid/list views, and pagination.
* **New:** `[hvnly_property_agents]` shortcode and auto-created Agents page (`/property-agents/`).
* **New:** Contact Agent — inquiry modal, email notifications, auto-reply, admin replies, and Inquiries admin with unread badge.
* **New:** Email settings tab — import success notifications and centralized sender/template options.
* **New:** Data Preservation Framework — safer upgrades, migrations, and builder/meta protection on existing sites.
* **Fix:** Linux upgrade and post-update admin redirect issues.
* **Fix:** Property builder and import wizard no longer reset data when properties already exist.
* **Fix:** Contact Agent form submission and inquiry storage reliability.
* **Improvement:** Production-ready performance, security hardening, and WordPress.org code quality compliance.

= 3.0.1 - 2026-06-9 =

* Fix: AJAX Load More repeatedly displaying duplicate property listings.
* Fix: AJAX pagination incorrectly loading page 1 due to stale pagination values.
* Fix: Elementor AJAX pagination now correctly respects requested page numbers.
* Improvement: Pagination state synchronization across archive, shortcode, and Elementor property widgets.
* Improvement: Enhanced pagination reliability for filtered and sorted property searches.

= 3.0.0 - 2026-06-8 =

**New: Elementor Page Builder Integration**

* **New:** Dedicated Elementor widgets for seamless page building
* **New:** HVN: Property Archive widget — complete archive system with filters, grid/list/map views, and AJAX
* **New:** Elementor widget style controls for brand colors and layout customization
* **New:** Automatic widget asset enqueuing for Elementor editor and frontend
* **New:** Widget instance-specific IDs for multiple widget support per page
* **New:** Full preloader system compatibility with Elementor widgets
* **New:** AJAX load more and pagination support within Elementor widgets

**Note:** The mortgage calculator is a WordPress sidebar widget (Appearance → Widgets), not an Elementor widget. Agent and agency Elementor widgets were added in 3.0.2 and 3.0.3.

**Improvement:** Elementor widgets inherit global Havenlytics settings  
**Improvement:** Responsive design for all Elementor widgets  
**Improvement:** Archive widget supports grid/list/map views with configurable columns  
**Improvement:** Mortgage calculator (sidebar widget) supports advanced options (tax, insurance, HOA, PMI) 

**Major release – production-ready architecture update**

Havenlytics 3.0.0 delivers a stable Property Builder and Import foundation, reliable frontend map search, cleaner admin UX, and production-safe architecture across the plugin.

* **New:** Version 2.3.2 migration backfills `_hvnly_field_map` for existing properties with zero data loss
* **New:** Safe first-time Property Import initialization with card builder defaults
* **New:** Unified template helpers (`hvnly_get_template`, `hvnly_get_template_part`) and shared AJAX utilities
* **New:** Property card and single renderers via centralized singleton helpers
* **Improvement:** Property Import now uses a stable 7-section default structure with consistent group field IDs
* **Improvement:** UnifiedFieldGenerator uses persistent master IDs so builder resets no longer orphan property meta
* **Improvement:** Property Builder admin UI with smoother drag-and-drop and better section handling
* **Improvement:** Video, gallery, map, and document group fields save and load reliably across import and edit screens
* **Improvement:** React Property Card Builder integrated with backend DnD API
* **Improvement:** Migration system hardened for backward compatibility and safe upgrades
* **Improvement:** Internal field architecture refactored for stability, scalability, and WordPress coding standards
* **Improvement:** Production debug output removed from frontend/admin JS; PHP logging gated behind debug mode
* **Improvement:** Cache admin menu and plugin action links now respect cache-enabled setting
* **Improvement:** Plugin activation redirects to Property Import and flushes permalinks correctly
* **Improvement:** CPT and taxonomy registration timing fixed for reliable property URLs after activation
* **Improvement:** OpenStreetMap/Leaflet search map reflow, bounds fit, and container cleanup on Map tab load
* **Fix:** Group field identifier (`group_id` / `group_base_id`) mapping across the dynamic builder system
* **Fix:** Metabox data duplication caused by cross-section field name overrides
* **Fix:** DnD builder no longer collapses unique group base IDs to shared master IDs
* **Fix:** Property Import standardized field names, demo video URL fallback, and `_hvnly_field_map` on import
* **Fix:** Video field import, thumbnail sync, gallery hydration, and single image upload in property edit
* **Fix:** Map field cross-section data leakage and invalid `(0,0)` coordinates in map AJAX responses
* **Fix:** Property Documents repeater saving and metabox debug noise in production
* **Fix:** OpenStreetMap markers stacking in the top-left corner on first Map tab view
* **Fix:** Map loading preloader stuck due to shared loading flags and Leaflet init timing
* **Fix:** Duplicate Leaflet zoom controls on property search map

= 2.2.1 (2026-06-4) =
* **Fix:** JavaScript error in property builder functionality.

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

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