افزونه پیگیری - توسط onwebs (نسخه ۲)
افزونه فارسی رهگیری سفارش ووکامرس — تم دارکمود سبز/مشکی، تایملاین ۵ مرحلهای و هندل خودکار درگاههای پرداخت ایرانی (زرینپال، زیبال و …). ساختهشده توسط سپهر فتحی.
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/sepehrfathi/onwebs-order-tracker/archive/refs/heads/main.zipReadme
افزونه پیگیری سفارش ووکامرس — onwebs
افزونهی فارسی و راستچین برای رهگیری سفارش ووکامرس با تایملاین زیبا (تم دارکمود سبز/مشکی)، پنل مدیریت ۵ مرحلهای، و هندل خودکار بازگشت از درگاههای پرداخت ایرانی (زرینپال، زیبال، IDPay، NextPay، Pay.ir و …).
ساختهشده توسط سپهر فتحی — onwebs
✨ امکانات
- 🎯 رهگیری سفارش با شماره سفارش، شماره موبایل یا ایمیل (پشتیبانی کامل از اعداد فارسی و فرمتهای مختلف موبایل:
09…,+98…,0098…). - 🌑 تم دارکمود سبز و مشکی کاملاً راستچین (RTL) و واکنشگرا (ریسپانسیو) برای موبایل و دسکتاپ.
- 🪜 تایملاین ۵ مرحلهای پویا — تعداد، عنوان، آیکون، رنگ و وضعیت ووکامرسِ هر مرحله از پنل قابل تنظیم است.
- 💳 هندل خودکار درگاه پرداخت: وقتی پرداخت با موفقیت از درگاه برمیگردد، سفارش بهصورت خودکار به «مرحلهی بعد» منتقل میشود (فقط رو به جلو — سفارشِ پرداختشده هرگز به وضعیت پرداختنشده برنمیگردد).
- ❌ حالت لغو شده: اگر سفارش لغو/ناموفق/مرجوع شود، هیچ مرحلهای طیشده نمایش داده نمیشود و کارت بهصورت کامل قرمز و شفاف نشان داده میشود.
- 🧾 نمایش کامل جزئیات سفارش: روش پرداخت، روش ارسال، هزینهی ارسال، تخفیف، مالیات و مبلغ کل.
- 🛠️ پنل تغییر وضعیت در لیست سفارشها برای مدیر — با دکمههای همان ۵ مرحله.
- ⚡ سازگار با HPOS (جدول سفارشهای پرسرعت ووکامرس) و همچنین حالت قدیمی.
💳 درگاههای پرداخت پشتیبانیشده
این افزونه به هیچ درگاه خاصی وابسته نیست. تمام درگاههای استانداردِ ووکامرس که هنگام تأیید پرداخت متد payment_complete() را صدا میزنند، بهصورت خودکار پشتیبانی میشوند؛ از جمله:
| درگاه | وضعیت |
|---|---|
| زرینپال (ZarinPal) | ✅ |
| زیبال (Zibal) | ✅ |
| آیدیپی (IDPay) | ✅ |
| نکستپی (NextPay) | ✅ |
| پیداتآیآر (Pay.ir) | ✅ |
| سایر درگاههای استاندارد ووکامرس | ✅ |
افزونه روی هوک استانداردِ woocommerce_payment_complete کار میکند، بنابراین نیازی به تنظیمات اختصاصی برای هر درگاه ندارید.
📦 نصب
- پوشهی افزونه را در مسیر
wp-content/plugins/آپلود کنید (یا فایل ZIP را از مسیر افزونهها ← افزودن ← بارگذاری افزونه نصب کنید). - افزونه را فعال کنید (نیازمند فعال بودن WooCommerce است).
- به پیشخوان ← تنظیمات ← افزونه پیگیری - onwebs بروید و مراحل و وضعیتهای پرداخت را تنظیم کنید.
🚀 استفاده (شورتکد)
فرم رهگیری را با این شورتکد در هر برگه یا نوشته قرار دهید:
[onwebs_order_tracker]پارامترهای اختیاری
[onwebs_order_tracker button_text="رهگیری مرسوله" placeholder="شماره سفارش یا موبایل خود را وارد کنید"]| پارامتر | توضیح | پیشفرض |
|---|---|---|
button_text |
متن دکمه | پیگیری سفارش |
placeholder |
متن راهنمای کادر جستجو | مقدار تنظیمشده در پنل |
⚙️ تنظیمات
در صفحهی تنظیمات افزونه میتوانید موارد زیر را مدیریت کنید:
- نمایش/عدم نمایش تایملاین
- متن راهنمای کادر جستجو
- وضعیت پس از پرداخت موفق — وضعیتی که سفارش پس از تأیید پرداخت به آن منتقل میشود (پیشفرض: «در حال انجام / processing»).
- وضعیت پس از پرداخت ناموفق — پیشنهاد: «ناموفق (failed)» تا مشتری بتواند دوباره پرداخت کند. گزینهی «بدون تغییر» هم وجود دارد.
- ۵ مرحلهی قابل تنظیم — برای هر مرحله: فعال/غیرفعال، وضعیت ووکامرس، عنوان نمایشی، آیکون و رنگ.
🔄 منطق تغییر وضعیت سفارش
- پرداخت موفق: سفارش فقط رو به جلو حرکت میکند؛ هرگز یک سفارش پرداختشده به وضعیت پرداختنشده برنمیگردد و در پایپلاین مرحلهای عقب نمیرود.
- پرداخت ناموفق: بر اساس تنظیمات (پیشفرض: بدون لغو اجباری، تا امکان تلاش مجدد حفظ شود).
- سفارشهای تکمیل/مرجوعشده: دستنخورده باقی میمانند.
🧩 سازگاری
- WooCommerce (شامل HPOS — High-Performance Order Storage).
- PHP نسخهی 7.4 به بالا.
- وردپرس راستچین (فارسی).
📝 تغییرات (Changelog)
2.8.0
- افزودن تم دارکمود سبز/مشکی.
- حالت لغو شده: نمایش قرمز بدون هیچ مرحلهی طیشده.
- افزودن روش ارسال و هزینهی ارسال به کارت سفارش.
2.7.0
- رفع باگ بحرانی: عدم بازگرداندن سفارشِ پرداختشده به وضعیت پرداختنشده.
- منطق تغییر وضعیت فقط رو به جلو پس از پرداخت موفق.
- سازگاری با HPOS.
- پشتیبانی از اعداد فارسی و نرمالسازی شماره موبایل ایران در جستجو.
- تنظیمات جداگانه برای وضعیت پس از پرداخت موفق/ناموفق.
- بازطراحی تایملاین (ستونهای پویا، نوار پیشرفت دقیق، راستچین) و رفع باگ فرم در موبایل.
📄 مجوز
این افزونه تحت مجوز GPLv2 یا بالاتر منتشر شده است.
ساختهشده با ❤️ توسط سپهر فتحی