PG Hostel Finder Final Year PHP Project

• Admin login for this final year project
• Admin dashboard with high-level platform counts and links
• Student/user list with enquiry, booking, and complaint counts
• User block and unblock controls
• Owner list filtered by verification status
• Owner verify and reject workflow with reason
• Owner block and unblock controls
• Listing moderation with approve and reject actions
• System-wide enquiries oversight
• System-wide booking oversight
• Review approval and hide controls
• Complaint status update: Open, In progress, Resolved, Rejected
• Complaint resolution notes visible to user and owner
• Facilities master list viewing
• Static page and platform data support from schema
• Admin activity and moderation-ready database structure

• Student registration and login in this final year project
• Forgot password with OTP email support
• Profile update with name, mobile, address, college/company, gender preference, and optional photo
• Change password
• Soft deactivate account
• Dashboard with quick stats and links
• Browse and search PG/hostel listings
• Filter by city, area, pincode, rent range, PG type, room type, and availability
• Sort by newest, rent low-high, and rent high-low
• Listing detail with gallery, rent, deposit, maintenance, facilities, rules, nearby text, and owner context
• Add/remove favorites and view shortlist
• Send enquiry with optional preferred visit date
• View enquiry thread and owner replies
• Request booking with move-in date, room type, persons, and optional ID proof
• Cancel pending booking
• Printable confirmation slip for approved bookings
• Submit star rating and review text
• Raise complaint with type, optional listing, subject, description, and screenshot
• Track complaint status and admin resolution
• In-app notifications for replies and booking outcomes

• Owner registration and login in this final year project
• Optional property proof and ID proof uploads
• Forgot password with OTP email support
• Owner profile update
• Verification status display: Unverified, Verified, Rejected
• Change password
• Dashboard with listing, enquiry, booking, and occupancy summary
• Add PG listing with address, city, area, pincode, PG type, rooms, beds, deposit, maintenance, nearby text, and availability
• Multiple room types with rent
• Facilities assignment from master list
• House rules such as timing, visitors, and smoking
• Multiple listing photo uploads
• Edit existing listings
• New listings remain pending until admin approval
• Enquiry list per property
• Reply to student enquiries
• Booking request list
• Approve booking and generate confirmation number
• Approved booking reduces available beds
• Reject booking with optional reason
• View reviews on own listings
• Complaint list and owner response to admin
• ublic homepage included in this final year project
• Static pages such as About, Terms, and Privacy via slug
• Contact form stored in database
• PDO prepared statements
• Session-based authentication for User, Owner, and Admin roles
• Bcrypt password hashing with password_hash() and password_verify()
• Upload directories for profiles, listings, ID proofs, owner documents, and complaints
• Placeholder image fallback for missing seed listing photos
• SITE_URL configuration for subfolder deployments
• Email OTP support through PHP mail/SMTP constants
• Schema includes banners, static pages, OTP store, review reports, and admin activity log tables
• Suitable for final year project demo, viva, source code review, and report preparation

• Install PHP 7.4+ with pdo_mysql; mbstring and openssl are recommended.

• Create a MySQL database for this final year project:

  mysql -u root -p -e "CREATE DATABASE pg_finder CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

• Import schema:

  mysql -u root -p pg_finder < database/schema.sql

• Optional: import demo data:

  mysql -u root -p pg_finder < database/seed.sql

• Configure config/config.php:
  • DB_HOST
  • DB_NAME
  • DB_USER
  • DB_PASS
  • SITE_URL
  • SMTP/OTP constants if using forgot password

• Create upload folders:

  mkdir -p uploads/profiles uploads/listings uploads/id_proofs uploads/owner_docs uploads/complaints

• Run locally:

  cd "PG Finder"
  php -S localhost:8000

• Open:
  http://localhost:8000
• Set SITE_URL to match the exact URL, such as http://localhost:8000.

Admin

• Username: admin
• Password: password

After seed.sql

All seeded users and owners use password: password.

Students

• [email protected]
• [email protected]
• [email protected]

Owners

• [email protected] — verified owner with listings
• [email protected]
• [email protected]
• [email protected] — unverified example