=== مشاور هوشمند استایل پارسیان — رایگان ===
Contributors: parsianit
Tags: ai, outfit, fashion, elementor, virtual try-on
Requires at least: 6.0
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPLv2 or later

مشاور لباس با هوش مصنوعی + پرو مجازی، فارسی و راست‌چین، با ویجت المنتور.

== نسخه‌ها ==
* رایگان: مشاوره با کلید API خودتان، پیشنهاد از ۲۵ محصول پرفروش فروشگاه، کارت محصول با لینک،
  پوسته‌های پارسیان، ویجت المنتور و شورت‌کد.
* Basic: همه محصولات، انتخاب دسته‌ها و اتصال جنسیت، افزودن به سبد (AJAX)، تحلیل عکس،
  رنگ و CSS دلخواه و استایل کامل المنتور، بدون لینک «قدرت گرفته از پارسیان».
* Pro: همه امکانات Basic + پرو مجازی، داشبورد آمار (نمایش/کلیک/افزودن به سبد/پرو)،
  لینک اشتراک‌گذاری ست، دریافت شماره/ایمیل مشتری با خروجی CSV.
مقایسه کامل: «مشاور استایل ← نسخه و لایسنس».
ارتقا: zip نسخه جدید را از «افزونه‌ها ← افزودن ← بارگذاری» نصب کنید و «جایگزین کردن» را بزنید؛ تنظیمات حفظ می‌شوند.

== نصب ==
1. پیشخوان ← افزونه‌ها ← افزودن ← بارگذاری افزونه ← فایل zip را انتخاب و فعال کنید.
2. منوی «مشاور استایل» ← تب «API مشاوره»: ارائه‌دهنده و کلید API را وارد و ذخیره کنید.
3. دکمه «تست اتصال مشاوره» را بزنید.
4. در المنتور ویجت «مشاور استایل هوشمند» (دسته «پارسیان آی‌تی») را به صفحه بکشید.
   یا بدون المنتور از شورت‌کد استفاده کنید: [parsian_outfit_adviser]

== تغییر API ==
همه از «مشاور استایل ← تنظیمات» قابل تغییر است، بدون دست زدن به کد:

* Google Gemini — ارزان‌ترین گزینه (پیشنهاد: gemini-2.5-flash-lite)
* OpenAI — مثلاً gpt-4o-mini
* OpenRouter — صدها مدل با یک کلید؛ نام مدل را به شکل provider/model بنویسید
* Anthropic Claude
* سفارشی — هر API سازگار با OpenAI (مثل Groq، Together، DeepSeek، یا سرور خودتان)

نکته برای هاست ایرانی: Google و OpenAI درخواست از IP ایران را رد می‌کنند. یا هاست خارج از ایران
بگیرید، یا در فیلد «آدرس پایه» آدرس یک پراکسی (مثل Cloudflare Worker) را بگذارید. OpenRouter هم
گزینه خوبی است.

== پیشنهاد از محصولات فروشگاه (ووکامرس) ==
از «مشاور استایل ← محصولات فروشگاه»:
* منبع لباس‌ها: «فقط محصولات فروشگاه» (پیش‌فرض)، «اول فروشگاه بعد آزاد» یا «آزاد».
* دسته‌بندی‌های مجاز، فقط محصولات موجود، و حداکثر تعداد محصولی که به هوش مصنوعی داده می‌شود.
* مرتبط‌ترین محصولات با پاسخ‌های کاربر (سبک، مناسبت، فصل، رنگ، بودجه، جنسیت) انتخاب و
  از هر دسته چند مورد فرستاده می‌شود تا ست کامل (بالاتنه، پایین‌تنه، کفش، کیف) ساخته شود.
* هر شناسه‌ای که مدل برگرداند با همان فهرست چک می‌شود؛ محصول ساختگی هرگز نمایش داده نمی‌شود.
* نتیجه: کارت محصول با عکس، قیمت، لینک، «افزودن به سبد» (AJAX) و «پرو مجازی».
* دکمه «نمایش فهرستی که به هوش مصنوعی ارسال می‌شود» برای بررسی داده‌ها.
* در ویجت المنتور (بخش «محصولات فروشگاه») می‌توانید منبع و دسته‌ها را برای هر صفحه جدا تعیین کنید.
* شورت‌کد: [parsian_outfit_adviser source="woo" cats="12,15"]

== پرو مجازی ==
* لباس را می‌توان از محصولات فروشگاه انتخاب کرد (با جستجو)، یا عکس آپلود کرد — قابل تنظیم.
در تب «API پرو مجازی» ارائه‌دهنده fal.ai را انتخاب کنید. Endpoint پیش‌فرض مدل FASHN است و
می‌توانید هر مدل try-on دیگری از fal یا هر سرویس دیگری را بگذارید:
* «قالب بدنه درخواست» را مطابق مستندات مدل تنظیم کنید؛ {{person_image}} و {{garment_image}}
  به‌صورت Data URI جایگزین می‌شوند.
* «مسیر تصویر در پاسخ» مشخص می‌کند لینک تصویر خروجی کجای JSON است (مثل images.0.url).

== شورت‌کد ==
[parsian_outfit_adviser title="عنوان دلخواه" subtitle="..." tryon="no" photo="yes"]

== امنیت ==
* کلیدهای API فقط روی سرور شما هستند و به مرورگر کاربر ارسال نمی‌شوند.
* برای امنیت بیشتر کلیدها را در wp-config.php تعریف کنید:
  define( 'POA_ADVICE_API_KEY', '...' );
  define( 'POA_TRYON_API_KEY', '...' );
* محدودیت تعداد درخواست در ساعت برای هر کاربر/IP (پیش‌فرض ۲۰) جلوی هزینه ناخواسته را می‌گیرد.
* تصاویر در مرورگر کوچک می‌شوند و در سرور از نظر نوع و حجم بررسی می‌شوند. هیچ تصویری ذخیره نمی‌شود.

== برای توسعه‌دهنده‌ها ==
* فیلتر poa_catalog_prompt برای تغییر دستورالعمل و فهرست محصولات ارسالی.
* فیلتر poa_advice_user_text برای تغییر متنی که به مدل فرستاده می‌شود.
* اکشن poa_after_advice پس از هر مشاوره (مثلاً برای ثبت آمار یا پیشنهاد محصول ووکامرس).
* کلاس اصلی CSS: .poa-app — رنگ‌ها با متغیرهای --poa-primary، --poa-accent، --poa-bg،
  --poa-surface، --poa-text، --poa-muted و --poa-radius کنترل می‌شوند.

== تغییرات ==
= 2.0.0 =
* سه نسخه رایگان، Basic و Pro.
* Pro: داشبورد آمار، لینک اشتراک‌گذاری ست، فرم دریافت شماره/ایمیل مشتری و خروجی CSV.
* Basic/Pro: فعال‌سازی لایسنس و آپدیت خودکار از سرور پارسیان.

= 1.2.0 =
* پوسته پارسیان آی‌تی (تیره و روشن) مطابق parsianitco.com؛ فونت استعداد داخل افزونه.
* رفع: پارامترهای source و cats در شورت‌کد اعمال نمی‌شدند.

= 1.1.0 =
* پیشنهاد ست فقط از محصولات ووکامرس فروشگاه، با کارت محصول و افزودن به سبد.
* پرو مجازی با انتخاب محصول از فروشگاه.

== پوسته ==
«مشاور استایل ← ظاهر ← پوسته»: پارسیان تیره (پیش‌فرض)، پارسیان روشن، یا سفارشی.
شورت‌کد: [parsian_outfit_adviser theme="parsian-light"]

== لایسنس و آپدیت (Basic/Pro) ==
همه امکانات بدون فعال‌سازی هم کار می‌کنند؛ لایسنس فعال برای آپدیت خودکار است.
آدرس سرور با فیلتر poa_license_server تغییر می‌کند (پیش‌فرض:
https://parsianitco.com/wp-json/parsian-license/v1). قرارداد API در includes/class-poa-license.php.

== فونت ==
فونت‌های استعداد و وزیرمتن (SIL Open Font License) داخل افزونه قرار دارد و از CDN بارگذاری نمی‌شود.
