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.