=== SkySwitcher - Multicurrency Currency switcher for Woocommerce ===
Contributors: siteskyline
Tags: currency, converter, woocommerce, exchange, rates
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 2.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple and powerful currency converter for your WooCommerce store.

== Description ==

Free Currency Converter is a lightweight and easy-to-use plugin that allows your customers to see product prices in their preferred currency. The plugin uses live exchange rates from exchangerate-api.com and provides a seamless experience for your users.

Check out our tutorial on how to use the plugin:

[youtube https://www.youtube.com/watch?v=1ud42dgv0Ts]

= Features =

*   **Live Exchange Rates:** Automatically syncs with live exchange rates.
*   **Manual Rate Control:** Set your own custom exchange rates.
*   **Exchange Fees:** Add a percentage markup to your exchange rates to cover bank fees.
*   **Custom Currency Symbols:** Override default symbols with your own (e.g., US$ instead of $).
*   **Configuration Safeguards:** Dashboard notices and automatic widget hiding if exchange rates are missing.
*   **Elementor Integration:** Dedicated widget for the Elementor page builder.
*   **Gutenberg Block:** Native block for the WordPress block editor.
*   **Menu Bar Integration:** Automatically add the switcher to any WordPress menu.
*   **Flexible Display Options:** Customize flags, symbols, names, and dimensions.
*   **WooCommerce Mini-Cart Fix:** Ensure prices update correctly in AJAX mini-carts.
*   **Easy Integration:** Use `[currency_converter]` anywhere via shortcode or widget.
*   **Floating Widget:** Display a floating currency converter on every page.
*   **Individual Product Prices:** Set different currency prices for products individually.
*   **Payment Gateway Rules:** Disable gateways for specific currencies.

= Free vs Pro Version =

The free version of SkySwitcher provides essential tools for multi-currency stores. To unlock advanced automation and insights, check out [SkySwitcher Pro](https://siteskyline.com/skyswitcher-woocommerce-multicurrency).

= Pro Version Features =

*   **Unlimited Currencies:** Support for every currency in the world.
*   **Auto-Sync Rates:** Automatically update exchange rates in chosen intervals.
*   **Advanced Analytics:** Track which currencies your customers are actually using.
*   **Smart Geo-Targeting:** Detect user location and switch currency automatically.
*   **Priority Support:** Get direct assistance from our expert team.

== Installation ==

1.  Upload the `frcc-convert-currency` folder to the `/wp-content/plugins/` directory.
2.  Activate the plugin through the 'Plugins' menu in WordPress.
3.  Configure the settings under **Settings > Currency Converter**.

== Frequently Asked Questions ==

= How do I use the currency converter? =

Simply add the `[currency_converter]` shortcode to any page, post, or widget where you want the converter to appear.

= Where do the exchange rates come from? =

The plugin fetches live exchange rates from exchangerate-api.com. You can also set your own manual rates in the settings.

== External services ==

This plugin connects to an API to obtain live exchange rates.

*   **Service:** [ExchangeRate-API](https://www.exchangerate-api.com/)
*   **Data Sent:** The base currency code (e.g., "USD") is sent to the API to fetch rates relative to it. No personal user data is sent.
*   **Terms of Use:** [https://www.exchangerate-api.com/terms](https://www.exchangerate-api.com/terms)
*   **Privacy Policy:** [https://www.exchangerate-api.com/privacy](https://www.exchangerate-api.com/privacy)

= Can I customize the appearance of the converter? =

Yes, you can customize the display options, including flags, symbols, and names, from the **Customize** tab in the plugin settings.

= How can I upgrade to the Pro version? =

Visit our website at [SkySwitcher Pro](https://siteskyline.com/skyswitcher-woocommerce-multicurrency) to upgrade and unlock all premium features.

== Changelog ==

= 2.1.2  =
*   Added Exchange Fee feature: set a percentage markup for each currency.
*   Added Custom Currency Symbols: override default WooCommerce symbols per currency.
*   Added Configuration Safeguards: Dashboard notices for missing exchange rates.
*   Improved widget rendering: Switchers now hide automatically if exchange rates are not configured.
*   Renamed "Manual Exchange Rates" to "Currency Settings" for a more comprehensive overview.

= 1.3 =
*   Refactored the settings page into a tabbed interface for a more organized and user-friendly experience.
*   Added a dedicated "Save" button for each settings tab (Exchange Rates, Add Currency, Customize).
*   Added a "Help" tab with instructions on how to use the shortcode.
*   Fixed a bug that prevented the success message from appearing immediately after syncing exchange rates.

= 1.2  =
*   Added a dismissible, site-wide notification to encourage user reviews after a successful sync.
*   Removed the static review widget from the options page.

= 1.1  =
*   Initial release.