User Management

Unfold CMS includes a complete user management system with user creation, profile editing, avatars, banning, and activity tracking.

Overview

The user management system provides:

  • User CRUD — Create, view, edit, and delete user accounts
  • Profile management — Avatars, display names, email changes
  • User banning — Ban/unban with reason and duration
  • Filtering & search — Find users by name, email, role, or status
  • Activity log — Track user actions across the CMS

Admin Panel

User List

Navigate to Users > All Users in the admin panel. The user index page displays:

  • User avatar and name
  • Email address
  • Assigned role
  • Registration date
  • Account status (active, banned, unverified)

Use the filters to narrow results by role, status, or search by name/email.

Creating Users

Click Create User to add a new account:

Field Required Description
Name Yes Display name
Email Yes Login email (must be unique)
Password Yes Account password
Role Yes User role assignment
Email Verified No Skip email verification

When creating a user through the admin panel, you can optionally mark their email as verified, skipping the verification email flow.

Editing Users

Click on any user to edit their profile:

  • Update name, email, and password
  • Change role assignment
  • Upload or remove avatar
  • View activity history
  • Ban or unban the account

User Profiles

Each user has a profile that includes:

Field Description
Name Display name shown across the CMS
Email Login email and notification address
Avatar Profile picture (upload or Gravatar)
Bio Short biography (optional)

Avatars

Unfold CMS supports two avatar sources:

  1. Custom upload — Users can upload their own profile picture
  2. Gravatar — Automatic avatars from Gravatar.com (when enabled)

Configure Gravatar in Settings > Users in the admin panel.

User Banning

Administrators can ban users to prevent access to the site.

Banning a User

  1. Navigate to the user's profile in admin
  2. Click Ban User
  3. Optionally provide a reason and duration
  4. Confirm the action

Ban Features

Feature Description
Ban Reason Optional message explaining the ban
Ban Duration Temporary (auto-expires) or permanent
Toggle Ban/unban with a single action
Notification Banned users receive a notification

Ban Status

The isBanned method checks whether a user is currently banned. The toggleBanStatus method switches between banned and unbanned states.

Banned users:

  • Cannot log in
  • See a "banned" message if they try to access the site
  • Receive a notification about the ban

User Settings

Configure user-related settings (welcome emails, comment notifications) in Settings > Users in the admin panel.

Self-Service Profile

Users can manage their own profiles at /settings/profile:

  • Update display name
  • Change email address (triggers re-verification if enabled)
  • Upload avatar
  • Change password
  • Enable/disable two-factor authentication
  • View and manage notification preferences

Membership Settings

Control whether new registrations are allowed in Settings > Authentication in the admin panel.

Code Snippets Roles & Permissions