Skip to content

Latest commit

 

History

History
155 lines (101 loc) · 10 KB

README.md

File metadata and controls

155 lines (101 loc) · 10 KB
Raw

CS2TP27 - 'UGame?' Project


Description

Repository containing source code for my University Team Project regarding a Full-Stack Website encompassing HTML, CSS, JS, Laravel (PHP) and SQL files.

We will commit all code to the main branch of this repository, all commit history will be viewable on the repository, including names and description of commits.

The following repository will include source code consisting of the following languages, including Blade (HTML), CSS, JavaScript, Laravel Framework (PHP) and SQL.

Table of Contents

Contributors

  1. DevPinda (Parminder Singh)
  2. SedulousFlame (Tyler Gilkes)
  3. Kesh0707 (Keshav Parikh)
  4. Victorymp (Victory Mpokosa)
  5. JahrayFacey (Jahray Facey)
  6. AR127 (Awais Riaz)
  7. Shinga1 (Shingai Mutumbi)
  8. Shaharyar05-beep (Muhammad Shaharyar Hussain Shigry)

Detailed Contributions

Below we have added the names of the contributors including the features they have added towards the completion of the project.

Parminder Singh

  • Created and Named Laravel Project.
  • Installed, verified and updated the compatibility of Laravel Dependencies: composer, node.js, npm.
  • Completed PageController and Web Routing in order to display the corresponding Blade PHP files upon entering the matching URL path.
  • Completed ProductsController and the relevant routing to display the products from the mySQL database to parsing the Array of Products in the front-end.
  • Installed and Setup Laravel Jetstream, LiveWire and other relevant dependencies for the Register and Login functionalities.
  • Created and Formatted the README.md file.
  • Developed and populated the database tables xboxProducts, playstationProducts and nintendoProducts; then set-up the routing to allow the database table to return to the specified front-end view.
  • Setup the functionality to allow Images to be displayed in the front-end by storing the image links in the database and then returning, formatting and displaying them in the front-end.

Tyler Gilkes

  • Designed the user interface of the website (multiple webpages) using Affinity Designer before implementation.
  • Designed the web graphics of the website.
  • Designed the ‘UGAME?’ logo using Affinity Designer.
  • Developed and built the entire user interface with web technologies: HTML, CSS and Javascript:
  • Responsible for all HTML and pages on the front-end (nintendo.blade.php, xbox.blade.php, playstation.blade.php, index.blade.php, about.blade.php (managed), contact.blade.php (managed) and the basket window)
  • Responsible for all CSS and styling on the front-end (style.css)
  • Responsible for all Javascript on the front-end (search.js, script.js, filter.js and embedded Javascript into ‘blade.php’ files)
  • Developed live search bar functionality (search.js)
  • Developed basket functionality (script.js), the ability to add products to the basket; users can close and open their basket at any time and remove items from the basket. The basket window also displays the current number of items, the current total price, a table of chosen items and the checkout button.
  • Developed filtered search functionality (filter.js), users can filter through all game products by their attributes; genre, price range, age rating and platform.

Shingai Mutumbi

Keshav Parikh

  • Developed the Order processing (Checkout page)
  • CSS for Admin Page
  • Debugging (HTML,CSS,PHP)

Jahray Facey

  • Obtained The Information for the products
  • Assisted with Database
  • Designed UI elements

Victory Mpokosa

Awais Riaz

  • Front end implementation (images for the prodcuts that are in the database and storage of images)
  • aided with the deployment of the database and website to the web server

Muhammad Shaharyar Hussain Shigry

  • Contacts page HTML

Pre-Requisites

- Git Bash: https://git-scm.com/downloads

- Composer: https://getcomposer.org

- XAMPP: https://www.apachefriends.org/download.html

Notes:

  • Make sure PHP is on the PATH inside the Environment Variables.
  • Make sure to run XAMPP with Administrator Privileges.

Installation

Below we have written a step-by-step list of instructions in order to download the source code, install dependencies and setup the project.

1. Open the folder with the directory below:

  • On Windows: C:\xampp\htdocs (Pre-requisite XAMPP is necessary)

2. Clone the repository to your local machine using Git (Pre-requisite Git is necessary)

Run the command below using Git Bash CLI:

  • Run: git clone https://github.com/DevPinda/CS2TP-Group-27-Project-1.git

3. Install dependencies (necessary)

Run the command below to install all the needed dependencies that are essential for the functioning of the Laravel project in the same Git Bash CLI window:

  • Run: composer install
  • Run: composer update (optional)

4. Copy .env.example file contents to .env (situational)

  • On Windows OS run: copy .env.example .env

  • On Linux OS run: cp .env.example .env

5. Generate Key (necessary)

To generate the key for the Laravel project run the command below:

  • Run: php artisan key:generate

6. Generate Database Tables from Migrations (necessary)

The comnmand below will generate the pre-coded tables for the database:

  • Run: php artisan migrate

7. Run PHP server

The command below will start the server on the local connection with the usual URL of: http://127.0.0.1@8000

  • Run php artisan serve