Better Messages for Ultimate Member: Real-Time Private Messaging

The Ultimate Member integration for Better Messages hooks into every Ultimate Member surface — the profile Messages tab, the Private Message button on user profiles and members directory, and integration with the UM Friends, UM Followers, and UM Groups extensions. If you are using the Ultimate Member Messages add-on, deactivate it after installing Better Messages to avoid a double-messenger conflict.

REQUIREMENTS

To install the plugin ensure that your website running:

WordPress 5.9 or newer
PHP 7.4 or newer

Installation#

How to install Ultimate Member#

Download Ultimate Member from the official WordPress.org repository and install it through the standard plugin flow.

How to install Better Messages with Ultimate Member#

Install Better Messages from Plugins → Add New or by uploading the plugin zip
Activate Better Messages
Create the WordPress page where the Better Messages page will live (or reuse an existing one)
Open Better Messages → Settings and set Messages Location to the page you just created — or set it to Show in Ultimate Member profile to embed Better Messages inside the UM profile Messages tab instead of using a separate page
If the Ultimate Member Messages add-on is still active, deactivate it — it conflicts with Better Messages
Open Better Messages → Settings → Integrations → Ultimate Member to fine-tune the integration

What gets integrated automatically#

When Ultimate Member is detected, Better Messages turns on every UM-specific touch-point with no manual setup:

A Messages tab is added to the Ultimate Member profile for the currently logged-in user; the tab embeds the full Better Messages interface so users never leave their UM profile
A live unread counter badge appears on the Messages tab whenever there are new messages, updating in real time
A Private Message button is added to every user profile (configurable) and to every members directory row (configurable)
All avatars and profile links in the Better Messages interface use Ultimate Member's data — so users land on the UM profile, not the WordPress one
UM Friends drives Better Messages' Friends widget (mini, mobile, and combined variants) and the recipient search inside the New Conversation popup
UM Followers can be used to restrict messaging — only users who follow each other are allowed to start a conversation
UM Groups drives Better Messages' Groups widget; group chats can be created automatically from a UM group, with members joining and leaving in sync

Messages tab in the Ultimate Member profile#

When the logged-in user opens their own UM profile, a new Messages tab is added next to the default tabs (About, Posts, Comments, etc.). Clicking it embeds the full Better Messages interface inside the profile — conversations list, message thread, composer — without leaving the UM layout.

The tab also carries a real-time unread badge: as new messages arrive, a numbered counter appears on the Messages tab label and disappears once everything is read. The badge uses the same live pipeline as the rest of Better Messages, so it updates without a page reload.

Private Message button on user profiles#

Every Ultimate Member user profile gets a Private Message button rendered in the profile's action area (next to Follow / Friend / Settings). Clicking it opens a new conversation with that user — or, if Advanced Mini Chats is enabled, opens a mini chat window without leaving the page.

Private Message button in the members directory#

Every row in the Ultimate Member members directory gets a Private Message button (or a mini-chat trigger, depending on the Advanced Mini Chats setting). The button is injected through Ultimate Member's own AJAX rendering pipeline, so it appears the same way native UM action buttons do — and pagination / search work unchanged.

UM Friends, UM Followers, UM Groups#

Better Messages auto-detects each of the official Ultimate Member extensions and wires them into the messaging layer:

UM Friends — the Better Messages Friends widget is populated from the user's UM friends list. Enable Only Friends Mode to additionally restrict messaging to friends only, and hide non-friends from the recipient search.
UM Followers — enable Only Followers Mode to restrict messaging to users who follow each other. Non-followers cannot start a thread and cannot reply to existing ones.
UM Groups — the Better Messages Groups widget lists every UM group the user belongs to. Each group can optionally have a Better Messages group chat attached: the chat is created the first time the group is opened in Better Messages, and members are added when they join the UM group and removed when they leave. File uploads, email notifications, and push notifications can be toggled per integration.

Settings reference#

All Ultimate Member-specific options live at Better Messages → Settings → Integrations → Ultimate Member.

Setting	What it does
Advanced Mini Chats	Opens a mini chat window instead of redirecting to the Messages page when a Private Message button is clicked. Requires the WebSocket version
Profile Message Button	Show a Private Message button on Ultimate Member user profiles
Members List Message Button	Show a Private Message button in the Ultimate Member members directory
Only Friends Mode	Restricts messaging to friends only; hides non-friends from search. Requires UM Friends
Only Followers Mode	Restricts messaging to users who follow each other. Requires UM Followers
Group Messages	Enables group chats for Ultimate Member Groups. Requires UM Groups
File Uploading	Allows file uploads in Ultimate Member group chats
Email Notifications	Sends email notifications for new messages in UM group chats
Push Notifications	Sends push notifications for new messages in UM group chats (WebSocket)

Frequently asked questions#

Does Better Messages replace the Ultimate Member Messages add-on?#

Yes. Deactivate the UM Messages add-on when Better Messages is installed — they conflict. Better Messages takes over the same URLs and surfaces.

Will the profile Messages tab work if I host Better Messages on a separate page?#

Yes — embed Better Messages inside the UM profile Messages tab, or set Messages Location to a regular WordPress page and have the tab link to it.

Can guests message UM members?#

Guest Chat is supported when Better Messages is hosted on a public page. Configure under Settings → Guest Chat.

Does it work with custom roles defined in Ultimate Member?#

Yes — Better Messages respects WordPress roles, including custom ones UM defines.

Can I add the Private Message button somewhere custom on the profile?#

Yes — the position is configurable in Settings, and the button can be placed manually via shortcode for custom forms or tabs.