پلاگین اشتراک سفارشات ووکامرس در ایتا و بله

افزونه وردپرس برای ارسال اطلاعات سفارش‌های ووکامرس به پیام‌رسان‌های ایتا و بله.

نسخه فعلی افزونه: 2.1.0

قابلیت‌ها

• ارسال خودکار سفارش‌های ووکامرس بعد از تغییر وضعیت سفارش به processing.
• ارسال سفارش به ایتا از طریق سرویس Eitaayar.
• ارسال سفارش به بله از طریق Bale Bot API.
• امکان فعال یا غیرفعال کردن جداگانه ایتا و بله.
• تنظیم جداگانه Base URL، توکن و Chat ID برای هر پیام‌رسان.
• نمایش وضعیت اتصال هر پیام‌رسان با متد getMe در صفحه تنظیمات افزونه.
• نمایش وضعیت پیام‌رسان‌ها در نوار ابزار مدیریت وردپرس.
• دکمه ارسال دستی سفارش در صفحه مدیریت سفارش ووکامرس.
• جلوگیری از ارسال تکراری در ارسال خودکار.
• ویرایش پیام قبلی بله با متد editMessageText در ارسال دستی، در صورتی که message_id پیام قبلی ذخیره شده باشد.
• نمایش نتیجه ارسال دستی داخل پنجره مودال مدیریت سفارش.

اطلاعات داخل پیام سفارش

متن پیام سفارش شامل این موارد است:

• شماره سفارش
• تاریخ ایجاد سفارش
• زمان پرداخت سفارش
• نام و نام خانوادگی خریدار
• آدرس، کد پستی و تلفن
• آیتم‌های سفارش، تعداد و قیمت هر آیتم
• روش ارسال با آیکون مشخص
• یادداشت خریدار با آیکون 📝
• مبلغ کل سفارش

نصب

1. پوشه افزونه را داخل مسیر wp-content/plugins قرار دهید.
2. افزونه را از بخش افزونه‌های وردپرس فعال کنید.
3. از منوی مدیریت وردپرس وارد بخش ایتــا/بله شوید.
4. اطلاعات اتصال پیام‌رسان‌های مورد نظر را وارد کنید.
5. وضعیت اتصال را در همان صفحه بررسی کنید.

تنظیمات ایتا

ارسال به ایتا از طریق Eitaayar انجام می‌شود.

تنظیمات ایتا:

• فعال یا غیرفعال بودن ارسال به ایتا
• Base URL
• توکن
• Chat ID

مقدار پیش‌فرض Base URL:

https://eitaayar.ir

الگوی درخواست:

/api/TOKEN/METHOD

تنظیمات بله

ارسال به بله از طریق Bale Bot API انجام می‌شود.

تنظیمات بله:

• فعال یا غیرفعال بودن ارسال به بله
• Base URL
• توکن ربات بله
• Chat ID بله

مقدار پیش‌فرض Base URL:

https://tapi.bale.ai

الگوی درخواست:

/bot<TOKEN>/METHOD

ارسال خودکار سفارش

افزونه به اکشن زیر ووکامرس متصل است:

woocommerce_order_status_processing

وقتی وضعیت سفارش به processing تغییر کند، سفارش برای پیام‌رسان‌های فعال ارسال می‌شود.

برای جلوگیری از ارسال تکراری، وضعیت ارسال هر پیام‌رسان در متای سفارش ذخیره می‌شود:

_eitaa_sent_eitaayar
_eitaa_sent_bale

ارسال دستی سفارش

در صفحه مدیریت سفارش ووکامرس، دکمه ارسال به پیام‌رسان‌ها اضافه می‌شود.

ارسال دستی برای تست، ارسال مجدد یا ویرایش پیام بله استفاده می‌شود.

ویرایش پیام در بله

برای بله، اگر پیام قبلی سفارش قبلا ارسال شده و شناسه پیام آن ذخیره شده باشد، ارسال دستی به جای ساخت پیام جدید، متد زیر را صدا می‌زند:

editMessageText

شناسه پیام بله در متای سفارش ذخیره می‌شود:

_eitaa_message_id_bale

نکته مهم: پیام‌هایی که قبل از اضافه شدن قابلیت ویرایش ارسال شده‌اند، معمولا message_id ذخیره‌شده ندارند. در این حالت افزونه نمی‌تواند پیام قبلی بله را ویرایش کند، چون API بله برای ویرایش حتما به chat_id و message_id نیاز دارد.

ویرایش پیام در ایتا

در نسخه فعلی، ویرایش پیام برای ایتا پیاده‌سازی نشده است. مسیر ایتا در این افزونه از Eitaayar استفاده می‌کند و در حال حاضر فقط ارسال پیام با sendMessage برای آن استفاده می‌شود.

اگر سرویس Eitaayar متد ویرایش پیام و شناسه پیام قابل استفاده ارائه کند، می‌توان منطق ویرایش را مشابه بله به افزونه اضافه کرد.

نکات توسعه

فایل‌های اصلی افزونه:

Core.php
class/EitaaAPI.php

کلاس EitaaAPI مسئول ساخت متن سفارش، ارسال درخواست‌ها، بررسی وضعیت اتصال و مدیریت ارسال یا ویرایش پیام است.

فایل Core.php مسئول ثبت تنظیمات، صفحه تنظیمات مدیریت، دکمه ارسال دستی و اتصال افزونه به اکشن‌های وردپرس و ووکامرس است.

نیازمندی‌ها

• وردپرس
• ووکامرس
• دسترسی خروجی سرور به API پیام‌رسان‌ها
• توکن و Chat ID معتبر برای پیام‌رسان‌های فعال