۱نصب سریع
پیش‌نیازها
| پیش‌نیاز | حداقل | توصیه‌شده |
|---|
| WordPress | 6.0 | 7.1.3+ |
| PHP | 7.4 | 8.2+ |
| MySQL | 5.7 | 8.0+ |
| SSL (HTTPS) | توصیه | الزامی برای درگاه |
مراحل نصب
- ورود به پنل مدیریت: وارد پنل وردپرس شوید (yoursite.com/wp-admin).
- بارگذاری افزونه: از منوی افزونه‌ها → افزودن → بارگذاری افزونه، فایل kargah-base.zip (نسخه پایه) را انتخاب کنید.
- فعال‌سازی: روی «فعال‌سازی» کلیک کنید. یک فرم نمونه با نام «فرم رزرو مشاوره (نمونه)» خودکار ایجاد می‌شود.
✓ نصب موفق!
پس از فعال‌سازی، منوی KarGah در وردپرس ظاهر می‌شود. شامل ۴ بخش: فرم‌های رزرو، رزروها، پرداخت‌ها و تنظیمات.
۲ساخت فرم رزرو
پس از نصب، یک فرم نمونه خودکار ایجاد می‌شود. برای ویرایش، از منوی KarGah به «فرم‌های رزرو» بروید. در نسخه پایه، فقط یک فرم می‌توانید داشته باشید.
تنظیمات قابل پیکربندی
عنوان فرمنامی که بالای فرم نمایش داده می‌شود
تقویمشمسی، میلادی یا هر دو
ساعات کاریبازه زمانی قابل رزرو در هر روز
مدت اسلات۱۵، ۳۰ یا ۶۰ دقیقه
مهلت پرداختچند دقیقه فرصت پرداخت دارد
ظرفیت مشترکفعال‌سازی ظرفیت مشترک بین خدمات
۵ مرحله فرم رزرو
| مرحله | نام | توضیح | الزامی |
|---|
| ۱ | انتخاب خدمت | کاربر خدمت را انتخاب می‌کند | بله |
| ۲ | اطلاعات تماس | نام، موبایل، ایمیل، استان، شهر | بله |
| ۳ | تاریخ و ساعت | انتخاب روز و ساعت از تقویم | بله |
| ۴ | نوع برگزاری | حضوری یا آنلاین | اختیاری |
| ۵ | پرداخت | انتخاب روش پرداخت | برای پولی |
۳پیکربندی درگاه پرداخت
افزونه KarGah از سه روش پرداخت پشتیبانی می‌کند. می‌توانید یکی، دو یا هر سه را فعال کنید.
💳 پرداخت کارت‌به‌کارت
کاربر مبلغ را به حساب شما واریز می‌کند، فیش را بارگذاری می‌کند، و شما پس از بررسی، رزرو را تأیید می‌کنید.
🟡 درگاه زرین‌پال (API v4)
- دریافت Merchant ID: از پنل زرین‌پال، درگاه جدید بسازید.
- فعال‌سازی: در تنظیمات KarGah، Merchant ID را وارد کنید.
- Sandbox: برای تست تیک بزنید. برای محیط تولید حتماً بردارید.
⚠️ هشدار مهم
قبل از انتشار سایت، حتماً یک پرداخت تستی انجام دهید. حالت Sandbox پیش‌فرض فعال است و باید قبل از انتشار غیرفعال شود.
🏦 درگاه بانکی عمومی
| فیلد | توضیح |
|---|
| Merchant ID | از بانک دریافت کنید |
| URL درخواست | آدرس API درخواست پرداخت |
| URL تأیید | آدرس API تأیید پرداخت |
| کدهای موفقیت | کدهای نشان‌دهنده موفقیت (۰، ۱۰۰، ۲۰۰) |
۴نمایش فرم در سایت
روش ۱: شورت‌کد
[kargah_booking id="FORM_ID"]
روش ۲: انتساب برگه
- ویرایشگر فرم را باز کنید
- برگه منتسب را از dropdown انتخاب کنید
- ذخیره کنید — فرم به‌صورت خودکار در آن برگه نمایش داده می‌شود
۵سوالات متداول
آیا KarGah رایگان است؟
نسخه پایه تجاری است و از مارکت‌پلیس راست‌چین قابل خرید است. این محصول با حمایت کاربران توسعه می‌یابد.
آیا تقویم شمسی پشتیبانی می‌شود؟
بله، تقویم جلالی به‌صورت پیش‌فرض فعال است. الگوریتم تبدیل در PHP و JavaScript پیاده‌سازی شده — نه ترجمه یک تقویم خارجی. نمایش هم‌زمان شمسی و میلادی نیز ممکن است.
چه درگاه‌های پرداختی پشتیبانی می‌شوند؟
سه روش هم‌زمان: زرین‌پال (API رسمی v4)، درگاه بانکی عمومی قابل پیکربندی برای هر بانک ایرانی، و پرداخت کارت‌به‌کارت با بارگذاری فیش.
آیا ثبت‌نام کاربر لازم است؟
خیر، کاربران بدون نیاز به ثبت‌نام می‌توانند رزرو کنند. فقط اطلاعات تماس (نام، موبایل، ایمیل) وارد می‌شود.
داده‌ها کجا ذخیره می‌شوند؟
همه داده‌ها در دیتابیس وردپرس شما. هیچ SaaS خارجی دخالت ندارد. فیش‌ها در پوشه محافظت‌شده با ۷ لایه امنیتی ذخیره می‌شوند.
آیا با Privacy API وردپرس سازگار است؟
بله، خروجی و حذف داده‌های شخصی کاربران مطابق GDPR یکپارچه شده است. فیش‌ها به‌طور خودکار هنگام حذف داده‌ها پاک می‌شوند.
محدودیت‌های نسخه پایه چیست؟
حداکثر ۱ فرم رزرو، ۱ خدمت رایگان، ۲ خدمت هزینه‌دار، اعتبارسنجی ایمیل محدود به gmail.com/yahoo.com. این محدودیت‌ها محصولی است، نه باگ — برای حذف، به نسخه Pro ارتقا دهید.
آیا می‌توانم لوگوی خود را اضافه کنم؟
بله، در نسخه پایه از تنظیمات KarGah می‌توانید لوگوی سفارشی آپلود کنید (با فیلدهای نام طراح و لینک پروفایل طراح).
