Description
Assertivlogix Local Currency Display for WooCommerce is a powerful and lightweight solution designed to enhance the shopping experience for your international customers. By automatically detecting a visitor’s location using WooCommerce’s built-in geolocation, the plugin switches your store’s currency to their local currency in real-time.
This plugin ensures that your customers always see prices in a familiar currency, reducing friction during the checkout process and increasing conversion rates.
Key Features:
- Automatic Country Detection: Uses WooCommerce’s built-in IP geolocation to identify the visitor’s country.
- Real-time Exchange Rates: Fetches live currency data from reliable sources like Open Exchange Rates API, Fixer.io, and Open Exchange Rates.
- Performance Optimized: Exchange rates are cached to ensure your site remains fast and responsive.
- Localhost & Testing Support: Built-in fallback to public IP detection, making it easy to test on local development environments.
- Developer Friendly: Clean code structure and standard WordPress hooks for easy customization.
- Easy Configuration: A modern, intuitive settings page integrated directly into WooCommerce.
Why Choose This Plugin?
Providing a localized experience is crucial for global e-commerce. This plugin takes the guesswork out of currency conversion, allowing you to focus on growing your business while your customers enjoy a seamless shopping journey.
External Services
This plugin connects to the following third-party external services to provide currency conversion and geolocation functionality. No personal user data (such as names, emails, or browsing history) is shared with these services.
Open Exchange Rates API (open.er-api.com)
This plugin connects to the Open Exchange Rates API at open.er-api.com to fetch live currency exchange rates. This is the default (free) exchange rate provider.
- What data is sent: The store’s base currency code (e.g., “USD”) is sent as a URL parameter.
- When data is sent: When exchange rates need to be refreshed (rates are cached for 24 hours to minimize requests).
- Service website: https://www.exchangerate-api.com/
- Terms of Use: https://www.exchangerate-api.com/terms
- Privacy Policy: https://www.exchangerate-api.com/privacy
Fixer.io
This plugin can optionally connect to the Fixer.io API to fetch live currency exchange rates. This provider requires a user-provided API key.
- What data is sent: The store’s base currency code and the site administrator’s Fixer.io API key are sent as URL parameters.
- When data is sent: Only when Fixer.io is selected as the exchange rate provider and rates need to be refreshed (cached for 24 hours).
- Service website: https://fixer.io/
- Terms of Use: https://fixer.io/terms
- Privacy Policy: https://fixer.io/privacy
Open Exchange Rates (openexchangerates.org)
This plugin can optionally connect to the Open Exchange Rates API at openexchangerates.org to fetch live currency exchange rates. This provider requires a user-provided App ID.
- What data is sent: The store’s base currency code and the site administrator’s Open Exchange Rates App ID are sent as URL parameters.
- When data is sent: Only when Open Exchange Rates is selected as the exchange rate provider and rates need to be refreshed (cached for 24 hours).
- Service website: https://openexchangerates.org/
- Terms of Use: https://openexchangerates.org/terms
- Privacy Policy: https://openexchangerates.org/privacy
ipapi.co (Geolocation Fallback)
This plugin connects to ipapi.co only as a fallback when the site is running on localhost or a local development environment where WooCommerce’s built-in geolocation cannot determine the visitor’s country. This service is not used on production/live sites where WooCommerce geolocation works normally.
- What data is sent: The server’s public IP address is sent implicitly via the HTTP request (no user IP is forwarded).
- When data is sent: Only on localhost/development environments when WooCommerce’s built-in geolocation returns no result.
- Service website: https://ipapi.co/
- Terms of Use: https://ipapi.co/terms/
- Privacy Policy: https://ipapi.co/privacy/
Installation
- Upload the plugin files to the
/wp-content/plugins/assertivlogix-local-currency-display-woocommercedirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Use the WooCommerce -> Country Currency menu to configure the plugin.
- Choose your preferred Exchange Rate API provider and save changes.
FAQ
-
Does it work on localhost?
-
Yes! We have implemented a special fallback that detects your public IP even when you are working on a local server, ensuring you can test the functionality before going live. This fallback uses the ipapi.co service only on localhost environments.
-
Which API providers are supported?
-
Currently, we support:
1. Open Exchange Rates API via open.er-api.com (Free, no API key required)
2. Fixer.io (Requires API key)
3. Open Exchange Rates via openexchangerates.org (Requires App ID) -
How often are exchange rates updated?
-
Rates are updated and cached for 24 hours by default to ensure accuracy without overloading the API or slowing down your site.
-
Is it compatible with other WooCommerce extensions?
-
Yes, it is designed to work seamlessly with the core WooCommerce price display logic, making it compatible with most themes and plugins.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Assertivlogix Local Currency Display for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Assertivlogix Local Currency Display for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release of Assertivlogix Local Currency Display for WooCommerce.
- Support for automatic geolocation.
- Integration with multiple exchange rate APIs.
- Admin settings dashboard.
