JoomSchool - Manage Private Messages

JoomSchool's private messaging system is the school's internal mailbox: a way for administrators, teachers, students and parents to send each other messages with optional file attachments without using personal email.

This article covers the inbox model, sending messages, replies, attachments and the Notifications and PMS options.

Overview

Private messages are stored inside the JoomSchool database, not in any external email server. Each message has a sender, a recipient, a subject, a body and zero or more file attachments. Replies form a thread tied to the original message.

Messages live in two places:

• Admin view — Components → JoomSchool → Messages — the administrator sees every message ever sent. Useful for auditing, moderation and recovering deleted threads.
• Frontend — every signed-in student, teacher and parent has a personal inbox at the Message menu item, with an envelope icon in the top navigation showing the unread count.

Email notifications are optional: when enabled, the recipient also gets a copy of the message at the email address on their Joomla user account.

Prerequisites

• Students, teachers and parents exist with linked Joomla accounts (so messages have valid email addresses for notifications).
• Components → JoomSchool → Options → Attachments sets the allowed file formats, size and count for any file attached to a message.
• Optionally, Components → JoomSchool → Options → Notifications is set to Enable for "When user receive a new private message".
• Optionally, Components → JoomSchool → Options → PMS is set to Enable for "Allow private messaging to sections" if you want teachers to send mass messages to whole sections.

Who can message whom

The recipient picker on the Compose form changes depending on who is logged in.

From the admin view

Two recipient types are available:

• Student — any published student in the database.
• Teacher — any published teacher in the database.

From the frontend

The recipient picker is a To dropdown:

Parents cannot message students directly through the frontend in the default setup; the section-level option exists for teacher-to-section announcements rather than student-to-student.

Sending a message

From the admin view

1. Open Components → JoomSchool → Messages and click New.
2. The form has these fields:

1. Click Save & Close. The recipient gets a row in their frontend inbox; if Notifications is enabled, they also get an email.

From the frontend (Compose)

1. Click Message in the top navigation, then Compose (or the equivalent New button).
2. Pick the recipient type from the To dropdown.
3. Type the recipient's name in the search field; suggestions appear after a few characters. Click the right person.
4. Fill in Subject and the Message body.
5. Attach one or more files via the Attachment field if needed.
6. Click Send.

Replies and threading

Click any message in the inbox to open it. Below the original body there's a Reply form with the same fields (message body and attachment). Click Reply to add to the thread.

The thread keeps the original sender and subject; recipients see the full back-and-forth in date order. Each reply is a separate database record but is grouped in the UI.

Attachments

The Attachment field is a multi-file input. Constraints come from Components → JoomSchool → Options → Attachments:

PHP's upload_max_filesize and post_max_size directives must be at least as large as Max File Size; otherwise the JoomSchool limit is silently overridden by PHP.

Attachments are stored on the server filesystem under JoomSchool's media folder and are served back via download links inside the message thread.

Email notifications

When Components → JoomSchool → Options → Notifications → When user receive a new private message is set to Enable, JoomSchool sends an email to the recipient's account email any time:

• A new message is sent to them
• A new reply is added to a thread they're part of

The email contains the subject and body in plain text, and a link back to the inbox. There is no separate template editor — the format is fixed, but the from-address respects Joomla's global mail configuration.

If you don't want users notified by email at all, leave the option set to Disable (the default).

Section-wide messages

The PMS option Allow private messaging to sections lets teachers compose a single message addressed to every student in a chosen section. To use it:

1. Enable the option in Components → JoomSchool → Options → PMS.
2. Log in as a teacher.
3. Open Compose; the To dropdown now has a Section entry.
4. Choose Section, pick the section, fill in the subject and body, and send.

Each student in the section gets their own copy of the message and their own email notification. Replies stay between the individual student and the teacher — the section is only the addressing convenience, not a group thread.

Searching and filtering the inbox

Both the admin view and the frontend inbox have:

• A keyword search across subject and body
• A read / unread filter (frontend only)
• A date filter

The admin view also allows filtering by sender type (Student / Teacher / Parent) so you can audit one role's messages.

Tips & Best Practices

• Use descriptive subjects. "Question" or "Hi" are useless to search later. "Math homework — Class 6 Section A" is searchable forever.
• Keep attachments small. A 10 MB attachment slows down email notifications dramatically. Resize photos before attaching, and link to large documents from announcements rather than emailing them.
• Use messages for one-to-one conversations, announcements for one-to-many. Section-wide messages are a third option, but parents don't see them — for school-to-parent broadcasts, use announcements.
• Audit the message log periodically. Once a year, archive older threads to keep the database tidy.
• Don't disable Notifications during the school year — users get used to email replies, and a sudden silence makes them miss messages.

Troubleshooting