=== Rate-API Currency Converter ===
Contributors: rateapi
Tags: currency, converter, exchange rate, forex, money
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed a live currency converter anywhere with a shortcode or block. Powered by Rate-API.com.

== Description ==

Add a live, auto-updating currency converter to any post, page, or widget area —
no coding and no API key required. Rates cover 160+ currencies and refresh hourly.

**Shortcode**

`[rate_api_converter from="USD" to="EUR" amount="100"]`

Attributes (all optional):

* `from` — source currency code (default USD)
* `to` — target currency code (default EUR)
* `amount` — starting amount (default 100)
* `theme` — `light` or `dark` (default light)

**Block**

Search for "Rate-API Converter" in the block inserter and set the currencies in
the sidebar. A live preview shows right in the editor.

== Privacy ==

The converter loads a small script from rate-api.com and fetches public exchange
rates. No visitor data is collected by this plugin. Want to self-host or point at
a different base URL? Use the `rate_api_base_url` filter.

== Frequently Asked Questions ==

= Do I need a Rate-API account? =

No. The embedded converter uses public rate data and needs no API key. For the
full API (historical data, conversions at scale, crypto, alerts) grab a free key
at https://rate-api.com.

= Can I change the source URL? =

Yes — `add_filter('rate_api_base_url', fn() => 'https://your-host.example');`

== Changelog ==

= 1.0.0 =
* Initial release: shortcode + dynamic block for the live converter.
