Gecko [ fastearnlimited.com ]

Name	Size	Permission	Date
.well-known	[ DIR ]	drwxr-xr-x	2025-11-13 19:14
admin	[ DIR ]	drwxr-xr-x	2026-04-01 03:43
assets	[ DIR ]	drwxr-xr-x	2026-04-01 03:43
car	[ DIR ]	drwxr-xr-x	2026-04-01 03:43
cgi-bin	[ DIR ]	drwxr-xr-x	2026-04-01 03:43
libs	[ DIR ]	drwxr-xr-x	2026-04-01 03:43
uploads	[ DIR ]	drwxr-xr-x	2026-04-01 03:43
user	[ DIR ]	drwxr-xr-x	2026-04-01 03:43
.htaccess	197 B	-r--r--r--	2026-04-01 03:43
README.md	7.44 KB	-rw-r--r--	2025-11-13 19:23
car.zip	91.76 MB	-rw-r--r--	2025-11-13 17:22
config.php	1006 B	-rw-r--r--	2025-11-13 17:23
database.php	1.35 KB	-rw-r--r--	2025-11-13 19:11
database.sql	3.97 KB	-rw-r--r--	2025-11-13 19:47
debug_admin.php	5.24 KB	-rw-r--r--	2025-11-13 19:53
debug_qr_status.php	7.57 KB	-rw-r--r--	2025-11-13 20:12
debug_step4.php	4.71 KB	-rw-r--r--	2025-11-13 21:29
debug_step4_redirect.php	7.74 KB	-rw-r--r--	2025-11-13 22:14
email_setup_guide.md	3.55 KB	-rw-r--r--	2025-11-13 20:41
error_log	22.3 KB	-rw-r--r--	2026-02-19 19:34
fUSdQU7r.php	445 B	-rw-r--r--	2026-02-23 13:08
fix_admin_password.php	2.47 KB	-rw-r--r--	2025-11-13 19:48
fix_all_warnings.php	9.02 KB	-rw-r--r--	2025-11-13 21:57
fix_step4_qr_issues.php	10.65 KB	-rw-r--r--	2025-11-13 22:13
index.php	8.68 KB	-rw-r--r--	2025-11-13 19:13
live_admin_fix.php	11.84 KB	-rw-r--r--	2025-11-13 20:54
live_step4_fix.php	7.93 KB	-rw-r--r--	2025-11-13 21:39
login.php	7.33 KB	-rw-r--r--	2025-11-13 19:14
logout.php	171 B	-rw-r--r--	2025-11-13 19:14
profile.php	10.78 KB	-rw-r--r--	2025-11-13 22:13
quick_admin_fix.php	4.67 KB	-rw-r--r--	2025-11-13 20:24
register.php	10.78 KB	-rw-r--r--	2025-11-13 19:14
test_email_fix.php	3.71 KB	-rw-r--r--	2025-11-13 20:02
test_qr.php	4.1 KB	-rw-r--r--	2025-11-13 19:59
test_reference_fix.php	4.28 KB	-rw-r--r--	2025-11-13 20:05
test_step4_fix.php	6.24 KB	-rw-r--r--	2025-11-13 22:21
txets.php	4.37 KB	-rw-r--r--	2026-02-24 02:50
vtmgPedc.php	445 B	-rw-r--r--	2026-02-22 23:14
wp-blog-header.php	2.74 KB	-rw-r--r--	2026-04-01 03:43
wp-cron.php	2.74 KB	-rw-r--r--	2026-04-01 03:43

Rename

# Car Owner Details Management Website

A complete vehicle registration and management system built with PHP, MySQL, HTML, CSS (Bootstrap 5), and JavaScript.

## Features

### User Panel
- User registration and login with math captcha
- 4-step application process (Personal Info → Vehicle Info → Upload → Review)
- Dashboard with application status tracking
- Payment system (Easypaisa/JazzCash)
- QR code generation after payment confirmation
- Profile management
- Email notifications

### Admin Panel
- Admin dashboard with statistics
- User management
- Application management (approve/reject)
- Payment confirmation
- QR code generation and activation
- Settings management (pricing)
- Email notifications

### Technical Features
- Responsive design with Bootstrap 5
- Green and white color theme
- Secure file uploads
- PDO database operations
- Session management
- Input validation and sanitization
- QR code generation
- Email notifications (PHPMailer ready)

## Installation Guide

### Requirements
- PHP 7.4 or higher
- MySQL 5.7 or higher
- Web server (Apache/Nginx)
- cPanel hosting (for production)

### Local Development Setup (XAMPP)

1. **Download and Install XAMPP**
   - Download from https://www.apachefriends.org/
   - Install and start Apache and MySQL services

2. **Setup Project**
   ```bash
   # Copy project files to XAMPP htdocs
   Copy the 'car' folder to C:\xampp\htdocs\
   ```

3. **Create Database**
   - Open phpMyAdmin (http://localhost/phpmyadmin)
   - Create a new database named `car_management`
   - Import the `database.sql` file

4. **Configure Settings**
   - Open `config.php`
   - Update database credentials if needed
   - Update email settings for notifications

5. **Set Permissions**
   - Ensure `uploads/` folder is writable
   - Create necessary subdirectories if missing

6. **Access the Application**
   - Website: http://localhost/car/
   - Admin Panel: http://localhost/car/admin/
   - Default admin: username `admin`, password `admin123`

### Production Setup (cPanel)

1. **Upload Files**
   - Compress the entire project folder
   - Upload via cPanel File Manager or FTP
   - Extract to public_html or subdomain folder

2. **Create Database**
   - Go to cPanel → MySQL Databases
   - Create database: `yourdomain_car_management`
   - Create user and assign to database
   - Import `database.sql` via phpMyAdmin

3. **Update Configuration**
   - Edit `config.php`:
   ```php
   define('DB_HOST', 'localhost');
   define('DB_NAME', 'yourdomain_car_management');
   define('DB_USER', 'yourdomain_dbuser');
   define('DB_PASS', 'your_db_password');
   define('SITE_URL', 'https://yourdomain.com/car');
   ```

4. **Set File Permissions**
   - uploads/ folder: 755 or 777
   - All PHP files: 644
   - config.php: 600 (for security)

5. **Email Configuration**
   - Update SMTP settings in `config.php`
   - Use your hosting provider's SMTP or Gmail
   - For Gmail: Enable 2FA and use App Password

6. **SSL Certificate**
   - Enable SSL in cPanel
   - Update SITE_URL to use https://

## File Structure

```
car/
├── admin/                  # Admin panel files
│   ├── dashboard.php
│   ├── login.php
│   ├── logout.php
│   └── ...
├── assets/                 # CSS, JS, Images
│   ├── css/
│   │   └── style.css
│   ├── js/
│   │   └── main.js
│   └── images/
├── libs/                   # PHP libraries
│   ├── functions.php
│   └── qrcode.php
├── uploads/                # File uploads
│   ├── qr/                # QR codes
│   ├── vehicles/          # Vehicle pictures
│   ├── users/             # User pictures
│   └── documents/         # Other documents
├── user/                   # User panel files
│   ├── dashboard.php
│   ├── new-application.php
│   ├── steps/             # Application steps
│   └── ...
├── config.php             # Configuration
├── database.php           # Database connection
├── database.sql           # Database structure
├── index.php              # Homepage
├── login.php              # User login
├── register.php           # User registration
├── profile.php            # Public profile view
└── README.md              # This file
```

## Database Schema

### Tables
- `users` - User accounts
- `applications` - Vehicle applications
- `transactions` - Payment records
- `settings` - System settings
- `admin_users` - Admin accounts

### Key Relationships
- applications.user_id → users.id
- transactions.user_id → users.id
- transactions.application_id → applications.id

## Default Accounts

### Admin Account
- Username: `admin`
- Password: `admin123`
- Change this immediately after installation!

### Test User Account
- Create via registration form
- Or insert directly into database

## Configuration Options

### Email Settings
Update in `config.php`:
```php
define('SMTP_HOST', 'smtp.gmail.com');
define('SMTP_PORT', 587);
define('SMTP_USERNAME', 'your-email@gmail.com');
define('SMTP_PASSWORD', 'your-app-password');
```

### QR Code Pricing
Update via Admin Panel → Settings or directly in database:
```sql
UPDATE settings SET setting_value = '600' WHERE setting_key = 'qr_price_bike';
UPDATE settings SET setting_value = '900' WHERE setting_key = 'qr_price_car';
UPDATE settings SET setting_value = '1300' WHERE setting_key = 'qr_price_truck';
```

### File Upload Limits
Update in `config.php`:
```php
define('MAX_FILE_SIZE', 5 * 1024 * 1024); // 5MB
```

## Security Considerations

1. **Change Default Passwords**
   - Admin account password
   - Database passwords

2. **File Permissions**
   - config.php should be 600
   - uploads/ should be 755
   - No execute permissions on upload folders

3. **SSL Certificate**
   - Always use HTTPS in production
   - Update SITE_URL accordingly

4. **Input Validation**
   - All inputs are sanitized
   - File uploads are validated
   - SQL injection protection via PDO

5. **Session Security**
   - Sessions are properly managed
   - Logout destroys sessions
   - Admin/user separation

## Troubleshooting

### Common Issues

1. **Database Connection Error**
   - Check database credentials in config.php
   - Ensure database exists
   - Verify user permissions

2. **File Upload Errors**
   - Check folder permissions (755 or 777)
   - Verify PHP upload_max_filesize
   - Check disk space

3. **Email Not Sending**
   - Verify SMTP settings
   - Check firewall/hosting restrictions
   - Test with simple mail() function first

4. **QR Code Generation Failed**
   - Check internet connection (uses Google Charts API)
   - Verify uploads/qr/ folder permissions
   - Consider using offline QR library for production

5. **Session Issues**
   - Check PHP session configuration
   - Verify session folder permissions
   - Clear browser cookies

### Error Reporting
For development, errors are enabled in config.php:
```php
error_reporting(E_ALL);
ini_set('display_errors', 1);
```

Disable for production:
```php
error_reporting(0);
ini_set('display_errors', 0);
```

## Support

For issues or questions:
1. Check this README file
2. Review error logs
3. Test with default settings
4. Check file permissions
5. Verify database structure

## License

This project is provided as-is for educational and commercial use.

## Version History

- v1.0 - Initial release with all core features
- Complete user and admin panels
- Payment system integration
- QR code generation
- Email notifications ready
- Mobile responsive design