=== Money92 Forex Widgets ===
Contributors: gettechinfinite
Tags: forex, currency, exchange rates, calculator, forex widget
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Two WordPress shortcodes that display Forex rates in PKR and a currency conversion calculator.

== Description ==

Money92 Forex Widgets provides two tools:

1) **Forex Rates Table**
Displays PKR exchange rates for multiple currencies with buying/selling spread applied.

2) **Currency Calculator**
Converts any supported currency into PKR using mid-market, buying, or selling rates.

= Shortcodes =

* `[m92fw_forex_widget]` – Display Forex Rates Table
* `[m92fw_currency_calculator]` – Display PKR Currency Calculator

== External services ==

This plugin relies on a third-party exchange-rate service to display PKR forex rates and power the included currency calculator.

= 1) Exchange-rate JSON service =

The plugin requests exchange-rate data from:

* https://latest.currency-api.pages.dev/v1/currencies/pkr.json

What the service is used for:

* It provides the latest PKR-based exchange-rate JSON needed to build the forex table and currency calculator results.

What data is sent and when:

* A request is made only when one of the plugin shortcodes is used and the cached rates are missing or expired.
* The request is sent from your server using the WordPress HTTP API.
* The remote service receives the requested endpoint URL, your server IP address (as part of the normal HTTPS request), and standard HTTP headers including a User-Agent string containing the plugin name/version and WordPress version.
* No visitor-entered form values, user accounts, or other personal data are intentionally sent by the plugin.

Caching:

* Rates are cached using WordPress transients for 6 hours by default to reduce external requests.

Service / project links:

* Project source: https://github.com/fawazahmed0/exchange-api
* Cloudflare Terms of Use: https://www.cloudflare.com/website-terms/
* Cloudflare Privacy Policy: https://www.cloudflare.com/privacypolicy/

Developer hooks:

* `m92fw_rates_endpoints` (array of URLs)
* `m92fw_rates_cache_ttl` (seconds)

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/money92-forex-widgets/`.
2. Activate the plugin through the “Plugins” menu in WordPress.
3. Insert the shortcode into any page or post.

== Usage ==

**Forex Rates Table**

[m92fw_forex_widget]

**Currency Calculator**

[m92fw_currency_calculator]

== Frequently Asked Questions ==

= Does this plugin use any paid API? =
No. It uses a free, public exchange-rate API.

= Does it cache results? =
Yes. Rates are cached using WordPress transients (default: 6 hours).

= Does this plugin send any personal data to external servers? =
The plugin does not intentionally send visitor-entered personal data. When cached rates are missing or expired, your server makes a request to the external exchange-rate service, which can receive your server IP address and standard HTTP headers as part of the normal HTTPS request.

== Screenshots ==

1. Forex Rates table view
2. Currency calculator UI

== Changelog ==

= 1.1.3 =
* Improved external service disclosure in the readme with service purpose, transmitted data, and policy links
* Reduced data sent in remote requests by removing the site URL from the User-Agent header

= 1.1.0 =
* Fixed WordPress.org review issues: enqueue scripts/styles correctly (no inline <script>/<style> tags)
* Added REST endpoint + server-side fetching with caching
* Updated shortcode names to use a unique prefix

= 1.0 =
* Initial release

== Upgrade Notice ==

= 1.1.3 =
This release updates the external service disclosure and minimizes request metadata sent to the exchange-rate provider.