=== TransparentCars Calculator ===
Contributors: transparentpt
Tags: cars, car price, portugal, used cars, calculator
Requires at least: 6.0
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed the free TransparentCars fair-price checker for used cars in Portugal — a shortcode or a block.

== Description ==

Add a small, responsive calculator to any page or post. Visitors enter a car (make, model, year,
mileage) and an asking price, and the widget shows the market range comparable cars sell for and
whether the price is fair, high or low — based on the Portuguese used-car market.

The calculator itself is served from transparent.pt; this plugin renders a lightweight, auto-resizing
iframe and a crawlable "Powered by transparent.pt" attribution link. No account, no API key.

* Shortcode: `[transparentcars_calc]` (optional `lang="pt|en|ru|ua"` and `height="640"`).
* Block: search for "TransparentCars Calculator" in the block inserter.
* Languages: Portuguese, English, Russian, Ukrainian.

== Installation ==

1. Upload the `transparentcars-calculator` folder to `/wp-content/plugins/`, or install the ZIP via
   Plugins → Add New → Upload Plugin.
2. Activate the plugin.
3. Add the block "TransparentCars Calculator" to a page, or use the shortcode `[transparentcars_calc]`.

== Frequently Asked Questions ==

= Where does the data come from? =
The fair-price range is computed by transparent.pt from its own market data. The figure is a
reference estimate, not a certified appraisal.

= Does it collect visitor data? =
The plugin only embeds the calculator. The widget reads only the car details the visitor enters to
compute the estimate. No personal data is collected by the plugin.

= Can I change the language or height? =
Yes — use the block controls, or the shortcode attributes `lang` and `height`.

== External services ==

This plugin embeds a calculator hosted by TransparentCars (transparent.pt) inside an iframe, and loads
a small script to auto-resize that iframe.

* **What is loaded:** the page `https://transparent.pt/embed-price` (with an optional `lang` parameter)
  is embedded as an iframe on any page/post where you place the shortcode or block.
* **What is sent:** nothing is sent by the plugin itself. Inside the embedded calculator, the visitor
  types car details (make, model, year, mileage, and optionally an asking price); those values are sent
  by the calculator to the TransparentCars public API to compute a price estimate. No personal data and
  no account are involved, and the plugin sets no cookies.
* **Why:** so the fair-price estimate reflects live TransparentCars market data.
* **Service provider:** TransparentCars — https://transparent.pt
  Terms: https://transparent.pt/en/terms · Privacy: https://transparent.pt/en/privacy

By using this plugin you agree that visitors' inputs to the embedded calculator are processed by
TransparentCars as described above.

== Changelog ==

= 0.1.0 =
* Initial release: shortcode + block embedding the transparent.pt fair-price calculator, with
  postMessage auto-resize and a crawlable attribution link.