=== MRN Nerkh ===
Contributors: mehran-mrn
Tags: woocommerce, gold, currency, dynamic pricing, iran
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 8.1
Requires Plugins: woocommerce
Stable tag: 1.3.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Gold and currency rates for Iranian websites, with Persian rate boards and dynamic WooCommerce product pricing.

== Description ==

MRN Nerkh is a Persian-first rate and pricing plugin for Iranian websites. It stores gold, coin, currency and crypto rates locally and calculates WooCommerce prices from a selected rate, quantity, multiplier, percentage and fixed adjustments. Its administration interface is in Persian with RTL layouts.

Manual rates work without an external service. External providers are disabled on fresh installations and require administrator configuration. Refresh jobs fetch rates on a schedule or at the administrator's request; visitors read locally cached rates. The plugin supports simple products, variations, cart price snapshots, rounding, and cards, tables or ticker rate boards.

See the Persian guide below for setup, migration, privacy and external service details. API availability, data reuse rights and subscription requirements depend on the selected provider.

== راهنمای فارسی ==

[صفحه افزونه](https://mrnwp.ir/mrnnerkh) | [MRNWP](https://mrnwp.ir) | [کد و گزارش مشکل](https://github.com/mehran-mrn/wp-price-engine)

= امکانات =

* پنل فارسی راست‌به‌چپ، مدیریت دارایی‌ها و تاریخچه نرخ.
* نرخ دستی، منابع API، JSON سفارشی و استخراج نرخ از منابع HTML منتخب.
* دریافت زمان‌بندی‌شده و دستی توسط مدیر؛ نمایش و محاسبه از دادهٔ محلی.
* قیمت محصولات ساده و متغیر، اجرت درصدی و ثابت، ضریب و گرد کردن.
* تبدیل ریال و تومان و تبدیل ارز با جفت‌نرخ‌های موجود روی سایت.
* قفل قیمت سبد و ذخیرهٔ مبنای نرخ در سفارش.
* نمای کارت، جدول و نوار، شورت‌کد و بلوک Gutenberg.
* حفظ آخرین نرخ معتبر هنگام خطای منبع و تنظیم رفتار نرخ قدیمی.

منابع بیرونی در نصب تازه خاموش هستند. مدیر باید هر منبع مورد نیاز را از بخش «منابع داده» فعال و تنظیم کند. نرخ دستی به سرویس بیرونی نیاز ندارد. محدودیت، هزینه، مجوز نمایش داده و نیاز به کلید API مربوط به سرویس انتخابی است؛ امکانات محلی افزونه قفل لایسنس ندارند.

= سازنده و مجوز =

توسعه‌دهنده: [Mehran Marandi](https://mehranmarandi.ir). کد و تصاویر همراه افزونه تحت GPLv3 or later عرضه می‌شوند. اطلاعات مرجع اتصال‌ها در NOTICE.txt آمده است. کد PHP، JavaScript و CSS قابل خواندن است و مرحلهٔ build لازم ندارد.

== Installation ==

1. ووکامرس را نصب و فعال کنید.
2. ZIP را از «افزونه‌ها ← افزودن ← بارگذاری افزونه» نصب کنید.
3. MRN Nerkh را فعال و بخش «نبض قیمت» را باز کنید.
4. نرخ دستی تعریف یا یک منبع را پس از بررسی شرایط استفاده فعال کنید.
5. در ویرایش محصول، تب «قیمت‌گذاری پویا» را تنظیم کنید.
6. برای نمایش از بلوک «تابلوی نرخ MRN» یا `[mrn_price_board]` استفاده کنید.

برای ارتقا از پوشهٔ توسعه‌ای `mrn-price-engine`، ابتدا نسخهٔ قبلی را غیرفعال و سپس نسخهٔ پوشهٔ `mrn-nerkh` را فعال کنید. جدول‌ها، تنظیمات، شورت‌کدها، REST API و نام داخلی بلوک حفظ شده‌اند. برای حفظ داده‌ها، نسخهٔ قبلی را با گزینهٔ حذف داده هنگام uninstall پاک نکنید.

== External services ==

درخواست‌ها فقط هنگام کار زمان‌بندی‌شده یا دریافت دستی مدیر برای منابع فعال ارسال می‌شوند. تابلوی نرخ و قیمت مشتری از دادهٔ محلی استفاده می‌کنند. درخواست می‌تواند شامل نماد دارایی، ارز مبنا/مقصد، کلید API یا توکن/مشخصات حساب واردشده برای همان سرویس باشد. سرویس IP سرور و شناسهٔ افزونه را می‌بیند. نشانی سایت در User-Agent ارسال نمی‌شود. اطلاعات سفارش، نام، ایمیل و نشانی مشتری به سرویس نرخ ارسال نمی‌شود.

فهرست دامنه‌ها و اتصال‌ها در services.txt آمده است. اتصال‌های قدیمی فاقد endpoint پشتیبانی‌شده فقط برای حفظ تنظیمات قبلی نگه داشته شده‌اند و نرخ دریافت نمی‌کنند.

* [Navasan](https://www.navasan.tech/) — نرخ ایران، نیازمند کلید و حساب سرویس.
* [CoinGecko](https://www.coingecko.com/en/api) — نرخ رمزارز؛ [شرایط API](https://www.coingecko.com/en/api_terms)، [حریم خصوصی](https://www.coingecko.com/en/privacy).
* [Frankfurter](https://frankfurter.dev/) — نرخ ارز مرجع بین‌المللی.
* [Metals.dev](https://metals.dev/) — نرخ فلزات؛ نیازمند کلید.
* [Nobitex](https://nobitex.ir/)، [Wallex](https://wallex.ir/)، [Bitpin](https://bitpin.ir/)، [Ramzinex](https://ramzinex.com/)، [Exir](https://www.exir.io/)، [TetherLand](https://tetherland.com/) و [ArzPaya](https://arzpaya.com/) — بازارهای رمزارز ایران.
* [Milli](https://milli.gold/)، [MelliGold](https://melligold.com/) و [TGJU](https://www.tgju.org/) — صفحات نرخ منتخب؛ استخراج HTML ممکن است با تغییر صفحه متوقف شود. عمومی‌بودن صفحه به معنی اجازهٔ بازنشر تجاری داده نیست؛ پیش از استفاده مجوز و شرایط منبع را بررسی کنید.
* JSON سفارشی — نشانی HTTPS که مدیر تعیین می‌کند؛ داده و header تنظیم‌شده به همان مقصد ارسال می‌شود.

== Privacy ==

تعریف دارایی، نرخ‌ها، تاریخچه، گزارش دریافت و تنظیمات سرویس در دیتابیس سایت ذخیره می‌شوند. کلیدها و توکن‌ها در گزینه‌های وردپرس ذخیره می‌شوند؛ از دسترسی مدیریت و نسخه‌های پشتیبان حفاظت کنید. مبنای نرخ در متادیتای محصول/سفارش ثبت می‌شود. حذف اطلاعات هنگام uninstall اختیاری و پیش‌فرض خاموش است.

آمار استفاده یا اطلاعات فروشگاه به MRNWP یا سازنده ارسال نمی‌شود. فایل‌های نمایشی محلی هستند. REST عمومی فقط دادهٔ نرخ را منتشر می‌کند و قابل خاموش‌کردن است؛ کلید API و header اتصال در آن قرار نمی‌گیرند.

== Frequently Asked Questions ==

= آیا نرخ‌ها لحظه‌ای هستند؟ =

دریافت دوره‌ای و وابسته به منبع، فاصلهٔ دریافت و WP-Cron است. قیمت بازار یا دسترسی دائمی سرویس تضمین نمی‌شود. زمان آخرین دریافت و رفتار نرخ قدیمی را تنظیم و بررسی کنید.

= بدون سرویس پولی هم کار می‌کند؟ =

نرخ دستی و منابعی که طبق شرایط خود دسترسی عمومی دارند قابل استفاده‌اند. هزینه و سهمیهٔ API را ارائه‌دهنده تعیین می‌کند.

= افزونه برای کاربران ایرانی است؟ =

رابط و معرفی برای سایت‌های ایرانی طراحی شده‌اند؛ تمرکز روی طلا، سکه، ریال و تومان است. منابع بین‌المللی برای تبدیل و نرخ رمزارز هم وجود دارند.

= آیا مالیات و قوانین فروش طلا را تضمین می‌کند؟ =

خیر. فرمول قیمت یک ابزار محاسبه است. نرخ، واحد، اجرت، تخفیف و مالیات باید متناسب با کسب‌وکار تنظیم و آزمایش شوند.

== Screenshots ==

1. داشبورد فارسی نرخ‌ها و وضعیت منابع.
2. مدیریت نرخ طلا، ارز و دارایی‌ها.
3. تابلوی نرخ فارسی در سایت.

== Changelog ==

= 1.3.0 =
* معرفی MRN Nerkh، صفحه محصول و اطلاعات سازنده.
* افزودن لوگو و آیکون هماهنگ با منوی وردپرس.
* خاموش‌بودن منابع بیرونی در نصب تازه؛ حفظ تنظیمات قبلی.
* حذف نشانی سایت از User-Agent و محدودسازی پاسخ JSON.
* هماهنگی دامنهٔ ترجمه و بستهٔ انتشار با mrn-nerkh.
* تکمیل مستندات منابع، حریم خصوصی و مجوز GPLv3 or later.

= 1.2.0 =
* استخراج نرخ از Milli، MelliGold و TGJU.
* حفظ آخرین نرخ معتبر هنگام خطای تشخیص صفحه.

= 1.1.0 =
* تبدیل نرخ به ارز فروشگاه با جفت‌نرخ‌های ذخیره‌شده.
* توسعهٔ فهرست منابع و تنظیمات اتصال.

= 1.0.0 =
* نخستین نسخه.

== Upgrade Notice ==

= 1.3.0 =
نام عمومی MRN Nerkh است. تنظیمات و نرخ‌های قبلی حفظ می‌شوند. منابع بیرونی نصب تازه باید توسط مدیر فعال شوند.
