=== EmlakX – Real Estate ===
Contributors: mohamadrw, emlakplatform8080
Donate link: https://roidnet.com/
Tags: real estate, property listing, elementor, wpml, polylang
Requires at least: 5.8
Tested up to: 7.1
Stable tag: 1.0.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Official WordPress solution for EmlakPlatform.com.tr – displays properties, projects, lands, and resales via Elementor and shortcodes.

== Description ==

A powerful, high-performance real estate plugin connecting WordPress directly to the **EmlakPlatform.com.tr** API to showcase properties, projects, lands, and resales.

**EmlakX – Real Estate** provides a complete property management solution for agencies, brokers, and property developers. It seamlessly synchronizes listings from EmlakPlatform with blazing-fast AJAX search, custom Elementor widgets, multi-currency switching, and full multilingual support.

### 🚀 Key Features

* **Dedicated Real Estate Listings:** Display comprehensive property pages for Projects, Lands, and Resales with custom permalink routing (`/projects/`, `/lands/`, `/resales/`).
* **Interactive AJAX Search & Filter:** Cascading dynamic dropdowns (Country → City → Area), property types, and price range filters with instant results and no page reloads.
* **Elementor Pro & Free Compatibility:** Includes custom `PropertyGrid` and `UniversalFilter` Elementor widgets for total drag-and-drop design freedom.
* **Multilingual Architecture:** Built-in deep integration with WPML and Polylang, supporting localized URL prefixes (e.g., `/{lang}/projects/`) and automatic RTL styling for Arabic out of the box.
* **Smart Multi-Currency Switcher:** Cookie-based live currency conversion with cache-busting DOM updates for international real estate buyers.
* **Automated XML Real Estate Sitemap:** Dedicated standalone XML sitemap (`/emlakx-sitemap.xml`) for all active listings, ensuring fast and flawless indexing in Google Search Console without conflicting with Yoast or Rank Math.
* **Instant WhatsApp Lead Generation:** Direct click-to-chat inquiry buttons prefilled with property title and reference details for rapid client conversion.
* **Developer Friendly & Theme Overrides:** Easily customize templates by copying files from `includes/Front/Templates/` to an `emlakx/` folder within your active theme, following WooCommerce conventions.
* **High Performance & Intelligent Caching:** 12-hour WordPress transient cache with automatic invalidation upon API updates to guarantee ultra-fast page speeds.
* **Mobile-First & Responsive Design:** Crafted with modern Bootstrap 5.3 and touch-friendly Swiper 11 galleries for an exceptional user experience on any device.

### 💡 Why Choose EmlakX?

1. **Official EmlakPlatform Integration:** Direct, reliable synchronization with EmlakPlatform.com.tr without messy CSV imports or manual data entry.
2. **Standalone or Elementor:** Use with Elementor or standard WordPress shortcodes (`[emlakx_projects]`, `[emlakx_lands]`, `[emlakx_resales]`, `[emlakx_currency_switcher]`) and native rewrite templates.
3. **Optimized for Search Engines:** Clean semantic markup, OpenGraph tags, and a dedicated XML sitemap designed to maximize property visibility on Google.
4. **No External Script Bloat:** All assets are locally bundled and selectively enqueued only where needed for maximum performance and GDPR compliance.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/emlakx/` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Navigate to **EmlakX > General Settings** in your WordPress admin dashboard and enter your **API Base URL** and **Access Key**.
4. Click **Verify API** to confirm your connection status.
5. Review the **Setup Guide** tab to verify that your listing pages (Projects, Lands, Resales) are configured and assigned.

== External services ==

This plugin connects to external services provided by EmlakPlatform to synchronize real estate properties, listings, and taxonomy data.

* **Service:** EmlakPlatform REST API (`https://www.emlakplatform.com.tr/api/v1/`).
* **What data is sent:** API Access Key (for authentication), requested language code (`lang`), user preferred currency (`currency`), and search query parameters (e.g., property type, country, city, area, price range). No personal identifying visitor data (PII) is transmitted to the external service.
* **Terms of Service:** [EmlakPlatform Terms of Service](https://emlakplatform.com.tr/)
* **Privacy Policy:** [EmlakPlatform Privacy Policy](https://emlakplatform.com.tr/)

== Frequently Asked Questions ==

= Does EmlakX require an API key? =
Yes, EmlakX requires an API Base URL and Access Key from [EmlakPlatform](https://emlakplatform.com.tr/) to fetch real-time property listings. Contact your EmlakPlatform account representative for credentials.

= Is Elementor required to use EmlakX? =
No, Elementor is completely optional. EmlakX includes native page templates and WordPress shortcodes. If Elementor is installed, dedicated drag-and-drop widgets become available in the editor.

= Does EmlakX support multilingual websites? =
Yes, EmlakX offers native integration with both WPML and Polylang, including language prefix URL routing (`/{lang}/projects/`) and automatic RTL stylesheet switching for languages such as Arabic.

= Can I customize the listing and detail templates? =
Yes. Just like WooCommerce, you can copy any template file from `emlakx/includes/Front/Templates/` into an `emlakx/` folder within your active theme or child theme to override it safely without losing changes during updates.

= How does the multi-currency switcher work? =
The currency preference is stored in a secure client cookie (`emlakx_currency`) and passed to the API on each request. The frontend dynamically swaps `.emlakx-price` elements using AJAX without requiring a full page reload.

= How do I submit the XML sitemap to Google Search Console? =
Navigate to **EmlakX > Setup Guide**, copy the standalone XML sitemap URL (`yoursite.com/emlakx-sitemap.xml`), and submit it in Google Search Console. It works alongside existing SEO plugins such as Yoast SEO and Rank Math without conflict.

== Screenshots ==

1. EmlakX General Settings: API connection configuration, WhatsApp contact, and default currency.
2. Setup Guide Checklist: Interactive wizard ensuring pages, templates, and API endpoints are properly connected.
3. XML Sitemap & SEO Tools: Dedicated standalone real estate sitemap URL and manual cache regeneration.

== Changelog ==

= 1.0.3 =
* Minor updates and fixes.

= 1.0.2 =
* Minor updates and fixes.

= 1.0.1 =
* Minor updates and fixes.

= 1.0.0 =
* Minor updates and fixes.

= 1.0.1 =
* WordPress.org review compliance enhancements.
* Added dedicated External Services disclosure for API integration.
* Standardized asset names and WordPress Playground blueprint support.
* Automated SVN deployment workflow integration.

= 1.0.0 =
* Initial public release.
* Real estate listing and single detail pages for Projects, Lands, and Resales.
* Dynamic AJAX search and cascading location filtering.
* Elementor widgets and customizable shortcodes.
* WPML & Polylang multilingual routing with RTL support.
* Currency switcher and standalone XML sitemap generator.

== Upgrade Notice ==

= 1.0.1 =
Recommended update for WordPress.org compliance and latest platform improvements.

== Credits ==

* Bootstrap 5.3.8, Copyright 2011-2025 The Bootstrap Authors
  License: MIT
  Source: https://getbootstrap.com

* Swiper 11.0.0, Copyright 2014-2024 Vladimir Kharlampidi
  License: MIT
  Source: https://swiperjs.com

* Bootstrap Icons 1.11.3, Copyright 2019-2024 The Bootstrap Authors
  License: MIT
  Source: https://icons.getbootstrap.com
