Notification System

Unfold CMS includes a notification system that alerts administrators and users about important events through email notifications and an in-app notification bell.

Overview

The notification system provides:

  • Email notifications — Sent for important events
  • Bell notifications — In-app notification dropdown in the admin panel
  • Event-based — Configurable per event type
  • User preferences — Users can manage their notification preferences
  • Retention policy — Old notifications are automatically cleaned up

Configuration

Toggle individual notification events and configure general notification settings in Settings > Notifications in the admin panel.

Notification Types

Email Notifications

Email notifications are sent when:

  • Admins — Receive notifications about new comments, tickets, and system events
  • Users — Receive notifications about replies to their comments, ticket updates, and security events

Email notifications respect the global enable/disable toggle and per-event toggles.

Bell Notifications

The notification bell in the admin panel header shows recent notifications:

  • Unread count badge
  • Dropdown list of recent notifications
  • Click to view the related item
  • Mark individual or all as read

The bell displays up to notifications.bell.max_display notifications (default: 10).

Notification Events

Comment Notifications

When a new comment is posted:

  • Post author receives a notification about the new comment
  • Parent comment author receives a reply notification (for threaded comments)
  • Admin receives a notification if comments require approval

Post Published Notification

When a post is published:

  • Subscribers or interested users can be notified
  • Useful for multi-author sites where editors want to know about new content

Security Notifications

Notification Recipient Trigger
Password Changed User User changes their password
New Login User Login from a new device/location
User Banned Banned user Account is banned by admin

Ticket Notifications (Pro)

Notification Recipient Trigger
Ticket Created Admin User creates a new ticket
Ticket Replied User/Admin New reply on a ticket
Status Changed User Ticket status is updated

Retention Policy

Notifications older than the configured retention period are automatically cleaned up. The default retention period is 90 days.

This prevents the notifications table from growing indefinitely on active sites.

Contact Form Blade Directives