Init Chat Engine – Real-Time, Community, Extensible

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) — 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.