Sten Chat

StenChat — Real-Time Chat for Dolibarr

Instant messaging and peer-to-peer video calling module for Dolibarr ERP/CRM. Enables real-time communication between system users with WebRTC video chat and screen sharing support.

Communication Capabilities

Instant Messaging

• One-to-one conversations between Dolibarr users

• Real-time text messages via AJAX polling

• File attachments (images, documents, etc.)

• Desktop notifications for new messages

• Persistent message history in database

Video Calls (WebRTC)

• Peer-to-peer video calls without intermediate servers

• Start video call via invitation sent as chat message

• "Join video call" button in the invitation message

• Popup modal with local and remote video (jQuery UI Dialog)

• Microphone and camera on/off toggling

• Screen sharing support

• STUN signaling (stun.l.google.com:19302)

• Works on LAN networks and same NAT

• Hang up and automatic signal cleanup

Presence

• Real-time online user indicator

• Periodic heartbeat to detect active connection

System Dependencies

Dolibarr

• Minimum version: 18.0

• Module installed in htdocs/custom/stenchat/

PHP

• Minimum version: 7.2

• Required extensions:

  • pdo_sqlite (for WebRTC signaling table)

  • gd or imagick (for image preview)

  • zip (for file compression)

Web Browser

• WebRTC: Chrome 56+, Firefox 52+, Edge 79+, Safari 12.1+

• Screen Sharing: Chrome 72+, Firefox 66+, Edge 79+

• JavaScript enabled

• Desktop notifications (optional, requires user permission)

Web Server

• Apache or Nginx with PHP configured

• Write permissions in htdocs/custom/stenchat/files/ and htdocs/custom/stenchat/data/

Installation

1. Download the module

text

# Clone from GitLab
git clone git@gitlab.com:jbasisty/dolibarr-chat.git /path/to/dolibarr/htdocs/custom/stenchat

# Or unzip the zip file
unzip module_stenchat-1.0.0.zip -d /path/to/dolibarr/htdocs/custom/

1. Create data directories

text

mkdir -p /path/to/dolibarr/documents/custom/stenchat/files
chmod -R 755 /path/to/dolibarr/documents/custom/stenchat

1. Activate the module in Dolibarr

• Log in to Dolibarr as administrator

• Go to Home → Modules → StenChat Module

• Click Activate

1. Verify installation

• The module automatically creates the necessary tables (llx_stenchat_message, llx_stenchat_signal)

• A new Chat item will appear in the navigation menu

• Click Chat to start using the messaging feature

Module Structure

text

custom/stenchat/
├── ajax/              # AJAX endpoints (messages, signaling, files, max_id)
├── class/             # PHP classes (StenChatDB, StenChatMessage)
├── core/modules/      # Module descriptor (modStenChat.class.php)
├── css/               # Stylesheets
├── js/                # Client-side JavaScript (WebRTC, UI)
├── sql/               # Database schema
├── chat.php           # Main chat page
└── .gitignore

License
GNU General Public License v3.0 or later.

Author
Developed for Dolibarr ERP/CRM.