Skip to main content

Overview

The Admin Dashboard is your central hub for managing content, monitoring performance, and accessing administrative tools. This guide covers all dashboard features and how to use them effectively.

Accessing the Dashboard

Navigate to /admin after logging in to access the admin dashboard.
Dashboard features vary based on your user role. Administrators see all features, while authors see limited personal statistics.

Dashboard Layout

The dashboard consists of several key sections:

Header Section

Left Side:
  • Page Title: “Dashboard”
  • Description: “Resumen de actividad y métricas principales”
Right Side:
  • Create Post Button: Quick access to post creation (if you have crear_post permission)
  • Last Update Timestamp: Shows when data was last refreshed

Main Content Areas

1

Statistics Cards

Role-based metrics displayed in a grid layout
2

Quick Actions Panel

Frequently used actions for rapid access
3

Activity Feed

Recent platform activity and updates
4

Recent Posts Widget

Latest posts with status indicators
5

Analytics Overview

High-level performance metrics (editors and admins only)

Statistics Cards

Dynamic statistics based on your role:

Administrator View

Site-wide page views
  • Total views across all content
  • Percentage change vs. previous month
  • 7-day trend mini-chart
  • Color: Blue
  • Icon: Eye 👁️
What it means: Measures overall traffic and content reach
All posts in the system
  • Includes published, draft, and pending
  • Month-over-month growth percentage
  • Content production trend
  • Color: Green
  • Icon: FileText 📄
What it means: Tracks content library growth
Registered and active users
  • Total user count
  • New user growth rate
  • User activity trend
  • Color: Purple
  • Icon: Users 👥
What it means: Monitors community growth
Posts awaiting approval
  • Number requiring editor review
  • Change from previous period
  • Review queue trend
  • Color: Orange
  • Icon: Clock ⏰
What it means: Indicates editorial workload
Click this card to navigate directly to pending posts

Editor View

Focused on moderation tasks:
  1. Posts para Revisar (Posts to Review)
    • Pending post count
    • Direct link to review queue
  2. Comentarios Moderación (Comments for Moderation)
    • Pending comment count
    • Quick access to comment moderation
  3. Posts Publicados Hoy (Posts Published Today)
    • Today’s publication count
    • Daily productivity metric
    • Percentage change from yesterday

Author View

Personal content statistics:
  1. Mis Posts (My Posts)
    • Total posts created by you
    • All statuses included
  2. Vistas Totales (Total Views)
    • Views on your posts
    • Personal reach metric
    • Trend indicator
  3. Posts en Borrador (Draft Posts)
    • Incomplete posts count
    • Reminder to finish drafts

Commenter View

Engagement metrics:
  1. Mis Comentarios (My Comments)
    • Total comments posted
  2. Posts Comentados (Posts Commented On)
    • Unique posts engaged with
  3. Likes Recibidos (Likes Received)
    • Likes on your comments
    • Engagement indicator

Quick Actions Panel

Frequently used actions for rapid access:

Available Actions (Role-Based)

  • Ver Mi Perfil (View My Profile)
  • Cambiar Contraseña (Change Password)
  • Configuración (Settings)
  • Crear Nuevo Post (Create New Post)
  • Ver Mis Borradores (View My Drafts)
  • Ver Mis Posts (View My Posts)
  • Revisar Posts Pendientes (Review Pending Posts)
  • Moderar Comentarios (Moderate Comments)
  • Ver Analytics (View Analytics)
  • Gestionar Categorías (Manage Categories)
  • Gestionar Usuarios (Manage Users)
  • Configuración del Sistema (System Configuration)
  • Ver Logs de Actividad (View Activity Logs)
  • Gestionar Roles y Permisos (Manage Roles & Permissions)
Quick Actions are context-aware and only show options you have permission to use.

Activity Feed

Real-time platform activity stream:

Activity Types Displayed

  1. New Posts
    • Author name
    • Post title
    • Timestamp
    • Status badge
  2. Post Status Changes
    • Post published
    • Post submitted for review
    • Post approved/rejected
  3. Comments
    • New comments posted
    • Comments moderated
    • Comment replies
  4. User Activity
    • New user registrations
    • Role changes
    • User status updates
  5. System Events
    • Configuration changes
    • Category updates
    • Important system notifications
Activity Feed Features:
  • Auto-updates every 30 seconds
  • Shows last 20 activities
  • “View All Activity” link for full history
  • Filterable by activity type
  • Searchable by user or content

Recent Posts Widget

Quick overview of latest posts:

Post Card Information

Displays:
  • Featured image thumbnail (60x60px)
  • Post title
  • Author name
  • Publication/creation date
  • Status badge (Published, Pending, Draft, Rejected)
Status Badge Colors:
  • 🟢 Published: Green
  • 🟡 Pending: Yellow/Orange
  • Draft: Gray
  • 🔴 Rejected: Red
Interactions:
  • Click post title to view full post
  • Click author name to view author profile
  • Hover for quick preview
Shows last 5 posts by default. Click “View All” to see complete post list.

Analytics Overview

Analytics Overview is only visible to Editors and Administrators with admin_completo or editar_post_cualquiera permissions.

High-Level Metrics

Four Key Performance Indicators:
Site-wide page views
  • Example: 125K views
  • Aggregated across all content
  • Color: Blue
Use case: Measure overall traffic
Engagement metric
  • Example: 1.2K likes
  • Likes across all posts
  • Color: Green
Use case: Measure content appreciation
Content output
  • Example: 156 posts
  • Only published posts
  • Color: Purple
Use case: Track content production
Interaction percentage
  • Example: 68%
  • Calculated from views, likes, comments
  • Color: Orange
Use case: Measure content effectiveness
Link to Detailed Analytics: Click “View Details” button to access full Analytics Dashboard with:
  • Time-series charts
  • Detailed breakdowns
  • Export capabilities
  • Custom date ranges
Persistent navigation for all admin sections:
  1. Dashboard 📊
    • Overview and statistics
    • Quick actions
    • Activity feed
  2. Posts 📝
    • All posts list
    • Create new post
    • Manage categories
  3. Comments 💬
    • Comment moderation
    • Spam management
    • Comment settings
  4. Users 👥 (Admin only)
    • User management
    • Role assignment
    • User statistics
  5. Analytics 📈 (Editor & Admin)
    • Detailed reports
    • Performance metrics
    • Export data
  6. Categories 🏷️
    • Manage categories
    • Category statistics
    • SEO settings
  7. Configuration ⚙️ (Admin only)
    • System settings
    • Platform configuration
    • Integration management
  8. Roles & Permissions 🔐 (Admin only)
    • Role definitions
    • Permission management
    • Access control

Notification Badges

Key menu items show notification counts:
  • Posts 📝 (8) - Pending posts count
  • Comments 💬 (23) - Pending comments count

Mobile Responsiveness

The dashboard adapts to different screen sizes:

Desktop View (> 1024px)

  • Full sidebar navigation
  • Multi-column grid layouts
  • Expanded statistics cards
  • Side-by-side content panels

Tablet View (768px - 1024px)

  • Collapsible sidebar
  • 2-column grid layouts
  • Compact statistics cards
  • Stacked content panels

Mobile View (< 768px)

  • Bottom navigation bar
  • Single-column layouts
  • Swipeable cards
  • Hamburger menu
  • Floating action button (FAB) for quick post creation
On mobile, use the FAB (floating action button) in the bottom-right corner for quick access to post creation.

Customization Options

Dashboard Preferences

Customizable elements:
  1. Widget arrangement (drag and drop)
  2. Visible statistics (show/hide)
  3. Activity feed filters
  4. Default date ranges
  5. Theme (light/dark mode)
To customize:
  1. Click ⚙️ icon in dashboard header
  2. Select “Dashboard Settings”
  3. Adjust preferences
  4. Click “Save Changes”

Refresh and Updates

Auto-refresh intervals:
  • Statistics: Every 5 minutes
  • Activity feed: Every 30 seconds
  • Recent posts: Every 2 minutes
Manual refresh:
  • Click refresh icon in header
  • Pull-to-refresh on mobile
  • Keyboard shortcut: Ctrl/Cmd + R

Performance Monitoring

Key Metrics to Watch

  1. Content Production
    • Posts per week/month
    • Author activity levels
    • Draft completion rate
  2. Moderation Health
    • Pending post queue depth
    • Average approval time
    • Rejection rate trends
  3. Engagement Metrics
    • Comments per post
    • Like rate
    • Share statistics
  4. Traffic Patterns
    • Page views trend
    • Peak traffic times
    • Traffic sources
Set up alerts for critical metrics:
  • Pending queue > 10 posts
  • Traffic drop > 20%
  • Error rate increase

Troubleshooting

Common causes:
  • Network connection issues
  • Browser cache problems
  • Session timeout
Solutions:
  1. Check internet connection
  2. Clear browser cache
  3. Log out and log back in
  4. Try incognito/private mode
Possible reasons:
  • Data cache not refreshed
  • Permission scope changed
  • Analytics processing delay
Try:
  1. Manual refresh (F5)
  2. Check time range filters
  3. Verify your current role
  4. Wait a few minutes for processing
Causes:
  • Insufficient permissions
  • Role change not applied
  • Feature disabled
Check:
  1. Your current role in profile
  2. Required permissions for feature
  3. Contact admin if permissions needed
Reasons:
  • No recent activity exists
  • Activity filters too restrictive
  • Auto-update paused
Solutions:
  1. Reset activity filters
  2. Expand time range
  3. Manually refresh feed

Best Practices

Daily Dashboard Routine

Morning checklist:
  1. ✅ Review pending posts count
  2. ✅ Check comment moderation queue
  3. ✅ Scan activity feed for issues
  4. ✅ Verify no spike in errors
Throughout the day:
  • Monitor pending queues
  • Respond to notifications
  • Track key metrics
End of day:
  • Review statistics changes
  • Clear pending items
  • Plan next day priorities

Dashboard Efficiency Tips

  1. Use Keyboard Shortcuts
    • D - Go to Dashboard
    • P - Go to Posts
    • C - Go to Comments
    • N - Create new post
  2. Bookmark Key Views
    • Pending posts page
    • Comment moderation
    • Your drafts list
  3. Set Up Notifications
    • Browser notifications enabled
    • Email digests configured
    • Mobile app alerts active

Technical Reference

Source Code References:
  • Dashboard Component: src/components/admin/AdminDashboard.tsx:30
  • Stats Cards: src/components/admin/AdminStatsCards.tsx:138
  • Quick Actions: src/components/admin/AdminQuickActions.tsx
  • Activity Feed: src/components/admin/AdminActivityFeed.tsx
  • Admin Layout: src/components/admin/ResponsiveAdminLayout.tsx

Build docs developers (and LLMs) love