Category Management

Overview

The Category Management page is the central hub for creating, editing, and managing content categories in ComusThumbz. Categories organize galleries, videos, and webcam content into browsable sections for the frontend. This page provides comprehensive category administration including image uploads with cropping, statistics tracking, and detailed configuration options for traffic management, content types, and submission settings.

Location: Navigate to Admin Panel → Categories or directly from the Dashboard

[Screenshot: categories-main-grid-view]

Getting to This Page

1. Log into the Admin Panel
2. From the Dashboard (main.php), click on Categories in the navigation
3. Alternatively, click the Categories link in the sidebar menu
4. Direct URL: ct/admin/categories.php

System Requirements

PHP Requirements

Required PHP Extensions

Required PHP Functions

Folder Permissions

Features & UI Elements

Page Header

[Screenshot: categories-page-header]

Statistics Dashboard

[Screenshot: categories-stats-dashboard]

Eight statistic cards display overall category metrics:

Action Bar

[Screenshot: categories-action-bar]

View Controls

Column Customizer (Table View Only)

[Screenshot: categories-column-customizer]

An expandable accordion that allows customizing which columns appear in table view:

Available Columns:

• Image, Category Name (mandatory), Galleries, Videos, Approved
• TGP Clicks, TGP True Clicks, Video Clicks, Video True Clicks, Camgirls True Clicks
• Thumb Size, Max Galleries, Content Types, Status, Actions (mandatory)

Card View

[Screenshot: categories-card-view]

Each category card displays:

Card Image Section

• Category Image - If uploaded, displays the cropped category image
• Placeholder Icon - Folder icon if no image uploaded

Card Body

Card Actions

Table View

[Screenshot: categories-table-view]

Compact list format with customizable columns:

Edit Mode

[Screenshot: categories-edit-mode]

The full category editor is accessed by clicking Edit Category on any category card or clicking the category name in table view.

Basic Settings Section

Content Types Section

Traffic Settings Section

Submission Settings Section

Advanced Settings Section

Skim Settings Section (Future Use)

Crop Mode

[Screenshot: categories-crop-mode]

After uploading an image, the crop interface appears:

Crop Canvas

• Source Image - Displayed with max 800px width
• Dark Overlay - Covers non-selected areas
• Selection Box - Green-bordered selection area
• Aspect Ratio Lock - Selection maintains $CATWSIZE:$CATHSIZE ratio

Preview Panel

• Live Preview - Real-time preview at target dimensions
• Dimensions Display - Shows target size (e.g., "260×400px")

Crop Controls

How to Crop

1. Click and drag on the source image to define selection
2. The aspect ratio is automatically maintained
3. Watch the preview update in real-time
4. Click Save Cropped Image when satisfied

Step-by-Step Usage

Adding a New Category

1. Navigate to Admin Panel → Categories
2. In the Action Bar, type the new category name
3. Click Add Category
4. Success message confirms creation
5. New category appears in the grid with default settings

Editing a Category

1. Find the category in grid or table view
2. Click Edit Category button
3. Modify desired settings in each section
4. Click Save Changes at the bottom
5. Redirected back to category list with success message

Uploading a Category Image

1. Click Add Image (or Change Image) on a category card
2. Modal opens with file selector
3. Choose JPG, PNG, or GIF image
4. Click Upload and Crop
5. Crop interface loads with your image
6. Draw selection box to define crop area
7. Preview updates in real-time
8. Click Save Cropped Image
9. Redirected to category list with success message

Deleting a Category Image

1. Find category with existing image
2. Click Delete Image button
3. Confirm the deletion
4. Image is removed, placeholder icon appears

Deleting a Category

1. Find the category to delete
2. Click Delete Category (orange button)
3. Read the confirmation warning carefully
4. Confirm deletion
5. Category and its image are permanently removed

Refreshing Statistics

1. Click Update Stats button in action bar
2. Wait for calculation to complete (may take several seconds with large datasets)
3. Success message confirms update
4. All statistics cards refresh with new values

Switching Between Views

1. Use the Cards / Table toggle buttons
2. View preference is saved to localStorage
3. Table view shows column customizer accordion
4. Drag columns to reorder, check/uncheck to show/hide
5. Click Apply to save column configuration

Statistics Explained

Gallery Statistics

Video Statistics

Webcam Statistics

Image Processing

File Handling Workflow

1. Upload → File saved to ct/images/cats/ as tempcat{id}{timestamp}.{ext}
2. Crop → User defines selection area on canvas
3. Process → GD library extracts and resizes selection
4. Save → Final image saved as cat{id}.jpg with 85% JPEG quality
5. Cleanup → Temporary file deleted
6. Database → categoryimage column updated

Supported Formats

Output Specifications

Troubleshooting

Common Errors

Cause: Database connection error
Solution:

1. Verify database credentials in ct/dat/config.inc.php
2. Check MySQL service is running
3. Verify database user has SELECT, INSERT, UPDATE, DELETE permissions

Cause: SQL UPDATE query failed
Solution:

1. Check database connection
2. Verify tblCategories has all required columns
3. Check for database locks or quota issues

Cause: File permissions or path issues
Solution:

1. Verify ct/images/cats/ folder exists and is writable (755)
2. Check the categoryimage value in database matches actual filename
3. Verify image file exists at expected path

Cause: PHP upload or permission issue
Solution:

1. Check uploadmaxfilesize and postmaxsize in php.ini
2. Verify ct/images/cats/ is writable by web server
3. Check available disk space

Cause: GD library issue or coordinate calculation error
Solution:
Verify GD extension is installed and enabled

1. Check PHP memorylimit is sufficient (128M+)
2. Ensure source image loaded correctly before cropping

Cause: Cache not invalidating or calculation error
Solution:

1. Click Update Stats to force recalculation
2. Delete ct/dat/cstats.dat manually to clear cache
3. Check for database query errors in PHP logs

Cause: Category may be hidden or have no content
Solution:

1. Check the Hide checkbox is unchecked in Edit mode
2. Verify category has content (galleries/videos) assigned
3. Check content type toggles (Gallery Support, Video Support) are enabled

Performance Issues

Solutions:

1. Statistics calculation can be slow with many categories/content
2. Use cached statistics (automatic after first load)
3. Reduce number of categories if possible
4. Ensure database indexes exist on tblTgp.category and tblVideoCategories.categoryid

JavaScript Features

LocalStorage Keys

Client-Side Functions

Drag and Drop

The column customizer supports full drag-and-drop reordering:

• Drag handle icon on each column item
• Visual feedback during drag operation
• Automatic index recalculation on drop

Translatable Strings

The following strings should be added to backendtranslations.md:

categoriestitle = "Category Management"
categoriesbreadcrumb = "Categories"
categoriesbackdashboard = "Back to Dashboard"
categoriesgalleries = "Galleries"
categoriesvideos = "Videos"
categoriesmodels = "Models"
categoriesoverallstats = "Overall Statistics"
categoriestotalcategories = "Total Categories"
categoriestotalgalleries = "Total Galleries"
categoriestotalvideos = "Total Videos"
categoriestgpclicks = "TGP Clicks"
categoriestgptrueclicks = "TGP True Clicks"
categoriesvideoclicks = "Video Clicks"
categoriesvideotrueclicks = "Video True Clicks"
categoriescamgirlstrueclicks = "Camgirls True Clicks"
categoriesaddcategory = "Add Category"
categoriesaddcategoryplaceholder = "Enter new category name..."
categoriesupdatestats = "Update Stats"
categoriesviewoptions = "View Options"
categoriesviewcards = "Cards"
categoriesviewtable = "Table"
categoriescustomizecolumns = "Customize List Columns"
categoriescolumndraginfo = "Drag items to reorder. Check/uncheck to show/hide columns. Yellow items are mandatory."
categoriesapply = "Apply"
categoriesresetdefault = "Reset to Default"
categorieseditcategory = "Edit Category"
categoriesaddimage = "Add Image"
categorieschangeimage = "Change Image"
categoriesdeleteimage = "Delete Image"
categoriesdeletecategory = "Delete Category"
categoriesuploadcategoryimage = "Upload Category Image"
categoriesuploadinstructions = "Select an image to upload. You'll be able to crop it to {width}x{height}px after upload."
categoriesallowedformats = "Allowed formats:"
categoriesuploadandcrop = "Upload and Crop"
categoriescancel = "Cancel"
categoriescropimage = "Crop Image for Category"
categoriescropinstructions = "Draw a selection box on the image below. The selected area will be resized to {width} x {height} pixels."
categoriespreview = "Preview"
categoriessavecropped = "Save Cropped Image"
categoriesedittitle = "Edit Category"
categoriesbasicsettings = "Basic Settings"
categoriescategoryname = "Category Name"
categoriesthumbnailwidth = "Thumbnail Width"
categoriesthumbnailheight = "Thumbnail Height"
categoriesmaxgalleries = "Max Galleries"
categoriescontenttypes = "Content Types"
categoriesgallerysupport = "Gallery Support"
categoriesvideosupport = "Video Support"
categorieswebcamssupport = "Webcams Support"
categoriestrafficsettings = "Traffic Settings"
categoriesclickperiod = "Click Period (hours)"
categoriesholdperiod = "Hold Period (hours)"
categoriesshave = "Shave %"
categoriesshave1 = "Shave1 %"
categoriesimmune = "Immune"
categoriesspin = "Spin"
categorieshide = "Hide"
categoriessubmissionsettings = "Submission Settings"
categoriesmaxsubmits = "Max Submits"
categoriesentrypage = "Entry Page"
categorieslocked = "Locked"
categorieshosted = "Hosted"
categoriesnotrade = "No Trade"
categoriesadvancedsettings = "Advanced Settings"
categoriessubcategory = "Subcategory"
categoriesalternate = "Alternate"
categorieskeywords = "Keywords"
categoriesoverlay = "Overlay"
categoriesdefaultoverlayon = "Default Overlay On"
categoriescensorthumbnail = "Censor Thumbnail"
categorieskeepbest = "Keep Best"
categoriesskimsettings = "Skim Settings"
categoriesskimurl = "Skim URL"
categoriesskimpercent = "Skim Percent"
categoriestextskimurl = "Text Skim URL"
categoriestextskimpercent = "Text Skim Percent"
categoriessavechanges = "Save Changes"
categoriesfutureuse = "(For Future Use)"
categoriessuccessadded = "Category '{name}' added successfully!"
categoriessuccessupdated = "Category updated successfully!"
categoriessuccessimagesaved = "Category image saved successfully!"
categoriessuccessimagedeleted = "Category image deleted successfully!"
categoriessuccessdeleted = "Category '{name}' deleted successfully!"
categoriessuccessstatsupdated = "Statistics updated successfully!"
categoriesconfirmdeleteimage = "Delete this category image?"
categoriesconfirmdelete = "Are you sure you want to delete this entire category? This will remove the category and its image. This action cannot be undone."
categorieserrorupdating = "Error updating category"
categoriesapproved = "Approved"
categoriesthumbsize = "Thumb Size"
categoriescontenttypescol = "Content Types"
categoriesstatus = "Status"
categoriesactions = "Actions"

Version History

Related Documentation

• Gallery Administration (admin.md) - Gallery management
• Video Administration (video.admin.md) - Video management
• Models Administration (models.md) - Model management
• Click Tracking - Click tracking system