=== Nerkh Gold ===
Contributors: nerkhgold
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
WC requires at least: 7.0
WC tested up to: 8.0
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

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

== Description ==

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

=== امکانات اصلی ===

* **قیمت لحظه‌ای بازار** — دریافت خودکار قیمت طلا، سکه، دلار و سایر دارایی‌ها از API
* **محاسبه خودکار قیمت** — محاسبه قیمت بر اساس وزن، نرخ بازار، اجرت ساخت، سود فروش و مالیات
* **پشتیبانی از چند دارایی** — طلای ۱۸ عیار، طلای ۲۴ عیار، سکه، دلار، یورو و بیشتر
* **قانون قیمت‌گذاری** — ایجاد قوانین مختلف قیمت‌گذاری برای گروه‌های مختلف محصولات
* **بازیابی خودکار قیمت** — به‌روزرسانی خودکار قیمت‌ها از طریق WP-Cron (هر دقیقه تا هر ساعت)
* **آپدیت خودکار پلاگین** — دریافت خودکار آپدیت‌ها از سرور نرخ

=== مدیریت محصول ===

* **تب ویژگی‌های طلایی** — تنظیمات هر محصول شامل وزن، دارایی، اجرت، سود و مالیات
* **پشتیبانی از محصولات متغیر** — محاسبه قیمت جداگانه برای هر وریشن
* **وزن بر اساس گرم** — محاسبه دقیق وزن با فرمت گرم و سوت
* ** Governor price override** — امکان تنظیم قیمت دستی برای هر محصول

=== محاسبه قیمت ===

* **اجرت ساخت** — ثابت (تومان) یا درصدی
* **سود فروش** — ثابت (تومان) یا درصدی
* **مالیات** — درصدی با پشتیبانی از روش‌های مختلف محاسبه مالیات
* **متعلقات** — هزینه چرم، جعبه، مروارید و سایر متعلقات
* **گرد کردن** — گرد کردن قیمت نهایی با روش‌های مختلف (نزدیک‌ترین، بالا، پایین)

=== رابط کاربری ===

* **داشبورد مدیریت** — نمایش خلاصه وضعیت سیستم، قیمت‌های بازار و آخرین به‌روزرسانی‌ها
* **صفحه قیمت‌ها** — نمایش لحظه‌ای قیمت تمام دارایی‌ها با امکان به‌روزرسانی دستی
* **صفحه لاگ‌ها** — مشاهده و فیلتر لاگ‌های سیستم با امکان حذف
* **شورتکات‌ها** — نمایش قیمت، وزن، اجرت، سود، مالیات و قیمت نهایی در هر صفحه
* **ماشین حساب** — ماشین حساب آنلاین محاسبه قیمت طلا

=== یکپارچه‌سازی ===

* **ووکامرس** — فیلتر قیمت، سبد خرید، تسویه حساب و نمایش وزن در سبد
* **المنتور** — ویجت ماشین حساب طلا برای صفحه‌ساز المنتور
* **سیستم آپدیت خودکار** — دریافت خودکار آپدیت‌ها از dl.nerkh.io

=== پرفورمنس و امنیت ===

* **کش هوشمند** — کش قیمت محصولات با TTL قابل تنظیم
* **کش Redis** — پشتیبانی از Object Cache با Redis
* **بهینه‌سازی queries** — استفاده از bulk update برای به‌روزرسانی همزمان محصولات
* **امنیت کامل** — nonce verification، capability checks، sanitization و escaping
* **سازگاری PHP** — پشتیبانی از PHP 7.4 تا 8.5

== Installation ==

1. فایل فشرده پلاگین رو از dl.nerkh.io دانلود کنید
2. پوشه `nerkh-gold` رو در مسیر `/wp-content/plugins/` آپلود کنید
3. پلاگین رو از منوی پلاگین‌های وردپرس فعال کنید
4. تنظیمات رو از منوی «تنظیمات بازار» پیکربندی کنید
5. توکن API رو از nerkh.io دریافت و وارد کنید
6. دارایی‌های مورد نظر رو تعریف کنید
7. محصولات ووکامرس رو با دارایی‌های مرتبط تنظیم کنید

== Frequently Asked Questions ==

= آیا این افزونه به ووکامرس نیاز دارد؟ =
بله، ووکامرس نسخه ۷.۰ یا بالاتر الزامی است.

= آیا می‌توانم قیمت‌ها رو دستی تغییر بدهم؟ =
بله، می‌توانید برای هر دارایی یا هر محصول قیمت دستی تنظیم کنید.

= قیمت‌ها چند وقت یکبار به‌روزرسانی می‌شوند؟ =
هر دقیقه تا هر ساعت، بسته به تنظیمات. همچنین می‌توانید دستی به‌روزرسانی کنید.

= آیا از محصولات متغیر پشتیبانی می‌کند؟ =
بله، هر وریشن می‌تواند وزن و تنظیمات جداگانه داشته باشد.

= آیا از چند زبان پشتیبانی می‌کند؟ =
بله، اعداد فارسی و عربی به درستی شناسایی و پردازش می‌شوند.

= آیا با Redis کار می‌کند؟ =
بله، اگر Redis Object Cache فعال باشد، از آن استفاده می‌کند. در غیر این صورت از Transient استفاده می‌شود.

== Screenshots ==

1. داشبورد مدیریت - نمایش خلاصه وضعیت سیستم
2. صفحه قیمت‌ها - نمایش لحظه‌ای قیمت بازار
3. تنظیمات محصول - تب ویژگی‌های طلایی
4. تنظیمات افزونه - پیکربندی کلی
5. صفحه قوانین - تنظیم قوانین قیمت‌گذاری
6. ماشین حساب - محاسبه آنلاین قیمت

== Changelog ==

= 1.1.0 =
* اضافه شدن سیستم آپدیت خودکار پلاگین
* اضافه شدن heartbeat برای آمارگیری هفتگی
* بهینه‌سازی عملکرد محاسبه قیمت برای سایت‌های با تعداد محصول زیاد
* اضافه شدن کش برای `calculate_for_display()`
* بهینه‌سازی `recalculate_all()` با bulk update
* بهینه‌سازی frontend JS با batch request
* اضافه شدن وزن در سبد خرید
* فیکس XSS در settings.php و Elementor widget
* فیکس نمایش API Token به صورت رمز
* حذف پشتیبانی از Dokan
* حذف GET parameter از cron.php برای امنیت بیشتر
* فیکس سازگاری PHP 7.4 (حذف match expressions)
* حذف فایل‌های غیرفعال و دایرکتوری خالی

= 1.0.0 =
* انتشار اولیه

== Upgrade Notice ==

= 1.1.0 =
آپدیت مهم: بهینه‌سازی پرفورمنس، رفع مشکلات امنیتی و اضافه شدن آپدیت خودکار.

== External Services ==

این افزونه از سرویس‌های خارجی زیر استفاده می‌کند:

* **API قیمت‌ها** (api.nerkh.io) — برای دریافت قیمت لحظه‌ای بازار. نیاز به توکن API دارد.
* **سرور آپدیت** (dl.nerkh.io) — برای بررسی و دریافت آپدیت‌های جدید پلاگین.
* **سرور Heartbeat** (dl.nerkh.io/heartbeat) — برای ارسال آمار هفتگی نصب پلاگین (شامل آدرس سایت، ورژن پلاگین، ورژن وردپرس و PHP).

== Privacy ==

این افزونه داده‌های زیر را به سرور dl.nerkh.io ارسال می‌کند:
* آدرس سایت (هش شده با SHA256)
* ورژن پلاگین
* ورژن وردپرس
* ورژن PHP

هیچ اطلاعات شخصی کاربران ارسال نمی‌شود.
