v1.0.0-beta
Star on GitHub

Admin Panel

The SocialApparatus admin panel provides comprehensive tools for managing your community. Access it at /admin with an administrator account.

Dashboard Overview

The admin dashboard gives you an at-a-glance view of your community:

User Stats

Total users, new registrations, active users

Content Stats

Posts, comments, engagement metrics

Moderation Queue

Pending reports, flagged content count

Activity Graphs

Trends over time, peak activity hours

User Management

User List

View and manage all registered users:

  • Search & Filter - Find users by name, email, or role
  • Sort - By registration date, last active, post count
  • Bulk Actions - Select multiple users for batch operations

User Actions

Action Description Reversible
Edit Profile Modify user details, email, password Yes
Change Role Promote to admin/mod or demote Yes
Verify Email Manually verify unverified accounts Yes
Mute Prevent user from posting (temporary) Yes
Ban Completely block account access Yes
Delete Permanently remove account and content No

User Details View

Click any user to see detailed information:

  • Account information and registration details
  • Login history and IP addresses
  • All posts and comments
  • Moderation history (warnings, mutes, bans)
  • Reports filed by or against user

Content Moderation

Moderation Queue

The moderation queue shows all content requiring review:

1

Reported Content

User-submitted reports with reason and context. Review the content and take appropriate action.

2

Auto-Flagged Content

Posts caught by spam filter or profanity detection. Approve or reject with one click.

3

Pending Approval

Content awaiting manual approval (if enabled for new users).

Moderation Actions

// Available moderation actions
- Approve: Publish the content
- Reject: Remove without penalty
- Delete: Remove and count against user
- Edit: Modify content directly
- Warn User: Send warning notification
- Mute User: Temporarily silence
- Ban User: Permanent removal

Moderation Logs

All moderation actions are logged for accountability:

  • Which moderator took the action
  • When the action occurred
  • What content was affected
  • The reason provided

Site Settings

General Settings

Setting Options
Site Name Your community's name
Site Description Meta description for SEO
Logo Upload site logo
Favicon Upload browser icon
Default Timezone Server timezone for dates
Date Format How dates are displayed

Registration Settings

  • Enable Registration - Toggle new user sign-ups
  • Email Verification - Require email confirmation
  • Admin Approval - Manually approve new accounts
  • Invite Only - Restrict to invited users
  • Allowed Email Domains - Whitelist specific domains
  • Blocked Email Domains - Block disposable emails

Content Settings

  • Max Post Length - Character limit for posts
  • Max Comment Length - Character limit for comments
  • Allow Media Embeds - YouTube, Twitter embeds
  • Max Upload Size - File size limits
  • Allowed File Types - Permitted extensions

Feature Toggles

Enable or disable major features:

// Toggle these on/off instantly
- Groups
- Private Messaging
- Notifications
- Reactions
- Bookmarks
- Following
- Badges
- Leaderboard

Categories & Tags

Managing Categories

  • Create - Add new categories with name, description, icon
  • Edit - Modify existing categories
  • Reorder - Drag-and-drop to change display order
  • Delete - Remove categories (posts moved to default)

Tag Management

  • View all tags with usage counts
  • Merge duplicate tags
  • Delete unused tags
  • Set featured tags for visibility

Groups Administration

Group Management

  • View all groups with member counts
  • Edit group details and settings
  • Change group ownership
  • Delete problematic groups

Group Settings

  • Max Groups Per User - Limit group creation
  • Require Approval - New groups need admin approval
  • Min Members to Create - Account age/activity requirements

Reports & Analytics

Available Reports

User Growth

Registration trends, churn rate, active user ratios

Content Activity

Posts per day, comments, engagement metrics

Peak Times

Most active hours, days, seasonal patterns

Moderation Stats

Reports, actions taken, moderator activity

Export Data

Export data for external analysis:

  • CSV export for spreadsheet analysis
  • JSON export for programmatic access
  • Scheduled automated exports

System Health

Status Indicators

  • Database - Connection status, query performance
  • Cache - Redis/Memcached connection
  • Queue - Pending jobs, failed jobs count
  • Storage - Disk usage, upload folder size
  • Email - Mail server connection test

Maintenance Mode

# Enable maintenance mode
php artisan down --secret="your-bypass-token"

# Disable maintenance mode
php artisan up

Admins can toggle maintenance mode from the dashboard with a custom message for users.

Audit Log

Track all administrative actions:

  • User management changes
  • Settings modifications
  • Content moderation actions
  • Login attempts (success/failure)
Security Note: Audit logs are immutable and retained for 90 days by default. Configure retention in config/audit.php.

Keyboard Shortcuts

Shortcut Action
g + d Go to Dashboard
g + u Go to Users
g + m Go to Moderation Queue
g + s Go to Settings
/ Focus Search
? Show Shortcuts Help

Next Steps