=== Nerkh Live ===
Contributors: Nerkh.IO
Tags: currency rates, gold price, crypto price, exchange rates, live rates
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display live gold, currency, coin and cryptocurrency prices with a customizable sticky bar.

== External Services ==

This plugin relies on the following third-party/external service to function:

=== Nerkh.IO API (api.nerkh.io) ===

* What the service is: Nerkh.IO provides real-time financial market data (gold, currency, coin, and cryptocurrency prices) via a REST API.
* What it is used for: Fetching live price data that is displayed on your website via a shortcode widget and/or a sticky price bar.
* What data is sent and when:
  – Your API key (for authentication) is sent with every request to api.nerkh.io.
  – A request is made when an admin manually triggers a "Test" or "Connect" action in the plugin settings.
  – Automatic requests are made on a recurring schedule (every 10, 30, or 60 minutes) via WordPress cron jobs to keep prices up to date.
  – No personal user or visitor data is transmitted.
* API endpoint used: https://api.nerkh.io/v1/prices/json/all
* Service provider: Nerkh.IO
* Website: https://nerkh.io
* Terms of Service: https://nerkh.io/terms
* Privacy Policy: https://nerkh.io/privacy

=== Nerkh.IO Website (nerkh.io) ===

* What the service is: The main website of the Nerkh.IO service.
* What it is used for: A link to "نرخ ❤" (brand attribution) is displayed in the frontend sticky price bar, linking back to https://nerkh.io. This is required by the API terms of use.
* What data is sent: No data is sent from the plugin to nerkh.io. The link is only rendered in the browser for end-users to click.
* Service provider: Nerkh.IO
* Website: https://nerkh.io
* Terms of Service: https://nerkh.io/terms
* Privacy Policy: https://nerkh.io/privacy

== Description ==

Nerkh Live is a professional WordPress plugin that allows you to display real-time Gold, Currency, Coin, and Cryptocurrency prices on your website.

The plugin receives live financial data from an API web service and automatically displays the rates on your website using a customizable sticky bar.

Users can easily connect the plugin to the API by entering their API Token/Key from the main website.

The plugin is completely free and compatible with both WordPress and WooCommerce.

== Main Features ==

* Real-time Gold prices
* Real-time Currency exchange rates
* Real-time Coin prices
* Real-time Cryptocurrency prices
* Automatic API price updates
* Update interval settings:

  * Every 10 minutes
  * Every 30 minutes
  * Every 60 minutes
* Sticky bar display
* Display at top or bottom of website
* Full style customization
* Background color customization
* Dark mode and light mode support
* Custom colors for each financial item
* Price color customization
* Separator color customization
* Financial symbol color customization
* Font size customization
* Select which items to display
* Support for more than 23 financial items
* API connection testing
* API response testing
* Easy installation and setup
* WooCommerce compatible
* Lightweight and optimized

== Supported Financial Items ==

The plugin supports various financial categories including:

* Gold
* Coins
* Dollar
* Euro
* Foreign currencies
* Bitcoin
* Tether
* Cryptocurrencies
* Digital currencies

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Open the Nerkh Live settings page.
4. Enter your API Token/Key.
5. Save settings.
6. Configure display styles and update intervals.
7. Done! Live prices will now appear on your website.

== Frequently Asked Questions ==

= Is the plugin free? =

Yes. Nerkh Live is completely free for WordPress and WooCommerce users.

= How do I connect the plugin to the API? =

Get your API Token/Key from the main website and enter it in the plugin settings page.

= Can I customize the design? =

Yes. You can fully customize colors, fonts, sticky bar position, and display styles.

= Can I choose which items to display? =

Yes. You can select only the financial items you want to show on your website.

= Does the plugin support automatic updates? =

Yes. The plugin can automatically update prices every 10, 30, or 60 minutes.

== Screenshots ==

1. Live rates sticky bar
2. Plugin settings panel
3. API connection test section
4. Financial item selection
5. Display customization settings

== Changelog ==

= 2.1.1 =

* Updated external service documentation — full disclosure of third-party API communication, terms of service, and privacy policy links in readme
* Replaced inline script echo with proper wp_enqueue_script() and wp_localize_script() for debug page JavaScript

= 2.1.0 =

* Security hardening — all output properly escaped
* Fixed database query warnings
* Improved PHPCS compliance
* Code quality improvements

= 1.0.6 =

* Fixed plugin structure
* Added automatic update intervals
* Added API connection testing
* Added customizable sticky bar
* Improved WooCommerce compatibility
* Performance improvements
* UI and settings improvements

== Upgrade Notice ==

= 2.1.1 =
Added full third-party service documentation for WordPress.org compliance and switched debug page scripts to proper WordPress enqueue methods.

= 2.1.0 =
Security and compliance updates with improved code quality.
