Documentación de ComusThumbz
Iniciar Sesión

Main Dashboard

Admin Dashboard - User Guide

Page Location: ct/admin/main.php
Menu Path: Admin Panel → Dashboard (Home icon)
Access Level: Administrator (requires login)
Last Updated: 2026-01-01


Overview

The Admin Dashboard is the central control hub for ComusThumbz administrators. It provides a comprehensive overview of your site's content, traffic, members, and system health. The design features collapsible sections, multi-column analytics, real-time alerts, and quick action buttons for common administrative tasks.

edited-image.png


Getting to This Page

  1. Log in to the admin panel at ct/admin/ctlogin.php
  2. You'll be automatically redirected to the dashboard
  3. Alternatively, click the Home icon in the navigation menu

 

Note:
The dashboard is the default landing page after successful login. It provides an at-a-glance view of your entire site.

 


System Requirements

 

Configuration Required:
This page requires the following system dependencies to function properly.

 

PHP Requirements

Requirement Minimum Recommended Notes
PHP Version 8.0 8.3+ Required for modern array functions
memorylimit 64M 128M For large dataset aggregation
maxexecutiontime 60 120 Dashboard queries multiple tables

Required PHP Extensions

Extension Required Purpose
mysqli Yes Database connectivity
session Yes Authentication state
json Yes Debug mode output

Folder Permissions

Folder Path Permission Owner Purpose
/ct/logs/ 775 www-data Error logging

Server Requirements

Component Requirement
Web Server Apache 2.4+ OR Nginx
Database MySQL 5.7+ / MariaDB 10.3+

Page Layout

The dashboard is organized into several distinct sections:

edited-image.png

Welcome Section

Element Description
Welcome Message Personalized greeting with admin name
Last Login Info Date/time and IP of last login
Version Badge Software name and version number
License Type Current license tier (Standard, Pro, etc.)

Quick Actions Bar

A horizontal bar with commonly-used action buttons:

Button Icon Destination
Videos Video icon video.admin.php
Cams Broadcast icon camperformers.php
Creators Star icon creatorsadmin.php
Galleries Images icon admin.php
Reports Chart icon Dropdown menu
Settings Cog icon Dropdown menu

Reports Dropdown:

  • Financial → financialreports.php
  • Clicks → clickstats.php
  • Tokens → tokenusage.php
  • Content → contentanalytics.php

Settings Dropdown:

  • Videos → videoprocessorsettings.php
  • General → config.setup.php
  • Cams → camssettings.php
  • Creators → creatorplatformsettings.php

 

Analytics Section (Collapsible)

The main analytics section contains a 4-column grid:
edited-image.png

Column 1: Submissions by Date

Data Description
Date Last 14 days
Videos Video uploads per day
Galleries Gallery submissions per day
Posts Creator posts per day

Also includes Scheduled Content (Next 30 Days) table showing upcoming scheduled releases.

Column 2: Content & Categorization

Content Statistics:

  • Active videos (linked to filter)
  • Pending videos (linked to filter)
  • Processing videos (linked to filter)
  • Active galleries
  • Pending galleries
  • Active models

 

Categorization Statistics:

  • Categories count
  • Tags count
  • Sponsors count

 

Database Health Mini-Panel:

  • Status indicator (green/yellow/red dot)
  • Database size in MB
  • Table count

 

Column 3: Traffic & Members

Traffic (Views):

  • Today's views
  • Last 7 days views
  • Total views (highlighted)
  • Total clicks

 

Members Area Totals:

  • Total members (linked)
  • Active members
  • Premium members
  • Creators (linked)
  • Playlists count
  • Comments count

 

Column 4: Errors & Alerts

Errors and Warnings Panel (Red):

  • Videos with processing errors
  • Pending videos requiring review
  • Galleries with bad scans
  • Galleries with 404 errors
  • User reports to review

 

Alerts Panel (Orange):

  • Failed login attempts (last 24h)
  • New comments to review
  • New video uploads
  • New gallery submissions

 


Features & Functions

Collapsible Sections

The Analytics section can be collapsed/expanded:

  1. Click the section header bar
  2. The +/- toggle indicates collapsed/expanded state
  3. State is saved in localStorage (persists across page loads)

 

Tip:
Collapse sections you don't need to see often. Your preferences are remembered automatically.

 

Quick Action Dropdowns

Dropdown menus provide access to related pages:

  1. Click the dropdown button (has caret icon)
  2. Menu appears with sub-options
  3. Click outside to close
  4. Only one dropdown can be open at a time

Real-time Statistics

The dashboard calculates statistics in real-time from database queries:

Statistic Source Table Query Description
Active Videos tblVideos status = 'active'
Pending Videos tblVideos status = 'pending'
Processing Videos tblVideos status = 'processing'
Active Galleries tblTgp accept IN ('yes', 'Approved')
Pending Galleries tblTgp accept = 'Pending' OR reviewed = 0
Today's Views tblVideoViews DATE(viewedat) = CURDATE()
Week Views tblVideoViews Last 7 days
Total Members tblCMSUsers All users
Premium Members tblCMSUsers accounttype IN ('Premium', 'VIP')
Creators tblCMSUsers iscreator = 1

Error Detection

The dashboard automatically detects and displays issues:

Issue Type Detection Query Panel
Pending Videos status = 'pending' count > 0 Errors (warning)
Error Videos status = 'error' count > 0 Errors (error)
Pending Galleries Unreviewed galleries Errors (warning)
Bad Scans badscan = 1 count > 0 Errors (warning)
404 Errors error404 > 3 count > 0 Errors (warning)
User Reports reporttype = 1 pending Errors (error)
Failed Logins Last 24h failures Alerts
New Comments Last 24h comments Alerts
New Uploads Last 24h videos Alerts

 

Database Health Check

The dashboard performs automatic database health monitoring:

Health Level Condition Indicator
Healthy Size < 1000 MB Green dot
Warning Size >= 1000 MB Yellow dot
Error Query failed Red dot

To check database health via AJAX:

  • URL: main.php?dbaction=health
  • Response: JSON with size, table count, status, issues

Step-by-Step Usage

Understanding Your Dashboard

  1. Check the Welcome Section
  • Verify you're logged in as the correct user
  • Note your last login time and IP for security
  1. Review Errors & Alerts First
  • Red panel shows critical issues requiring attention
  • Orange panel shows informational alerts
  • Click linked items to navigate to the relevant page
  1. Monitor Content Statistics
  • Check pending content queue size
  • Monitor processing pipeline status
  • Review submission trends by date
  1. Track Traffic Trends
  • Compare today vs weekly views
  • Monitor click-through rates
  • Watch member growth

Acting on Alerts

For Pending Videos:

  1. Note the count in the Errors panel
  2. Click the link to go to video.admin.php?filter=pending
  3. Review and approve/reject videos

 

For Error Videos:

  1. Click the error count link
  2. Check video processor logs for issues
  3. Retry processing or delete failed videos

 

For User Reports:

  1. Click the reports link
  2. Review reported content
  3. Take action (approve, remove, warn user)

 

For Failed Logins:

  1. Click the alerts link to view logs
  2. Check for suspicious IP patterns
  3. Consider IP blocking if needed

 

Using Quick Actions

  1. Navigate to Content:
  • Click Videos, Galleries, Cams, or Creators buttons
  • Each goes directly to the management page
  1. Access Reports:
  • Click Reports dropdown
  • Select Financial, Clicks, Tokens, or Content
  1. Configure Settings:
  • Click Settings dropdown
  • Select Videos, General, Cams, or Creators

Troubleshooting

Common Issues

Issue Cause Solution
All statistics show 0 Database tables don't exist Run installation SQL
"No recent submissions" No content added in 14 days Normal if site is new/inactive
Server stats show 0 Windows server or disabled functions Normal - Linux-only features
Debug panel not showing Missing ?debugapi parameter Add parameter to URL
Section stays collapsed localStorage issue Clear browser storage

Statistics Not Loading

Problem: Dashboard shows errors or blank sections.

Solutions:

  1. Check database connection:

 

// Test in a separate file

   $conn = mysqliconnect($dbhost, $dbuser, $dbpasswd, $db);

   if (!$conn) {

       echo mysqliconnecterror();

   }

 

  1. Verify tables exist:
SHOW TABLES LIKE 'tblVideos';
   SHOW TABLES LIKE 'tblTgp';
   SHOW TABLES LIKE 'tblCMSUsers';
  1. Check PHP error log:
tail -100 /path/to/ct/logs/php-error.log

Slow Dashboard Loading

Problem: Dashboard takes too long to load.

Solutions:

  1. Add indexes to frequently queried columns:

 

ALTER TABLE tblVideos ADD INDEX idxstatus (status);

   ALTER TABLE tblTgp ADD INDEX idxaccept (accept);

   ALTER TABLE tblVideoViews ADD INDEX idxviewedat (viewedat);

 

  1. Optimize large tables:
OPTIMIZE TABLE tblVideos;
   OPTIMIZE TABLE tblTgp;
  1. Consider archiving old data if tables are very large

Alerts Not Showing

Problem: Expected alerts don't appear.

Check:

  1. Verify table contains expected data
  2. Check date/time queries match your timezone
  3. Ensure tblLogs is being written to

 


  • Login Page (ct/admin/ctlogin.php) - Authentication gateway
  • Video Management (ct/admin/video.admin.php) - Manage videos
  • Gallery Review (ct/admin/admin.php) - Review galleries
  • User Management (ct/admin/users.admin.php) - Manage members
  • System Logs (ct/admin/logs.php) - View all logs
  • Settings (ct/admin/config.setup.php) - Site configuration

Translatable Strings

The following text strings appear in this page and should be added to backend_translations.md:

Welcome Section

  • "Welcome,"
  • "Your last login was on"
  • "from"
  • "license"
  • "Standard"

Quick Actions

  • "Videos"
  • "Cams"
  • "Creators"
  • "Galleries"
  • "Reports"
  • "Settings"
  • "Financial"
  • "Clicks"
  • "Tokens"
  • "Content"
  • "General"

Section Headers

  • "Analytics"

Table Captions

  • "Videos / Galleries / Posts"
  • "Scheduled (Next 30 Days)"
  • "Content"
  • "Categorization"
  • "Traffic (Views)"
  • "Members Area Totals"

Table Headers & Labels

  • "Date"
  • "Videos"
  • "Galleries"
  • "Posts"
  • "Active videos"
  • "Pending videos"
  • "Processing videos"
  • "Active galleries"
  • "Pending galleries"
  • "Active models"
  • "Categories"
  • "Tags"
  • "Sponsors"
  • "Today"
  • "Last 7 days"
  • "Total views"
  • "Total clicks"
  • "Total members"
  • "Active members"
  • "Premium members"
  • "Creators"
  • "Playlists"
  • "Comments"

Panel Headers

  • "Errors and warnings"
  • "Alerts"
  • "No errors or warnings"
  • "No alerts at this time"
  • "No recent submissions"
  • "No scheduled content"

Alert Categories

  • "Admin panel alerts"
  • "Content added / modified by users"

Alert Messages

  • "There are X videos pending review."
  • "There are X videos with processing errors."
  • "There are X galleries pending review."
  • "There are X galleries with bad scans."
  • "There are X galleries with frequent 404 errors."
  • "There are X user reports to review."
  • "There are X failed login attempts in the last 24 hours."
  • "There are X new comments to review."
  • "There are X new videos uploaded."
  • "There are X new galleries submitted."

Database Health

  • "Database:"
  • "tables"

Changelog

Date Version Changes
2026-01-01 1.0 Initial guide created
2025-11-06 - Collapsible sections
2025-10-27 - Added database health monitoring