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>Image Sharing: Upload and share images directly in chat with drag-and-drop support</li>
<li>Custom Avatars: Personalized user avatars with upload, crop, and preview functionality</li>
<li>Smart Image Processing: Automatic optimization, resizing, and format conversion (WebP support)</li>
<li>Performance Optimized: Memory-efficient processing with caching and lazy loading</li>
<li>Mobile-First Images: Touch-friendly upload interface with responsive image display</li>
<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.

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.

Chat for WebIRC vs NS Chat