MADRASATU TARTEELIL QUR'AN — SCHOOL PORTAL v2 (multi-branch)

INSTALL ON CPANEL
1. Create a MySQL database + user in cPanel (MySQL Databases) and give the user ALL PRIVILEGES.
2. Upload this zip to public_html (or a sub-folder) and Extract.
3. Open  https://your-site/install.php  — enter the database details and the head-office admin login.
   (Tables are created automatically. database.sql is only needed if you prefer phpMyAdmin.)
4. Log in at /login.php → "Teachers & staff" → School settings: bank account(s), OPay / Moniepoint keys (optional),
   social media links, Director / Mudir names, departments, programmes, FAQ, YouTube links.
5. Website & uploads (head office menu): logo, banner/letterhead, stamp, home page slideshow, pictures,
   photo gallery, short videos (up to 100 MB) and audio (recitations / nasheeds, up to 50 MB).
   Big videos upload in small pieces, so they work even when cPanel's upload limit is only 2 MB.
Requires PHP 8.0+ with pdo_mysql, zip, mbstring, fileinfo, curl (gd recommended for resizing photos).

HOW IT WORKS
- Branch registers → pays (OPay / Moniepoint online, or bank transfer + receipt) → head office approves → School Portal v2.
  Registration receipt prints on POS 80 mm / A5 / A4.
- Parents apply online (apply.php) with department, State/LGA, family, health and Qur'anic details → print the form →
  branch admits → student ID (MTQ/Y26/001) + parent PIN.
- Each branch has a public page (branch.php?id=…) listing its departments, classes and the other branches.
- Upload students from Excel (.xlsx), CSV or typed PDF. ID cards with attendance QR. Hifz, attendance, fees.
- Musabaqah with scores and rankings; certificates and testimonials verified by QR at verify.php.
