badwolf72

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.
<h3>Version 5.2.0 – What’s New</h3>
<h3>🔧 WordPress 6.9 Compatibility</h3>
<ul>
<li>FIXED: Plugin now works perfectly with WordPress 6.9</li>
<li>FIXED: Script loading issues with block themes and Full Site Editing (FSE)</li>
<li>FIXED: Configuration passing to JavaScript</li>
</ul>
<h3>🔌 WebSocket Improvements</h3>
<ul>
<li>FIXED: Connection stability issues</li>
<li>FIXED: Binary WebSocket data handling</li>
<li>ADDED: IRC subprotocol support for UnrealIRCd</li>
</ul>
<h3>⚙️ User Experience</h3>
<ul>
<li>ADDED: Settings link in plugin list for easy access</li>
<li>IMPROVED: Error handling and logging</li>
<li>IMPROVED: Connection reliability</li>
</ul>
<h3>Features</h3>
<ul>
<li>✅ Real-time IRC chat via secure WebSocket (wss://)</li>
<li>✅ Private messaging between users</li>
<li>✅ Desktop notifications for mentions and PMs</li>
<li>✅ Multiple channel support with tabbed interface</li>
<li>✅ User list with right-click context menus</li>
<li>✅ Command history (use arrow keys)</li>
<li>✅ Auto-reconnection with smart retry logic</li>
<li>✅ Customizable themes (light/dark)</li>
<li>✅ Mobile-responsive design</li>
<li>✅ IRC commands support (/nick, /join, /part, /msg, /me)</li>
<li>✅ Tab completion for nicknames</li>
<li>✅ Unread message badges</li>
<li>✅ Message history (500 messages per channel)</li>
</ul>
<h3>Requirements</h3>
<ul>
<li>WordPress: 5.0 or higher (tested up to 6.9)</li>
<li>PHP: 7.4 or higher</li>
<li>IRC Server: UnrealIRCd 6.x with WebSocket support (recommended)</li>
<li>SSL Certificate: Valid SSL/TLS certificate for secure WebSocket (wss://)</li>
</ul>
<h3>Configuration</h3>
<h3>WordPress Settings</h3>
Navigate to Settings → Badwolf Web IRC Client and configure:
<ul>
<li>WebSocket URL: Your IRC server WebSocket URL (e.g., <code>wss://irc.example.com:7443</code>)</li>
<li>Default Channel: IRC channel to join (e.g., <code>#general</code>)</li>
<li>Nickname Prefix: Prefix for auto-generated nicknames (e.g., <code>guest</code>)</li>
<li>Real Name: Default real name for users</li>
<li>Theme: Light or Dark theme</li>
<li>Auto Connect: Automatically connect when page loads</li>
</ul>
<h3>UnrealIRCd Server Configuration</h3>
Your UnrealIRCd server must have WebSocket support enabled:
<pre><code>`conf
</code></pre>
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; 
 } 
 } 
} 
 `
<h3>SSL Certificate Setup (Let’s Encrypt)</h3>
<pre><code>`bash
</code></pre>
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 
 `
<h3>Auto-Renewal Setup</h3>
Create a renewal hook to automatically copy certificates:
<pre><code>`bash
</code></pre>
Create renewal hook script
sudo nano /etc/letsencrypt/renewal-hooks/deploy/copy-to-unrealircd.sh 
 `
Add this content:
<pre><code>`bash
</code></pre>
!/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:
<pre><code>`bash
</code></pre>
sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/copy-to-unrealircd.sh 
 `
<h3>Usage</h3>
<h3>Basic Shortcode</h3>
<pre><code>`
</code></pre>
[web_irc_client] 
 `
<h3>Shortcode with Attributes</h3>
<pre><code>`
</code></pre>
[web_irc_client theme=”dark” width=”100%” height=”600px”] 
 `
Available attributes:
<ul>
<li><code>theme</code> – Override theme (light or dark)</li>
<li><code>width</code> – Set custom width (default: 100%)</li>
<li><code>height</code> – Set custom height (default: 70vh)</li>
</ul>
<h3>IRC Commands</h3>
Users can use standard IRC commands:
<ul>
<li><code>/nick newname</code> – Change nickname</li>
<li><code>/join #channel</code> – Join a channel</li>
<li><code>/part</code> – Leave current channel</li>
<li><code>/msg username message</code> – Send private message</li>
<li><code>/me action</code> – Send action message</li>
<li><code>/help</code> – Show available commands</li>
</ul>
<h3>Troubleshooting</h3>
<h3>Connection Issues</h3>
Problem: “Reconnecting…” message appears
Solutions:
<ol>
<li>Verify UnrealIRCd is running: <code>ps aux | grep unrealircd</code></li>
<li>Check port is listening: <code>sudo netstat -tlnp | grep 7443</code></li>
<li>Verify SSL certificate is valid and not expired</li>
<li>Check UnrealIRCd logs: <code>tail -f /path/to/unrealircd/logs/ircd.log</code></li>
<li>Test WebSocket connection: <a href="https://www.piesocket.com/websocket-tester" rel="nofollow ugc">https://www.piesocket.com/websocket-tester</a></li>
</ol>
<h3>SSL Certificate Errors</h3>
Problem: Certificate expired or invalid
Solution:
<pre><code>`bash
</code></pre>
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 
 `
<h3>Plugin Not Loading</h3>
Problem: IRC client doesn’t appear on page
Solutions:
<ol>
<li>Verify shortcode is correct: <code>[web_irc_client]</code></li>
<li>Clear WordPress cache</li>
<li>Clear browser cache (Ctrl+Shift+R)</li>
<li>Check browser console for JavaScript errors (F12)</li>
<li>Verify WebSocket URL is configured in plugin settings</li>
</ol>
<h3>WordPress 6.9 Issues</h3>
Problem: Plugin stopped working after WordPress 6.9 update
Solution: Update to version 5.2.0 which includes WordPress 6.9 compatibility fixes.
<h3>Support</h3>
<ul>
<li>GitHub: <a href="https://github.com/badwolf1972/web-irc-client" rel="nofollow ugc">https://github.com/badwolf1972/web-irc-client</a></li>
<li>Issues: <a href="https://github.com/badwolf1972/web-irc-client/issues" rel="nofollow ugc">https://github.com/badwolf1972/web-irc-client/issues</a></li>
<li>WordPress Support: <a href="https://wordpress.org/support/plugin/badwolf-web-irc-client/" rel="ugc">https://wordpress.org/support/plugin/badwolf-web-irc-client/</a></li>
</ul>
<h3>Credits</h3>
<ul>
<li>Author: Martin Cooper (badwolf72)</li>
<li>Website: <a href="https://www.oo3dmodels.com" rel="nofollow ugc">https://www.oo3dmodels.com</a></li>
<li>License: GPL v2 or later</li>
</ul>

Badwolf Web IRC Client

WebSocket IRC client for WordPress with real-time messaging, private chats, and desktop notifications. # Badwolf Web IRC Client - Version 5.2.0

yoren

jtzl

This plugin provides a shortcode that renders a lightweight IRC client written in vanilla JavaScript. It supports direct WebSocket connections to IRC servers (IRCv3-friendly) and includes an optional WebIRC gateway.
Security-conscious defaults:
<ul>
<li>Server allow-list (host:port format), WSS (WebSockets over SSL/TLS) only</li>
<li>Optional WebSocket subprotocols (e.g., <code>text.ircv3.net</code>)</li>
<li>Optional WS path (e.g., <code>/webirc</code>)</li>
<li>Optional CSP connect-src helper (off by default)</li>
<li>Input sanitization and validation</li>
<li>Proper escaping of output</li>
</ul>
Features:
<ul>
<li>Modern Responsive Design: Mobile-first approach with adaptive layouts for all screen sizes</li>
<li>Enhanced Mobile Experience: Touch-optimized interface with proper virtual keyboard support</li>
<li>Smart Responsive Behavior: Overlay sidebar on mobile, collapsible on tablet, side-by-side on desktop</li>
<li>Editable Username: Click-to-edit nickname with real-time validation and user persistence</li>
<li>User Persistence: Automatic nickname saving for logged-in WordPress users</li>
<li>Lightweight vanilla TypeScript/JavaScript implementation (no frameworks)</li>
<li>Fully responsive design with semantic HTML</li>
<li>Internationalization ready (i18n strings)</li>
<li>Configurable server allow-list with strict validation</li>
<li>WebSocket subprotocol support (IRCv3)</li>
<li>Optional WebIRC gateway fallback</li>
<li>Comprehensive IRC slash commands: 30+ commands including /join, /part, /nick, /msg, /whois, /topic, /away, /help, and more</li>
<li>Automatic nickname generation and collision handling</li>
<li>Debug logging and connection status indicators</li>
<li>Optional Content Security Policy (CSP) header generation</li>
<li>WordPress hooks and filters for extensibility</li>
<li>Follows WordPress Coding Standards</li>
</ul>
<h3>Usage</h3>
Basic Usage: 
Simply add the shortcode <code>[chat_webirc]</code> to any page or post where you want the IRC chat to appear. The plugin will use secure default settings to connect to a test IRC server.
Shortcode Examples: 
* Basic: <code>[chat_webirc]</code> – Uses default server and channel 
* Custom channel: <code>[chat_webirc channel="#mychannel"]</code> 
* Custom server: <code>[chat_webirc server="irc.example.com:7443" channel="#general"]</code>
Available IRC Commands: 
Once the chat is loaded, users can use these commands:
Basic Commands: 
* <code>/join #channel</code> – Join a channel 
* <code>/part [#channel]</code> – Leave current or specified channel 
* <code>/nick newname</code> – Change nickname 
* <code>/quit [message]</code> – Disconnect 
* <code>/help</code> – Show all available commands
Communication: 
* <code>/msg <nick> <message></code> – Send private message 
* <code>/notice <target> <message></code> – Send notice message 
* <code>/me <action></code> – Send action message 
* <code>/query <nick></code> – Open private chat context
User & Channel Info: 
* <code>/whois <nick></code> – Get detailed user information 
* <code>/who [channel]</code> – List users in channel 
* <code>/list [pattern]</code> – List available channels 
* <code>/names [channel]</code> – List nicknames in channel 
* <code>/topic [text]</code> – View/set channel topic
Status & Utility: 
* <code>/away [message]</code> – Set away status 
* <code>/back</code> – Remove away status 
* <code>/ping <nick></code> – Ping user 
* <code>/version [nick]</code> – Get version info
Advanced Commands: 
* <code>/ctcp <nick> <command></code> – Send CTCP command 
* <code>/motd [server]</code> – View message of the day 
* <code>/stats <query> [server]</code> – View server statistics 
* <code>/raw <command></code> – Send raw IRC command (if enabled)
Type <code>/help</code> in the chat for the complete command reference.
Configuration: 
Go to Settings → Chat for WebIRC in your WordPress admin to customize servers, channels, and security options.
<h3>Notes</h3>
<ul>
<li>Some public IRC networks may restrict WebSocket connections to certain origins. The included test server permits connections for testing purposes.</li>
<li>Do not send sensitive information. This client is intentionally minimal and does not yet support SASL authentication.</li>
</ul>

Chat for WebIRC

A framework-light WordPress plugin that embeds a WebSocket IRC client.

Badwolf Web IRC Client vs Chat for WebIRC