STALLIONS FOOTBALL ACADEMY - CPANEL SHARED HOSTING INSTALLATION
Domain: https://stallionsfa.com.ng/
==============================================================

PACKAGE CONTENTS
----------------
StallionsFA-public_html-2026-11-11.zip
    Upload this ZIP into cPanel File Manager > public_html and extract it there.

stallionsfa_database-2026-11-11.sql
    Import this file into the new MySQL database using cPanel phpMyAdmin.
    The same SQL file is also included inside the ZIP as
    stallionsfa_database.sql.


SERVER REQUIREMENTS
-------------------
PHP 8.2 or newer with these extensions enabled:
intl, mbstring, mysqli, json, fileinfo, gd and openssl.

Apache mod_rewrite must be enabled. Most cPanel Apache hosting enables it.


INSTALLATION ORDER - NO TERMINAL REQUIRED
-----------------------------------------

1. POINT THE DOMAIN TO THE HOST
   In the domain registrar DNS settings, use the nameservers supplied by your
   hosting company. In cPanel, confirm that stallionsfa.com.ng points to
   public_html (or set that as its document root).

2. ENABLE SSL
   Open cPanel > SSL/TLS Status and run AutoSSL for stallionsfa.com.ng.
   Wait until https://stallionsfa.com.ng opens without a certificate warning.

3. SELECT PHP
   Open cPanel > MultiPHP Manager and select PHP 8.2 or PHP 8.3 for the domain.
   In Select PHP Version/Extensions, enable the extensions listed above.

4. CREATE THE DATABASE
   Open cPanel > MySQL Database Wizard.

   a. Create a database, for example: stallionsfa
   b. Create a database user and a strong password.
   c. Add the user to the database and grant ALL PRIVILEGES.

   cPanel normally prefixes both names. For example:
       Database: cpaneluser_stallionsfa
       Username: cpaneluser_stallions

   Save the exact database name, username and password.

5. IMPORT THE DATABASE WITH PHPMYADMIN
   Open cPanel > phpMyAdmin.

   a. Click the new database in the left sidebar.
   b. Click Import.
   c. Choose stallionsfa_database-2026-11-11.sql.
   d. Leave the format as SQL and click Import/Go.
   e. Confirm that phpMyAdmin reports a successful import and that tables such
      as users, players, programs and site_settings appear.

6. UPLOAD THE WEBSITE
   Open cPanel > File Manager > public_html.

   a. Back up or remove the host's default index.html if one exists.
   b. Upload StallionsFA-public_html-2026-11-11.zip.
   c. Extract it directly inside public_html.
   d. Confirm that index.php, .env, .htaccess, app, vendor, assets and writable
      are directly inside public_html. There must not be another public_html
      folder nested inside public_html.

7. CONNECT THE WEBSITE TO MYSQL
   In File Manager, enable "Show Hidden Files (dotfiles)" and edit:
       public_html/.env

   Replace only these three placeholder values with the exact details from
   step 4:

       database.default.database = 'CPANEL_DATABASE_NAME'
       database.default.username = 'CPANEL_DATABASE_USER'
       database.default.password = 'CPANEL_DATABASE_PASSWORD'

   Keep these supplied production values unchanged:

       CI_ENVIRONMENT = production
       app.baseURL = 'https://stallionsfa.com.ng/'
       database.default.hostname = 'localhost'
       database.default.DBDriver = MySQLi

8. SET WRITABLE PERMISSIONS
   In File Manager, set writable and all folders beneath it to 0755.
   If uploads, logs, sessions or cache cannot be written, use 0775 if allowed
   by the host. Do not use 0777 unless the hosting provider specifically
   requires it.

9. TEST THE SITE
   Website: https://stallionsfa.com.ng/
   Admin:   https://stallionsfa.com.ng/admin/login

   Initial administrator:
       Email:    admin@stallionsfa.test
       Password: ChangeMe!2026

   Change the administrator email and password immediately after first login.

10. CLEAN UP
    After the database imports successfully, delete these public files:
        stallionsfa_database.sql
        INSTALLATION.txt
        StallionsFA-public_html-2026-11-11.zip (if still in public_html)


COMMON CPANEL PROBLEMS
----------------------

500 Internal Server Error
    Check PHP 8.2+, required extensions and writable permissions. Temporarily
    inspect writable/logs for the newest log file. Do not switch the live site
    to development mode.

Database connection error
    Recheck the cPanel-prefixed database name and username, the password, and
    confirm the user has ALL PRIVILEGES on the database.

404 on every page except the homepage
    Ask the host to enable Apache mod_rewrite and AllowOverride for .htaccess.

Images or CSS do not load
    Confirm app.baseURL ends with one slash exactly:
        https://stallionsfa.com.ng/

Certificate warning
    Finish AutoSSL and DNS propagation before testing the HTTPS address.

