ComusThumbz Documentation
Admin Login

Messages Manager

Messages Manager

What This Page Does

The Messages Manager lets you monitor and moderate private messages between users on your site. You can view all conversations, handle user reports about inappropriate messages, see which users have blocked each other, and delete problematic content when needed.

Think of this as your messaging moderation center. When users report a message or when you need to check on what people are saying to each other, this is where you'll come.

[Screenshot: page-overview]


How to Get Here

Navigate to Admin Panel > Users > Messages


Understanding the Page

When you first open this page, you'll see a statistics bar at the top showing your messaging activity, followed by three tabs for different views.

Statistics Bar

Five colored cards show you messaging activity at a glance:

  • Total Conversations - How many unique conversation threads exist on your site
  • Total Messages - The total number of messages sent
  • Unread Messages - Messages that haven't been read yet
  • Pending Reports - How many messages users have reported and are waiting for your review
  • Last 24 Hours - New messages sent in the past day

These numbers update every time you load the page.

Navigation Tabs

Three tabs let you switch between different views:

  • Conversations - Browse and read all user conversations
  • Reports - Review messages that users have flagged as inappropriate (shows a red badge when you have pending reports)
  • Blocked Users - See which users have blocked each other

Click any tab to switch views.


Common Tasks

How to Read a Conversation

Sometimes you need to see what two users are saying to each other, whether you're investigating a report or just monitoring activity.

  1. Click the Conversations tab.
  2. Scroll through the list of conversations.
  3. Click on any conversation to open it.
  4. A full-screen chat window appears showing all messages between those two users.
  5. Messages appear in chronological order with the oldest at the top.
  6. Each message shows who sent it, when it was sent, and whether the recipient has read it.
Tip: Conversations with unread messages have a light green background. Conversations with reported messages show a red "reported" badge.

[Screenshot: chat-overlay-example]

How to Find a Specific User's Messages

If you need to find conversations involving a particular user:

  1. In the Conversations tab, look for the search box at the top.
  2. Type the username you're looking for.
  3. Press Enter or click outside the search box.
  4. The page refreshes and shows only conversations involving that user.

The search looks at both participants in a conversation, so you'll see all conversations where either person matches your search.

How to Delete an Entire Conversation

When a conversation violates your site's policies and you need to remove it completely:

  1. Open the conversation by clicking it in the list.
  2. Scroll to the bottom of the chat window.
  3. Click the red Delete Conversation button.
  4. A confirmation message appears showing both usernames.
  5. Click Yes to confirm deletion.
Warning: This removes ALL messages between these two users. Both users will immediately lose access to the entire conversation on your site. This cannot be undone from the admin panel.

How to Handle Reported Messages

When a user reports a message as spam, harassment, or inappropriate content, you need to review and resolve the report.

  1. Click the Reports tab (you'll see a red badge if you have pending reports).
  2. Each report shows:
  • Why the user reported it
  • Any additional details they provided
  • The actual message content
  • Who sent it and who reported it
  1. Read the message and decide what action to take.
  2. Type your reasoning in the Admin Notes field.
  3. Choose a status:
  • Reviewed - You've looked at it but need to monitor the situation
  • Resolved - You've addressed the issue (deleted message, warned user, etc.)
  • Dismissed - The report was invalid or no action is needed
  1. Click Update Report.
Tip: Always fill in the Admin Notes field. This creates a record of why you made your decision, which is helpful if the same user gets reported again or if you need to explain your actions later.

[Screenshot: report-resolution-form]

How to View Blocked Users

Users can block each other from sending messages. This view shows you all block relationships on your site.

  1. Click the Blocked Users tab.
  2. View the table showing who blocked whom.
  3. Each row shows:
  • The user who created the block
  • The user who was blocked
  • The reason (if provided)
  • When the block was created
Note: This is view-only. You cannot unblock users from here. Users must manage their own block lists from the frontend of your site.

Understanding the Chat Window

When you open a conversation, a full-screen window appears with the message history.

What You'll See

  • Header - Shows both usernames and how many messages are in the conversation
  • Messages Area - All messages displayed like a phone messenger app:
  • Messages from one user appear on the left in white bubbles
  • Messages from the other user appear on the right in green bubbles
  • Each message shows the sender's initial in a circle, the message text, and the timestamp
  • Date separators appear between messages sent on different days
  • Read Status - A checkmark icon shows whether each message has been read:
  • Single check = sent but not read yet
  • Double check = read by the recipient
  • Reported Messages - If a message has been reported, a yellow warning banner appears below it
  • Action Buttons - At the bottom:
  • Delete Conversation removes all messages between both users
  • Close closes the chat window

Closing the Chat Window

You can close the chat window in three ways:

  • Click the X button in the top right corner
  • Click the Close button at the bottom
  • Click anywhere outside the chat window on the dark background
  • Press the Escape key on your keyboard

 


Searching for Users

Use the search box in the Conversations view to filter by username:

  1. Type a username (you can type part of the name, not the full username).
  2. Press Enter or click away from the search box.
  3. The page reloads with filtered results.
  4. To see all conversations again, clear the search box and press Enter.

Understanding Report Statuses

When you're handling reports, you assign one of these statuses:

Status When to Use It
Pending New reports start with this status automatically
Reviewed You've acknowledged the report but need to keep monitoring or take additional action later
Resolved You've fully addressed the issue (deleted the message, contacted the user, etc.)
Dismissed The report was false, a misunderstanding, or doesn't violate your policies
Tip: Move reports to Resolved or Dismissed as you finish with them. This keeps your pending count low and makes it easier to find reports that still need attention.

Tips for New Users

Tip:
  • Check the Reports tab daily if you have active users. Quick responses to reports help build trust in your community.
  • Always read the full conversation before making moderation decisions. A single message might look bad out of context but be perfectly fine when you see the whole exchange.
  • Keep track of repeat offenders. If the same user appears in multiple reports, they may need a warning or temporary ban.
  • Use Admin Notes consistently. Even a short note like "Spam - deleted" helps you track what you've done and why.
  • The statistics at the top are useful for spotting unusual activity. If you see a spike in reports or messages, investigate to see if something is going on.

Troubleshooting

The chat window won't open when I click a conversation

What you see: You click on a conversation but nothing happens or you see a loading spinner that never finishes.

How to fix it:

  1. Wait a few seconds - large conversations take time to load.
  2. Check your internet connection.
  3. Refresh the page and try again.
  4. If it still doesn't work, check the browser console for errors (press F12 and look at the Console tab).

 

I can't delete a conversation or update a report

What you see: The buttons are grayed out or clicking them does nothing.

How to fix it:

  1. Check if you're in demo mode. A banner at the top of the page will tell you if demo mode is enabled. Demo mode disables all changes to protect the demonstration site.
  2. Refresh the page. Your session may have expired.
  3. Make sure you're logged in as an administrator with proper permissions.

 

Search isn't working

What you see: You type a username and nothing happens.

How to fix it:

  1. Make sure you press Enter after typing. The search doesn't update automatically as you type - you need to submit it.
  2. Click outside the search box if pressing Enter doesn't work.
  3. Verify the username exists on your site. The search only finds existing users.

 

Reports aren't showing up

What you see: The Reports tab shows "no reports found" but you know users have reported messages.

How to fix it:

  1. Check that you're looking at all statuses, not just pending reports.
  2. Verify that reports exist in your database (contact technical support if needed).
  3. Refresh the page in case it's a caching issue.

 

A conversation shows no messages

What you see: You open a conversation but the chat window is empty.

How to fix it:

  1. Check if both users still exist. If one user was deleted, their messages may not display properly.
  2. Both users may have deleted all their messages from the conversation.
  3. Refresh the page and try opening the conversation again.

 


Page When to Use It
Users To view user profiles, ban users, or manage user accounts
Notifications To send announcements to users about policy changes or site updates
Comments To moderate public comments on videos and galleries

Demo Mode Notice

If you see an orange banner at the top of the page with a lock icon, demo mode is enabled. In demo mode:

  • You can view everything normally
  • You cannot delete messages or conversations
  • You cannot update report statuses
  • All buttons for making changes are disabled

This protects demonstration or test sites from being modified. Demo mode is controlled in your site's configuration file and can only be changed by someone with server access.