توضیحات
حمید پالس هر زمان اتفاقی در سایت وردپرسی شما بیفتد، اعلانهایی کامل و قالببندیشده با مارکداون را به تلگرام، بله یا هر دو بهطور همزمان ارسال میکند. هر پلتفرم تنظیمات مستقل خود (توکن ربات، گیرندگان و نقطه پایانی) را دارد تا بتوانید اعلانها را همزمان در دو پیامرسان دریافت کنید.
دریافت اعلان هنگامی که:
- نوشتهای منتشر شود یا برای بازبینی ارسال گردد (از هر نوع نوشتهای).
- کاربر جدیدی ثبتنام کند.
- کاربری وارد شود — یا ورود ناموفقی رخ دهد (رمزهای عبور هرگز جمعآوری یا ارسال نمیشوند).
- دیدگاه جدیدی ارسال شود (همراه با فیلتر اختیاری هرزنامهها).
- فرمهای فرم تماس ۷، WPForms، نینجا فرمز یا المنتور پرو ارسال شوند.
- بازدیدکنندگان از طریق میلچیمپ (MC4WP) عضو یا لغو عضویت شوند.
- سفارش جدیدی در ووکامرس ثبت شود (محرک قابل تنظیم)، وضعیت سفارش تغییر کند، محصولاتی به سبد خرید اضافه/حذف شوند، یا موجودی انبار کم شود.
- افزونه WP Activity Log (WSAL) رویدادی را ثبت کند.
ویژگیهای برجسته:
- توزیعکننده چندپلتفرمی — API رباتهای تلگرام و بله (با شباهت تقریبی ۹۵٪) از یک درایور انتزاعی مشترک استفاده میکنند تا هر دو رفتار یکسانی داشته باشند و در عین حال تنظیمات مجزا حفظ شود.
- قالببندی مارکداون — تمامی پیامها از
parse_mode: Markdownبا توابع فرار امن برای محتوای پویا استفاده میکنند. - صف ناهمگام (Async) — ارسال صفبندیشده از طریق کران وردپرس سرعت تسویهحساب، فرمها و ورودها را بالا نگه میدارد؛ پیامها در پسزمینه بهصورت دستهای ارسال میشوند.
- دکمه ارسال پیام آزمایشی و ابزار یافتن شناسههای گفتگو مستقیماً درون تنظیمات هر پلتفرم.
- عیبیابی — گزارش ارسال همراه با برچسب زمان، کدهای HTTP و جزئیات خطای API بههمراه پاکسازی دستی صف.
- پشتیبانی از پروکسی — نقاط پایانی سفارشی API برای هر پلتفرم و پروکسی HTTP برای هاستهای دارای محدودیت.
- اولویت با حریم خصوصی — موقعیتیابی IP کاملاً اختیاری است (بهطور پیشفرض غیرفعال) و کش میشود.
- مناسب توسعهدهندگان — اکشن
pulse_send_message، فیلترpulse_notification_textو کد کوتاه[pulse_notify]. - آماده برای هوش مصنوعی — ادغام اختیاری با Abilities API / MCP تا کارگزاران مجاز بتوانند اعلان ارسال کنند.
راهاندازی
- ساخت ربات: از طریق @BotFather در تلگرام یا @BotFather در بله.
- توکن ربات را در تب پالس اتصالات کپی کرده و پلتفرم را فعال کنید.
- شناسههای گفتگوی گیرندگان (کاربران، گروهها یا کانالها) را وارد کنید یا از ابزار داخلی یافتن شناسههای گفتگو استفاده نمایید.
- روی ارسال پیام آزمایشی کلیک کنید — در صورتی که پیام ارسال شد، کار تمام است.
سرویسهای خارجی
این افزونه برای ارسال اعلانها به APIهای شخص ثالث متصل میشود. هیچ دادهای به این سرویسها ارسال نمیشود مگر اینکه توکن ربات را تنظیم، پلتفرم را فعال کرده و رویداد اعلانی رخ دهد (یا از ابزارهای پیام آزمایشی / یافتن شناسه گفتگو در مدیریت استفاده کنید).
API ربات تلگرام
برای ارسال پیامهای اعلان به گفتگوها، گروهها یا کانالهای تلگرامی که تنظیم کردهاید و همچنین برای نمایش گفتگوهای اخیر هنگام استفاده از یافتن شناسههای گفتگو استفاده میشود.
هنگام اجرا شدن اعلان (یا ارسال پیام آزمایشی)، افزونه متن پیام، توکن ربات، شناسه(های) گفتگوی گیرنده و پیوند دکمه درونخطی اختیاری را از طریق HTTPS به api.telegram.org (یا نقطه پایانی سفارشی شما) ارسال میکند.
تلگرام: شرایط استفاده، سیاست حفظ حریم خصوصی.
API ربات بله
برای اهداف مشابه در پیامرسان بله از طریق tapi.bale.ai (یا نقطه پایانی سفارشی شما) استفاده میشود.
هنگام اجرا شدن اعلان (یا استفاده از ابزارهای مدیریت)، افزونه متن پیام، توکن ربات، شناسه(های) گفتگوی گیرنده و پیوند دکمه درونخطی اختیاری را از طریق HTTPS به API ربات بله ارسال میکند.
بله: شرایط استفاده، سیاست حفظ حریم خصوصی (بخش حریم خصوصی درون برگه شرایط).
ip-api.com (اختیاری)
تنها زمانی استفاده میشود که گزینه تکمیل اعلانها با موقعیت جغرافیایی IP را در تب ارسال و حریم خصوصی فعال کنید (بهطور پیشفرض غیرفعال است).
هنگام فعالسازی و در صورتی که اعلان حاوی آدرس IP باشد، IP عمومی بازدیدکننده برای شناسایی شهر، استان، کشور و ارائهدهنده اینترنت (ISP) از طریق پروتکل HTTP به ip-api.com ارسال میشود. نتایج بهمدت یک ساعت در رونوشتهای موقت (Transients) وردپرس ذخیره میشوند.
ip-api.com: شرایط استفاده و حریم خصوصی.
نصب
- پوشه
hamidرا در مسیر/wp-content/plugins/بارگذاری کنید، یا افزونه را از طریق صفحه افزونههای وردپرس نصب نمایید. - افزونه را از طریق صفحه «افزونهها» در وردپرس فعال کنید.
- منوی حمید پالس را در پیشخوان خود باز کنید و ربات تلگرام و/یا بله خود را در تب اتصالات پیکربندی نمایید.
سوالات متداول
-
چگونه توکن ربات دریافت کنم؟
-
تلگرام: @BotFather را باز کنید، دستور
/newbotرا ارسال کرده و مراحل را دنبال کنید؛ توکن شبیه123456789:ABCdefGhIJKlmNoPQRsTUVwxyZخواهد بود.
بله: @BotFather را درون بله باز کرده و همین مراحل را تکرار کنید — Bot API بله مشابه تلگرام است و پالس از هر دو در یک رابط کاربری مشترک پشتیبانی میکند. -
چگونه شناسه گفتگوی (Chat ID) خود را پیدا کنم؟
-
پیامی به ربات خود ارسال کنید، سپس روی یافتن شناسههای گفتگو در تب پالس اتصالات کلیک کنید. پالس تمام گفتگوهای اخیر (کاربران، گروهها، کانالها) را با شناسه دقیق برای درج در تنظیمات فهرست میکند. شناسه گروهها اعداد منفی هستند و کانالهای عمومی بهصورت
@channelnameآدرسدهی میشوند. -
آیا میتوانم همزمان از تلگرام و بله استفاده کنم؟
-
بله. هر دو پلتفرم را در تب اتصالات فعال کنید؛ هر پلتفرم توکن، گیرندگان و نقطه پایانی مستقل خود را حفظ میکند و تمام اعلانها بهطور همزمان برای هر دو ارسال میشوند.
-
آیا ارسال اعلانها باعث کندی سایتم میشود؟
-
خیر. حالت ارسال را در تب «ارسال و حریم خصوصی» روی صفبندی از طریق کران وردپرس (WP-Cron) قرار دهید: پیامهای خروجی در یک صف سبک ذخیره شده و در پسزمینه بهصورت دستهای ارسال میشوند؛ بنابراین تسویهحساب، ارسال فرمها و ورودها هرگز معطل پاسخ Bot API نمیمانند.
-
هاست من api.telegram.org را مسدود کرده است — چه کاری میتوانم انجام دهم؟
-
دو راهکار وجود دارد: تنظیم نقطه پایانی سفارشی API برای هر پلتفرم (هر سرور واسط یا میرور که با Bot API سازگار باشد)، یا پیکربندی پروکسی HTTP در تب «ارسال و حریم خصوصی».
-
آیا افزونههای دیگر میتوانند اعلان ارسال کنند؟
-
بله — اکشن عمومی را از هر کجای کد اجرا کنید:
do_action( 'pulse_send_message', 'Hello from my plugin!' );همراه با دکمه شیشهای (درونخطی):
do_action( 'pulse_send_message', 'New order!', 'View', 'https://example.com/order/1' );
همراه با تغییر گیرنده:do_action( 'pulse_send_message', 'Hello', '', '', '123456789' );متن پیام با استفاده از فیلتر
pulse_notification_textقابل سفارشیسازی است. -
آیا کد کوتاه (Shortcode) دارد؟
-
[pulse_notify message=”Backup finished” site=”1″ ip=”1″] — ویژگیها:
message(اجباری)،site،ip،platform(شاملtelegram،baleیاboth)،button_label،button_url. توکنها طبق طراحی افزونه از طریق کدهای کوتاه قابل بازنویسی نیستند. -
آیا پالس دادههای من را جمعآوری میکند؟
-
بدون تلهمتری، بدون ردیابی و بدون ارسال داده به سرور مرکزی. موقعیتیابی جغرافیایی IP بهطور پیشفرض غیرفعال است؛ هنگام فعالسازی، IPها در ip-api.com بررسی شده و بهمدت یک ساعت بهصورت محلی ذخیره (کش) میشوند. لطفاً اطمینان حاصل کنید که این مورد در سیاست حفظ حریم خصوصی سایت شما ذکر شده باشد.
-
آیا از کارگزاران هوش مصنوعی / MCP پشتیبانی میکند؟
-
بهصورت اختیاری. با نصب افزونههای Abilities API و MCP Adapter، قابلیت «ارسال اعلان پالس» در مسیر
/wp-json/pulse/mcpبرای کارگزاران مجاز (نیازمند سطح دسترسی مدیر) در دسترس قرار میگیرد. -
آیا با ویژگی HPOS ووکامرس سازگار است؟
-
بله. تمام دادههای سفارش از طریق رابط برنامهنویسی CRUD سفارشهای ووکامرس (WC_Order) خوانده و نوشته میشوند.
نقد و بررسیها
نقد و بررسیای برای این افزونه یافت نشد.
توسعه دهندگان و همکاران
“اعلانهای حمید پالس برای تلگرام و بله” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کردهاند.
مشارکت کنندگان
“اعلانهای حمید پالس برای تلگرام و بله” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمکهایشان.
ترجمه “اعلانهای حمید پالس برای تلگرام و بله” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
1.0.5
- یکپارچهسازی انتهای خطوط فایلهای PHP جهت سازگاری با ابزارهای بازبینی افزونه.
1.0.4
- محدود کردن پاکسازی هنگام حذف فقط به تنظیمات صریح و رویداد زمانبندیشده این افزونه.
1.0.3
- تغییر نام نمایشی و دامنه متنی افزونه به شناسه متمایز حمید.
- درخواست نامک (اسلاگ) جدید افزونه در مخزن وردپرس:
hamid. - مستندسازی سرویسهای شخص ثالث (تلگرام، بله، ip-api.com) در فایل ریدمی.
- حذف داراییهای دایرکتوری مخزن وردپرس (بنرها/آیکونها) از بسته دانلودی افزونه.
1.0.1
- رفع خطای نبود توضیح مترجم برای رشته شمارش گفتگوها (WordPress.WP.I18n.MissingTranslatorsComment).
- نادیدهگرفتن هشدار کاذب اعتبارسنجی نانس در آزمایشکننده اتصال ایجکس (نانس در verify_request() اعتبارسنجی میشود).
- نادیدهگرفتن هشدارهای کوئری مستقیم پایگاه داده در uninstall.php (کوئری پاکسازی یکباره عمدی).
1.0.0
- انتشار نخستین.
- توزیعکننده چندپلتفرمی برای تلگرام و بله با تنظیمات مجزا برای هر پلتفرم.
- پیامهای قالببندیشده با مارکداون همراه با توابع فرار امن برای کاراکترها.
- صف ارسال ناهمگام با کران وردپرس همراه با ارسال دستی و عیبیابی تحویل.
- اعلانها برای نوشتهها، کاربران، ورودها، دیدگاهها، فرمها (CF7، WPForms، Ninja Forms، Elementor Pro، MC4WP)، ووکامرس و WP Activity Log.
- آزمایشکننده داخلی اتصال و شناسیاب گفتگو برای هر پلتفرم.
- پشتیبانی از نقاط پایانی سفارشی API و پروکسی HTTP.
- ادغام اختیاری با Abilities API / MCP.
- کد کوتاه
[pulse_notify]و اکشنpulse_send_messageبرای توسعهدهندگان.