DDChatExtended is an extended live chat module for FreeScout helpdesk. It provides an interactive real-time website chat widget for visitors and a full-featured operator console inside FreeScout.
Background: This module was created internally because the official standard FreeScout Chat module was too basic for our daily support workflow. It adds essential features like focus-aware read receipts (
✓/✓✓), advanced visitor tracking, customizable keyboard behavior, sound notification controls, and greeting banners.
- Real-Time Live Chat: Instant two-way communication between website visitors and support operators.
- Focus-Aware Read Receipts: WhatsApp-style delivery checkmarks (
✓Delivered,✓✓Read) that only trigger when the chat tab is actively focused. - Customizable Greeting Banner: Warm welcome card displayed to new visitors, customizable per mailbox in settings.
- Enter Key Configuration: Toggle between Enter to send (Shift+Enter for new line) or Enter for new line (use Send button).
- Sound Notifications: Audio alerts for new incoming visitor messages with optional continuous ringing mode for background tabs.
- Visitor Tracking & Metadata: Displays visitor IP address, country flag, city, browser, OS, and page breadcrumb navigation history in the operator view.
- Typing Indicators: Shows real-time typing indicators for both visitors and operators.
- File Attachments: Easy file upload and attachment sharing directly inside the chat window.
- Multi-Language Support: Complete translations for 14 languages (
cs,de,en,es,fi,fr,he,it,nl,no,pt-BR,pt-PT,ru,sk).
- Download or clone this repository into the
Modules/DDChatExtendeddirectory of your FreeScout installation. - Navigate to Manage -> Modules in your FreeScout admin panel.
- Activate the DDChatExtended module.
- Configure widget options under Manage -> Mailboxes -> [Select Mailbox] -> Chat.
- FreeScout helpdesk v1.18.0 or higher
- PHP 8.1 or higher (PHP 8.x)
Licensed under the GNU General Public License v3.0 (GPLv3).