# Ultimate Member - Private Messages

`meteorgpl-plugin/um-messaging` — a WordPress plugin as a Composer package.

Allow users to send private messages to each other on your site.

- Author: Ultimate Member — http://ultimatemember.com/
- Homepage: http://ultimatemember.com/extensions/private-messages
- License: GPL-3.0-only (profile: gpl-full)
- Buy a license from the vendor: http://ultimatemember.com/extensions/private-messages
- Latest version: 2.3.5 (2023-08-29)
- Page: https://meteorgpl.com/packages/meteorgpl-plugin/um-messaging
- Requires WordPress: 5.5
- Tested up to WordPress: 6.3
- Requires PHP: 5.6
- Translations: de_CH, de_DE, en_US, es_ES, fr_FR, pt_BR, sv_SE
- Vendor: Ultimate Member — https://meteorgpl.com/vendors/ultimatemember.com

## About

Add a private messaging system to your site and allow users to privately message each other. Perfect for websites where users need to interact one on one.

= Key Features: =

* Allows users to send private messages to other users
* Adds a message button to user profiles which lets users send a private message to that user via messages modal
* Adds a messages tab to each user profile so users can view all conversations and read/send private messages from profile
* Automatic refresh of private messages
* Ability to add emoticons to each private message easily
* Option to set a maximum number of characters allowed in each conversation reply
* Adds option to user account page for users to decide if they want to receive private messages or not
* Sends an e-mail notification to users when someone starts a new conversation with them
* Adds option to user account page so users can turn on/off receiving an e-mail notification for new conversations
* Control which user roles can use private messages
* Control which user roles can send or receive private messages
* Limit the number of new conversations a user role can create within a certain timeframe
* Includes block feature so users can block specific users from messaging them and also provides a way to unblock users from account page
* Messages accept plain text, with urls automatically converted into links (No other HTML is accepted in messages)
* Show unread messages count in your menu easily using the {new_messages} tag

= Integrations with other extensions: =

* Followers – Users can decide to let only users who follow them to message them.
* Real-time Notifications – Users can receive a notification when someone starts a new conversation with them.
* Online users – Shows a green dot next to user when user is online

= Development * Translations =

Want to add a new language to Ultimate Member? Great! You can contribute via [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/ultimate-member).

If you are a developer and you need to know the list of UM Hooks, make this via our [Hooks Documentation](https://docs.ultimatemember.com/article/1324-hooks-list).

= Documentation & Support =

Got a problem or need help with Ultimate Member? Head over to our [documentation](http://docs.ultimatemember.com/) and perform a search of the knowledge base. If you can’t find a solution to your issue then you can create a topic on the [support forum](https://wordpress.org/support/plugin/um-forumwp).

## Changelog

### 2.3.5 — 2023-08-29

* Added: Option for hide message button for guests
* Fixed: PHP warnings
* Fixed: Removed `extract()`
* Fixed: Issue with lack of the nonces
* Fixed: "editable" field data format in predefined fields
* Tweak: Template overwrite versioning
* Tweak: changed `input_filter` to WordPress native sanitize
* Tweak: Ultimate Member 2.6.7 compatibility

### 2.3.4 — 2022-12-14

* Fixed: Layout issues related to the textarea auto-size and the conversation layout
* Fixed: Security issue related to the COOKIES using

* Templates required update:
  - conversation.php
  - emoji.php
  - message.php

* Cached and optimized/minified assets(JS/CSS) must be flushed/re-generated after upgrade

### 2.3.3 — 2022-08-17

* Added: Refresh new real-time notifications on async query when conversation is refreshed

### 2.3.2 — 2022-02-09

* Added: 'Hide a "Download Chats History" link' setting.
* Fixed: setCaretPosition when paste emoji in the message textarea
* Fixed: Extension settings structure
* Deprecated: user_id attribute for [ultimatemember_messages] shortcode. Messaging conversations list is displayed only for the current logged in user

### 2.3.1 — 2021-12-20

* Added: Filter `um_messaging_get_messages_limit` for getting more than 1000 messages in 1 conversation via customization
* Added: Restriction settings for role who can start conversation/reply. There is possible to everyone or selected roles.
* Fixed: Multisite installation and tables creating when the plugin is active on the single site or network

* Templates required update:
  - conversation.php

Full changelog: https://meteorgpl.com/packages/meteorgpl-plugin/um-messaging/changelog

## Install

```sh
composer config repositories.meteorgpl composer https://composer.meteorgpl.com
composer require meteorgpl-plugin/um-messaging
```

The repository needs a token (see https://meteorgpl.com/docs). The vendor's license checks are intact: activate the plugin in WordPress with a key bought from the vendor.

## Versions

| Version | Released | Size | SHA-256 | Status |
| --- | --- | --- | --- | --- |
| 2.3.5 | 2023-08-29 | 207.9 KB | a11709fad96359b6cb3ca4d0324e1cf9a556b2a7c1f748365abc5e7a605fe5d3 | verified |
| 2.3.3 | 2022-08-17 | 199.5 KB | 73a99c062409c7a592283d0af12ddeea7d5302125a4a3ae422e32e5ed09494c6 | verified |