AFG CARS - Premium Car Marketplace Afghanistan (Offline Edition)
AFG CARS is a modern, responsive web application for buying and selling cars in Afghanistan. This version is specially prepared to run completely offline on a local XAMPP environment.
🚀 Key Features
- Offline Ready: No internet connection required. All assets (Bootstrap, Icons) are stored locally.
- Car Listings: Browse verified car listings across major Afghan cities (Kabul, Herat, etc.).
- User Authentication: Secure Login and Registration system.
- Admin Dashboard: Comprehensive panel for managing inventory, approvals, users, and sales.
- User Dashboard: Manage your own listings and view purchase history.
- Simulation Systems: Simulated banking payment and local mail logging.
💻 Installation (XAMPP)
-
Move Project Folder:
- Copy the
afg-carsfolder into your XAMPP'shtdocsdirectory (usuallyC:\xampp\htdocs\).
- Copy the
-
Start Services:
- Open the XAMPP Control Panel.
- Start Apache and MySQL.
-
Database Setup (Automatic):
- Open your browser and go to:
http://localhost/afg-cars/db/setup.php - This script will automatically create the
afg_carsdatabase and all required tables. - It will also insert a default admin account and sample listings.
- Open your browser and go to:
-
Database Setup (Manual - Optional):
- Go to
http://localhost/phpmyadmin/. - Create a database named
afg_cars. - Import the
db/database.sqlfile.
- Go to
🔐 Default Admin Credentials
- Email:
admin@gmail.com - Password:
12345678
📁 Project Structure
admin/: Admin-specific pages and dashboards.assets/: Local CSS, JS, and Bootstrap files.db/: Database configuration, setup script, and SQL schema.includes/: Reusable header and footer components.mail/: Offline mail simulation service.user/: User-specific dashboard and listing management.
🛠 Troubleshooting
- Database Connection Error: Ensure MySQL is running in XAMPP. Check
db/config.phpif you have changed the default XAMPP MySQL credentials (default isrootwith no password). - Broken Layout: Ensure the
assets/bootstrap/folder contains the required CSS and JS files. - Page Not Found: Ensure you are accessing the project via
http://localhost/afg-cars/.
🎓 University Project Note
This system is designed as a university final-year project to demonstrate full-stack web development capabilities using PHP, MySQL, and Bootstrap, with a focus on local enterprise deployment.
Description
Languages
PHP
79.1%
CSS
15%
JavaScript
5.9%