افزونه ارسال خودکار نوشته به تلگرام

اگر مدیر یک سایت خبری، وبلاگ یا فروشگاه اینترنتی هستید و می‌خواهید هر بار که محتوای تازه‌ای در وردپرس منتشر می‌کنید، همان لحظه در کانال تلگرامتان هم دیده شود، دیگر لازم نیست این کار را به‌صورت دستی و کپی/پیست انجام دهید. افزونه ارسال خودکار نوشته به تلگرام با نام WP Telegram Publisher دقیقاً برای حل همین مشکل ساخته شده است: اتصال مستقیم وردپرس به ربات تلگرام و ارسال خودکار پست‌ها و صفحات به یک یا چند کانال، با قالب پیام دلخواه شما.

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

اهمیت اتصال وردپرس به تلگرام

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

افزونه WP Telegram Publisher

افزونه فارسی و رایگان WP Telegram Publisher یک افزونه وردپرسی است که از طریق API رسمی تلگرام به ربات تلگرام شما متصل می‌شود و هر بار که یک نوشته، برگه، محصول یا هر محتوای جدیدی منتشر می‌شود، پیام متناظر آن را به کانال‌های تعریف‌شده ارسال می‌کند.

امکانات کلیدی افزونه

• ارسال خودکار: با انتشار هر پست یا برگه، پیام به‌صورت خودکار به کانال‌های پیکربندی شده ارسال می‌شود.
• پشتیبانی از چند کانال: می‌توانید همزمان به چند کانال تلگرام متصل شوید و برای هرکدام تنظیمات جداگانه تعریف کنید.
• قالب پیام دلخواه: با استفاده از پارامترهایی مثل {title}، {excerpt} و {url} می‌توانید متن پیام را کاملاً مطابق سبک خودتان طراحی کنید.
• ارسال تصویر شاخص: تصویر شاخص پست به صورت خودکار به همراه پیام در تلگرام نمایش داده می‌شود.
• دکمه‌های اینلاین: دکمه «ادامه مطلب» با چند استایل رنگی (پیش‌فرض، آبی، سبز، قرمز) قابل افزودن به پیام است.
• ارسال دستی: از داخل ادیتور وردپرس، با یک کلیک می‌توانید پست را به صورت دستی نیز به تلگرام بفرستید.
• کنترل تک‌تک پست‌ها: در صورت نیاز می‌توانید یک پست خاص را از ارسال به تلگرام مستثنی کنید.
• لاگ کامل پیام‌ها: تمام پیام‌های ارسالی همراه با زمان دقیق، وضعیت تحویل و پیام خطا (در صورت بروز) ثبت و قابل بررسی هستند.
• پشتیبانی از انواع پست: علاوه بر نوشته‌های عادی، از صفحات، محصولات و هر نوع پست سفارشی عمومی نیز پشتیبانی می‌کند.
• چندزبانه و فارسی: رابط کاربری افزونه به طور کامل از i18n استاندارد وردپرس استفاده می‌کند و ترجمه فارسی نیز ارائه شده است.
• آدرس API سفارشی: امکان تعریف یک آدرس پایه جایگزین برای API تلگرام، مناسب برای زیرساخت‌های پروکسی یا پیاده‌سازی‌های خاص.
• فوتر اختصاصی هر کانال: برای هر کانال می‌توان یک متن پایانی (فوتر) جداگانه تعریف کرد.
• متن‌باز و رایگان: افزونه به صورت متن‌باز و رایگان، تحت لایسنس GPLv2 منتشر شده است.

این افزونه برای چه کسانی مناسب است؟

• سایت‌های خبری که نیاز به انتشار سریع و خودکار محتوا در کانال تلگرام دارند.
• وبلاگ‌نویسان و تولیدکنندگان محتوا که می‌خواهند مخاطبان تلگرامی خود را از دست ندهند.
• فروشگاه‌های اینترنتی برای اطلاع‌رسانی محصولات و مطالب جدید.
• مدیران چند کانال تلگرامی که به دنبال یک منبع واحد برای انتشار محتوا هستند.

پیش‌نیازهای استفاده از افزونه

پیش از نصب، باید موارد زیر را در اختیار داشته باشید:

• نسخه PHP برابر یا بالاتر از 7.0
• نسخه وردپرس برابر یا بالاتر از 5.0
• یک توکن معتبر ربات تلگرام (از طریق BotFather قابل دریافت است)
• دسترسی ادمین به کانال تلگرامی که می‌خواهید پیام‌ها در آن منتشر شود

آموزش نصب و راه‌اندازی گام‌به‌گام

گام اول: ساخت ربات تلگرام

1. به ربات رسمی BotFather@ در تلگرام یک پیام بدهید تا مکالمه شما شروع شود.
2. دستور newbot/ را برای بات فادر ارسال کنید.
3. مراحل ساخت ربات را طی کنید و یک نام برای آن انتخاب کنید.
4. توکن API که بات فادر در اختیارتان قرار می‌دهد را کپی کرده و در جای امنی نگهداری کنید.

گام دوم: نصب افزونه

1. فایل افزونه را از انتهای همین نوشته یا گیت‌هاب دانلود کنید.
2. از منوی «افزونه‌ها» در پنل مدیریت وردپرس، افزونه را نصب و فعال کنید.
3. به مسیر تنظیمات ← ارسال به تلگرام بروید تا پیکربندی را شروع کنید.

گام سوم: پیدا کردن شناسه کانال (Channel ID)

1. کانال تلگرامی خود را ایجاد یا انتخاب کنید.
2. ربات ساخته شده را به عنوان ادمین به کانال اضافه کنید.
3. یک پیام آزمایشی در کانال ارسال کنید.
4. آدرس زیر را متناسب با ربات خود در مرورگر باز کنید (به‌جای {TOKEN} توکن ربات خود را قرار دهید):
5. در خروجی JSON، شناسه چت کانال را پیدا کنید؛ معمولاً با عدد 100- شروع می‌شود.

https://api.telegram.org/bot{TOKEN}/getUpdates

گام چهارم: تکمیل تنظیمات افزونه

در صفحه تنظیمات افزونه، موارد زیر را وارد کنید:

• توکن ربات تلگرام: همان توکنی که از بات فادر گرفتید.
• کانال‌ها: نام نمایشی کانال، شناسه چت (Channel ID) و در صورت تمایل یک فوتر اختصاصی.
• نوع پست‌ها: انتخاب اینکه کدام نوع محتوا (نوشته،‌ برگه یا پست سفارشی) به تلگرام ارسال شود.
• متن دکمه ادامه مطلب: به‌صورت پیش‌فرض «ادامه مطلب» است که قابل تغییر است.
• استایل دکمه: انتخاب از میان حالت‌های پیش‌فرض، آبی، سبز یا قرمز.

نحوه استفاده از افزونه

ارسال خودکار هنگام انتشار

هر بار که یک نوشته یا برگه جدید منتشر می‌شود، افزونه به صورت خودکار وضعیت ارسال آن را بررسی، پیام را بر اساس قالب تعریف شده تولید می‌کند. سپس تصویر شاخص (در صورت وجود) را پیوست و در نهایت پیام را همراه با دکمه «ادامه مطلب» به همه کانال‌های پیکربندی‌شده ارسال می‌کند.

ارسال دستی از داخل ادیتور

اگر بخواهید یک محتوای خاص را بدون انتظار برای انتشار خودکار به تلگرام بفرستید، کافی است در ادیتور پست، باکس «ارسال به تلگرام» در ستون کناری را پیدا کرده و روی دکمه «بفرست به تلگرام» کلیک کنید. نتیجه ارسال بلافاصله نمایش داده می‌شود.

مستثنی کردن یک پست از ارسال

برای محتوایی که نمی‌خواهید در تلگرام منتشر شود، در همان باکس کناری گزینه «به تلگرام ارسال نشود» را فعال کرده و پست را ذخیره کنید.

پیگیری وضعیت ارسال

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

سفارشی‌سازی قالب پیام

افزونه به صورت پیش‌فرض از یک قالب استفاده می‌کند، اما شما می‌توانید آن را کاملاً مطابق نیاز خود بازنویسی کنید:

<b>{title}</b>

{excerpt}

<i>مشاهده مقاله کامل:</i> {url}

پارامترهای قابل استفاده در قالب پیام عبارت‌اند از:

• {title} — عنوان نوشته
• {excerpt} — چکیده نوشته
• {url} — آدرس کامل نوشته
• {content} — محتوای کامل نوشته (در صورت نیاز)
• {tags} — برچسب‌های نوشته
• {categories} — دسته‌بندی نوشته

سفارشی‌سازی آدرس API

به دلیل فیلترینگ اینترنت در ایران، ممکن است دسترسی به APIهای سرویس‌هایی مانند تلگرام و اینستاگرام از طریق سرورهای داخل کشور امکان‌پذیر نباشد. در نتیجه، درخواست‌هایی که مستقیماً به این APIها ارسال می‌شوند، ممکن است با شکست مواجه شوند یا پاسخ‌های ناموفقی ارائه دهند. برای اطمینان از ارتباط API قابل اعتماد، افزونه WP Telegram Publisher با بهره‌گیری از ورکرهای کلودفلر، یک روش برای دور زدن این محدودیت‌ها و هدایت درخواست‌ها از طریق یک نقطه پایانی قابل دسترسی پیشنهاد می‌کند که از قسمت سفارشی‌سازی API می‌توانید آن را تعریف کنید.

معماری و ساختار فنی افزونه

این افزونه با معماری شیءگرا (OOP) نوشته شده و شامل سه بخش اصلی است: کلاس اصلی افزونه، مدیریت تنظیمات و ماژول ارتباط با API تلگرام؛ ساختاری که نگهداری و توسعه آن را در آینده ساده می‌کند.

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

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

یکپارچگی با Telegram Bot API

افزونه از دو متد اصلی Telegram Bot API استفاده می‌کند:

• متد sendMessage برای ارسال پیام‌های متنی همراه با دکمه‌های اختیاری
• متد sendPhoto برای ارسال پیام‌هایی که تصویر شاخص دارند

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

پشتیبانی چندزبانه و فارسی‌سازی

افزونه WP Telegram Publisher با تکست‌دامین wp-telegram-publisher به‌طور کامل بین‌المللی‌سازی شده است. ترجمه فارسی به‌صورت پیش‌فرض در پوشه languages ارائه شده است؛ بنابراین کاربران فارسی‌زبان می‌توانند تمام رابط کاربری افزونه را به فارسی مشاهده کنند.

دریافت و نصب افزونه

برای دریافت آخرین نسخه افزونه WP Telegram Publisher و مشاهده جزئیات فنی بیشتر، می‌توانید به گیت‌هاب من مراجعه کنید.

اگر در زمینه این افزونه سوالی داشتید یا به مشاوره و پشتیبانی نیاز داشتید، می‌توانید از طریق کانال تلگرام byreza_net@ یا شناسه تلگرامی reza_qalekhani@ با من در ارتباط باشید.

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

افزونه WP Telegram Publisher با ترکیب سادگی در راه‌اندازی و قابلیت‌های پیشرفته‌ای مثل قالب‌بندی پیام، چند کاناله بودن، دکمه‌های اینلاین و لاگ کامل، یک راه حل کامل برای انتشار خودکار محتوای وردپرس در تلگرام است. اگر به دنبال راهی برای حذف کارهای تکراری انتشار محتوا در تلگرام و افزایش سرعت اطلاع‌رسانی به مخاطبان خود هستید، این افزونه گزینه مناسبی برای وبسایت وردپرسی شماست.