=== ThemexHunt Currency Switcher for WooCommerce ===
Contributors: themexhunt
Tags: woocommerce, currency switcher, multi-currency, woocommerce currency
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Easily switch currencies in WooCommerce with custom manual rates, session-based selections, and gateway restrictions.

== Description ==
ThemexHunt Currency Switcher for WooCommerce allows your store to support multiple currencies with manual rate controls. Users can switch currencies seamlessly, and store owners can define gateway restrictions based on currency preferences. This lightweight plugin integrates directly into WooCommerce and includes a shortcode-based dropdown for currency switching.

== Plugin Settings ==

You can find plugin settings under:
WordPress Admin → Settings → THEMCUSW

= Options Include: =

* Enable/Disable Currencies – Toggle visibility of specific currencies.
* Currency Position – Left/Right alignment with symbol.
* Exchange Rate – Manually set conversion rates.
* Symbol Customisation – Override default WooCommerce symbols.
* Payment Gateways – Select payment gateways for different currency.

== How to Use the Plugin ==

== Add to Navigation Menu ==
To add a currency switcher directly to your header or main nav menu:

Go to: Appearance → Menus

* A new metabox titled Currency Switcher will appear on the left.
* Tick the currencies you want and click Add to Menu.
* Rearrange as needed and click Save Menu.

Your customers will now see the currency options in your site navigation.

== Shortcode Integration ==

You can also display the switcher using a shortcode.

==  Paste it into: ==

* Any WordPress page or post.
* Custom HTML block.
* Elementor, Gutenberg, or any page builder.
* Shortcode using: `[themcusw_currency_switcher]` .

== Widget Integration ==

A currency switcher widget is available to place in:

* Sidebar.
* Footer.
* Any widget-ready area (Appearance > Widgets).

==Features==

= ✅ Manual Rate Management =
Define and update currency rates manually with precision — perfect for store owners who want full control over exchange rates without relying on APIs.

= ✅ Shortcode Integration =
Easily embed the currency switcher anywhere on your site using a simple shortcode. Place it in product pages, sidebars, footers — wherever your customers need it most.

= ✅ Widget Integration =
Seamlessly integrate the currency switcher into your WordPress widgets area. No setup hassles. Just drag, drop, and it’s live.

= ✅ Position Customisation =
Choose where and how your switcher appears — left or right of the price, before or after the symbol. Full flexibility, no compromises.

= ✅ Mobile-Friendly =
Built with responsive design, the plugin adapts perfectly to mobile and tablet screens, ensuring a great user experience across all devices.

= ✅ Ultra-Lightweight =
Unlike bulky currency switchers, Themexhunt’s plugin is optimised for performance. Fast loading. Clean code. Zero bloat.

= ✅ Payment Method Selection =
Allow or restrict specific payment methods based on selected currency. Fine-tune your checkout flow and avoid payment gateway issues.

= ✅ ON/OFF Feature =
Need to temporarily disable currency switching? Do it in one click. No need to deactivate the plugin — just flip the switch.

= ✅ Add, Edit or Remove Currencies =
Easily add new currencies, modify existing ones, or remove unused ones. Total freedom to tailor the experience to your store’s needs.

= ✅ Define Symbol, Rate, and Position =
Set custom currency symbols, manually assign exchange rates, and define the display format for complete visual consistency.


== Installation ==
1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to **WooCommerce > Currency Switcher** to configure settings

== Frequently Asked Questions ==

= Is this plugin compatible with the latest version of WooCommerce? =
Yes, it is tested up to WooCommerce 8.5 and WordPress 6.8.

= Does this plugin automatically fetch exchange rates? =
No. You can manually define currency rates in the admin panel.

= Can I restrict payment gateways per currency? =
Yes. You can configure allowed gateways per currency under settings.

== Screenshots ==
1. Currency Settings Panel in Admin
2. Menu item Settings
3. Gutenberg Settings
4. Frontend Display
4. Currency List Dropdown

== Changelog ==
= 1.0.0 =
* Updated stable tag and tested up to version
* Initial public release features:
  - Currency switcher UI
  - Manual exchange rate support
  - Session and cookie-based currency persistence
  - Payment gateway filtering by currency

== Upgrade Notice ==
= 1.0.0 =
Initial public release.

== License ==
This plugin is licensed under the GPLv2 or later. You are free to modify and redistribute it under the same license.
