توضیحات
کافیچت لایت یک افزونه رایگان و سبک برای گفتوگوی زنده است که وبسایت وردپرسی شما را به پیامرسان بله متصل میکند. بازدیدکنندگان میتوانند مستقیماً از طریق وبسایت با شما گفتگو کنند و شما نیز پیامهای آنها را از طریق ربات بله خود دریافت کرده و به آنها پاسخ دهید.
ویژگیهای کلیدی:
- چت بلادرنگ: پیامرسانی فوری و لحظهای بین بازدیدکنندگان وبسایت و ربات بله شما.
- فرم مهمان: قبل از شروع چت، نام و شماره تلفن بازدیدکننده را دریافت میکند.
- Smart Adaptive Polling: Efficient message checking using Page Visibility API (stops polling when the tab is inactive to save server resources).
- RTL Support: Fully optimized for Persian/Farsi websites with built-in Vazirmatn font.
- Mobile Responsive: Works perfectly on all screen sizes with a beautiful overlay.
- قابل شخصیسازی: موقعیت نمایش، عنوان سربرگ و پیام خوشآمدگویی را به دلخواه خود تغییر دهید.
- Secure: Encrypted PII (Name/Phone/IP) using Libsodium/OpenSSL, nonce verification, and advanced rate limiting.
- CDN Compatible: Correctly identifies real client IPs behind Cloudflare and ArvanCloud.
- سبک و بهینه: بدون وابستگی به jQuery، مبتنی بر JavaScript خالص و با حداقل مصرف منابع.
- یکپارچهسازی وبهوک: انتقال خودکار پیامها از بله به وبسایت شما.
- Admin Dashboard: Full settings panel with debug tools, system info, and conversation logs.
—
برای کاربران فارسیزبان:
این افزونه کاملاً برای سایتهای فارسیزبان بهینهسازی شده است:
✅ ویژگیهای اختصاصی برای ایران:
– پشتیبانی کامل از RTL (راستچین)
– فرم مهمان فارسی با اعتبارسنجی شماره موبایل ایرانی
– پنل ادمین کاملاً فارسی با فونت زیبای وزیر
– اتصال مستقیم به پیامرسان بله
– نمایش ساعت به وقت ایران
– سازگاری کامل با شبکههای توزیع محتوا (CDN) مانند کلودفلر و آروان
✅ نصب آسان:
1. افزونه را نصب و فعال کنید
2. از @BotFather در بله، توکن ربات بگیرید
3. توکن و شناسه چت ادمین را وارد کنید
4. وبهوک را تنظیم کنید
5. ویجت چت بهصورت خودکار نمایش داده میشود
✅ پشتیبانی از هاستهای ایرانی:
– سازگار با هاستهای اشتراکی ایرانی
– پشتیبانی از هاستهایی که هدرهای امنیتی را حذف میکنند
– بهینهسازی شده برای سرورهای ایران
چگونه کار میکند:
- KafiChat Lite را نصب و فعال کنید.
- یک ربات در پیامرسان بله از طریق @BotFather ایجاد کنید.
- توکن ربات و شناسه چت (Chat ID) مدیر را در تنظیمات افزونه وارد کنید.
- وبهوک را برای دریافت پیامها از بله پیکربندی کنید.
- ویجت چت بهصورت خودکار در وبسایت شما نمایش داده میشود.
حریم خصوصی:
KafiChat Lite stores conversation data and messages in your WordPress database. Sensitive guest data (Name, Phone, IP) is encrypted at rest. No data is sent to third-party servers except Bale messenger API. You can configure data retention periods in the settings.
سرویسهای خارجی
این افزونه به پلتفرم پیامرسان بله متصل میشود تا امکان گفتوگوی زنده و مستقیم میان بازدیدکنندگان وبسایت و مدیران سایت را فراهم کند.
این سرویس چیست و برای چه استفاده میشود
بله یک پیامرسان ایرانی است. این افزونه از API ربات بله برای انجام موارد زیر استفاده میکند:
ارسال پیامهای کاربران از وبسایت شما به حساب بله مدیر سایت
دریافت پاسخهای مدیر و نمایش آنها به بازدیدکنندگان وبسایت
راهاندازی وبهوک (Webhook) برای ارسال و دریافت آنی پیامها در زمان واقعی (Real-Time)
چه دادههایی ارسال میشود و در چه زمانی ارسال میشوند
- هنگامی که یک بازدیدکننده از طریق ویجت چت پیام ارسال میکند، متن پیام، نام بازدیدکننده (در صورت وارد شدن) و شماره تلفن (در صورت وارد شدن) به API ربات بله ارسال میشود.
- توکن ربات بله و شناسه چت (Chat ID) مدیر سایت برای احراز هویت و ارسال پیامها به مقصد موردنظر استفاده میشوند.
- تا زمانی که مدیر سایت توکن ربات بله را در تنظیمات افزونه وارد نکند، هیچ دادهای ارسال نخواهد شد.
لینکهای مربوط به شرایط استفاده و سیاستهای سرویس
- شرایط استفاده و سیاست حفظ حریم خصوصی بله: https://bale.ai/terms
- مستندات API ربات بله: https://docs.bale.ai
لایسنس
این افزونه تحت مجوز GPLv2 یا نسخههای جدیدتر منتشر شده است.
اعتبارها
توسعه داده شده توسط کافگرام
نصب
- پوشه
کافیچت لایترا در دایرکتوری/wp-content/plugins/آپلود کنید، یا مستقیماً از طریق صفحه افزونه وردپرس نصب کنید. - افزونه را از طریق صفحه «افزونهها» در وردپرس فعال کنید.
- در پیشخوان وردپرس به مسیر «کافیچت لایت» > «تنظیمات» مراجعه کنید.
- توکن ربات بله و شناسه چت مدیر (Admin Chat ID) را وارد کنید.
- با کلیک روی گزینه «تنظیم وبهوک در بله»، وبهوک را راهاندازی کنید.
- ظاهر و پیامهای افزونه را مطابق نیاز خود سفارشیسازی کنید.
- ابزارک گفتوگو (چت) در وبسایت شما نمایش داده خواهد شد.
سوالات متداول
-
آیا این افزونه با تمامی قالبهای وردپرس سازگار است؟
-
بله! کفیچت لایت از CSS ایزولهشده استفاده میکند و در صورت نیاز از z-index بالا و دستور !important بهره میبرد تا حداکثر سازگاری را با تمامی قالبهای وردپرسی تضمین کند.
-
آیا برای استفاده از این افزونه به حساب کاربری بله نیاز دارم؟
-
بله، برای استفاده از این افزونه به یک حساب کاربری در پیامرسان بله و یک ربات که از طریق @BotFather در بله ایجاد شده باشد، نیاز دارید.
-
آیا این افزونه با مقررات GDPR سازگار است؟
-
بله. شما میتوانید مدت زمان نگهداری اطلاعات را مطابق نیاز خود تنظیم کنید و تمامی دادهها بهصورت کامل روی سرور شما ذخیره میشوند. همچنین فرم گفتوگوی مهمان تنها با رضایت کاربر، نام و شماره تلفن او را دریافت میکند.
-
آیا میتوانم از این افزونه همراه با پیامرسانهای دیگر نیز استفاده کنم؟
-
نسخه رایگان (Lite) تنها از پیامرسان بله پشتیبانی میکند. برای استفاده از تلگرام و پشتیبانی از چندین پلتفرم مختلف، به نسخه حرفهای کافیچت (KafiChat Pro) ارتقا دهید.
-
آیا این افزونه باعث کند شدن وبسایت من میشود؟
-
No. The widget uses vanilla JavaScript (no jQuery), loads asynchronously, and uses smart adaptive polling to minimize server requests.
-
آیا با همه قالبها کار میکند؟
-
بله! این افزونه با تمام قالبهای وردپرس سازگار است.
-
آیا نیاز به اکانت بله دارم؟
-
بله، باید یک اکانت در پیامرسان بله داشته باشید و از @BotFather یک ربات بسازید.
نقد و بررسیها
توسعه دهندگان و همکاران
“کافی چت لایت” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کردهاند.
مشارکت کنندگانترجمه “کافی چت لایت” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
1.0.1
- New: Added Vazirmatn font via CDN for a better Persian typography experience.
- New: Implemented Adaptive Polling using the Page Visibility API to drastically reduce server load.
- Security: Enhanced RateLimiter to detect real client IPs behind CDNs (Cloudflare, ArvanCloud).
- Performance: Fixed N+1 query issue in the admin conversations list for much faster loading.
- DB Schema: Added
search_indexcolumn to conversations table for future-proofing and Pro compatibility. - Compatibility: Fixed a fatal error with the
%iSQL placeholder for WordPress 6.0/6.1. - UX: Logged-in users now bypass the guest form and enter the chat directly.
- UX: Fixed admin spinner alignment.
- Tweak: Extensive optimization and minification of frontend and backend CSS/JS.
- Tweak: Code refactoring (moved direct DB queries to repositories, removed duplicate code).
1.0.0
- انتشار اولیه
- یکپارچهسازی با پیامرسان بله
- فرم گفتوگو برای مهمانان همراه با اعتبارسنجی شماره تلفن
- بهروزرسانی و دریافت پیامها بهصورت لحظهای
- پشتیبانی از زبان های راست به چپ
- طراحی واکنشگرا برای موبایل
- پیشخوان مدیریت همراه با ابزارهای عیبیابی




