=== AddonLogic Currency Converter Widget ===
Contributors: snehalpancholi
Tags: currency converter, exchange rates, widget, shortcode, forex
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight currency converter with admin-managed rates and optional live rate fetching via ExchangeRate-API.

== Description ==

AddonLogic Currency Converter Widget lets your visitors convert between currencies directly on your website. Administrators define a list of supported currencies and their exchange rates — either manually or fetched live from ExchangeRate-API (free tier, API key required).

**Key Features:**

* Interactive converter — amount input, From select, To select, and a Swap button
* All conversion calculated client-side (no server round-trips after page load)
* Three visual themes: Default, Compact, Dark
* Flag emoji support in currency dropdowns
* 20 pre-loaded currencies with static USD-relative rates
* Optional live rate sync via ExchangeRate-API v6 on a configurable cron schedule
* Admin currency table — add, edit, remove currencies and rates inline
* Sidebar widget with per-instance settings (from, to, amount, theme)
* `[currency_converter]` shortcode with full attribute support
* Fully responsive, mobile-first CSS
* Translation-ready

== Installation ==

1. Upload the `currency-converter-widget` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **Settings → Currency Converter** to configure currencies and rates.
4. Add the shortcode `[currency_converter]` to any page or post, or add the **AddonLogic Currency Converter** widget to a sidebar.

== Frequently Asked Questions ==

= Do I need an API key? =

No. The plugin ships with 20 currencies and approximate static rates that work without any API key. An API key is only required if you want live rate updates.

= Where do I get an API key? =

Sign up for a free account at https://www.exchangerate-api.com/ — the free tier allows up to 1,500 requests per month.

= How often are rates updated? =

When live rates are enabled the plugin fetches new rates on a twice-daily WP-Cron schedule. You can also click "Refresh Rates Now" in Settings → Currency Converter → API & Settings.

= Can I add my own currencies? =

Yes. Go to Settings → Currency Converter → Currencies and add as many rows as you need.

= Can I use multiple converters on one page? =

Yes. Each `[currency_converter]` shortcode instance operates independently.

= Is jQuery required? =

No. The plugin uses vanilla JavaScript (ES6+) with no jQuery dependency.

== Screenshots ==

1. Default theme converter on the frontend
2. Compact theme converter
3. Dark theme converter
4. Admin — Currencies tab with inline editable table
5. Admin — API & Settings tab

== Changelog ==

= 1.0.0 =
* Initial release.
* 20 pre-loaded currencies with static USD rates.
* `[currency_converter]` shortcode.
* Sidebar widget.
* Three themes: Default, Compact, Dark.
* Optional live rate sync via ExchangeRate-API v6.
* Admin currency table with add/remove row functionality.
* WP-Cron scheduled rate refresh.
* Flag emoji support in dropdowns.
