ComusThumbz 文档
HTML Markdown Print/PDF Plain Text
管理员登录

文档菜单


管理员访问

Remote Installer

ComusThumbz Remote Installer (Bootstrap Installer)

Document Version: 1.0.0
Last Updated: 2026-01-02
Applies To: ComusThumbz v1.11.14+
Location: comusthumbzinstaller.php

Overview

The ComusThumbz Remote Installer (also called the Bootstrap Installer) is a single-file PHP script that customers download and upload to their server to install ComusThumbz. It handles user authentication via the ComusThumbz API, license key management, script version selection, secure download with checksum verification, ZIP extraction, and launching of the main installation wizard.

[Screenshot: remote-installer-welcome-screen]

Purpose

This installer serves as the distribution mechanism for ComusThumbz:

  1. Customers download this single PHP file from comusthumbz.com
  2. Upload it to their server
  3. Run it in their browser
  4. It authenticates them, downloads the full script package, and extracts it
  5. Then launches the main /install/index.php installer

Key Features

  • 6-Stage Remote Installation Process - Guided step-by-step download and setup
  • ComusThumbz Account Integration - Login/register via central API
  • License Key Management - Validates and applies license during installation
  • Secure File Download - HTTPS with SHA256 checksum verification
  • Version Selection - Choose between Stable and Beta releases
  • Multi-Language Support - Auto-detects browser language (10 languages)
  • Interactive Help System - Troubleshooting guidance for failed requirements
  • Security Protection - Prevents execution on ComusThumbz servers

System Requirements

 

Configuration Required:
This installer checks these requirements before allowing the installation to proceed. All critical requirements must pass.

 

PHP Requirements

Requirement Minimum Recommended Notes
PHP Version 7.4 8.3+ Required for modern features
memorylimit 128M 256M For download and extraction
maxexecutiontime 120s 300s For large file downloads
allowurlfopen On On Optional, cURL fallback available

Required PHP Extensions

Extension Required Purpose
cURL ✅ Critical API communication, file downloads
json ✅ Critical JSON data processing
zip ✅ Critical ZIP file extraction
PDO ✅ Critical Database connectivity check
pdomysql ✅ Critical MySQL/MariaDB driver
mbstring ✅ Critical Multibyte string handling
openssl ✅ Critical HTTPS/encryption

Folder Permissions

Folder Permission Purpose
Install Directory 755 (Writable) Script extraction location
Warning: The directory where you upload comusthumbzinstaller.php must be writable. The installer will extract the full ComusThumbz package into this location.

Server Requirements

Component Requirement
Web Server Apache 2.4+ with modrewrite OR Nginx
HTTPS Required for API communication
Internet Access Required to download from comusthumbz.com

Installation Requirements

Files Created After Extraction

After successful download and extraction:

/your-installation-directory/
├── comusthumbzinstaller.php    (this file - can be deleted after)
├── install/                      (main installation wizard)
│   ├── index.php
│   ├── stages/
│   └── schema/
└── ct/                           (main application)
    ├── admin/
    ├── api/
    ├── dat/
    └── ...

Features & UI Elements

Header and Branding

[Screenshot: remote-installer-header]

The installer features a branded header matching the ComusThumbz admin theme:

  • COMUSTHUMBZ Logo - Orbitron font with gradient effect
  • Tagline - "High Powered Website Automation"
  • Icon Row - Five feature icons (Film, Images, Video, Heart, Fire)
  • Accent Bar - Green gradient accent line
  • Version Display - Shows installer version number

Progress Steps Bar

[Screenshot: remote-installer-progress-bar]

A horizontal progress indicator showing all 6 steps:

Step Label Purpose
1 Requirements System compatibility check
2 Account Login or register
3 License View license information
4 Version Select script version
5 Download Download and extract
6 Install Launch main installer

Step States:

  • Completed (Green checkmark) - Step finished
  • Active (Blue highlight) - Current step
  • Pending (Gray) - Not yet reached

Alert/Notification Styles

Style Purpose Example
Success (Green) Positive confirmations "All requirements met!"
Error (Red) Critical failures "Critical requirements not met."
Warning (Orange) Non-blocking issues "Some optional requirements not met."
Info (Blue) Informational notes "Loading license information..."

Stage-by-Stage Guide

Step 1: System Requirements Check

[Screenshot: step-1-requirements-check]

Purpose: Verify server meets all requirements before proceeding.

Checks Performed:

  1. PHP Version (Critical)
  • Required: 7.4+
  • Recommended: 8.3+
  • Shows current version
  1. PHP Extensions (7 checked)

cURL, JSON, ZIP - Critical

  • PDO, pdomysql - Critical for database
  • mbstring, openssl - Critical
  1. PHP Settings
  • memorylimit (128M minimum)
  • maxexecutiontime (120s minimum)
  • allowurlfopen (optional)
  1. Directory Permissions
  • Current directory must be writable

Status Indicators:

  • ✅ Passed (Green) - Requirement met
  • ⚠️ Warning (Orange) - Recommended but not blocking
  • ❌ Failed (Red) - Must be fixed

 

Help Button: Each failed/warning item has a "Help" button that opens a modal with specific troubleshooting instructions.

[Screenshot: step-1-help-modal]

Help Modal Contents:

  • Problem description
  • Multiple solution options
  • Command-line examples for Linux
  • cPanel/Plesk instructions
  • php.ini and .htaccess examples

 

Step 2: Account Authentication

[Screenshot: step-2-login-register]

Purpose: Authenticate with ComusThumbz account or create new one.

Two Tabs:

Login Tab

Field Description Required
Email Address ComusThumbz account email ✅ Yes
Password Account password ✅ Yes
  • "Forgot your password?" link to comusthumbz.com

Register Tab

Field Description Required
License Key XXXX-XXXX-XXXX-XXXX format ✅ Yes
Email Address New account email ✅ Yes
Password Minimum 8 characters ✅ Yes
Confirm Password Must match password ✅ Yes
  • "Don't have a license? Purchase one here" link

API Calls:

  • Login: POST /userauth.php/login
  • Register: POST /userauth.php/register

 

 

Tip:
After registration, users must verify their email before they can log in. The installer will prompt them to check their email.

 

Step 3: License Information

[Screenshot: step-3-license-info]

Purpose: Display user's license details and verify eligibility.

License Information Displayed:

Field Description Example
License Type Free, Basic, Pro, Enterprise Pro
Licensed Domain Domain the license is tied to example.com
License Key Masked key (first 20 chars + ...) XXXX-XXXX-XXXX...
Expires Expiration date or "Never" 2027-01-01
Skim Rate Traffic skim percentage 0%

States:

  • License Found - Shows info card with Continue button
  • No License Found - Shows error with "Purchase License" button

 

Note:
Your license key will be automatically configured in the site's config.inc.php during the main installation process.

 

Step 4: Version Selection

[Screenshot: step-4-version-selection]

Purpose: Choose which version of ComusThumbz to install.

Two Version Cards:

Stable (Recommended)

  • Production-ready release
  • Full testing and stability
  • Recommended for live sites
  • Badge: "Recommended" (green)
  • Shows version number and release date

Beta (Testing)

  • Latest features
  • May contain bugs
  • For testing only
  • Badge: "Testing" (orange)
  • Shows version number and release date

Selection:

  • Click a card to select it
  • Selected card shows green border and background highlight
  • Hidden input stores selected version

 

API Call: GET /installerapi.php/versions/list

Step 5: Download Progress

[Screenshot: step-5-download-progress]

Purpose: Download and extract the ComusThumbz package.

Process Flow:

  1. Request Download Token
  • API call to get temporary download URL
  • Receives: downloadurl, checksum, filename, filesize
  1. Download Progress
  • Visual progress bar (0-100%)
  • Status text updates
  • File size display
  1. Checksum Verification
  • SHA256 hash verification
  • Server sends checksum in X-Checksum-SHA256 header
  • Fallback to original checksum if header missing
  1. ZIP Extraction
  • Extract to installation directory
  • Verify expected folder structure:
  • /install/ folder exists
  • /install/index.php exists
  • /ct/ folder exists

Progress Bar:

  • Animated green gradient fill
  • Percentage counter
  • File size counter (MB)

 

States:

  • Downloading - Progress bar animating
  • Complete - Green success alert, extraction begins
  • Extracting - Spinner with extraction message
  • Extracted - "Launch Installer" button appears
  • Error - Red error alert with "Try Again" button
Warning:
Do not close the browser or navigate away during download and extraction. The process may take several minutes depending on your server's internet connection speed.

Step 6: Ready to Install

[Screenshot: step-6-ready-to-install]

Purpose: Confirm extraction success and launch main installer.

Elements:

  1. Success Alert
  • "ComusThumbz has been downloaded and extracted!"
  • "Click the button below to launch the installation wizard."
  1. What Happens Next List:
  • Database configuration
  • Site settings setup
  • Folder permissions check
  • Admin account creation
  • Initial data import
  • Security configuration
  1. Launch Installation Wizard Button
  • Redirects to /install/index.php
  • Starts the main 7-stage installation

Help Modal System

[Screenshot: help-modal-example]

Purpose: Provide troubleshooting guidance for failed requirements.

Available Help Topics:

PHP Version

  • Contact host to upgrade
  • cPanel MultiPHP Manager instructions
  • .htaccess handler example

Extension Help (cURL, JSON, ZIP, PDO, pdomysql, mbstring, openssl)

  • Linux apt-get commands (Ubuntu/Debian)
  • Linux yum commands (CentOS/RHEL)
  • cPanel extension enablement steps
  • Windows XAMPP/WAMP php.ini edits

Settings Help (memorylimit, maxexecutiontime, allowurlfopen)

  • php.ini modifications
  • .htaccess phpvalue directives
  • iniset() runtime examples

Permission Help

  • Linux chmod/chown commands
  • FTP client instructions
  • cPanel File Manager steps
  • Security warnings about 777

Modal Structure:

  • Green header with title
  • Problem description
  • Multiple solution boxes with:
  • Solution title
  • Step list
  • Code block (if applicable)
  • "Got it" button to close

Multi-Language Support

[Screenshot: auto-translation-example]

Purpose: Automatically translate interface based on browser language.

Supported Languages:

Code Language Coverage
en English 100% (default)
es Spanish 100%
fr French 90%
de German 85%
pt Portuguese 60%
ru Russian 60%
zh Chinese 60%
ja Japanese 60%
it Italian 60%
nl Dutch 60%
pl Polish 60%

How It Works:

  1. Detects browser language via navigator.language
  2. Extracts primary language code (e.g., 'en-US' → 'en')
  3. Merges translated strings with English defaults
  4. Updates elements with data-translate attributes
  5. Updates button text dynamically
Note:
Missing translations fall back to English. The page functions fully regardless of language support level.

Security Features

Blocked Domain Protection

The installer cannot run on ComusThumbz servers:

$blockeddomains = [
    'comusthumbz.com',
    'www.comusthumbz.com',
    'license.comusthumbz.com',
    'api.comusthumbz.com'
];

If accessed from a blocked domain, it returns the file as a download instead of executing.

Secure Download

  1. HTTPS Only - All API communication uses HTTPS
  2. Session Tokens - API authentication via session tokens
  3. Checksum Verification - SHA256 hash verification of downloaded files
  4. ZIP Signature Check - Verifies file starts with 'PK' (valid ZIP)
  5. SSL Certificate Verification - cURL verifies SSL certificates

After Extraction

@chmod($installDir, 0755);
@chmod($installDir . '/index.php', 0644);

Sets appropriate permissions on extracted files.

Troubleshooting

Common Errors and Solutions

Error:
Error: "PHP Version Too Low"
Your server is running an older PHP version.

 

Solutions:

  1. Contact hosting provider to upgrade PHP
  2. Use cPanel → MultiPHP Manager to select PHP 7.4+
  3. Add to .htaccess: AddHandler application/x-httpd-php81 .php

 

Error:
Error: "cURL Extension Missing"
The cURL extension is required for API communication.

 

Solutions:

  1. Linux: sudo apt-get install php-curl && sudo service apache2 restart
  2. cPanel: Software → Select PHP Version → Check "curl" → Save
  3. Windows: Edit php.ini, remove semicolon from ;extension=curl

 

Error:
Error: "ZIP Extension Missing"
Required for extracting the downloaded package.

 

Solutions:

  1. Linux: sudo apt-get install php-zip && sudo service apache2 restart
  2. cPanel: Software → Select PHP Version → Check "zip" → Save

 

Error:
Error: "Directory Not Writable"
The installer cannot write files to the current directory.

 

Solutions:

  1. SSH: chmod 755 /path/to/directory && chown www-data:www-data /path/to/directory
  2. FTP: Right-click folder → File Permissions → Set to 755
  3. cPanel: File Manager → Folder → Change Permissions → 755

 

Error:
Error: "Connection error" during login/download
Network issue or firewall blocking.

 

Solutions:

  1. Verify internet connection
  2. Check firewall allows HTTPS to comusthumbz.com
  3. Verify SSL certificates are up to date
  4. Try again in a few minutes

 

Error:
Error: "Checksum verification failed"
Downloaded file is corrupted or incomplete.

 

Solutions:

  1. Try downloading again
  2. Check available disk space
  3. Verify no network interruption occurred
  4. Contact support if issue persists

 

Error:
Error: "ZIP structure error: install/ folder is inside ct/"
The ZIP file has an incorrect structure.

 

Solutions:

  1. This is a packaging error - contact ComusThumbz support
  2. Manually extract and reorganize if needed:

  • /install/ should be at root level
  • /ct/ should be at root level (sibling to install/)

 

Error:
Error: "Installation files not found"
Extraction succeeded but files are missing.

 

Solutions:

  1. Check available disk space
  2. Verify write permissions
  3. Try the download again
  4. Check for extraction errors in server logs

 

Link Destination
Website https://comusthumbz.com
Documentation https://comusthumbz.com/manual/index.php
Support https://comusthumbz.com/projects/userdashboard.html

Translatable Strings

The following strings are used in the interface and should be translated:

General UI

  • "Installation Wizard"
  • "System Requirements Check"
  • "Account Authentication"
  • "License Information"
  • "Select Version"
  • "Downloading ComusThumbz"
  • "Ready to Install"

Buttons

  • "Continue"
  • "Back"
  • "Download"
  • "Login"
  • "Register"
  • "Create Account"
  • "Try Again"
  • "Launch Installation Wizard"
  • "Purchase License"
  • "Got it"
  • "Help"

Form Labels

  • "Email Address"
  • "Password"
  • "Confirm Password"
  • "License Key"

Version Cards

  • "Stable"
  • "Beta"
  • "Recommended"
  • "Testing"
  • "Production-ready release with full testing and stability."
  • "Latest features, may contain bugs. For testing only."

Status Messages

  • "All requirements met!"
  • "Your server is ready for ComusThumbz installation."
  • "Critical requirements not met."
  • "Please fix the issues above before continuing."
  • "Some optional requirements not met."
  • "Installation can continue, but some features may be limited."
  • "Loading license information..."
  • "Loading available versions..."
  • "Preparing download..."
  • "Downloading..."
  • "Download complete!"
  • "Checksum verified successfully."
  • "Extracting files..."
  • "Extraction complete!"
  • "Ready to begin installation."
  • "Download failed"

License Display

  • "License Type"
  • "Licensed Domain"
  • "License Key"
  • "Expires"
  • "Skim Rate"
  • "No valid license found."
  • "Please purchase a license to continue."

Help Modal

  • "Problem"
  • "How to Fix This"

What's Next List

  • "What happens next:"
  • "Database configuration"
  • "Site settings setup"
  • "Folder permissions check"
  • "Admin account creation"
  • "Initial data import"
  • "Security configuration"
  • "Forgot your password?"
  • "Don't have a license?"
  • "Purchase one here"
  • "Website"
  • "Documentation"
  • "Support"

Version History

Version Date Changes
1.0.0 2026-01-02 Initial comprehensive guide
  • Admin Panel: Navigate to Admin Panel → Help → Documentation

 

Related Pages