BuddyBoss Messaging Plugin: Real-Time Chat for Platform & ReadyLaunch
Originally published when Better Messages added the BuddyBoss Theme header replacement in v1.9.9.103–106 (early 2021). The post has been kept up to date as the integration matured — the live unread counter in the profile dropdown, the members-directory call icons, the bbPress reply integration, and the BuddyBoss ReadyLaunch rendering path are all later additions. ReadyLaunch support shipped in v2.15.10 (May 2026).
Better Messages turns BuddyBoss Platform messaging into a modern WordPress-native messenger — real-time delivery on its own WebSocket cloud (no third-party service to manage), group conversations, file uploads, voice messages, voice and video calls, AI bots, end-to-end encryption, web push, and a native mobile app. When activated, Better Messages takes over every BuddyBoss messaging link and auto-disables BuddyBoss Live Messaging to avoid a double-messenger conflict. The integration has two rendering paths — one tuned for the ReadyLaunch theme and one for the classic BuddyBoss Theme — and switches between them automatically based on which one is enabled on the site.
This guide walks through what changes when Better Messages is installed on a BuddyBoss site, how it adapts to ReadyLaunch versus the classic theme, how it integrates with BuddyBoss Friends and Groups, and what the differences are between the free and WebSocket versions.
What changes on a BuddyBoss site#
Once Better Messages is installed:
- BuddyBoss Live Messaging is automatically disabled to avoid a double-messenger conflict
- Every BuddyBoss messages link — header inbox icon, profile dropdown, member-row Message button — now points at the Better Messages inbox
- The profile dropdown unread counter goes live, updating in real time alongside the header inbox icon
- BuddyBoss Friends drives the Friends widget inside the messenger
- BuddyBoss Groups can have paired group chats — members auto-join when they join the BuddyBoss group, auto-leave when they leave
- BuddyBoss Web Push is wired in — push notifications for new messages use BuddyBoss's existing web-push setup, no extra configuration
BuddyBoss ReadyLaunch support#
ReadyLaunch is BuddyBoss's modern, App-style front-end theme. Better Messages ships a dedicated ReadyLaunch rendering path that activates the moment ReadyLaunch is enabled at BuddyBoss → ReadyLaunch — no setting needs to be flipped on the Better Messages side. The integration matches ReadyLaunch's design tokens (typography, primary color, spacing) and the messenger sits flush with the ReadyLaunch content area.
Header inbox dropdown#
The chat-bubble icon in the ReadyLaunch header opens a dropdown listing recent conversations, with a live unread counter on the icon itself. Clicking a thread jumps straight into the conversation without leaving the page.
Full-page messenger on ReadyLaunch#
A Full-page messenger toggle hides the profile avatar, tabs, and right sidebar on the Messages screen so the messenger fills the full ReadyLaunch content area. Companion toggles fine-tune the layout — Full Width Layout removes the page padding so it stretches edge to edge, Page Title shows a Messages heading matching the secondary header used by Forums / Members / Groups, and Hide Mini Widget on Messages Page hides the floating chat bubble while the messenger is already open.
Members directory icons (WebSocket version)#
Each row in the ReadyLaunch members directory and group member list gets Send Message, Audio Call, and Video Call icons next to the native Connect button — styled to match ReadyLaunch's circular icon buttons.
Automatic light / dark mode sync#
ReadyLaunch has a built-in dark mode toggle (or it can be forced to dark via BuddyBoss → Settings → General → ReadyLaunch). The integration listens to the bb-rl-dark-mode class on <body> and switches the messenger to its dark palette automatically — no second toggle to flip.
bbPress in ReadyLaunch#
When bbPress is active alongside ReadyLaunch, every forum reply gets a Private Message entry inside the existing reply actions dropdown — next to Edit, Move, Split, Spam, and Trash — instead of as plain text under the author block. ReadyLaunch organizes reply controls as a dropdown rather than as inline icons, and the integration follows that convention.
Classic BuddyBoss Theme support#
The classic BuddyBoss Theme (pre-ReadyLaunch) is fully supported and shares the same set of full-page layout toggles — Full-page messenger, Page Title, and Hide Mini Widget on Messages Page — in its own settings section. The classic theme path also has its own bbPress integration that places the Private Message link as an inline icon between Reply and More actions, matching the BuddyBoss action-row design.
The header chat-bubble icon carries the same live unread badge and opens a dropdown with the most recent conversations:
BuddyBoss Friends integration#
The Friends widget inside the messenger is populated from BuddyBoss Friends — no separate friends list to maintain.
The widget supports three placements: mini bar, mobile bar, and the standard messenger sidebar. Members start a one-to-one thread by clicking a friend's name.
BuddyBoss Groups integration#
Each BuddyBoss group can have an attached group chat. The chat is created the first time the group is opened in Better Messages; members are synced both ways:
- A user joins a BuddyBoss group → they are added to the group chat
- A user leaves the BuddyBoss group → they are removed from the chat
- A group admin can disable the chat for a specific group at any time
Group chats are full conversations — shared history, mentions, file uploads, reactions, and the rest.
Live unread counter in the profile dropdown#
The Messages item in the BuddyBoss Theme profile dropdown (the menu under the user avatar in the top-right) carries a real-time unread badge. It uses the same blue style as the native Connections / Notifications badges and hides automatically when there is nothing new. On ReadyLaunch the same unread counter is shown on the header chat-bubble icon and the side menu Messages link.
The badge updates instantly with the WebSocket version, and on a short AJAX polling interval with the free version.
Voice and video calls from the members directory (WebSocket version)#
On the WebSocket version, each row in the BuddyBoss members directory and group member list gets dedicated Audio Call and Video Call icons next to the Send Message icon. Clicking the icon starts a one-to-one call without first opening a thread.
The two icons are independent toggles in Better Messages → Settings → Integrations → BuddyBoss. They respect the existing friends-only restriction: if Only Friends Can Call is enabled, non-friends do not see the buttons.
Installing Better Messages on BuddyBoss#
- Install Better Messages from WordPress.org and activate it
- Open WP Admin → Better Messages → Settings → General
- Set Messages Location to Show in BuddyBoss profile — or to a dedicated WordPress page if you prefer a different URL
- Save
That is the entire setup. BuddyBoss Live Messaging is automatically deactivated, every existing BuddyBoss messages link now points at Better Messages, and the appropriate theme path (ReadyLaunch or classic) is selected automatically based on what is enabled on the site.
Free vs WebSocket version for BuddyBoss communities#
| Feature | Free version | WebSocket version |
|---|---|---|
| BuddyBoss Theme + ReadyLaunch integration | yes | yes |
| Header inbox dropdown (ReadyLaunch) | yes | yes |
| Automatic dark mode sync (ReadyLaunch) | yes | yes |
| BuddyBoss Friends and Groups integration | yes | yes |
| Group chats with file uploads | yes | yes |
| Live unread counter on profile dropdown / header | yes (polling) | yes (instant) |
| Real-time delivery | polling | instant |
| One-on-one voice and video calls from members directory and threads | — | yes |
| Group voice and video calls inside any thread | — | yes |
| Web push notifications for new messages | — | yes |
| End-to-end encryption (optional) | — | yes |
For BuddyBoss sites running paid community programs, the WebSocket version is usually worth the upgrade — the call buttons in the members directory turn the community into a one-click voice/video platform without redirecting members to an external service, and real-time delivery removes the polling delay that's visible on busy boards.
Frequently asked questions#
Does Better Messages replace BuddyBoss Live Messaging or coexist with it?#
It replaces it. On activation, BuddyBoss Live Messaging is automatically disabled to avoid a double-messenger conflict. BuddyBoss's underlying message data is preserved.
Does the integration support BuddyBoss ReadyLaunch?#
Yes — ReadyLaunch is supported as a first-class rendering path. The moment ReadyLaunch is enabled at BuddyBoss → ReadyLaunch, Better Messages switches to the ReadyLaunch path automatically and matches the theme's typography, primary color, spacing, and dark mode setting. The classic BuddyBoss Theme path is preserved for sites that have not enabled ReadyLaunch.
Will the BuddyBoss header inbox icon still work?#
Yes — the icon stays where it is, with the same blue badge style, but now opens the Better Messages inbox. On ReadyLaunch the same icon opens a dropdown listing recent conversations.
Does it work with the BuddyBoss app?#
Better Messages has its own iOS and Android app (Capacitor-based) with white-label rebuild support. The BuddyBoss native app uses BuddyBoss's own messaging stack, not Better Messages.
Can members block each other?#
Yes — the User Block feature lets any member block another. Blocked users cannot send new messages or see the blocker online. Admins can also globally block users from Better Messages → Reports.
Does it work with bbPress on BuddyBoss?#
Yes. On the classic BuddyBoss Theme every forum reply gets an inline Private Message icon between the Reply and More actions buttons. On ReadyLaunch the Private Message entry is added to the reply actions dropdown, matching ReadyLaunch's reply-control layout.
See also#
- BuddyBoss integration documentation — full setup reference
- BuddyPress messaging plugin — the BuddyPress counterpart
- Group conversations — how group chats work
- Real-time messaging — what changes with the WebSocket version
- WordPress video call plugin — group calls inside any thread
- WordPress community chat plugin — comparing community platforms