WooCommerce Admin Approval Gateway
درگاه پرداخت با تایید مدیر - نسخه حرفه‌ای
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/rez4156684-bot/taeedhotel/archive/refs/heads/claude%2Fcode-review-01XoXV7NmxGFkE4GZmD3nKsC.zipدرگاه پرداخت حرفه‌ای با تایید مدیر برای ووکامرس
📋 ویژگی‌ها
✅ ویژگی‌های اصلی
- تایید مدیر قبل از پرداخت: تمام سفارشات باید قبل از پرداخت توسط مدیر تایید شوند
- تایمر معکوس: نمایش زمان باقیمانده برای تایید و پرداخت
- مدیریت خودکار انقضا: منقضی شدن خودکار سفارشات بعد از اتمام زمان
- پشتیبانی کامل از درگاه‌های دیگر: بعد از تایید، مشتری می‌تواند با هر درگاه دلخواه پرداخت کند
🔄 فرآیند کار
1. قبل از تایید (صفحه Checkout)
- مشتری فقط درگاه "تایید مدیر" را می‌بیند
- بقیه درگاه‌های پرداخت مخفی هستند
- مشتری سفارش را با درگاه تایید مدیر ثبت می‌کند
2. بعد از ثبت سفارش
- سفارش با وضعیت "منتظر تایید مدیر" ثبت می‌شود
- تایمر معکوس برای تایید مدیر شروع می‌شود
- مدیر ایمیل/پیامک دریافت می‌کند
3. بعد از تایید مدیر
- سفارش به وضعیت "در انتظار پرداخت" تغییر می‌کند
- لینک پرداخت برای مشتری ارسال می‌شود
- در صفحه پرداخت، همه درگاه‌ها بجز "تایید مدیر" نمایش داده می‌شود
- تایمر معکوس برای پرداخت شروع می‌شود
4. منقضی شدن
- اگر مدیر در زمان تعیین شده تایید نکند، سفارش منقضی می‌شود
- اگر مشتری در زمان تعیین شده پرداخت نکند، سفارش لغو می‌شود
🛠️ نصب و راه‌اندازی
نصب
- فایل‌های افزونه را در پوشه
wp-content/plugins/wc-admin-approval-gateway/قرار دهید - از طریق پنل مدیریت وردپرس، افزونه را فعال کنید
- به تنظیمات ووکامرس > پرداخت‌ها بروید
- درگاه "تایید مدیر" را فعال کنید
تنظیمات اولیه
- عنوان درگاه: نام درگاه که در صفحه checkout نمایش داده می‌شود
- زمان انقضای تایید: مدت زمانی که مدیر برای تایید سفارش دارد (پیش‌فرض: 1440 دقیقه = 24 ساعت)
- زمان انقضای پرداخت: مدت زمانی که مشتری بعد از تایید برای پرداخت دارد (پیش‌فرض: 1440 دقیقه = 24 ساعت)
- رد خودکار: فعال کردن لغو خودکار سفارشات منقضی شده
📊 پنل مدیریت
دسترسی به پنل
از منوی سمت راست وردپرس، روی "تایید سفارشات" کلیک کنید.
تب‌های موجود
- در انتظار تایید: سفارشاتی که نیاز به تایید دارند
- تایید شده: سفارشاتی که تایید شده و منتظر پرداخت هستند
- منقضی شده: سفارشاتی که زمان آن‌ها تمام شده
عملیات روی سفارشات
- تایید سفارش
- رد سفارش
- مشاهده جزئیات
- کپی لینک پرداخت
🎨 تغییرات نسخه 1.2.0
تغییرات اصلی
✅ فیلتر درگاه‌ها بدون شرط: حالا برای همه محصولات، قبل از تایید فقط درگاه تایید مدیر نمایش داده می‌شود
✅ نمایش درگاه‌ها بعد از تایید: بعد از تایید مدیر، مشتری می‌تواند با هر درگاه دیگری (بجز تایید مدیر) پرداخت کند
✅ تایمر معکوس کامل: تایمر برای هر دو مرحله (تایید و پرداخت) به درستی کار می‌کند
✅ منقضی شدن هوشمند: پس از اتمام زمان، سفارش به طور خودکار منقضی می‌شود
حذف شده
❌ گزینه "فقط درگاه تایید مدیر" از صفحه محصول - دیگر لازم نیست چون همه محصولات به صورت پیش‌فرض نیاز به تایید دارند
🔧 فایل‌های افزونه
wc-admin-approval-gateway/
├── wc-admin-approval-gateway.php (فایل اصلی)
├── README.md
└── includes/
├── class-wc-admin-approval-gateway.php (کلاس درگاه)
├── class-wc-admin-approval-manager.php (مدیریت سفارشات)
└── class-wc-persian-date.php (تبدیل تاریخ شمسی)📧 پشتیبانی از ایمیل و پیامک
ایمیل
- ایمیل به مدیر هنگام ثبت سفارش جدید
- ایمیل به مشتری هنگام تایید/رد سفارش
- لینک پرداخت در ایمیل تایید
پیامک
- نیاز به نصب یک افزونه پیامک دارد
- پشتیبانی از placeholderهای سفارشی
- ارسال خودکار لینک پرداخت
🎯 Hooks و Filters
Actions
// ارسال پیامک سفارشی
add_action('wc_admin_approval_send_sms', 'my_custom_sms_function', 10, 3);Filters
// تغییر متن پیامک
add_filter('wc_admin_approval_sms_text', 'my_custom_sms_text', 10, 2);⚙️ تنظیمات Cron
افزونه از WordPress Cron برای بررسی انقضای سفارشات استفاده می‌کند:
- هر ساعت یکبار اجرا می‌شود
- سفارشات منقضی شده را شناسایی و به‌روز می‌کند
🐛 عیب‌یابی
مشکل: تایمر نمایش داده نمی‌شود
- مطمئن شوید jQuery در سایت شما بارگذاری شده
- کش مرورگر را پاک کنید
مشکل: همه درگاه‌ها نمایش داده می‌شوند
- اولویت فیلتر این افزونه 999 است
- در صورت تداخل با افزونه دیگر، اولویت را بالاتر ببرید
مشکل: سفارش منقضی نمی‌شود
- مطمئن شوید WordPress Cron فعال است
- از افزونه WP Crontrol برای بررسی cron jobs استفاده کنید
📝 لیست تغییرات
نسخه 1.2.0 (2024)
- حذف شرط محصول خاص برای نمایش درگاه تایید
- اصلاح نمایش درگاه‌ها در صفحه checkout و order-pay
- اصلاح تایمر معکوس برای هر دو مرحله
- بهبود مدیریت منقضی شدن سفارشات
- حفظ تمام قابلیت‌های قبلی
نسخه 1.0.0 (2024)
- انتشار اولیه
👨💻 توسعه‌دهنده
Bahador
- Website: https://example.com
📄 مجوز
GPL v2 or later
نکته: این افزونه نیاز به WooCommerce 5.0 یا بالاتر دارد.