Init Chat Engine – Real-Time, Community, Extensible

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.

Shortcode [init_chat_stats] also accepts room to show statistics for a single room (e.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 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

init_plugin_suite_chat_engine_message_saved (action) Fired after a message is stored. Applies to: POST /send Params: int $message_id , string $message , int|null $user_id , string $display_name , string $room (added in 1.3.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.