Wowonder Database File Manager

Installation & Usage Documentation

Supported Environments

• Cloud Hosting (Linux servers with PHP & MySQL)
• Linux Machines (LAMP stack: Linux, Apache, MySQL, PHP)
• Windows Machines (XAMPP/WAMP with PHP & MySQL)
• Android Devices via Termux (PHP & MySQL installed on Termux)
• Shared Web Hosting with PHP and MySQL support

Prerequisites

• PHP 7.4 or higher with the fileinfo extension enabled
• MySQL or compatible database server
• Writable public/uploads directory on your server
• Apache or compatible web server with URL rewriting enabled (optional)

Step-by-Step Installation

1. Upload Files to Server

Upload the entire wowonder-file-manager directory to your server or hosting root. For Linux/Windows use FTP/SFTP or direct file transfer. For Termux on Android, clone or download files into your Termux home directory.

2. Create Upload Directory

Ensure public/uploads exists and is writable by the web server. If missing, create it with these commands:

mkdir -p public/uploads
chmod 755 public/uploads

3. Run the Installer

Access install.php via your browser (e.g. https://your-domain.com/install.php) and fill in your database credentials. The installer will create the necessary database and tables, and generate the configuration file config/config.php.

4. Configure Web Server Document Root (Linux/Cloud/Hosting)

Set the wowonder-file-manager directory as the web root or point your domain/subdomain to it. Your main app entry point is index.php in the root.

5. Access the File Manager

Navigate to https://your-domain.com/index.php to start uploading and managing files with the modern Wowonder-style interface.

Special Notes for Different Environments

Linux

Make sure Apache or Nginx user (e.g. www-data) has write permissions on public/uploads. Use commands:

chown -R www-data:www-data public/uploads
chmod -R 755 public/uploads

Windows

If using XAMPP or WAMP, ensure the uploads folder has write permissions through folder Properties > Security > Edit > allow write for Everyone or the Apache user account.

Android via Termux

Install PHP and MySQL inside Termux, upload the project files in Termux home directory, and start PHP built-in server:

php -S localhost:8080

Access the app in a browser on Android or another device via http://localhost:8080/install.php.

Shared Web Hosting

The usual hosting control panel (cPanel, Plesk, etc.) supports PHP & MySQL; upload files and run the installer similarly. Set proper file permissions via the panel’s file manager.

Troubleshooting

• File Upload Fails: Confirm public/uploads exists and is writable.
• Database Connection Errors: Check your credentials and that the database server is online.
• MIME Type Errors on Upload: Confirm the fileinfo PHP extension is enabled in php.ini.
• PHP Fatal Errors: Verify PHP version is 7.4 or above and all files are uploaded correctly.

Security Considerations

• Run the app under HTTPS.
• Set correct permissions on public/uploads, avoid writable permissions for all users.
• Remove or restrict access to install.php after setup.
• Backup your uploads and database data regularly.

Further Customization

You can customize allowed file types, size limits, and UI elements by editing the relevant files in config/, src/, and templates/ directories.

Support & Contributions

Refer to the project’s README.txt for contribution guidelines or contact support channels if this is a commercial project.