افزونه تایید مدیر قبل از پرداخت ووکامرس

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

ویژگی‌های افزونه

✅ استفاده از وضعیت‌های سفارشی اختصاصی

• وضعیت "منتظر تایید مدیر" (wc-awaiting-approval) - هنگام ثبت سفارش
• وضعیت "تایید شده - منتظر پرداخت" (wc-approved-payment) - پس از تایید مدیر
• ثبت خودکار در ووکامرس بدون نیاز به تغییر در فایل‌های اصلی

✅ پشتیبانی کامل از سیستم پیامک

• سازگار با تمام افزونه‌های پیامکی ووکامرس
• امکان ارسال پیامک برای وضعیت "منتظر تایید مدیر"
• امکان ارسال پیامک برای وضعیت "تایید شده - منتظر پرداخت"

✅ فعال‌سازی تایید مدیر برای هر محصول ساده به صورت جداگانه

• در صفحه ویرایش محصول می‌توانید فعال کنید

✅ صفحه انتظار تایید زیبا و کاربرپسند

• نمایش کامل اطلاعات سفارش
• بروزرسانی خودکار هر 5 ثانیه
• نمایش وضعیت بررسی/تایید/رد

✅ پنل مدیریت کامل

• مشاهده تمام سفارشات نیازمند تایید
• فیلتر بر اساس وضعیت
• تایید یا رد سفارش با یک کلیک

✅ پنل کاربری

• مشاهده سفارشات در انتظار تایید
• دسترسی مستقیم به لینک پرداخت پس از تایید

✅ سیستم ایمیل ووکامرس

• از ایمیل‌های پیش‌فرض ووکامرس استفاده می‌کند
• قابل تنظیم از بخش ایمیل‌های ووکامرس

✅ نمایش وضعیت در لیست سفارشات

• ستون جداگانه برای وضعیت تایید
• نمایش جزئیات در صفحه سفارش
• استایل‌های رنگی برای هر وضعیت
• فیلتر سفارشات بر اساس وضعیت‌های سفارشی

نصب افزونه

روش 1: نصب دستی

1. فایل wc-admin-approval-payment.php را به پوشه افزونه‌های وردپرس منتقل کنید:

   /wp-content/plugins/wc-admin-approval-payment/wc-admin-approval-payment.php

2. به پنل مدیریت وردپرس بروید

3. به بخش افزونه‌ها → افزونه‌های نصب شده بروید

4. افزونه WooCommerce Admin Approval Payment را فعال کنید

روش 2: نصب از طریق آپلود

1. فایل را در یک پوشه قرار دهید و زیپ کنید
2. به پنل مدیریت وردپرس → افزونه‌ها → افزودن بروید
3. روی بارگذاری افزونه کلیک کنید
4. فایل زیپ را انتخاب و نصب کنید
5. افزونه را فعال کنید

راهنمای استفاده

مرحله 1: فعال کردن تایید مدیر برای محصول

1. به محصولات → همه محصولات بروید
2. محصول ساده مورد نظر را ویرایش کنید
3. در تب عمومی، گزینه نیاز به تایید مدیر را فعال کنید
4. محصول را ذخیره کنید

مرحله 2: خرید توسط مشتری

1. مشتری محصول را به سبد خرید اضافه می‌کند
2. در صفحه پرداخت، روی دکمه پرداخت کلیک می‌کند
3. سفارش با وضعیت منتظر تایید مدیر ثبت می‌شود
4. به صورت خودکار به صفحه انتظار تایید منتقل می‌شود
5. صفحه به صورت خودکار هر 5 ثانیه بروزرسانی می‌شود

مرحله 3: تایید توسط مدیر

1. به پنل مدیریت وردپرس بروید
2. روی منوی تایید پرداخت‌ها کلیک کنید
3. سفارشات منتظر تایید را مشاهده کنید
4. روی دکمه تایید یا رد کلیک کنید
5. وضعیت سفارش به تایید شده - منتظر پرداخت تغییر می‌کند

مرحله 4: پرداخت توسط مشتری

1. پس از تایید، صفحه انتظار به صورت خودکار بروزرسانی می‌شود
2. دکمه پرداخت سفارش نمایش داده می‌شود
3. مشتری روی دکمه کلیک می‌کند و به درگاه پرداخت منتقل می‌شود

امکانات پنل مدیریت

صفحه تایید پرداخت‌ها

در منوی سمت راست پنل مدیریت، گزینه تایید پرداخت‌ها اضافه شده است که شامل:

• لیست سفارشات: نمایش تمام سفارشات نیازمند تایید
• فیلتر وضعیت: فیلتر بر اساس وضعیت (همه، منتظر تایید، تایید شده - منتظر پرداخت، رد شده)
• اطلاعات سفارش: شماره سفارش، مشتری، محصولات، مبلغ، تاریخ
• عملیات: دکمه‌های تایید و رد

صفحه جزئیات سفارش

در صفحه ویرایش هر سفارش، بخش وضعیت تایید پرداخت نمایش داده می‌شود که شامل:

• وضعیت فعلی (منتظر تایید / تایید شده - منتظر پرداخت / رد شده)
• زمان درخواست تایید
• زمان تایید (در صورت تایید)
• نام تایید کننده (در صورت تایید)

صفحه لیست سفارشات

در صفحه لیست سفارشات ووکامرس:

• فیلترهای جدید: "منتظر تایید مدیر" و "تایید شده - منتظر پرداخت"
• شمارنده: تعداد سفارشات در هر وضعیت
• رنگ‌بندی: وضعیت‌ها با رنگ‌های مخصوص نمایش داده می‌شوند
  • زرد: منتظر تایید مدیر
  • سبز: تایید شده - منتظر پرداخت

امکانات پنل کاربری

در پنل کاربری مشتری، منوی پرداخت‌های در انتظار اضافه شده است که شامل:

• لیست سفارشات در انتظار تایید
• وضعیت هر سفارش
• دکمه پرداخت (پس از تایید)
• لینک مشاهده جزئیات

وضعیت‌های سفارشی جدید

این افزونه دو وضعیت سفارشی جدید ایجاد می‌کند که به صورت خودکار در ووکامرس ثبت می‌شوند:

1. منتظر تایید مدیر (wc-awaiting-approval)

• زمان فعال شدن: وقتی کاربر سفارشی با محصول نیازمند تایید ثبت می‌کند
• رنگ: زرد (#ffc107)
• کاربرد: مشتری در صفحه انتظار تایید قرار می‌گیرد و نمی‌تواند پرداخت کند
• پیامک/ایمیل: امکان ارسال پیامک/ایمیل اطلاع‌رسانی به مشتری
• نمایش در پنل: در لیست سفارشات و فیلترها نمایش داده می‌شود

2. تایید شده - منتظر پرداخت (wc-approved-payment)

• زمان فعال شدن: وقتی مدیر سفارش را تایید می‌کند
• رنگ: سبز (#28a745)
• کاربرد: مشتری می‌تواند نسبت به پرداخت اقدام کند
• پیامک/ایمیل: امکان ارسال پیامک/ایمیل اطلاع‌رسانی به مشتری با لینک پرداخت
• نمایش در پنل: در لیست سفارشات و فیلترها نمایش داده می‌شود

یکپارچگی با سیستم پیامک

این افزونه به صورت کامل با افزونه‌های پیامکی ووکامرس یکپارچه است:

تنظیمات پیامک:

1. به بخش ووکامرس → تنظیمات → پیامک بروید
2. وضعیت‌های جدید را خواهید دید:
   • منتظر تایید مدیر (Awaiting Approval)
   • تایید شده - منتظر پرداخت (Approved Payment)
3. برای هر وضعیت می‌توانید:
   • متن پیامک را تنظیم کنید
   • فعال/غیرفعال کنید
   • الگوی پیامک را سفارشی کنید

افزونه‌های پیامکی پشتیبانی شده:

• ✅ افزونه پیامک ووکامرس ایرانی
• ✅ Kavenegar SMS
• ✅ Mediana SMS
• ✅ هر افزونه پیامکی که از وضعیت‌های سفارشی ووکامرس پشتیبانی کند

نحوه کار وضعیت‌های سفارشی

چگونه وضعیت‌های سفارشی ایجاد می‌شوند؟

این افزونه از طریق هوک‌های وردپرس و ووکامرس وضعیت‌های جدید را ثبت می‌کند:

1. ثبت در وردپرس:

   register_post_status('wc-awaiting-approval', [...])
   register_post_status('wc-approved-payment', [...])

   این دستورات در هوک init اجرا می‌شوند و وضعیت‌های جدید را در سیستم وردپرس ثبت می‌کنند.

2. اضافه کردن به ووکامرس:

   add_filter('wc_order_statuses', ...)

   این فیلتر باعث می‌شود ووکامرس وضعیت‌های جدید را بشناسد و در لیست خود نمایش دهد.

3. نمایش در فیلترها:

   add_filter('views_edit-shop_order', ...)

   این فیلتر وضعیت‌ها را در فیلترهای صفحه سفارشات اضافه می‌کند.

4. Bulk Actions:

   add_filter('bulk_actions-edit-shop_order', ...)

   امکان تغییر دسته‌جمعی وضعیت سفارشات.

نکته مهم: تمام این کدها داخل افزونه هستند و هیچ تغییری در فایل‌های اصلی ووکامرس یا وردپرس ایجاد نمی‌شود!

سوالات متداول

س: آیا این افزونه با تمام درگاه‌های پرداخت سازگار است؟ ج: بله، افزونه با تمام درگاه‌های پرداخت ووکامرس سازگار است.

س: آیا می‌توان برای محصولات متغیر هم استفاده کرد؟ ج: خیر، این افزونه فقط برای محصولات ساده طراحی شده است. برای محصولات متغیر نیاز به توسعه بیشتر دارد.

س: مشتری چگونه از تایید سفارش مطلع می‌شود؟ ج: از طریق سه روش:

1. ایمیل خودکار ووکامرس
2. پیامک (در صورت فعال بودن افزونه پیامک)
3. بروزرسانی خودکار صفحه انتظار

س: آیا می‌توان چند محصول با تایید مدیر و چند محصول بدون تایید در یک سبد خرید داشت؟ ج: بله، اگر حتی یک محصول نیازمند تایید باشد، کل سفارش باید تایید شود.

س: آیا وضعیت‌های سفارش در گزارشات ووکامرس نمایش داده می‌شوند؟ ج: بله، وضعیت‌های سفارشی در تمام گزارشات و صفحات مدیریت نمایش داده می‌شوند.

س: اگر افزونه را غیرفعال کنم، سفارشاتی که با این وضعیت‌ها ثبت شده‌اند چه می‌شوند؟ ج: هنگام غیرفعال‌سازی افزونه، وضعیت‌های سفارشی حذف می‌شوند. بهتر است قبل از غیرفعال‌سازی، تمام سفارشات را به وضعیت‌های استاندارد ووکامرس تغییر دهید.

س: آیا نیاز به تغییر در فایل‌های ووکامرس هست؟ ج: خیر! تمام کدها در افزونه هستند و از طریق هوک‌ها و فیلترهای وردپرس کار می‌کنند.

پشتیبانی

برای گزارش مشکلات یا درخواست ویژگی‌های جدید، لطفاً با ما تماس بگیرید.

نسخه‌ها

نسخه 4.0.0 (نسخه فعلی) ⭐

• 🎉 تغییر اساسی: استفاده از وضعیت‌های سفارشی
  • ایجاد وضعیت "منتظر تایید مدیر" (wc-awaiting-approval)
  • ایجاد وضعیت "تایید شده - منتظر پرداخت" (wc-approved-payment)
• ✅ ثبت خودکار وضعیت‌ها در ووکامرس
• ✅ اضافه کردن فیلترهای سفارشی به صفحه سفارشات
• ✅ پشتیبانی کامل از Bulk Actions
• ✅ رنگ‌بندی اختصاصی برای هر وضعیت
• ✅ نمایش در تمام بخش‌های مدیریت ووکامرس
• 🔧 تضمین عدم تداخل با وضعیت‌های پیش‌فرض ووکامرس
• 🔧 رفع کامل مشکل تغییر خودکار وضعیت به "تکمیل شده"

نسخه 3.1.0

• 🔧 بهبود مهم: استفاده از هوک‌های صحیح ووکامرس
  • استفاده از woocommerce_checkout_update_order_meta
  • استفاده از woocommerce_payment_complete_order_status
  • استفاده از woocommerce_get_checkout_order_received_url
• ✅ رفع مشکل تغییر خودکار وضعیت به "تکمیل شده"
• ✅ الهام گرفته از WooCommerce Order Approval

نسخه 3.0.0

• 🔄 تغییر اساسی: استفاده از وضعیت‌های پیش‌فرض ووکامرس
• ✅ حذف وضعیت‌های سفارشی برای سازگاری بهتر

نسخه 2.0.0

• ✨ افزودن وضعیت‌های سفارشی ووکامرس
• ✨ یکپارچگی کامل با سیستم پیامک ووکامرس
• ✨ سیستم ایمیل سفارشی برای هر وضعیت

نسخه 1.0.0

• انتشار اولیه افزونه
• امکان تایید مدیر برای محصولات ساده
• صفحه انتظار تایید با بروزرسانی خودکار
• پنل مدیریت کامل
• پنل کاربری برای مشتریان

مجوز

این افزونه تحت مجوز GPL v2 یا بالاتر منتشر شده است.

توسعه دهنده

توسعه یافته با ❤️ برای جامعه ووکامرس فارسی

---

نکته مهم نسخه 4.0.0: این نسخه از وضعیت‌های سفارشی اختصاصی استفاده می‌کند که به صورت خودکار در ووکامرس ثبت می‌شوند. این روش باعث می‌شود سفارشات دیگر به صورت خودکار به وضعیت "تکمیل شده" تغییر نکنند و کنترل کامل بر جریان کار باشد.