توضیحات
افزونه Hamidreza Order Notifier اعلان‌های وضعیت سفارش ووکامرس را مستقیماً به چت ربات تلگرام یا بله شما ارسال می‌کند.
ویژگی‌ها:
– ارسال اعلان برای وضعیت‌های انتخابی سفارش ووکامرس
– پشتیبانی از تلگرام و بله (فرمت‌بندی Markdown)
– پشتیبانی از چند شناسه چت و امکان ارسال همزمان به تلگرام و بله
– دکمه شیشه‌ای «باز کردن سفارش» در پیام‌های تلگرام و بله
– قالب پیام سفارشی همراه با برچسب‌های جایگزین (Placeholders)
– فیلدهای اختیاری: شناسه محصول (SKU)، یادداشت مشتری، کد تخفیف و هزینه حمل‌ونقل
– پیش‌نمایش پیام قبل از ذخیره‌سازی
– فیلترها و اکشن‌های توسعه‌دهنده برای شخصی‌سازی
– دکمه تست اتصال در صفحه تنظیمات
– ارسال در پس‌زمینه بدون ایجاد تاخیر در فرآیند تسویه‌حساب
– صفحه تنظیمات در منوی مدیریت ووکامرس
– آماده ترجمه و کاملاً راست‌چین (RTL)
– نیازمند نصب و فعال بودن ووکامرس به عنوان پیش‌نیاز اصلی
سرویس‌های بیرونی
این افزونه به API پیام‌رسان‌های ثالث متصل می‌شود تا اعلان‌های سفارش ووکامرس را به چت تنظیم‌شده توسط مدیر سایت تحویل دهد.
API ربات تلگرام
هنگامی که تلگرام در تنظیمات افزونه انتخاب شده باشد، هربار که یک سفارش ووکامرس به یکی از وضعیت‌های فعال سفارش برسد، افزونه یک درخواست HTTP POST به API ربات تلگرام (https://api.telegram.org/bot) ارسال می‌کند.
این درخواست شامل توکن ربات و شناسه چت پیکربندی‌شده در تنظیمات افزونه است، به همراه پیام اعلانی که شامل جزئیات سفارش مانند شماره سفارش، وضعیت، نام مشتری، شماره تلفن، روش پرداخت، جمع کل سفارش، تاریخ، آیتم‌های خریداری‌شده، نشانی ارسال و لینک مدیریت سفارش می‌باشد.
این سرویس توسط تلگرام ارائه می‌شود: شرایط خدمات، سیاست حریم خصوصی.
API ربات بله
هنگامی که بله در تنظیمات افزونه انتخاب شده باشد، هربار که یک سفارش ووکامرس به یکی از وضعیت‌های فعال سفارش برسد، افزونه یک درخواست HTTP POST به API ربات بله (https://tapi.bale.ai/bot) ارسال می‌کند.
این درخواست شامل توکن ربات و شناسه چت پیکربندی‌شده در تنظیمات افزونه است، به همراه پیام اعلانی که شامل جزئیات سفارش مانند شماره سفارش، وضعیت، نام مشتری، شماره تلفن، روش پرداخت، جمع کل سفارش، تاریخ، آیتم‌های خریداری‌شده، نشانی ارسال و لینک مدیریت سفارش می‌باشد.
این سرویس توسط بله ارائه می‌شود: شرایط خدمات، سیاست حریم خصوصی.
نصب
- پوشه افزونه را در مسیر
/wp-content/plugins/آپلود کنید، یا از طریق صفحه افزونه‌ها در مدیریت وردپرس اقدام به نصب نمایید. - اطمینان حاصل کنید که ووکامرس نصب و فعال است.
- افزونه را از طریق منوی «افزونه‌ها» در وردپرس فعال کنید.
- به مسیر
ووکامرس > Order Notifierبروید. - تلگرام یا بله را انتخاب کرده، سپس توکن ربات و شناسه چت خود را وارد کنید.
- روی «ارسال پیام آزمایشی» کلیک کنید تا اتصال بررسی شود.
- اعلان‌ها را فعال کرده و وضعیت‌های سفارش مورد نظر خود را انتخاب کنید.
- روی «ذخیره تنظیمات» کلیک کنید.
سوالات متداول
-
آیا این افزونه به ووکامرس نیاز دارد؟
-
بله. ووکامرس باید نصب و فعال باشد. افزونه بدون ووکامرس فعال نخواهد شد.
-
صفحه تنظیمات کجا قرار دارد؟
-
صفحه تنظیمات در بخش ووکامرس > Order Notifier در دسترس است. یک لینک تنظیمات نیز در صفحه افزونه‌ها نمایش داده می‌شود.
-
آیا از بله پشتیبانی می‌کند؟
-
بله. می‌توانید تلگرام یا بله را از تنظیمات افزونه انتخاب کنید.
-
توکن ربات تلگرام خود را از کجا پیدا کنم؟
-
با استفاده از @BotFather در تلگرام یک ربات بسازید. BotFather یک توکن احراز هویت به شما می‌دهد.
-
شناسه چت (Chat ID) خود را از کجا پیدا کنم؟
-
به ربات خود پیام دهید، سپس شناسه چت (Chat ID) را از
getUpdatesبخوانید، یا از یک ربات کمکی مانند @userinfobot استفاده کنید. شناسه گروه‌ها معمولاً منفی است. برای بله، ازgetUpdatesدرtapi.bale.aiاستفاده کنید. -
چگونه می‌توانم بررسی کنم که کار می‌کند؟
-
از گزینه ارسال پیام آزمایشی در صفحه تنظیمات استفاده کنید. اگر پیام در چت شما دریافت شد، اعلان‌های زنده سفارش آماده هستند.
نقد و بررسی‌ها
توسعه دهندگان و همکاران
“اعلان سفارش حمیدرضا” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.
مشارکت کنندگان
“اعلان سفارش حمیدرضا” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمک‌هایشان.
ترجمه “اعلان سفارش حمیدرضا” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
1.5.0
- افزوده شدن شناسه‌های چت جداگانه برای تلگرام و بله با بخش‌های تنظیمات مجزا برای هر پلتفرم (فهرست مشترک موجود به عنوان جایگزین حفظ شد)
- توکن‌های ربات پس از ذخیره‌سازی هرگز دوباره نشان داده نمی‌شوند؛ خالی گذاشتن فیلد توکن مقدار ذخیره‌شده را حفظ می‌کند، همراه با راهنمای ماسک‌شده و پشتیبانی از ثابت wp-config
- ویرایشگر قالب پیام به‌صورت پیش‌فرض خالی می‌ماند تا چیدمان خودکار به‌روزرسانی شود؛ دکمه‌های «درج چیدمان پیش‌فرض» و «بازنشانی به پیش‌فرض» اضافه شدند و پیش‌نمایش اکنون متن ساده و Markdown را نمایش می‌دهد
- متن جایگزین ساده اکنون همیشه شامل پیوند سفارش است، و قفل صف تکراری هنگام تغییر وضعیت سفارش پاک می‌شود
- نمایش نام و نشانی وب‌سایت در یک خط زیر عنوان پیام
1.4.0
- افزوده شدن هوک‌های توسعه‌دهنده: hron_should_notify, hron_notification_message, hron_notification_sent, hron_notification_failed, hron_chat_ids و hron_delivery_platforms
- افزوده شدن پشتیبانی از چند شناسه چت (یک شناسه در هر خط)
- افزوده شدن امکان ارسال همزمان اختیاری به تلگرام و بله
- افزوده شدن دکمه شیشه‌ای باز کردن سفارش برای پیام‌های تلگرام و بله
- افزوده شدن نام و دامنه سایت در بالای پیام اعلان پیش‌فرض
- غیرفعال شدن پیش‌نمایش پیوندها برای آدرس‌های وب در پیام‌های اعلان
- افزوده شدن فیلدهای اختیاری پیام: شناسه محصول (SKU)، یادداشت مشتری، کد تخفیف و هزینه حمل‌ونقل
- افزوده شدن قالب پیام سفارشی با برچسب‌های جایگزین
- افزوده شدن پیش‌نمایش پیام در صفحه تنظیمات
- رفع مشکل ارسال پیام آزمایشی بله با توکن ربات اشتباه هنگام ذخیره بودن هر دو توکن
- تست‌شده تا وردپرس 7.1
1.3.7
- به‌روزرسانی متادیتای نویسنده و نوسازی المان‌های بصری افزونه.
1.3.6
- افزوده شدن نشانی ارسال (با جایگزینی نشانی صورتحساب در صورت عدم وجود) در زیر آیتم‌های خریداری‌شده در اعلان‌های سفارش.
1.3.0
- بهبود صفحه اختصاصی تنظیمات ووکامرس با چیدمان دو ستونه واکنش‌گرا و خلاصه پیکربندی
- افزوده شدن متن پیشنهادی سیاست حریم خصوصی برای داده‌های سفارش ارسال‌شده به تلگرام یا بله
- بهبود دسترسی‌پذیری برای نتایج تست و کنترل‌های وضعیت سفارش انتخاب‌شده
- جلوگیری از کارهای اعلان قدیمی و تکراری در پس‌زمینه
- پاک‌سازی کارهای اعلان در انتظار هنگام غیرفعال‌سازی افزونه
- ایمن‌سازی و پاک‌سازی پیشرفته‌تر توکن ربات و شناسه چت
- اعلام سازگاری با وردپرس 7.0 و ووکامرس 11.0
1.2.0
- طراحی مجدد صفحه تنظیمات با نشان وضعیت، کارت‌های پلتفرم و دسته‌بندی شفاف‌تر
- افزوده شدن دکمه ارسال پیام آزمایشی برای بررسی اطلاعات اعتبار تلگرام یا بله
- مخفی شدن فیلد توکن ربات به صورت پیش‌فرض، همراه با دکمه نمایش/مخفی‌سازی
- قرارگیری اعلان‌ها در صف پس‌زمینه تا فرآیند تسویه‌حساب به تاخیر نیفتد
- تلاش مجدد خودکار برای ارسال‌های ناموفق و افزودن یادداشت به سفارش
- پیام‌های تلگرام و بله اکنون از Markdown استفاده می‌کنند (با جایگزینی متن ساده در صورت عدم پشتیبانی)
- پیام شامل شماره سفارش، روش پرداخت و لینک مدیریت سفارش است
- حذف تنظیمات ثبت خطاهای API
- مدیران فروشگاه با دسترسی manage_woocommerce می‌توانند صفحه تنظیمات را باز کنند
- افزوده شدن لینک تنظیمات در صفحه افزونه‌ها
- اعتبارسنجی اطلاعات قبل از امکان فعال‌سازی اعلان‌ها
1.1.0
- بازنویسی کدها بر پایه معماری ماژولار مبتنی بر کلاس
- انتقال صفحه تنظیمات به زیرمنوی ووکامرس (ووکامرس > Order Notifier)
- ووکامرس اکنون پیش‌نیاز اصلی است – افزونه بدون آن فعال نخواهد شد
- افزوده شدن CSS اختصاصی بخش مدیریت برای داشتن صفحه تنظیمات تمیزتر
- ثبت خطاها (Error logging) اکنون در صورت فعال بودن WP_DEBUG کار می‌کند
- به‌روزرسانی هدرهای سازگاری وردپرس و ووکامرس
- بهبود ساختار کد بر اساس استانداردهای برنامه‌نویسی وردپرس
1.0.8
- افزودن پیشوند hamidreza_ به شناسه‌های تنظیمات افزونه جهت انطباق با قوانین WordPress.org.
- انتقال تنظیمات ذخیره‌شده از کلید قدیمی hrwcn_settings.
1.0.7
- حذف فایل‌های ترجمه همراه افزونه؛ ترجمه‌ها از طریق translate.wordpress.org مدیریت می‌شوند.
- مستندسازی سرویس‌های بیرونی تلگرام و بله در فایل readme.
1.0.6
- انتشار اولیه.