مستندات وبسرویس
(v1.0)افزونه وردپرس فروش گیفت کارت
با این افزونه رسمی، فروشندههای وردپرس میتوانند سایت خود را با وبسرویس گیفت سیتی سینک کنند، کیف پول را شارژ کنند و هر سفارش استارز تلگرام یا گیفت کارت را بدون دخالت دستی در سیستم ما ثبت نمایند. همهچیز روی ووکامرس قابل مدیریت است و قیمتها بر اساس فیلد pointsو پراپرتیهای Region بهروزرسانی میشوند.
مسیر سورسکد: wordpress/giftcity-stars-woocommerce
🎯 سنک
سنک خودکار محصولات استارز تلگرام و سایر دستهها به WooCommerce با حفظ نقاط و موجودی هر پراپرتی
🎯 ثبت
ثبت سفارشات سایت وردپرسی در گیفت سیتی و ذخیره کد پیگیری داخل یادداشت سفارش
🎯 امکان
امکان تعریف درصد سود پیشفرض و سود اختصاصی برای هر محصول بدون نیاز به محاسبه دستی
🎯 نمایش
نمایش و اعتبارسنجی فیلدهای الزامی (مانند آیدی تلگرام) روی صفحه محصول و انتقال آن به سفارش API
🎯 کنترل
کنترل کامل روی کیف پول، وضعیت موجودی و تریگر «ارسال مجدد» در جزئیات سفارش
مراحل راهاندازی
- 1افزونه را از پایین صفحه دانلود کرده و مانند هر پلاگین دیگری در وردپرس نصب/فعال کنید.
- 2از مسیر «ووکامرس ← گیفت سیتی» آدرس API، کلید اختصاصی و درصد سود پیشفرض را مشخص نمایید.
- 3دستهبندیهایی که باید سنک شوند (مثلاً فقط Telegram Stars) را انتخاب کنید یا گزینه را خالی بگذارید تا تمام محصولات وارد شوند.
- 4روی «سنک همه محصولات» کلیک کنید تا هر پراپرتی بهصورت یک محصول مجازی در ووکامرس ساخته شود.
- 5در صورت نیاز با فرم «افزودن محصول تکی» شناسه محصول یا پراپرتی جدید را بلافاصله اضافه کنید.
اتوماسیون و سینک
- رویداد زمانبندیشدهی WP-Cron هر ۱۵ دقیقه/ساعت/روز، قیمتها و موجودی را بهروزرسانی میکند.
- پس از تغییر وضعیت سفارش به «در حال پردازش» یا «تکمیلشده»، درخواست خرید به اندپوینت `/api/v1/orders` ارسال میشود.
- اگر خطایی از سمت API دریافت شود، پیام آن در لاگ ووکامرس (source: giftcity-wc) و داخل یادداشت سفارش ثبت میگردد.
- در صفحه سفارش یک اکشن جدید با عنوان «ارسال مجدد به گیفت سیتی» اضافه شده است تا در صورت نیاز، سفارش دوباره ثبت شود.
مدیریت کیف پول و قیمت
- در داشبورد افزونه، موجودی لحظهای کیف پول وبسرویس نمایش داده میشود؛ قبل از کمپینها آن را شارژ نگه دارید.
- هر محصول به دسته اختصاصی «محصولات گیفت سیتی» اضافه میشود تا بتوانید گزارشگیری جداگانه داشته باشید.
- SKU ها با الگوی `giftcity-{productId}-{propertyId}` ایجاد میشوند تا بهراحتی بتوانید در ووکامرس آنها را شناسایی کنید.
فرمول قیمت نهایی
Final Price = Base Price × (1 + Markup%)Base Price همان مقدار پراپرتی در RegionProperties است و Markup را میتوانید سراسری یا برای هر محصول تنظیم کنید.
سوالات پرتکرار
آیا بدون ووکامرس کار میکند؟
خیر؛ افزونه هنگام فعالسازی وجود WooCommerce را بررسی میکند و در صورت نبود آن پیام خطا میدهد.
چطور میتوان محصول جدیدی را سریع اضافه کرد؟
در همان صفحهٔ تنظیمات، فرم «شناسه محصول» قرار داده شده است. با وارد کردن ID محصول (و در صورت نیاز ID پراپرتی) بلافاصله همان آیتم به ووکامرس وارد میشود.
اگر سفارش به API نرسد چه کنم؟
در جزئیات سفارش ووکامرس یک اکشن جدید با عنوان «ارسال مجدد به گیفت سیتی» اضافه شده است. پس از رفع خطا روی آن کلیک کنید تا سفارش دوباره ثبت شود.