=== BK Real Estate Calculators and Checklist for Elementor ===
Contributors: bisnukundu
Donate link: https://buymeacoffee.com/bisnukunduy
Tags: elementor, real estate, calculator, tax, checklist
Requires at least: 5.9
Tested up to: 6.9
Stable tag: 2.4.0
Requires PHP: 7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Three free Elementor widgets for real estate professionals: IRPF tax calculator, offer simulator, and an interactive document checklist.

== Description ==

**Real Estate Widgets for Elementor** adds three purpose-built widgets to the Elementor page builder, designed specifically for real estate professionals and agencies in Spain. All widgets are fully translatable and compatible with Polylang and WPML.

= 🧮 Widget 1 — Tax Calculator (Calculadora IRPF) =

Calculate the estimated IRPF (capital gains tax) when selling a property. Enter the sale price, purchase price, acquisition costs, agency fee percentage, and optional municipal tax (plusvalía). The result updates live as you type — no button needed.

**Features:**
* Live auto-calculation using official IRPF 2024 tax brackets (19% → 28%)
* Agency fee breakdown with automatic 21% VAT calculation
* Optional plusvalía municipal field
* Two result cards: estimated capital gain + estimated IRPF
* Itemised cost summary
* Number format locale selector (es-ES, en-GB, de-DE, fr-FR, pt-PT)
* Full Elementor style controls for every element

= 📊 Widget 2 — Offer Simulator (Simulador de Ofertas) =

Analyse a received offer against the listed price and the estimated market value simultaneously. Three colour-coded comparison cards show the difference and percentage for each pairing, with contextual advice messages.

**Features:**
* Three simultaneous comparisons: offer vs price, offer vs market, price vs market
* Dynamic "Por encima / Por debajo" badges
* Contextual advice text per card (fully editable)
* Summary bar with all three values
* Live calculation — updates as you type
* Full Elementor style controls

= ✅ Widget 3 — Document Checklist (Checklist de Documentos) =

An interactive document checklist for property sellers. Tracks progress with a live progress bar, supports filtering by badge type, and groups documents by category.

**Features:**
* 25 pre-loaded documents across 8 categories
* Badge types: Esencial, Imprescindible, Recomendado, Aconsejable, Opcional, Según el caso
* Live progress bar updates on every checkbox tick
* Filter tabs to show only documents of a specific type
* Checked items display strikethrough styling
* All documents, groups, and labels fully editable via Elementor Repeater
* Full Elementor style controls for card, rows, badges, progress bar and filters

= 🌐 Translation Ready =

All three widgets support Polylang and WPML. Every text string is editable directly in the Elementor Content panel per language page, and a `.pot` file is included for Loco Translate users.

= Requirements =
* WordPress 5.9 or higher
* Elementor (free) 3.0 or higher
* PHP 7.0 or higher

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install via **Plugins → Add New → Upload Plugin**.
2. Activate the plugin from the **Plugins** menu in WordPress.
3. Make sure **Elementor** is installed and activated.
4. Open any page or post in the Elementor editor.
5. Search for **"Tax Calculator"**, **"Offer Simulator"**, or **"Document Checklist"** in the widget panel.
6. Drag the widget onto the canvas and configure it in the Content and Style tabs.

== Frequently Asked Questions ==

= Does this plugin require the paid version of Elementor? =

No. All three widgets work with the free version of Elementor.

= Are the calculations legally accurate? =

The tax calculator uses the official Spanish IRPF 2024 savings tax brackets (19%–28%). Results are estimates for orientation only and do not account for personal exemptions (e.g. reinvestment in primary residence, over-65s exemption). Always consult a qualified tax advisor.

= Can I translate the widgets into another language? =

Yes. All text strings in the widget Content panels are directly editable in Elementor per page. A `.pot` template file is included in the `languages/` folder for use with Loco Translate or WPML String Translation.

= Can I use multiple instances of the same widget on one page? =

Yes. Each widget instance is fully scoped with a unique ID, so multiple instances coexist without JavaScript conflicts.

= Is the plugin compatible with caching plugins? =

Yes. All JavaScript is output inline and scoped per widget instance — there are no external JS dependencies or AJAX calls that could conflict with caching.

= Does the document checklist save the user's progress? =

Not currently. The checklist state is session-only (in-memory). A future version may add optional localStorage persistence.

== Screenshots ==

1. Tax Calculator widget — live IRPF estimation with agency fee breakdown and result cards.
2. Offer Simulator widget — three simultaneous comparisons with colour-coded cards and advice messages.
3. Document Checklist widget — interactive checklist with progress bar, filter tabs and badge-styled items.
4. Elementor Content panel — all text labels editable, compatible with Polylang per-language pages.
5. Elementor Style panel — granular colour and typography controls for every element.

== Changelog ==

= 2.2.0 =
* Added Document Checklist widget with progress bar, filter tabs, 8 groups, 25 items, and full style controls
* Fixed item row backgrounds and box shadow controls in checklist
* Badge positioned inline beside item label (matching design spec)

= 2.1.0 =
* Added Offer Simulator widget with three comparison cards, dynamic badges, and advice messages
* Added dual Elementor hook registration for compatibility with Elementor < 3.5

= 2.0.0 =
* Full OOP rewrite: singleton Plugin class, separate widget class files
* Tax Calculator: improved number formatting, IRPF bracket accuracy, scoped JS per instance
* Polylang / WPML compatible — all strings editable in Elementor Content panel

= 1.0.0 =
* Initial release — Tax Calculator (Calculadora IRPF) Elementor widget

== Upgrade Notice ==

= 2.2.0 =
New widget added: Document Checklist. Deactivate and delete the previous version before uploading this update.
