=== افزونه فروش گیفت سیتی برای ووکامرس ===
Contributors: mrdejam
Tags: woocommerce, telegram, giftcard, api, sync
Requires at least: 6.2
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

اتصال مستقیم وبسایت ووکامرسی به API گیفت سیتی برای فروش استارز تلگرام و گیفت کارت با سنک خودکار قیمت، مدیریت سود و ثبت سفارش.

== توضیحات ==
افزونه «فروش گیفت سیتی برای ووکامرس» فروشگاه شما را به وب‌سرویس [گیفت سیتی](https://gift30t.com) وصل می‌کند. بعد از وارد کردن API Key می‌توانید:

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

این افزونه توسط **mrdejam** (اینستاگرام: [@mrdejam](https://www.instagram.com/mrdejam)) توسعه داده شده است.

== نصب ==
1. پوشه `giftcity-stars-woocommerce` را در مسیر `/wp-content/plugins/` بارگذاری کنید یا فایل ZIP را از بخش افزونه‌ها آپلود کنید.
2. افزونه را از منوی «افزونه‌ها» فعال نمایید.
3. به مسیر **ووکامرس → گیفت سیتی** بروید و آدرس پایه API (`https://gift30t.com/api/v1`) و کلید وب‌سرویس را وارد کنید.
4. بازه سنک خودکار و درصد سود پیش‌فرض را تعیین کنید.
5. روی «سنک همه محصولات» بزنید یا از جدول «افزودن تکی» برای وارد کردن محصول/پراپرتی خاص استفاده کنید و دسته‌بندی ووکامرس را مشخص نمایید.
6. در صورت نیاز داخل صفحه هر محصول مقدار سود اختصاصی را تنظیم کنید. فیلدهای ضروری گیفت سیتی به‌صورت خودکار نمایش داده می‌شوند.
7. وقتی سفارش ووکامرس در وضعیت «در حال پردازش» یا «تکمیل‌شده» قرار گرفت، افزونه سفارش را در گیفت سیتی ثبت کرده و کد پیگیری را ذخیره می‌کند.

== سوالات متداول ==
= کلید API را از کجا بگیرم؟ =
از داخل پنل کاربری گیفت سیتی (https://gift30t.com) برای شما صادر می‌شود.

= آیا بدون ووکامرس کار می‌کند؟ =
خیر. افزونه هنگام فعال‌سازی بررسی می‌کند که ووکامرس نصب و فعال باشد.

= می‌توانم فقط محصولات دلخواهم را سنک کنم؟ =
بله؛ در صفحه تنظیمات از فرم «افزودن تکی» استفاده کنید، شناسه محصول یا پراپرتی را وارد کرده و دسته‌بندی ووکامرس را انتخاب نمایید.

= قیمت نهایی چگونه محاسبه می‌شود؟ =
قیمت ووکامرس = قیمت پراپرتی × (۱ + درصد سود / ۱۰۰). می‌توانید سود پیش‌فرض را تعیین و برای هر محصول مقدار اختصاصی اعمال کنید.

== تصاویر ==
1. داشبورد افزونه در ووکامرس.
2. لیست محصولات وب‌سرویس و فرم افزودن تکی.
3. فیلدهای ضروری روی صفحه محصول.
4. یادداشت سفارش شامل کد پیگیری گیفت سیتی.

== تغییرات ==
= 1.0.0 =
* انتشار اولیه افزونه با سنک کامل محصولات، افزودن تکی، فیلدهای الزامی و ثبت سفارش.

== اعلامیه به‌روزرسانی ==
= 1.0.0 =
نخستین نسخه عمومی افزونه. برای اتصال ووکامرس به گیفت سیتی و وارد کردن کاتالوگ از این نسخه استفاده کنید.
