About this plugin
Init Chat Engine is a clean and minimal frontend chatbox plugin, designed for homepage or site-wide communication with comprehensive administrative controls.
This plugin is the core user system behind the Init Plugin Suite – optimized for frontend-first interaction, extensibility, and real-time gamification.
com/brokensmile2103/init-chat-engine
Key Features:
Frontend Experience:
– Built with 100% REST API and Vanilla JS
– No jQuery, no bloat – blazing fast
– Fully embeddable via [init_chatbox] shortcode
"] – each room has its own messages, pinned message and limits
– Guest messaging support (optional)
5–10s based on activity, up to 20s when the chatbox is scrolled out of view)
– Browser notifications when new messages arrive
– Scroll-up to load history, scroll-down to auto-scroll
– Optimistic sending & “new message” jump button
– Clean UI with customizable themes
php )
Administrative Control:
– Complete Settings Panel – Basic, Security, and Advanced configurations
– Message Management – Search, view, delete messages with pagination
– User Moderation – Ban/unban users by IP or user ID with expiration
– Rate Limiting – Prevent spam with configurable message limits
– Word Filtering – Block messages containing prohibited words
– Statistics Dashboard – View chat activity, user engagement, and trends
– Cleanup Tools – Automatic and manual cleanup of old messages
– Custom CSS Support – Full styling customization options
Security & Moderation:
– IP-based and user-based banning system
– Configurable rate limiting (messages per minute)
– Word filtering with custom blocked word lists
– Message moderation queue (optional)
– Automatic cleanup of old messages and expired bans
– Admin override capabilities
Multilingual Ready:
pot file included
– Vietnamese translation included
– Easy to translate to any language
Perfect for community-based sites, forums, fanpages, manga readers, SaaS dashboards, customer support, or any interactive chat widget.
Shortcode Attributes
Shortcode [init_chatbox] supports the following attributes:
- height – Set chat height (e.g., height="400px" )
- width – Set chat width (e.g., width="100%" )
- theme – Apply custom theme (e.g., theme="dark" )
- show_avatars – Override avatar setting ( true / false )
- show_timestamps – Override timestamp setting ( true / false )
- title – Add custom chat title
- class – Add custom CSS classes
- id – Set custom container ID
- room – Chat room name (letters, numbers, - and _ ). Leave empty for the default room (the main chat, which keeps all existing messages). Each room has its own messages, pinned message and message limit (e.g. room="vip" )
- allow_guests – Per-room override of the “Allow guests” setting ( yes / no )
- max_messages – Per-room override of the “Maximum Messages” setting (10–10,000)
Example: [init_chatbox height="500px" title="Community Chat" theme="modern"]
Room example: [init_chatbox room="members" title="Members Lounge" allow_guests="no" max_messages="500"]
Only one chatbox per page is supported. Room overrides ( allow_guests, max_messages ) are saved when the shortcode is displayed on published content (not in drafts or previews), so use the same attributes everywhere a room is embedded.
g. [init_chat_stats room="vip"] ); without it, all rooms are counted.
Filters for Developers
This plugin provides filters and actions to allow developers to extend word filtering, message processing, and chat behavior without modifying core files.
init_plugin_suite_chat_engine_word_filter_strategy
Modify word filtering strategy ( substring, word, regex ).
Applies to: Message validation
Params: string $strategy, array $settings, string $message
init_plugin_suite_chat_engine_blocked_words
Modify the blocked-words list before validation.
Applies to: Message validation
Params: array $blocked_words, array $settings, string $message
init_plugin_suite_chat_engine_bypass_filter
).
Applies to: Message validation
Params: bool $bypass, string $message, WP_User|null $user, array $settings
init_plugin_suite_chat_engine_word_block_hit (action)
Triggered when a word filter rule blocks a message.
Applies to: Message validation
Params: string $blocked_word, string $message, string $strategy
init_plugin_suite_chat_engine_enrich_message_row
).
Applies to: Backend DB → JSON output
Params: array $message_row, WP_User|null $user
init_plugin_suite_chat_engine_message_saved (action)
Fired after a message is stored.
Applies to: POST /send
9; '' = default room)
init_plugin_suite_chat_engine_ip_headers
Choose which $_SERVER keys are trusted (in priority order) when detecting the visitor IP used for bans and rate limiting. Default keeps the existing list (Cloudflare / proxy headers first, then REMOTE_ADDR ). Sites not behind a proxy or CDN can return array( 'REMOTE_ADDR' ) to prevent spoofed X-Forwarded-For headers from bypassing IP bans.
Applies to: Ban check, rate limiting, message logging
Params: array $ip_keys
License
This plugin is licensed under the GPLv2 or later.
You are free to use, modify, and distribute it under the same license.