=== پنل مدیریت فروشگاه ===
Contributors: avasite
Tags: woocommerce, mobile, products, orders, persian
Requires at least: 6.9
Requires PHP: 8.2
Stable tag: 1.4.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

پنل رایگان فارسی و راست‌چین برای مدیریت محصولات و سفارش‌های ووکامرس از گوشی.

== Description ==

افزونه برای مدیر کل و مدیر فروشگاه طراحی شده و از ورود و مجوزهای همان سایت استفاده می‌کند. نشانی پنل از پیوند یکتای برگهٔ منتخب مدیر گرفته می‌شود. فهرست محصولات اخیر و کامل، جست‌وجو با نام یا SKU، فیلتر دسته و برند، محصول ساده و متغیر، گالری، تخفیف و زمان‌بندی، ویرایش سریع و مدیریت سفارش‌ها در پنل در دسترس‌اند.

افزونه برای اجرا به سرویس خارجی یا کلید API احتیاج ندارد. قابلیت برند به دسته‌بندی برند ووکامرس، تقویم شمسی سمت سرور به intl و نصب روی گوشی به HTTPS و پیوند یکتا وابسته‌اند.

این بسته نسخهٔ آزمایشی 1.4.1 است؛ گزارش اصلاحات طراحی و محدودیت‌های تست در docs/RELEASE-1.4.1-FA.md قرار دارد. تأیید نهایی انتشار عمومی به آزمون روی وردپرس/ووکامرس واقعی نیاز دارد.

== Installation ==

1. WooCommerce نسخهٔ 10.8 یا جدیدتر را نصب و فعال کنید.
2. فایل ZIP را از «افزونه‌ها ← افزودن افزونه تازه ← بارگذاری افزونه» نصب و فعال کنید.
3. یک برگهٔ اختصاصی بسازید، شورت‌کد [ava_store_panel] را در بلوک «کد کوتاه» قرار دهید و آن را منتشر کنید.
4. از «ووکامرس ← پنل مدیریت فروشگاه ← عمومی» برگه را انتخاب و ذخیره کنید. نشانی برگه، نشانی پنل است.
5. با حساب وردپرس وارد شوید. در حالت پیش‌فرض داشبورد باز می‌شود و می‌توانید از منوهای «محصولات»، «سفارش‌ها» و «افزودن» استفاده کنید.

== Frequently Asked Questions ==

= آیا ورود جداگانه‌ای لازم است؟ =

ورود، خروج و سیاست احراز هویت از وردپرس به ارث می‌رسند.

= چرا پیشنهاد نصب روی گوشی نمایش داده نمی‌شود؟ =

وضعیت نصب از حافظهٔ قدیمی مرورگر حدس زده نمی‌شود. پنل در Android Chrome سازگار، نصب واقعی PWA را با getInstalledRelatedApps بررسی می‌کند و پیشنهاد مستقیم را فقط پس از beforeinstallprompt نمایش می‌دهد. تمام کاربران مجاز پنل از منوی همبرگری به راهنمای نصب مجدد دسترسی دارند؛ بستن پیشنهاد همچنان رعایت می‌شود. در iOS از Safari و گزینهٔ Add to Home Screen استفاده کنید. برنامه فقط در HTTPS و پیوند یکتای سازگار نصب می‌شود.

= آیا این افزونه APK اندروید (TWA) می‌سازد؟ =

خیر. TWA به بستهٔ Android امضاشده با Bubblewrap و فایل Digital Asset Links در ریشهٔ دامنه نیاز دارد. در «نصب روی گوشی» می‌توانید Package ID و SHA-256 گواهی را تنظیم کنید؛ افزونه در شرایط سازگار فایل عمومی /.well-known/assetlinks.json را ارائه می‌کند. در آیفون از PWA استفاده کنید. راهنمای کامل در docs/PWA-TWA-FA.md است.

= با حذف افزونه چه اتفاقی می‌افتد؟ =

محصول، سفارش، رسانه، دسته و برند در ووکامرس و وردپرس باقی می‌مانند. تنظیمات افزونه هنگام حذف تنها با فعال‌بودن گزینهٔ پاک‌کردن تنظیمات حذف می‌شوند.

== Changelog ==

= 1.4.1 =
* بازطراحی بصری داشبورد با اولویت‌بندی سفارش‌های نیازمند رسیدگی، کارت‌های آماری خوانا، میان‌برهای سریع و فهرست‌های واضح‌تر؛ بدون کوئری اضافه.
* حذف زیرخط لینک‌ها در رابط پنل همراه با حفظ نشانگر فوکوس صفحه‌کلید.
* تبدیل اصلاح سریع قیمت و موجودی محصول ساده به یک پاپ‌آپ مشترک در دسکتاپ و Bottom Sheet روی موبایل، با حفظ کنترل‌های nonce، مجوز، کنترل نسخه و ذخیره AJAX.
* انتقال فیلتر تاریخ سفارش‌ها به پاپ‌آپ انتخابی؛ بازه‌های امروز، دیروز، ۷/۳۰ روز اخیر، این ماه و ماه قبل؛ تقویم شمسی یا میلادی براساس تنظیمات سایت.
* حفظ فیلترهای فعال وضعیت و جست‌وجو هنگام اعمال/پاک‌کردن تاریخ و اعتبارسنجی تاریخ در سرور.
* بدون تغییر دیتابیس یا افزودن کتابخانه خارجی.

= 1.4.0 =
* داشبورد مدیریت با آمار سفارش‌های امروز، در حال انجام، در انتظار و محصولات ناموجود؛ جمع‌آوری آمار با کوئری محدود و کش ۴۵ ثانیه‌ای.
* پنج سفارش اخیر، محصولات ناموجود اخیر و میان‌برهای سریع.
* ویرایش مستقیم قیمت عادی یا موجودی هر محصول ساده با AJAX، مجوز محصول، nonce، قفل نوشتن و کنترل نسخه.
* تکثیر محصول ساده یا متغیر تا ۱۰۰ ترکیب، به‌صورت پیش‌نویس و با جلوگیری از اجرای مجدد همان فرم.
* فیلتر سریع سفارش‌ها، جست‌وجوی دقیق با شماره سفارش، تلفن، ایمیل یا نام؛ تغییر وضعیت از فهرست با تأیید.
* اعلان‌های داخلی بدون Web Push، به‌روزرسانی دوره‌ای فقط روی داشبورد باز و فعال.
* تنظیمات صفحه آغازین، سطح نقش‌ها، عملیات سریع و اعلان‌ها؛ محدودیت نقش، جایگزین مجوزهای اصلی ووکامرس نمی‌شود.
* ابزار عیب‌یابی Manifest، آیکون‌ها، Worker و مسیر PWA؛ نشانی آغاز درون محدوده اپ برای کاربران واردنشده.
* حفظ قابلیت‌های پیشین ۱.۳.۳ و پشتیبانی از ردیف‌های ۵ محصول اخیر، قیمت ووکامرس و PWA/TWA.

= 1.3.3 =
* اصلاح تشخیص نصب مجدد PWA پس از حذف WebAPK، بدون تکیه بر مقدار نصب ذخیره‌شده.
* راهنمای نصب دائمی در منوی پنل و بررسی نصب در Chromeهای دارای API مربوطه.

= 1.3.2 =
* اصلاح قطعی نمایش بنر بسته‌شده/نصب‌شده با CSS hidden و جلوگیری از پیشنهاد تکراری.
* راهنمای دقیق نصب PWA برای Android Chrome و Safari iOS، و پشتیبانی از حالت مستقل iOS.
* اصلاح ابعاد آیکون‌های Manifest و حفظ کش امن دارایی‌های عمومی.
* پیکربندی اختیاری TWA اندروید با اعتبارسنجی Package ID و SHA-256 و ارائه فایل Digital Asset Links از دامنهٔ سازگار، بدون بازنویسی فایل فیزیکی موجود.
* مستندات تولید APK/AAB با Bubblewrap و تست‌ها/محدودیت‌ها.

= 1.3.1 =
* همسان‌سازی نمایش قیمت فهرست، جزئیات و سفارش‌ها با تنظیمات ارز، جداکننده و اعشار ووکامرس؛ حذف صفرهای انتهایی اضافی فقط در پنل.
* نمایش ثابت پنج محصول جدیدتر بر اساس تاریخ ثبت و شناسهٔ نزولی در نمای ابتدایی؛ بدون شمارش غیرضروری همهٔ محصولات.
* بازکردن کپی‌رایت آوا سایت در تب جدید به‌شکل ایمن.
* سقف ۱۰۰۰ نتیجه برای جست‌وجوی نام/SKU با اطلاع‌رسانی هنگام رسیدن به سقف برای جلوگیری از بار نامحدود.
* خواندن صفحه‌ای شناسهٔ ترکیب‌های محصولات متغیر و بررسی وجود ترکیب با کوئری محدود.
* پذیرش جداکنندهٔ اعشار تنظیم‌شده در ووکامرس در ورودی قیمت و حفظ قالب عدد داخلی ووکامرس.
* بازبینی امنیت ایستا، بدون ادعای تست زنده روی فروشگاه عملیاتی.

= 1.3.0 =
* انتخاب‌گر جست‌وجوی دسته و برند در خود پنل و مرور دستهٔ مادر و زیردسته‌ها.
* تعویض هر عکس گالری در جای خودش و نمایش مبلغ با جداکنندهٔ هزارگان و اعشار.
* حفظ وضعیت نصب یا بستن پیشنهاد نصب در مرورگر و دسترسی مدیر از منو.
* افزودن لوگوی آوا به اعتبار طراحی.

= 1.2.0 =
* تعیین نشانی پنل با برگهٔ وردپرس و شورت‌کد [ava_store_panel].
* نمایش پیام‌های خود پنل در تنظیمات و پنهان‌کردن اعلان‌های عمومی وردپرس و افزونه‌ها در همان صفحه.
* نمایش ثابت اعتبار طراحی آوا.

= 1.1.0 =
* نام «پنل مدیریت فروشگاه» و صفحهٔ تنظیمات راست‌چین با فونت محلی استعداد.
* پیش‌نمایش زنده، چهار رنگ قابل تنظیم، پالت آماده، لوگو و آیکون رسانه.
* اعتبار طراحی آوا و تشخیص نوع تداخل نامک با پیشنهاد مسیر.

= 1.0.1 =
* کاهش حداقل PHP لازم برای نصب افزونه به 8.2.

= 1.0.0 =
* بستهٔ مستقل وردپرس با احراز هویت استاندارد، مجوزها، تنظیمات و مسیر قابل تغییر.
* محصولات ساده و متغیر، گالری، زمان‌بندی شمسی و میلادی و ویرایش سریع با مرور و نتیجهٔ هر مورد.
* فهرست و جزئیات سفارش، فیلتر تاریخ و وضعیت، یادداشت داخلی و تغییر وضعیت با WooCommerce CRUD.
* نصب روی گوشی و کش محدود به دارایی‌های ثابت نسخه‌دار.
* راهنما، گزارش تست و متن معرفی صفحهٔ دانلود.

== Upgrade Notice ==

= 1.2.0 =
مسیر قبلیِ فعال تا انتخاب و ذخیرهٔ برگهٔ معتبر در دسترس می‌ماند.

= 1.1.0 =
نسخهٔ قبلی را جایگزین کنید. نام‌های سفارشی و تنظیمات قبلی حفظ می‌شوند. عنوان پیش‌فرض به «پنل مدیریت فروشگاه» تغییر می‌کند.

= 1.0.1 =
حداقل PHP برای نصب 8.2 است. بسته را روی افزونهٔ فعلی نصب و جایگزین کنید.

= 1.0.0 =
اولین نسخهٔ افزونهٔ مستقل. تنظیمات پنل مستقل نسخهٔ 1.2.0 به‌طور خودکار مهاجرت نمی‌کنند. داده‌های فروشگاه از نصب فعلی ووکامرس خوانده می‌شوند.
