Hamidreza Order Notifier

توضیحات

افزونه Hamidreza Order Notifier اعلان‌های وضعیت سفارش ووکامرس را مستقیماً به چت ربات تلگرام یا بله شما ارسال می‌کند.

قابلیت‌ها:
– ارسال اعلان برای وضعیت‌های انتخاب‌شده سفارش ووکامرس
– پشتیبانی از تلگرام و بله (با قالب‌بندی Markdown)
– دکمه تست اتصال در صفحه تنظیمات
– ارسال در پس‌زمینه جهت جلوگیری از کندی فرآیند تسویه‌حساب
– صفحه تنظیمات در زیرمنوی مدیریت ووکامرس
– آماده ترجمه و سازگار با راست‌چین (RTL)
– نیازمند ووکامرس به عنوان پیش‌نیاز اصلی

سرویس‌های بیرونی

این افزونه به API پیام‌رسان‌های ثالث متصل می‌شود تا اعلان‌های سفارش ووکامرس را به چت تنظیم‌شده توسط مدیر سایت تحویل دهد.

API ربات تلگرام

هنگامی که تلگرام در تنظیمات افزونه انتخاب شده باشد، هربار که یک سفارش ووکامرس به یکی از وضعیت‌های فعال سفارش برسد، افزونه یک درخواست HTTP POST به API ربات تلگرام (https://api.telegram.org/bot) ارسال می‌کند.

این درخواست شامل توکن ربات و شناسه چت پیکربندی‌شده در تنظیمات افزونه است، به همراه پیام اعلانی که شامل جزئیات سفارش مانند شماره سفارش، وضعیت، نام مشتری، شماره تلفن، روش پرداخت، جمع کل سفارش، تاریخ، آیتم‌های خریداری‌شده، نشانی ارسال و لینک مدیریت سفارش می‌باشد.

این سرویس توسط تلگرام ارائه می‌شود: شرایط خدمات، سیاست حریم خصوصی.

API ربات بله

هنگامی که بله در تنظیمات افزونه انتخاب شده باشد، هربار که یک سفارش ووکامرس به یکی از وضعیت‌های فعال سفارش برسد، افزونه یک درخواست HTTP POST به API ربات بله (https://tapi.bale.ai/bot) ارسال می‌کند.

این درخواست شامل توکن ربات و شناسه چت پیکربندی‌شده در تنظیمات افزونه است، به همراه پیام اعلانی که شامل جزئیات سفارش مانند شماره سفارش، وضعیت، نام مشتری، شماره تلفن، روش پرداخت، جمع کل سفارش، تاریخ، آیتم‌های خریداری‌شده، نشانی ارسال و لینک مدیریت سفارش می‌باشد.

این سرویس توسط بله ارائه می‌شود: شرایط خدمات، سیاست حریم خصوصی.

نصب

  1. پوشه افزونه را در مسیر /wp-content/plugins/ آپلود کنید، یا از طریق صفحه افزونه‌ها در مدیریت وردپرس اقدام به نصب نمایید.
  2. اطمینان حاصل کنید که ووکامرس نصب و فعال است.
  3. افزونه را از طریق منوی «افزونه‌ها» در وردپرس فعال کنید.
  4. به مسیر ووکامرس > Order Notifier بروید.
  5. تلگرام یا بله را انتخاب کرده، سپس توکن ربات و شناسه چت خود را وارد کنید.
  6. روی «ارسال پیام آزمایشی» کلیک کنید تا اتصال بررسی شود.
  7. اعلان‌ها را فعال کرده و وضعیت‌های سفارش مورد نظر خود را انتخاب کنید.
  8. روی «ذخیره تنظیمات» کلیک کنید.

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

آیا این افزونه به ووکامرس نیاز دارد؟

بله. ووکامرس باید نصب و فعال باشد. افزونه بدون ووکامرس فعال نخواهد شد.

صفحه تنظیمات کجا قرار دارد؟

صفحه تنظیمات در بخش ووکامرس > Order Notifier در دسترس است. یک لینک تنظیمات نیز در صفحه افزونه‌ها نمایش داده می‌شود.

آیا از بله پشتیبانی می‌کند؟

بله. می‌توانید تلگرام یا بله را از تنظیمات افزونه انتخاب کنید.

توکن ربات تلگرام خود را از کجا پیدا کنم؟

با استفاده از @BotFather در تلگرام یک ربات بسازید. BotFather یک توکن احراز هویت به شما می‌دهد.

شناسه چت (Chat ID) خود را از کجا پیدا کنم؟

به ربات خود پیام دهید، سپس شناسه چت (Chat ID) را از getUpdates بخوانید، یا از یک ربات کمکی مانند @userinfobot استفاده کنید. شناسه گروه‌ها معمولاً منفی است. برای بله، از getUpdates در tapi.bale.ai استفاده کنید.

چگونه می‌توانم بررسی کنم که کار می‌کند؟

از گزینه ارسال پیام آزمایشی در صفحه تنظیمات استفاده کنید. اگر پیام در چت شما دریافت شد، اعلان‌های زنده سفارش آماده هستند.

نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

توسعه دهندگان و همکاران

“Hamidreza Order Notifier” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.

مشارکت کنندگان

“Hamidreza Order Notifier” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمک‌هایشان.

ترجمه “Hamidreza Order Notifier” به زبان شما.

علاقه‌ مند به توسعه هستید؟

کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.

گزارش تغییرات

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

  • انتشار اولیه.