=== Converterhub Currency Converter ===
Contributors: converterhub
Tags: currency converter, exchange rates, currency, money, finance
Requires at least: 5.5
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a free, real-time currency converter to your WordPress site. 150+ currencies, no signup, no API keys.

== Description ==

Embed a beautiful, real-time currency converter on your WordPress site in seconds. Perfect for travel blogs, finance sites, e-commerce stores, and any website that needs to show currency conversions.

= Key Features =

* **150+ currencies** — All major world currencies supported
* **Real-time exchange rates** — Updated every minute, automatically
* **No signup or API keys** — Install and use, that's it
* **Three ways to use** — Gutenberg block, shortcode, and sidebar widget
* **Fully customizable** — Choose currencies, theme (light/dark), accent color, and size
* **Lightweight** — Loads as a small iframe, doesn't slow down your site
* **Mobile responsive** — Looks great on any screen size
* **Translation ready** — Available in English and Spanish (more languages coming)

= How to use =

**Gutenberg Block (recommended):**
Add a new block, search for "Currency Converter", and configure it visually.

**Shortcode (any page or post):**
`[converterhub_widget from="USD" to="EUR" amount="100"]`

Available attributes: `from`, `to`, `amount`, `theme` (light/dark), `accent` (hex color), `width`, `height`.

**Sidebar Widget:**
Go to Appearance → Widgets and add "Currency Converter (Converterhub)" to any widget area.

= Use cases =

* **Travel bloggers** — Show readers how much things cost in their home currency
* **E-commerce** — Display prices in multiple currencies
* **Finance blogs** — Provide instant currency conversions for readers
* **Forex/Crypto sites** — Quick conversion reference
* **Educational sites** — Currency conversion examples for students

= How it works =

The plugin embeds a lightweight iframe that loads the live currency converter from converterhub.com. Exchange rates are pulled from official sources and updated continuously.

= Attribution (optional, off by default) =

The converter does NOT show any "Powered by" attribution link by default and the plugin works exactly the same whether you enable it or not. There is no requirement, no nag, and no reduced functionality if you leave it off.

If you choose to enable it, you can do so in three places:

* Plugin settings: Settings → Currency Converter → Attribution
* Gutenberg block sidebar: Attribution panel
* Shortcode attribute: `show_credit="yes"`

= Privacy =

This plugin loads an iframe from converterhub.com. When visitors view a page with the widget, their browser makes a request to converterhub.com to load the converter. No personal information is collected, stored, or tracked by this plugin. See https://converterhub.com/en/privacy-policy/ for details on the converterhub.com privacy practices.

= External services =

This plugin embeds a third-party iframe from https://converterhub.com/embed/converter/ to display real-time currency exchange rates. By using this plugin, you and your site visitors interact with this external service.

* Service: Converterhub Currency Converter
* Service URL: https://converterhub.com
* Terms of service: https://converterhub.com/en/legal-notice/
* Privacy policy: https://converterhub.com/en/privacy-policy/

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the WordPress plugins screen.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. (Optional) Configure default settings under "Settings → Currency Converter".
4. Add the converter to your pages using the Gutenberg block, shortcode, or widget.

== Frequently Asked Questions ==

= Is this plugin really free? =

Yes, completely free for personal and commercial use. No premium version, no API keys, no upsells.

= Where do the exchange rates come from? =

Rates are pulled from professional currency data providers and updated every minute. They're aggregated from interbank rates and reflect real-time market values.

= Can I customize the appearance? =

Yes. You can choose from light or dark themes, set a custom accent color, and adjust the size (width and height). The Gutenberg block has a visual customizer panel.

= Does it work with page builders like Elementor or Divi? =

Yes. Use the shortcode `[converterhub_widget]` in any HTML/Shortcode element.

= Does it slow down my site? =

No. The widget loads as an iframe, which is rendered separately by the browser and doesn't block your page rendering. The iframe itself is lightweight (~5KB).

= Can I use it offline? =

No, the widget needs an internet connection to fetch live exchange rates from converterhub.com.

= Does it work with caching plugins? =

Yes. The widget is just an iframe, so it works with any caching setup including WP Rocket, W3 Total Cache, LiteSpeed Cache, etc.

= Does the widget show a "Powered by Converterhub" link? =

No. The attribution link is **off by default** and completely optional. The plugin functions identically with or without it. There is no license requirement, no nag, and no reduced functionality if you leave it off. You can opt-in via the plugin settings page (Settings → Currency Converter → Attribution), the Gutenberg block sidebar, or by adding `show_credit="yes"` to the shortcode.

= How do I report a bug or request a feature? =

Visit https://converterhub.com/en/contact/ to reach support.

== Screenshots ==

1. Light theme converter widget embedded on a page
2. Dark theme variant
3. Gutenberg block visual editor with all options
4. Sidebar widget configuration
5. Admin settings page for default values

== Changelog ==

= 1.0.2 =
* Updated "Tested up to" header to WordPress 7.0.

= 1.0.1 =
* Hardened `default_from` / `default_to` sanitization in the settings page: values are now strictly whitelisted against the supported ISO currency list.
* Removed `load_plugin_textdomain()` call (no longer needed for WordPress.org-hosted plugins since WP 4.6).
* Clarified Attribution wording in the readme and admin UI: the "Powered by" link is fully optional, off by default, and the plugin functions identically whether it is enabled or not.
* Added `type`, `default`, and `show_in_rest` keys to `register_setting()` for stricter typing.

= 1.0.0 =
* Initial release
* Gutenberg block with full visual editor (currencies, amount, size, theme, accent color, attribution)
* Shortcode support: [converterhub_widget from="USD" to="EUR" amount="100"]
* Sidebar widget for classic widget areas
* Admin settings page for global defaults
* Four themes: Light, Dark, Soft (warm pastel), Glass (transparent)
* Color palette with 9 preset accent colors plus custom color picker
* 156 currencies supported
* Translation-ready (English, Spanish)
* Optional "Powered by Converterhub" attribution (off by default, opt-in)

== Upgrade Notice ==

= 1.0.2 =
Compatibility update for WordPress 7.0.

= 1.0.1 =
Stricter currency-input validation, clearer Attribution wording, and minor cleanup. Recommended for all users.

= 1.0.0 =
Initial release.
