=== Raven Gold Price Widget ===
Contributors: ravengold
Tags: gold price, currency, widget, iran, persian
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Live Iranian gold, coin, currency and stock prices on your site, in six shapes.

== Description ==

Show live prices of gold, Emami and Bahar Azadi coins, the US dollar, the euro, Tether, Bitcoin and Tehran Stock Exchange symbols on your WordPress site.

* Six shapes, each sized for a standard slot: list (sidebar, 300 wide), table (inside a post), tiles, single card (300 × 250), moving ticker (header) and small (160 wide).
* Light and dark colours.
* Prices refresh every 10 minutes on their own.
* A block for the editor, a classic widget for sidebars, and a shortcode for anything else.
* Each row links to that asset's page on Raven, in a new tab.

Shortcode:

`[ravengold_widget mode="list" symbols="IR_GOLD_18K,IR_COIN_EMAMI,USD" theme="light"]`

`mode` is one of `list`, `table`, `tiles`, `card`, `ticker`, `mini`. `theme` is `light` or `dark`. Build a widget at https://ravengold.ir/widget/ to find the symbol id of any stock or fund.

**فارسی:** قیمت لحظه‌ای طلا، سکه، ارز و سهام بورس تهران را در سایت وردپرسی خود نشان دهید. شش شکل (فهرست، جدول، کاشی‌ها، کارت تکی، نوار متحرک و کوچک)، رنگ روشن و تیره، به‌روزرسانی خودکار هر 10 دقیقه. بلوک ویرایشگر، ابزارک کلاسیک و کد کوتاه.

== External services ==

This plugin shows a widget served by Raven (ravengold.ir), a price service for the Iranian market. It is the only external service the plugin uses.

* What: the plugin prints an iframe that loads https://ravengold.ir/w/ in your visitor's browser. The widget page then fetches the current prices from ravengold.ir.
* When: every time a page with the widget is viewed, and again every 10 minutes while it stays open.
* What is sent: only what any web page request carries — the visitor's IP address, browser user agent, and (because of the referrer policy) your site's address. The chosen shape, colour and symbol ids are in the widget address. No cookies are set and no personal data is collected by the plugin.
* The plugin itself, on your server, makes no requests and stores nothing.

Raven terms of use: https://ravengold.ir/terms/
Raven privacy policy: https://ravengold.ir/privacy/

== Installation ==

1. Install from Plugins → Add New (search "Raven Gold Price Widget"), or upload the zip.
2. Activate.
3. Add the "Raven price widget" block to a post, page or block widget area, or the classic widget under Appearance → Widgets, or paste the shortcode.

== Frequently Asked Questions ==

= Is it free? =

Yes. The widget carries a small "قیمت از رِیون" link back to Raven.

= How do I show a stock that is not in the list? =

Build the widget at https://ravengold.ir/widget/, search for the stock, and copy the symbol id (the part after `s=`) into "Other symbols".

= Does it slow my site down? =

The widget loads lazily in its own frame, after your page, from Raven's server.

== Screenshots ==

1. The six shapes.
2. The block settings in the editor.

== Changelog ==

= 1.0.0 =
* First release.
