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

Sergey Ivanov

NS Chat Plugin enables real-time communication between WordPress users using WebSocket technology, powered by the Workerman library.
Key Features: 
* Real-time private chat between users 
* Visual unread message indicators 
* Persistent chat history stored in the database 
* Lightweight modular JS + PHP architecture 
* Automatic migration and sync of WP users to chat system 
* Linux daemon service with SSL support for secure connections 
* Future-ready integration with NFS or AWS S3 for file upload/download
Planned Features: 
* Message editing and deletion 
* Read receipt indicators (message seen) 
* File attachments with optional NFS or AWS S3 integration
Ideal for community websites, intranets, or any platform requiring internal messaging without third-party services.
For integration help or consulting on adapting the plugin to your project, contact the developer at: ns.group.tech@gmail.com
<h3>WebSocket Server Setup (Linux with SSL)</h3>
<ol>
<li>
Create a systemd service file: 
<code>bash 
sudo vim /etc/systemd/system/websocket_server.service</code>
</li>
<li>
Paste the following content: 
<code>bash 
[Unit] 
Description=WebSocket Server for NS Chat (SSL) 
After=network.target 
[Service] 
ExecStart=/usr/bin/php /file/to/path/yourdomain/wp-content/plugins/ns-chat/server.php start 
Restart=always 
RestartSec=25 
User=www-data 
Group=www-data 
StandardOutput=file:/var/log/websocket_server.out.log 
StandardError=file:/var/log/websocket_server.err.log 
[Install] 
WantedBy=multi-user.target</code>
</li>
<li>
Add SSL context in <code>server.php</code>: 
<code>php 
$context = [ 
'ssl' => [ 
 'local_cert' => '/path/to/file.crt', 
 'local_pk' => '/path/to/file.key', 
 'verify_peer' => false, 
] 
];</code>
</li>
<li>
Set permissions for plugin folder: 
<code>bash 
sudo chown -R www-data:www-data /path/to/ns-chat/ 
sudo chmod -R 775 /path/to/ns-chat/</code>
</li>
<li>
Reload and start the daemon: 
<code>bash 
sudo systemctl daemon-reload 
sudo systemctl enable websocket_server --now 
sudo systemctl restart websocket_server 
sudo systemctl status websocket_server</code>
</li>
<li>
Check logs if needed: 
<code>bash 
/var/log/websocket_server.out.log 
/var/log/websocket_server.err.log</code>
</li>
</ol>
<h3>Custom Port Configuration</h3>
By default, the WebSocket server listens on port 2346.
To use a different port:
<ol>
<li>Change the port in <code>server.php</code>: 
<code>php 
$wsWorker = new Worker('websocket://0.0.0.0:2346', $context);</code></li>
<li>
Change the port in <code>ns-chat.php</code>: 
<code>php 
$ws_port = 2346;</code>
</li>
<li>
You can check and change the port in <code>chat-ui.js</code>: 
<code>js 
const port = nschat_data.wsPort || 2346;</code>
</li>
<li>
If the port is closed, then open a new port on your server’s firewall: 
<code>bash 
sudo ufw allow <your-port>/tcp 
sudo firewall-cmd --permanent --add-port=<your-port>/tcp 
sudo firewall-cmd --reload 
sudo iptables -A INPUT -p tcp --dport <your-port> -j ACCEPT 
sudo iptables-save > /etc/iptables/rules.v4</code>
</li>
</ol>
<h3>Database Tables</h3>
The plugin creates and uses the following tables:
<ul>
<li><code>wp_ns_chat_dialogues</code></li>
<li><code>wp_ns_chat_messages</code></li>
<li><code>wp_ns_chat_users</code></li>
</ul>
Tables are created and populated automatically on plugin activation.
<h3>User Synchronization</h3>
<ol>
<li>Initial migration of all users from <code>wp_users</code> to <code>wp_ns_chat_users</code> on plugin activation.</li>
<li>New registrations are handled by: 
<code>php 
add_action('user_register', 'ns_chat_add_user_on_registration');</code></li>
<li>Profile updates are synced via: 
<code>php 
add_action('profile_update', 'ns_chat_update_user_data');</code> 
You may bind these functions to custom hooks based on your app’s logic.</li>
</ol>
<h3>License</h3>
GPLv2 or later

NS Chat

Real-time WebSocket chat for WordPress with user sync and message history.

Badwolf Web IRC Client vs NS Chat