Init Chat Engine – Real-Time, Community, Extensible for WordPress Plugin Directory

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.

GitHub repository: https://github.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

– Guest messaging support (optional)

– Smart polling system (adaptive 3.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

– Template override supported (chatbox.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:

– Translation-ready with full .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

Example: [init_chatbox height="500px" title="Community Chat" theme="modern"]

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

Bypass filtering under custom conditions (VIP, internal users, etc.).

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

Extend chat message data (add flags, metadata, user info, etc.).

Applies to: Backend DB → JSON output

Params: array $message_row, WP_User|null $user

License This plugin is licensed under the GPLv2 or later.

You are free to use, modify, and distribute it under the same license.