WP Manifestindependent plugin directory
manifest / ecommerce / onwebs-order-tracker

افزونه پیگیری - توسط onwebs (نسخه ۲)

افزونه فارسی رهگیری سفارش ووکامرس — تم دارک‌مود سبز/مشکی، تایم‌لاین ۵ مرحله‌ای و هندل خودکار درگاه‌های پرداخت ایرانی (زرین‌پال، زیبال و …). ساخته‌شده توسط سپهر فتحی.

by سپهر فتحی · github.com/sepehrfathi/onwebs-order-tracker

★ 3stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/sepehrfathi/onwebs-order-tracker/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/sepehrfathi/onwebs-order-tracker ↗

افزونه پیگیری سفارش ووکامرس — onwebs

افزونه‌ی فارسی و راست‌چین برای رهگیری سفارش ووکامرس با تایم‌لاین زیبا (تم دارک‌مود سبز/مشکی)، پنل مدیریت ۵ مرحله‌ای، و هندل خودکار بازگشت از درگاه‌های پرداخت ایرانی (زرین‌پال، زیبال، IDPay، NextPay، Pay.ir و …).

ساخته‌شده توسط سپهر فتحی — onwebs

✨ امکانات

  • 🎯 رهگیری سفارش با شماره سفارش، شماره موبایل یا ایمیل (پشتیبانی کامل از اعداد فارسی و فرمت‌های مختلف موبایل: 09…, +98…, 0098…).
  • 🌑 تم دارک‌مود سبز و مشکی کاملاً راست‌چین (RTL) و واکنش‌گرا (ریسپانسیو) برای موبایل و دسکتاپ.
  • 🪜 تایم‌لاین ۵ مرحله‌ای پویا — تعداد، عنوان، آیکون، رنگ و وضعیت ووکامرسِ هر مرحله از پنل قابل تنظیم است.
  • 💳 هندل خودکار درگاه پرداخت: وقتی پرداخت با موفقیت از درگاه برمی‌گردد، سفارش به‌صورت خودکار به «مرحله‌ی بعد» منتقل می‌شود (فقط رو به جلو — سفارشِ پرداخت‌شده هرگز به وضعیت پرداخت‌نشده برنمی‌گردد).
  • ❌ حالت لغو شده: اگر سفارش لغو/ناموفق/مرجوع شود، هیچ مرحله‌ای طی‌شده نمایش داده نمی‌شود و کارت به‌صورت کامل قرمز و شفاف نشان داده می‌شود.
  • 🧾 نمایش کامل جزئیات سفارش: روش پرداخت، روش ارسال، هزینه‌ی ارسال، تخفیف، مالیات و مبلغ کل.
  • 🛠️ پنل تغییر وضعیت در لیست سفارش‌ها برای مدیر — با دکمه‌های همان ۵ مرحله.
  • ⚡ سازگار با HPOS (جدول سفارش‌های پرسرعت ووکامرس) و همچنین حالت قدیمی.

💳 درگاه‌های پرداخت پشتیبانی‌شده

این افزونه به هیچ درگاه خاصی وابسته نیست. تمام درگاه‌های استانداردِ ووکامرس که هنگام تأیید پرداخت متد payment_complete() را صدا می‌زنند، به‌صورت خودکار پشتیبانی می‌شوند؛ از جمله:

درگاه وضعیت
زرین‌پال (ZarinPal) ✅
زیبال (Zibal) ✅
آیدی‌پی (IDPay) ✅
نکست‌پی (NextPay) ✅
پی‌دات‌آی‌آر (Pay.ir) ✅
سایر درگاه‌های استاندارد ووکامرس ✅

افزونه روی هوک استانداردِ woocommerce_payment_complete کار می‌کند، بنابراین نیازی به تنظیمات اختصاصی برای هر درگاه ندارید.

📦 نصب

  1. پوشه‌ی افزونه را در مسیر wp-content/plugins/ آپلود کنید (یا فایل ZIP را از مسیر افزونه‌ها ← افزودن ← بارگذاری افزونه نصب کنید).
  2. افزونه را فعال کنید (نیازمند فعال بودن WooCommerce است).
  3. به پیشخوان ← تنظیمات ← افزونه پیگیری - 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 یا بالاتر منتشر شده است.

ساخته‌شده با ❤️ توسط سپهر فتحی