=== پرو مجازی هوشمند پارسیان (Parsian AI Virtual Try-On) ===
Contributors: parsianit
Requires at least: 6.0
Requires PHP: 7.4
Stable tag: 1.5.0
Plugin URI: https://parsianitco.com

ویجت المنتور فروشگاه با «اتاق پرو» هوش مصنوعی برای ووکامرس.

== نصب ==
1. فایل zip را از «افزونه‌ها ← افزودن ← بارگذاری افزونه» نصب و فعال کنید.
2. ووکامرس ← پرو مجازی AI: سرویس (AvalAI / Google Gemini / FASHN / fal.ai / Replicate) را انتخاب و کلید API را وارد کنید.
3. ووکامرس ← مانکن‌های پرو: مانکن‌ها را از کتابخانه‌ی رسانه اضافه کنید یا با هوش مصنوعی بسازید (جنسیت + سایز).
4. در المنتور ویجت «فروشگاه با اتاق پرو AI» (دسته‌ی پارسیان IT) را اضافه کنید.
5. (اختیاری) در صفحه‌ی هر محصول، جعبه‌ی «پرو مجازی AI»: نوع لباس، عکس جداگانه‌ی لباس، یا خاموش کردن پرو.

== نکته‌ها ==
* سایت روی لوکال‌هاست یا با ضدهات‌لینک: روش ارسال تصویر را روی Base64 بگذارید.
* پشت CDN (کلودفلر، ابرآروان): برای محدودیت هر IP، با فیلتر pvto_client_ip آی‌پی واقعی را برگردانید، مثلاً:
  add_filter( 'pvto_client_ip', fn( $ip ) => $_SERVER['HTTP_AR_REAL_IP'] ?? $_SERVER['HTTP_CF_CONNECTING_IP'] ?? $ip );
* افزونه‌ی علاقه‌مندی غیر از YITH: رویداد جاوااسکریپتی pvto:wishlist با (productId, active) ارسال می‌شود.
* فیلترها برای تغییر ورودی سرویس‌ها: pvto_fashn_inputs، pvto_fal_input، pvto_replicate_input، pvto_gemini_prompt، pvto_gemini_body، pvto_mannequin_prompt، pvto_product_gender، pvto_product_enabled.

== سازنده ==
طراحی و توسعه: پارسیان IT — https://parsianitco.com
© Parsian IT. All rights reserved.

== تغییرات ==
= 1.5.0 =
* نسخه‌ی عمومی پارسیان IT: پوسته‌ی خنثی (فونت سایت، رنگ‌های قابل تغییر).
* برندینگ پارسیان IT در پیشخوان، المنتور و اتاق پرو (لینک اعتبار قابل خاموش کردن).

= 1.4.0 =
* سرویس جدید AvalAI (ایرانی، پرداخت ریالی): مدل‌های Nano Banana از طریق درگاه سازگار با Gemini؛ از سرور داخل ایران کار می‌کند.
* تست اتصال AvalAI (کلید + وجود مدل در حساب).
* ساخت مانکن با AvalAI؛ سرویس فعال در اولویت است.

= 1.3.0 =
* کتابخانه‌ی مانکن (ووکامرس ← مانکن‌های پرو): جنسیت، سایز، پیش‌فرض؛ برای همه‌ی ویجت‌ها.
* ساخت خودکار مانکن یا مدل واقعی‌نما با Gemini / fal.ai / Replicate (زن، مرد، کودک × لاغر، متوسط، درشت).
* اتاق پرو: دکمه‌های زن/مرد/کودک، سایز روی هر مانکن؛ بارگذاری عکس مشتری اختیاری.
* جنسیت محصول (خودکار از دسته یا دستی) و تعویض خودکار مانکن هنگام پرو.

= 1.2.0 =
* پوسته‌ی پیش‌فرض جدید: روشن و تخت، قابل تغییر با متغیرهای CSS.
* امکان معرفی فونت دلخواه و فایل‌های آن در تنظیمات.
* کارت جدید: دکمه‌ی «پرو کن» و سبد خرید در نوار پایین تصویر (روی هاور؛ در موبایل همیشه).
* عنوان برای بخش مدل‌ها و لباس‌های تن در اتاق پرو.
* رفع فشرده شدن تصویر مدل در پنل کشویی موبایل.

= 1.1.0 =
* سرویس چهارم: Google Gemini (Nano Banana) با انتخاب مدل؛ نتیجه در یک مرحله برمی‌گردد و روی سرور ذخیره می‌شود.
* تست اتصال Gemini وجود مدل را هم بررسی می‌کند.
* تشخیص خطاهای گوگل: کلید نامعتبر، سهمیه/Billing، و محدودیت موقعیت مکانی.

= 1.0.1 =
* دکمه‌ی «تست اتصال و کلید» در تنظیمات (رایگان).
* پیام خطای دقیق: تفکیک کلید نامعتبر، اعتبار/پرداخت، و مسدود بودن IP سرور؛ مدیر فروشگاه کد HTTP و پیام خود سرویس را می‌بیند.
* نمایش آخرین خطای سرویس در صفحه‌ی تنظیمات.
* حذف خودکار پیشوند Key/Bearer و فاصله‌های اضافه از کلید واردشده.

= 1.0.0 =
* نسخه‌ی اول.
