Model Management

Overview

The Model Management page is the central hub for managing all performer/model profiles in ComusThumbz. It provides comprehensive tools for creating, editing, searching, and organizing model records. Features include grid/table view switching, advanced filtering by multiple attributes, mass editing capabilities, AI-powered data enrichment, image management integration, and detailed analytics per model. This page serves as the primary interface for maintaining the model database that links to galleries and videos.

Location: Navigate to Admin Panel → Models or click the Dashboard Models card

[Screenshot: models-main-grid-view]

Getting to This Page

1. Log into the Admin Panel at main.php
2. Click Models in the navigation menu
3. Or click the Models stat card on the Dashboard
4. Direct URL: ct/admin/models.php

System Requirements

PHP Requirements

Required PHP Extensions

Required PHP Functions

Folder Permissions

Features & UI Elements

Page Header

[Screenshot: models-page-header]

AI Processing Banner

[Screenshot: models-ai-banner]

When models need AI processing, a dismissible banner appears:

Controls Bar

[Screenshot: models-controls-bar]

Selection Controls

[Screenshot: models-selection-controls]

Column Customizer (Table View)

[Screenshot: models-column-customizer]

An expandable accordion for table column configuration:

Available Columns:

• Checkbox (mandatory), Image, Name (mandatory), Status, Age, Location
• Gender, Ethnicity, Body Type, Hair Color, Eye Color
• Galleries, Videos, Views, Rating, Favorites
• AI Processed, Image Processed, Actions (mandatory)

Sort & Filter Controls

[Screenshot: models-sort-filter]

Advanced Filter Controls

[Screenshot: models-advanced-filters]

Two rows of attribute-based filters:

Row 1:

• Gender (dynamically populated)
• Body Type (dynamically populated)
• Ethnicity (dynamically populated)
• Country (dynamically populated)

Row 2:

• Eye Color (dynamically populated)
• Hair Color (dynamically populated)
• Cup Size (dynamically populated)
• Status (dynamically populated)
• Apply Filters button

Mass Edit Bar

[Screenshot: models-mass-edit-bar]

Appears when models are selected. Allows bulk editing of:

Card View

[Screenshot: models-card-view]

Each model card displays:

Card Header Buttons

Card Body

Analytics Section

Card Footer

Table View

[Screenshot: models-table-view]

Compact list format with customizable columns:

Default Columns

Row Highlighting

Models needing AI processing are highlighted with a subtle yellow background to help identify incomplete records.

Edit Modal

[Screenshot: models-edit-modal]

The edit modal opens when clicking a model name. Organized into sections:

Basic Information

Physical Attributes

Location & Contact

Statistics & Settings

Image Settings

Additional Information

Step-by-Step Usage

Adding a New Model

1. Navigate to Admin Panel → Models
2. In the Controls Bar, enter the model name in the "Enter new model name" field
3. Click Add New Model
4. Success message confirms creation
5. The new model appears in the list with default values
6. Click the model name to open the edit modal and add details

Editing a Model

1. Find the model in card or table view
2. Click the model name
3. Edit modal opens with all current values
4. Modify desired fields in each section
5. Click Save Changes
6. Modal closes and list refreshes

Uploading a Model Image

Method 1: Manual Upload

1. Click Upload or Change button on model card
2. Redirected to uploadmodelimage.php
3. Select image file
4. Crop to target dimensions
5. Save cropped image

Method 2: AI Image Selector

1. Click AI Image button on model card
2. AI searches multiple sources for matching images
3. Select best match
4. Crop and save

Method 3: Batch Image Selector

1. Click Batch Image button
2. Process multiple models in sequence
3. Select and crop images for each

Using AI Data Update

1. Click AI Update button on model card
2. AI queries external databases (CamModelDB, CamsFinder, etc.)
3. Review suggested data
4. Accept or modify suggestions
5. Save updates

Mass Editing Models

1. Select models using checkboxes

• Click individual checkboxes, or
• Click Select All on Page, or
• Click Select All in Database

1. Mass Edit Bar appears showing selected count
2. Fill in only the fields you want to change
3. Click Apply Changes
4. All selected models updated

Deleting Models

Single Model:

1. Click Delete button on model card
2. Confirm deletion in popup
3. Model permanently removed

Multiple Models:

1. Select models to delete
2. Click Delete Selected
3. Confirm deletion
4. All selected models removed

Filtering Models

Quick Filters:

1. Use "Filter by" dropdown for common filters:

• Has Image / No Image
• AI Updated / Not AI Updated

Advanced Filters:

1. Expand the Advanced Filter section
2. Select values from attribute dropdowns
3. Click Apply Filters
4. Grid/table shows filtered results
5. Use Clear All Filters to reset

Sorting Models

1. Use "Sort by" dropdown
2. Options include: Name, Date, Popularity, Rating, Views, Age, Gallery count
3. Grid/table reorders immediately

Troubleshooting

Common Errors

Cause: Database connection error
Solution: Verify database credentials in ct/dat/config.inc.php

Cause: SQL UPDATE query failed
Solution:

1. Check for duplicate modelname (unique constraint)
2. Verify database connection
3. Check for required fields

Cause: Image file missing or path incorrect
Solution:
Verify file exists in ct/images/models/

1. Check modelimage column has correct filename
2. Verify web server has read permissions

Cause: No models selected or form not submitted properly
Solution:

1. Ensure models are actually selected (checkboxes checked)
2. At least one field must have a value
3. Click "Apply Changes" button (not just filling fields)

Solutions:

1. Reduce records per page (20-50 instead of 1000)
2. Use Table View instead of Card View
3. Apply filters to reduce result set
4. Ensure database indexes exist on tblModels

Cause: AI tools not completing successfully
Solution:

1. Check AI tool logs for errors
2. Verify license key is valid
3. Ensure network connectivity to AI services

JavaScript Features

LocalStorage Keys

Session Storage Keys

Client-Side Functions

Translatable Strings

The following strings should be added to backendtranslations.md:

modelstitle = "Model Management System"
modelsbreadcrumb = "Models"
modelsaibannertitle = "AI Processing Recommended"
modelsaibannertext = "{count} of {total} models need AI processing"
modelsaibannerbreakdown = "{imagecount} need AI Image, {updatecount} need AI Update"
modelsbatchprocess = "Batch Process"
modelssearchplaceholder = "Search models..."
modelssearch = "Search"
modelsclearsearch = "Clear Search"
modelsaddnewplaceholder = "Enter new model name"
modelsaddnew = "Add New Model"
modelsperpage = "Models per page:"
modelsviewcontrols = "Model Selection & View Controls"
modelsviewcards = "Cards"
modelsviewtable = "Table"
modelscustomizecolumns = "Customize List Columns"
modelscolumndraginfo = "Drag items to reorder. Check/uncheck to show/hide columns. Yellow items are mandatory."
modelsapply = "Apply"
modelsresetdefault = "Reset to Default"
modelsselectallpage = "Select All on Page"
modelsselectalldb = "Select All in Database"
modelsselectnone = "Select None"
modelsdeleteselected = "Delete Selected"
modelssortby = "Sort by:"
modelssortnameasc = "Name (A-Z)"
modelssortnamedesc = "Name (Z-A)"
modelssortnewest = "Newest First"
modelssortoldest = "Oldest First"
modelssortpopularity = "Popularity"
modelssortrating = "Rating"
modelssortviews = "Most Viewed"
modelssortageasc = "Age (Young to Old)"
modelssortagedesc = "Age (Old to Young)"
modelssortgalleriesdesc = "Most Galleries"
modelssortgalleriesasc = "Least Galleries"
modelsfilterby = "Filter by:"
modelsfilterall = "All Models"
modelsfilterhasimage = "Has Image"
modelsfilternoimage = "No Image"
modelsfilteraiupdated = "AI Updated"
modelsfilternotaiupdated = "Not AI Updated"
modelsclearfilters = "Clear All Filters"
modelsadvancedfiltersgender = "Gender:"
modelsadvancedfiltersbodytype = "Body Type:"
modelsadvancedfiltersethnicity = "Ethnicity:"
modelsadvancedfilterscountry = "Country:"
modelsadvancedfilterseyecolor = "Eye Color:"
modelsadvancedfiltershaircolor = "Hair Color:"
modelsadvancedfilterscupsize = "Cup Size:"
modelsadvancedfiltersstatus = "Status:"
modelsapplyfilters = "Apply Filters"
modelsmassedittitle = "Mass Edit"
modelsmasseditselected = "Selected Models"
modelsmasseditleaveblank = "Leave blank for no change"
modelsmasseditapply = "Apply Changes"
modelsmasseditcancel = "Cancel"
modelstotal = "Total Models:"
modelsedittitle = "Edit Model Details"
modelssectionbasic = "Basic Information"
modelssectionphysical = "Physical Attributes"
modelssectionlocation = "Location & Contact"
modelssectionstats = "Statistics & Settings"
modelssectionimage = "Image Settings"
modelssectionadditional = "Additional Information"
modelssavechanges = "Save Changes"
modelscancel = "Cancel"
modelsnoimage = "No Image"
modelscardaiimage = "AI Image"
modelscardbatchimage = "Batch Image"
modelscardaiupdate = "AI Update"
modelscardbatchai = "Batch AI"
modelscardupload = "Upload"
modelscardchange = "Change"
modelscarddelete = "Delete"
modelsanalyticstitle = "Analytics"
modelsanalyticsimpressions = "Impressions"
modelsanalyticsclicks = "Clicks"
modelsanalyticsctr = "CTR"
modelsnomodels = "No models found"
modelsnomodelsfiltered = "No models match your current filters"
modelsclearandretry = "Clear All Filters"
modelsconfirmdelete = "Are you sure you want to delete this model?"
modelsconfirmdeleteselected = "Are you sure you want to delete all selected models? This cannot be undone."
modelssuccessadded = "Model added successfully!"
modelssuccessupdated = "Model updated successfully!"
modelssuccessdeleted = "Model deleted successfully!"
modelserrorduplicate = "A model with this name already exists"

Version History

Related Documentation

• AI Image Selector - AI-powered image search
• AI Model Data Update - AI data enrichment
• Model Image Cropper - Image cropping
• Gallery Administration - Gallery management
• Video Administration - Video management