manifest / ecommerce / woo-order-notifier

WooCommerce Order Notifier (Telegram & Bale)

Real-time WooCommerce order notification plugin for Telegram and Bale messengers, featuring HPOS compatibility, proxy support for Iranian hosts, and live connection testing.

by آرمان محبعلی · github.com/rmaawn/woo-order-notifier · website

★ 0stars

v1.0.0latest · 12d ago

Install

Download woo-order-notifier.zip From the v1.0.0 release on GitHub, Oct 10, 2026

Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/rmaawn/woo-order-notifier/releases/download/v1.0.0/woo-order-notifier.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/rmaawn/woo-order-notifier ↗

افزونه اطلاع‌رسانی سفارشات ووکامرس (تلگرام و بله)

WooCommerce Order Notifier (Telegram & Bale)

افزونه سبک، سریع و حرفه‌ای وردپرس جهت ارسال خودکار اعلان سفارش‌های جدید و تغییر وضعیت سفارشات ووکامرس برای مدیر سایت از طریق پیام‌رسان‌های تلگرام (Telegram) و بله (Bale).

🚀 ویژگی‌های کلیدی

ارسال فوری به تلگرام و بله: اطلاع‌رسانی لحظه‌ای به محض ثبت سفارش یا پرداخت آن.
تست اتصال آنلاین (AJAX): امکان ارسال پیام آزمایشی به تلگرام و بله مستقیماً از پنل مدیریت بدون ذخیره یا خروج از صفحه.
جلوگیری هوشمند از ارسال تکراری: ذخیره متادیتای اختصاصی برای هر سفارش تا در صورت رفرش صفحه «تشکر از خرید» یا ویرایش مجدد، پیام تکراری فرستاده نشود.
پشتیبانی کامل از HPOS: سازگار با ویژگی ذخیره‌سازی سفارشات با کارایی بالا در ووکامرس (High-Performance Order Storage).
قالب پیام قابل شخصی‌سازی: امکان تغییر متن با تگ‌های هوشمند نظیر {order_number}, {customer_name}, {customer_phone}, {shipping_address}, {postcode}, {items_list}, {total_price} و...
پشتیبانی از هاست‌های داخل ایران: امکان تعریف Reverse Proxy یا ورکر کلودفلر برای دور زدن محدودیت‌های تلگرام روی سرورهای داخلی.
رابط کاربری راست‌چین (RTL) و فارسی.

📸 پیش‌نمایش اعلان‌ها / Screenshots

اعلان در تلگرام (Telegram)	اعلان در بله (Bale)

📋 راهنمای راه‌اندازی و دریافت توکن‌ها

۱. راه‌اندازی تلگرام:

در تلگرام وارد ربات BotFather@ شوید و دستور /newbot را ارسال کنید.
نام و نام‌کاربری ربات را انتخاب کنید و HTTP API Token دریافت شده را کپی نمایید.
ربات ساخته‌شده خود را باز کرده و دکمه Start را بزنید.
برای پیدا کردن شناسه عددی چت خودتان (Chat ID)، ربات userinfobot@ یا ChatIDRobot@ را در تلگرام استارت کنید تا شناسه عددی شما (مثلاً 123456789) را نمایش دهد.
توکن و Chat ID را در بخش تنظیمات تلگرام افزونه وارد کنید و دکمه «ارسال پیام تست به تلگرام» را بزنید.

۲. راه‌اندازی بله (Bale):

در پیام‌رسان بله، شناسه BotFather@ را جستجو کرده و وارد آن شوید.
با دستور /newbot یا منوی ربات، یک بازوی جدید ایجاد کرده و توکن بازو را دریافت کنید.
بازوی ایجاد شده را در بله باز کنید و گزینه شروع (Start) را بزنید.
شناسه چت (Chat ID) حساب خود در بله را دریافت و در فیلد مربوطه قرار دهید.
روی دکمه «ارسال پیام تست به بله» کلیک کنید تا از اتصال مطمئن شوید.

🛠 نصب و استفاده

محتوای این پوشه را در مسیر wp-content/plugins/woo-order-notifier/ سایت خود قرار دهید.
از بخش پیشخوان وردپرس > افزونه‌ها، افزونه را فعال کنید.
به مسیر ووکامرس > اطلاع‌رسانی تلگرام و بله مراجعه کرده و تنظیمات را پیکربندی نمایید.

📁 ساختار فایل‌های افزونه

woo-order-notifier/
├── .gitignore
├── README.md
├── woo-order-notifier.php              # فایل اصلی افزونه و راه‌انداز
├── includes/
│   ├── class-notifier-dispatcher.php   # ماژول ارسال درخواست به API تلگرام و بله
│   ├── class-notifier-order-handler.php# هندلر هوک‌های ووکامرس و ساخت متن سفارش
│   └── class-notifier-admin.php        # پنل تنظیمات، اعتبارسنجی و درخواست‌های AJAX
└── assets/
    ├── css/
    │   └── admin.css                   # استایل‌های بخش مدیریت (RTL)
    ├── js/
    │   └── admin.js                    # اسکریپت تست اتصال و درج تگ‌ها
    └── images/                         # تصاویر و اسکرین‌شات‌های پیش‌نمایش

👨‍💻 توسعه‌دهنده

نویسنده: آرمان محبعلی
مخزن پروژه: Rmaawn/woo-order-notifier
مجوز: GPL-2.0-or-later

Releases

1 release. Each count is every asset in that release; expand a row for the breakdown.

Tag

Published

Assets

Downloads

v1.0.0 latest

Oct 10, 2026 12d ago

woo-order-notifier.zip