Badwolf Web IRC Client
A modern, feature-rich WebSocket IRC client for WordPress. Connect your website visitors to your IRC server with real-time chat, private messaging, desktop notifications, and a beautiful tabbed interface. Version 5.2.0 – What’s New 🔧 WordPress 6.9 Compatibility FIXED: Plugin now works perfectly with WordPress 6.9 FIXED: Script loading issues with block themes and Full Site Editing (FSE) FIXED: Configuration passing to JavaScript 🔌 WebSocket Improvements FIXED: Connection stability issues FIXED: Binary WebSocket data handling ADDED: IRC subprotocol support for UnrealIRCd ⚙️ User Experience ADDED: Settings link in plugin list for easy access IMPROVED: Error handling and logging IMPROVED: Connection reliability Features ✅ Real-time IRC chat via secure WebSocket (wss://) ✅ Private messaging between users ✅ Desktop notifications for mentions and PMs ✅ Multiple channel support with tabbed interface ✅ User list with right-click context menus ✅ Command history (use arrow keys) ✅ Auto-reconnection with smart retry logic ✅ Customizable themes (light/dark) ✅ Mobile-responsive design ✅ IRC commands support (/nick, /join, /part, /msg, /me) ✅ Tab completion for nicknames ✅ Unread message badges ✅ Message history (500 messages per channel) Requirements WordPress: 5.0 or higher (tested up to 6.9) PHP: 7.4 or higher IRC Server: UnrealIRCd 6.x with WebSocket support (recommended) SSL Certificate: Valid SSL/TLS certificate for secure WebSocket (wss://) Configuration WordPress Settings Navigate to Settings → Badwolf Web IRC Client and configure: WebSocket URL: Your IRC server WebSocket URL (e.g., wss://irc.example.com:7443) Default Channel: IRC channel to join (e.g., #general) Nickname Prefix: Prefix for auto-generated nicknames (e.g., guest) Real Name: Default real name for users Theme: Light or Dark theme Auto Connect: Automatically connect when page loads UnrealIRCd Server Configuration Your UnrealIRCd server must have WebSocket support enabled: `conf Load WebSocket module loadmodule “websocket”; Configure WebSocket listener listen { ip *; port 7443; options { tls; websocket; } tls-options { certificate “/path/to/fullchain.pem”; key “/path/to/privkey.pem”; options { no-client-certificate; } } } ` SSL Certificate Setup (Let’s Encrypt) `bash Install certbot if not already installed sudo apt-get install certbot Get certificate for your IRC domain sudo certbot certonly –standalone -d irc.yourdomain.com Copy certificates to UnrealIRCd sudo cp /etc/letsencrypt/live/irc.yourdomain.com/fullchain.pem /path/to/unrealircd/conf/tls/ sudo cp /etc/letsencrypt/live/irc.yourdomain.com/privkey.pem /path/to/unrealircd/conf/tls/ Set correct permissions sudo chown unrealircd:unrealircd /path/to/unrealircd/conf/tls/*.pem sudo chmod 600 /path/to/unrealircd/conf/tls/privkey.pem sudo chmod 644 /path/to/unrealircd/conf/tls/fullchain.pem Restart UnrealIRCd cd /path/to/unrealircd ./unrealircd restart ` Auto-Renewal Setup Create a renewal hook to automatically copy certificates: `bash Create renewal hook script sudo nano /etc/letsencrypt/renewal-hooks/deploy/copy-to-unrealircd.sh ` Add this content: `bash !/bin/bash cp /etc/letsencrypt/live/irc.yourdomain.com/fullchain.pem /path/to/unrealircd/conf/tls/ cp /etc/letsencrypt/live/irc.yourdomain.com/privkey.pem /path/to/unrealircd/conf/tls/ chown unrealircd:unrealircd /path/to/unrealircd/conf/tls/*.pem chmod 600 /path/to/unrealircd/conf/tls/privkey.pem chmod 644 /path/to/unrealircd/conf/tls/fullchain.pem /path/to/unrealircd/unrealircd rehash ` Make it executable: `bash sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/copy-to-unrealircd.sh ` Usage Basic Shortcode ` [web_irc_client] ` Shortcode with Attributes ` [web_irc_client theme=”dark” width=”100%” height=”600px”] ` Available attributes: theme – Override theme (light or dark) width – Set custom width (default: 100%) height – Set custom height (default: 70vh) IRC Commands Users can use standard IRC commands: /nick newname – Change nickname /join #channel – Join a channel /part – Leave current channel /msg username message – Send private message /me action – Send action message /help – Show available commands Troubleshooting Connection Issues Problem: “Reconnecting…” message appears Solutions: Verify UnrealIRCd is running: ps aux | grep unrealircd Check port is listening: sudo netstat -tlnp | grep 7443 Verify SSL certificate is valid and not expired Check UnrealIRCd logs: tail -f /path/to/unrealircd/logs/ircd.log Test WebSocket connection: https://www.piesocket.com/websocket-tester SSL Certificate Errors Problem: Certificate expired or invalid Solution: `bash Check certificate expiry sudo certbot certificates Renew if needed sudo certbot renew –force-renewal Copy to UnrealIRCd and restart sudo cp /etc/letsencrypt/live/irc.yourdomain.com/*.pem /path/to/unrealircd/conf/tls/ ./unrealircd restart ` Plugin Not Loading Problem: IRC client doesn’t appear on page Solutions: Verify shortcode is correct: [web_irc_client] Clear WordPress cache Clear browser cache (Ctrl+Shift+R) Check browser console for JavaScript errors (F12) Verify WebSocket URL is configured in plugin settings WordPress 6.9 Issues Problem: Plugin stopped working after WordPress 6.9 update Solution: Update to version 5.2.0 which includes WordPress 6.9 compatibility fixes. Support GitHub: https://github.com/badwolf1972/web-irc-client Issues: https://github.com/badwolf1972/web-irc-client/issues WordPress Support: https://wordpress.org/support/plugin/badwolf-web-irc-client/ Credits Author: Martin Cooper (badwolf72) Website: https://www.oo3dmodels.com License: GPL v2 or later
Top keywords
- unrealircd31×3.92%
- irc23×2.91%
- path16×2.02%
- websocket15×1.90%
- path to unrealircd14×1.77%
- pem13×1.64%
- sudo13×1.64%
- tls13×1.64%
- conf12×1.52%
- com11×1.39%
- conf tls11×1.39%
- unrealircd conf11×1.39%
AI Chat App – Live Agent Handover, Help Docs,
⚠️ This plugin is being discontinued. We recommend switching to Echo Knowledge Base which includes a free, more powerful AI Chat. Features not available in KB AI Chat: FAQs in the chat widget, article search in the chat widget, and direct contact form in the chat widget. Free KB AI Chat features: * Built-in ChatGPT and Google Gemini support * AI training from your KB articles * Source citations in AI responses * Chat history and analytics * AI Smart Search PRO features: * Agent Handoff and Feedback * Email Notifications * PDF Training Data Learn more about Echo Knowledge Base. ✅ AI Chat Integration AI Chat can answer questions based on content from your Knowledge Base, FAQs, internal documentation, notes, pages, or any other information source. 73 % fewer repeat tickets (our own numbers) After enabling AI Chat, we saw a 73 percent drop in repetitive questions response times shrank, customers got answers faster, and the team could finally tackle higher-value projects without hiring extra staff. Why Customers Love It Answers in Seconds, Day or Night The bot reads your KB articles, FAQs, pages, and internal notes, then delivers clear replies before a ticket ever lands in your inbox. Set-Up in a Coffee Break A guided wizard walks you from install to “live” in under 30 minutes. No coding, no APIs, no fuss. Visible ROI, Fast Most teams cut repeat questions by the first week freeing staff for revenue-generating work instead of copy-and-paste responses. Built-In Extras Content Gap Alerts – Flags missing or outdated KB articles so you fix an issue once and never hear about it again. Pain-point analytics – Real-time dashboards surface the topics that frustrate users the most, turning support data into a product roadmap. Smart learning – As you update or add content, the model re-indexes automatically, keeping answers accurate without manual re-training. Intelligent Agent Handover – Multiple triggers ensure users get human help when needed: Keyword Detection: Automatically offers agent support when users mention terms like “human”, “agent”, or “support” Sentiment Analysis: Detects frustrated users through thumbs down feedback and offers immediate human assistance Always-On Option: Display a persistent “Talk to Agent” button for instant human connection Powered by AI Engine, the leading WordPress AI plugin that also drives site-wide content and image generation. Intelligent Agent Handover Features Our smart handover system ensures no customer gets stuck: Multi-Trigger System – Detects when users need human help through keywords, negative feedback, or manual request One-Click Setup – Configure agent buttons, keywords, and routing in minutes Custom Workflows – Route to different teams based on keywords or customer type (beta) Our AI integration is powered by AI Engine, the leading WordPress AI plugin, which supports not only your chat but also site editing and image generation needs. Result: fewer tickets, happier users, and support staff who finally have time for the work that moves your business forward. For detailed setup instructions, visit our AI Chat Integration Guide ✅ Contact Form Add contact form to any page Get instant email notifications for inquiries Track which pages generate inquiries Ensure no customer question goes unanswered ✅ FAQs Create custom questions and answers Display FAQs on any page Share FAQs across multiple pages Customize content for individual pages ✅ Search Search FAQs and documentation Integrate with Echo Knowledge Base Search posts and custom post types Quick access to relevant content ✅ Contact Options Add phone support link Include custom URL links Multiple contact methods Easy access to support ✅ Customization Match your website’s branding Customize widget appearance Adjust colors and styles Flexible design options See the AI Chat in action. Open it in the right bottom corner of our website: AI Chat Demo ⭐ How Will AI Chat Assist My Customers? Your customers can get instant answers to their questions through AI Chat, Phone, or FAQs. The AI Chat assistant provides 24/7 automated support by learning from your knowledge base and documentation. AI Chat widget provides FAQs, search, and a contact form. The contact form is available for user queries and issue submissions. Easy-to-find support questions can be displayed on any page. ⭐ KEY FEATURES Quick, five-minute setup. Intelligent agent handover with keyword detection and sentiment analysis. Full conversation context preserved during agent transfers. A lightweight and customizable widget that works great with your branding. Supports RTL and WCAG accessibility. Responsive design that works with any theme. ⭐ WHY CHOOSE AI CHAT WIDGET? Innovative features and ongoing improvements Friendly and timely 24/7 support Integrated with Echo Knowledge Base Unlimited AI Chat widgets and FAQs See our AI Chat documentation here — ⭐ OUR FREE COMPLEMENTARY PLUGINS ⭐ ✅ Echo Knowledge Base is a documentation plugin for WordPress. Create knowledge base, docs, FAQs, and wikis easily. Learn More ✅ Creative Add-Ons for Elementor helps you write articles and documents faster and more easily using our powerful and practical Elementor widgets. Learn More ✅ Show IDs reveals IDs on admin screens that list posts, pages, custom post types and taxonomies, and others. Learn More ✅ Scroll Down Arrow Scroll Down Arrow is an easy-to-use WordPress plugin that displays a downward-pointing arrow. It provides users with a visual cue that there is more content further down the page.