🌐 Auto Currency Switcher for WooCommerce

Auto Currency Switcher for WooCommerce is an intelligent, high-performance multi-currency converter and switcher plugin for WooCommerce. It automatically detects visitor country location using GeoIP Geolocation, converts store prices in real-time, and displays prices in USD, GBP, EUR, INR, SAR, and AED with crisp SVG country flags and a glassmorphic floating popup switcher.

Designed with advanced Real-time Anti-Cache JS conversion technology, it functions seamlessly across cached hosting environments including Hostinger, LiteSpeed, Nginx, Cloudflare, and WP Rocket without double-conversion glitches.

✨ Key Features

• 🌍 Smart GeoIP Auto Detection: Automatically detects user location (combining WooCommerce Geolocation with ipapi.co fallback) and switches to their local currency on first visit.
• ⚡ Anti-Cache Real-Time Conversion Engine: Prevents double-conversion issues on cached servers (Hostinger, LiteSpeed, Nginx, WP Rocket) using client-side data-acsw-raw-price tracking.
• 💱 0-Key Exchange Rate APIs: Automatically fetches real-time exchange rates via reliable multi-fallback APIs (open.er-api.com, frankfurter.app, exchangerate.host). No API keys required!
• ✏️ Manual Rate Overrides: Option to switch between Auto Rate Updates (daily/hourly) and custom manual exchange rates per currency.
• 🎨 Glassmorphic Floating Switcher Popup:
  • Smooth glassmorphism popup modal with entrance/exit animations.
  • Crisp vector SVG country flag icons.
  • Position fixed on screen for easy access on both Desktop & Mobile devices.
• 🎨 Complete Admin Styling Customizer: Customize floating button background, hover states, popup modal colors, text colors, and border-radius directly from the admin settings.
• 🧩 Shortcode Support: Easily place a inline currency switcher anywhere on your site using [acsw_switcher].

🛠️ Supported Currencies

By default, base prices are set in USD ($). The plugin supports seamless auto-conversion to:

🛠️ Installation

Manual Installation via WordPress Admin

1. Download or clone this repository as a .zip archive.
2. Go to your WordPress Dashboard -> Plugins -> Add New -> Upload Plugin.
3. Select the auto-currency-switcher.zip file and click Install Now.
4. Click Activate Plugin.

Upload via FTP / File Manager

1. Extract the auto-currency-switcher folder.
2. Upload the auto-currency-switcher folder to your /wp-content/plugins/ directory.
3. Navigate to WordPress Dashboard -> Plugins -> Installed Plugins.
4. Locate Auto Currency Switcher for WooCommerce and click Activate.

⚙️ Configuration

After activating the plugin:

1. Go to WooCommerce -> Currency Switcher in the WordPress admin sidebar.
2. General Settings:
   • Enable/Disable the Currency Switcher.
   • Choose Supported Currencies.
   • Select Rate Mode (Auto or Manual).
   • Set Auto-Update Interval (Daily / Weekly).
   • Click Fetch Rates Now to immediately update live exchange rates.
3. GeoIP Settings:
   • Toggle GeoIP Auto Location Detection on or off.
4. Style & Display Customizer:
   • Adjust floating button background color, text color, and hover effects.
   • Customize popup modal background, text colors, and border radius.

🧩 Shortcode Reference

You can display an inline currency switcher dropdown inside any page, post, widget, or header layout using:

[acsw_switcher]

📂 Directory Structure

auto-currency-switcher/
├── assets/
│   ├── css/
│   │   ├── admin.css              # Admin settings stylesheet
│   │   └── frontend.css           # Switcher popup & floating button styles
│   └── js/
│       ├── admin.js              # Admin color picker & rate fetch script
│       └── frontend.js           # Real-time Anti-Cache JS conversion script
├── includes/
│   ├── class-acsw-currency.php   # Core currency calculations & API rate fetcher
│   ├── class-acsw-frontend.php   # Frontend hooks, shortcode & popup renderer
│   ├── class-acsw-geolocation.php# GeoIP lookup engine & country mapping
│   └── class-acsw-settings.php   # WooCommerce admin settings panel & options
├── auto-currency-switcher.php    # Main plugin entry file
├── INSTALL-GUIDE-BN.md           # Installation guide in Bengali
└── readme.txt                    # Standard WordPress.org plugin readme

📝 Changelog

Version 1.4.1

• Fixed: WooCommerce PHP filter chain double-conversion.
• Added: Hostinger cache-bypass reload handler.

Version 1.4.0

• Added: Hostinger & server caching Anti-Double-Conversion Fix with data-acsw-raw-price tracking.

Version 1.3.0

• Added: Real-time Anti-Cache JS conversion engine + LiteSpeed/Nginx cache vary headers for instant 0ms price switching.

Version 1.2.0

• Added: Vector SVG flag icons support for cross-platform compatibility + glassmorphic popup entrance & exit animations.

👤 Author

Al Amin (Developer Alamin)

• Website: devalamin.me

📄 License

This project is licensed under the GPL-2.0+ License - see the GNU General Public License for details.