# گیفتی کارت

افزونه گیفتی کارت ووکامرس را با سرویس Gifticard.ir برای کاربران بین‌المللی یکپارچه می‌کند و امکان ثبت سفارش خودکار گیفت کارت، پیگیری وضعیت و تحویل به مشتری را فراهم می‌سازد.

## امکانات

### پشتیبانی از محصولات ساده و متغیر ووکامرس

- افزونه به طور کامل از مپ کردن محصولات ساده و متغیر ووکامرس (شامل واریانت‌های محصول) به واریانت‌های گیفتی کارت پشتیبانی می‌کند.

### ساخت محصول از واریانت‌های گیفتی کارت

- ساخت محصولات ساده ووکامرس مستقیماً از واریانت‌های گیفتی کارت با تنظیمات سفارشی.
- ساخت محصولات متغیر ووکامرس با چندین واریانت در یک عملیات.
- مپ خودکار محصولات ایجاد شده به واریانت‌های گیفتی کارت.
- قابل تنظیم جزئیات محصول (نام، SKU، قیمت، وضعیت) در حین ایجاد.

### همگام‌سازی قیمت

- همگام‌سازی خودکار قیمت محصولات از API گیفتی کارت بر اساس قیمت واریانت به علاوه حاشیه سود قابل تنظیم.
- تنظیمات حاشیه سود قابل پیکربندی (درصد یا مبلغ ثابت) در تنظیمات محصول.
- کنترل سینک قیمت اختصاصی برای هر محصول/واریانت مپ شده با حاشیه سود سفارشی.
- همگام‌سازی قیمت به طور خودکار در حین همگام‌سازی وضعیت محصول (کرون یا بازدید صفحه) اجرا می‌شود.

### وضعیت اتصال و موجودی لحظه‌ای کیف پول

- مدیران می‌توانند وضعیت اتصال فعلی به API گیفتی کارت را مشاهده کرده و موجودی لحظه‌ای کیف پول گیفتی کارت خود را مستقیماً از داشبورد افزونه ببینند.

### مپ کردن محصولات

- هر محصول یا واریانت ووکامرس را به یک واریانت خاص گیفتی کارت از طریق پنل مدیریت مپ کنید.
- مپ کردن از طریق AJAX مدیریت شده و در فیلدهای متای محصول ذخیره می‌شود، که به شما امکان فروش انواع دقیق گیفت کارت از کاتالوگ ووکامرس را می‌دهد.
- رابط مپ کردن از جستجوی محصولات ووکامرس و اتصال آنها به واریانت‌های گیفتی کارت پشتیبانی می‌کند.

### همگام‌سازی وضعیت محصولات

- به طور خودکار وضعیت موجودی محصولات گیفتی کارت را با وضعیت موجودی ووکامرس همگام‌سازی کنید.
- کنترل سینک موجودی اختصاصی برای هر محصول مپ شده - امکان فعال/غیرفعال کردن سینک موجودی برای هر محصول.
- تنظیم سراسری سینک موجودی با امکان لغو برای هر محصول.
- مپ کردن وضعیت قابل تنظیم برای انواع مختلف تحویل گیفتی کارت (فوری، دستی، ناموجود، حذف شده/در دسترس نیست).
- سیستم پردازش دسته‌ای برای مدیریت کارآمد کاتالوگ‌های بزرگ محصول (اندازه دسته قابل تنظیم).
- همگام‌سازی برنامه‌ریزی شده از طریق کران جاب‌های وردپرس (توصیه شده: 2-3 بار در روز).
- گزینه همگام‌سازی دستی برای به‌روزرسانی فوری.
- نمایش وضعیت لحظه‌ای که زمان اجرای بعدی، وضعیت همگام‌سازی فعلی و پیشرفت دسته را نشان می‌دهد.
- به‌روزرسانی خودکار وضعیت موجودی بر اساس تغییرات موجودی گیفتی کارت.
- پیگیری پیشرفت با نوار پیشرفت بصری برای وضعیت پردازش دسته‌ای.

### ثبت خودکار سفارش گیفت کارت

- هنگامی که مشتری سفارشی حاوی محصولات مپ شده ثبت می‌کند، افزونه به طور خودکار درخواست خرید را برای هر آیتم مپ شده به API گیفتی کارت ارسال می‌کند.
- افزونه پاسخ API را مدیریت کرده، جزئیات سفارش گیفتی کارت (شامل کدها) را در متای سفارش ووکامرس ذخیره کرده و یادداشت‌های سفارش را برای پیگیری اضافه می‌کند.

### اتوماسیون وضعیت سفارش

- افزونه وضعیت سفارشات گیفتی کارت را (از طریق API و webhook) نظارت می‌کند.
- اگر تمام آیتم‌های مپ شده با موفقیت تحویل داده شوند، وضعیت سفارش ووکامرس به طور خودکار به "تکمیل شده" تغییر می‌یابد.
- اگر هر آیتم مپ شده شکست بخورد، وضعیت سفارش می‌تواند به "ناموفق" تغییر یابد (قابل تنظیم).
- به‌روزرسانی وضعیت هم از طریق بررسی‌های برنامه‌ریزی شده (کران) و هم از طریق اعلان‌های لحظه‌ای webhook از گیفتی کارت مدیریت می‌شود.
- افزونه می‌تواند به طور خودکار وضعیت سفارش ووکامرس را در صورت نیاز به "لغو شده" تغییر دهد (لغو خودکار).

### نمایش گیفت کارت‌های خریداری شده

- کدهای گیفت کارت خریداری شده و اطلاعات مرتبط (سریال، کد کارت، لینک استفاده، تاریخ انقضا و غیره) به مشتری نمایش داده می‌شود:
  - در ایمیل تایید سفارش
  - در صفحه جزئیات سفارش در حساب کاربری
  - در صفحه "تشکر از پرداخت" پس از پرداخت
- نمایش پویا است و فقط برای آیتم‌هایی که به واریانت‌های گیفتی کارت مپ شده‌اند نشان داده می‌شود.

### همگام‌سازی و مدیریت ادمین

- مدیران می‌توانند دسته‌بندی‌ها، محصولات و واریانت‌ها را از API گیفتی کارت به وردپرس همگام‌سازی کنند تا مپ کردن و مدیریت آسان‌تر شود.
- ابزارهایی برای حذف دسته‌جمعی داده‌های افزونه و مدیریت دستی سفارشات وجود دارد.

### سازگاری

- کاملاً سازگار با HPOS (سیستم ذخیره سفارش با عملکرد بالا) و سیستم قدیمی ذخیره سفارش ووکامرس
- تست شده تا وردپرس ۶.۹
- تست شده تا ووکامرس ۱۰.۴.۳

## پیش‌نیازهای راه‌اندازی

- برای شروع استفاده از افزونه، باید `base_url`، `consumer_key` و `consumer_secret` خود را در تنظیمات افزونه وارد کنید.
- برای محیط اصلی، اطلاعات خود را از [gifticard.ir](https://gifticard.ir) دریافت کنید.
- همچنین می‌توانید توکن Sandbox برای تست و توسعه دریافت کنید.

## نصب

1. فایل‌های افزونه را در مسیر `/wp-content/plugins/gift-i-card` آپلود کنید یا افزونه را مستقیماً از طریق صفحه افزونه‌های وردپرس نصب کنید.
2. افزونه را از طریق صفحه «افزونه‌ها» در وردپرس فعال کنید.
3. از منوی گیفتی کارت برای پیکربندی افزونه استفاده کنید.
4. محصولات ووکامرس خود را به واریانت‌های گیفتی کارت مپ کنید.

## لینک‌ها

- [گیفتی کارت](https://gifticard.ir)

## مجوز

این افزونه تحت مجوز GPLv2 یا بالاتر منتشر شده است. (فایل LICENSE را ببینید)