=== Assertivlogix Local Currency Display for WooCommerce ===
Contributors: assertivlogix,nikulpatel
Tags: woocommerce, currency converter, multi-currency, geolocation, exchange rates, auto currency, forex, country currency
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically converts product prices based on the visitor's country using real-time exchange rates.

== 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.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/assertivlogix-local-currency-display-woocommerce` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Use the **WooCommerce -> Country Currency** menu to configure the plugin.
4. Choose your preferred Exchange Rate API provider and save changes.

== Frequently Asked Questions ==

= 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.

== 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/](https://www.exchangerate-api.com/)
* **Terms of Use:** [https://www.exchangerate-api.com/terms](https://www.exchangerate-api.com/terms)
* **Privacy Policy:** [https://www.exchangerate-api.com/privacy](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/](https://fixer.io/)
* **Terms of Use:** [https://fixer.io/terms](https://fixer.io/terms)
* **Privacy Policy:** [https://fixer.io/privacy](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/](https://openexchangerates.org/)
* **Terms of Use:** [https://openexchangerates.org/terms](https://openexchangerates.org/terms)
* **Privacy Policy:** [https://openexchangerates.org/privacy](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/](https://ipapi.co/)
* **Terms of Use:** [https://ipapi.co/terms/](https://ipapi.co/terms/)
* **Privacy Policy:** [https://ipapi.co/privacy/](https://ipapi.co/privacy/)

== Screenshots ==

1. **Modern Admin Dashboard:** Configure geolocation fallbacks and API providers with ease.
2. **Real-time Status:** View current detection status and exchange rates directly in the admin.

== 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.
