Install
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/tofayelsfamily/wpfia-currency-switcher/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
WPFIA Instant Currency Switcher & Auto Geo-Detector for WooCommerce
WPFIA Instant Currency Switcher is an ultra-fast, lightweight, and modern multi-currency conversion plugin engineered specifically for high-conversion WooCommerce stores. Designed with zero external dependencies and local caching, it delivers instantaneous price conversions without slowing down store checkout.
✨ Key Features
- ⚡ Zero-Reload AJAX Switching: Customers switch currencies instantaneously without tedious full-page reloads.
- 🌍 Auto Geo-Location Detector: Automatically detects visitor country and presents prices in their local currency.
- 🍔 Navigation Menu Switcher: Effortlessly integrates into your store's primary navigation menu with clean flags and symbols.
- 📌 Executive Topbar Strip: Optional sleek topbar header strip for desktop & mobile viewports.
- 💱 Real-Time Exchange Rates: Automatically fetches reliable rates with configurable manual fallback overrides.
- 🚀 Ultra-Lightweight & Clean: Pure native WooCommerce integration, zero bloated libraries, and 100% PHP 8+ compatible.
- 🛡️ Reentrancy Guard Protection: Hardened against infinite recursion loops on
get_woocommerce_currency.
🚀 Installation
- Download or clone this repository:
git clone https://github.com/tofayelsfamily/wpfia-currency-switcher.git - Upload the
wpfia-currency-switcherdirectory to/wp-content/plugins/. - Activate the plugin via WordPress Admin > Plugins.
- Configure your preferred currencies, exchange rates, and switcher positions under WooCommerce > Settings > Currency Switcher.
🛠️ Architecture & Hooks
Developed following strict WordPress Plugin Check (PCP) and WordPress VIP coding standards:
- All options, transients, and functions strictly prefixed with
wpfia_cs_. - Nonce and capability verification on all AJAX handlers.
- Safe output escaping using
esc_html(),esc_attr(), andesc_url().
🏢 About WPFIA
Developed with precision by WPFIA Solutions.
Explore our complete suite of high-performance WordPress & WooCommerce tools at wpfia.com.
License: GNU General Public License v2 or later.