WP Manifestindependent plugin directory
manifest / ecommerce / auto-currency-switcher

Auto Currency Switcher for WooCommerce

GeoIP auto currency detection + floating switcher popup with full color customization. Base currency USD. Supports GBP, USD, EUR, INR, SAR, AED. Auto rate via free API or manual rates. Same position on PC & Mobile. * Version: 1.4.1

by Al Amin · github.com/developeralaminvi/auto-currency-switcher · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/developeralaminvi/auto-currency-switcher/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/developeralaminvi/auto-currency-switcher ↗

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:

Currency Code Currency Name Symbol Flag
USD US Dollar (Base) $ 🇺🇸
GBP British Pound £ 🇬🇧
EUR Euro € 🇪🇺
INR Indian Rupee ₹ 🇮🇳
SAR Saudi Riyal ﷼ 🇸🇦
AED UAE Dirham د.إ 🇦🇪

🛠️ 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)

📄 License

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