Skip to content

Danthewaann/Kingdomhire-2.0

Repository files navigation

Kingdomhire-2.0

This is the repository for the new Kingdomhire-2.0 website re-design.
I thought it was a good time to re-visit www.kingdomhire.com and improve the site.

I am using Laravel 6 to aid in the development process.
I will be using a MySQL database backend for the new website.
The application needs to be compatible with MySQL 5.5, due to the web host only supporting it.

New Features

The Administrator Dashboard

A new admin dashboard, where an admin can access a dashboard that allows them to directly query the database.
The purpose of the dashboard is allow an admin to be able to manage vehicles, hires and reservations, along with smaller features included.

Website Front-end Update

More important business info will need to be displayed on the website, along with a more complete list of vehicles

Setup

Clone this repo with git clone https://github.com/dcrblack/Kingdomhire-2.0.git and then install Homestead and all of its prerequisites before setting up this website.

I've tested this codebase with verson v8.6.0 of Homestead, so make sure your Homestead checkout is that version e.g. git checkout v8.6.0.

Installation steps

After installing Homestead, do the following:

  1. run vagrant up to start your VM if you haven't already
  2. run vagrant ssh into your laravel/homestead VM
  3. run cd /home/vagrant/Kingdomhire-2.0 && composer install to install php dependencies.
  4. run composer run-script post-root-package-install to create .env config file
  5. run php artisan key:generate to create application key
  6. run php artisan migrate --seed to create and populate the db with dummy data (exclude --seed if you only want to create the db)
  7. run php artisan storage:link to create public/storage symlink to storage/app/public
  8. run php artisan schedule:run to convert reservations to active hires, and any active hires to past hires
  9. run php artisan user:create -t to create a test user so you can login to the admin dashboard (you can login to the dashboard at http://homestead.test/login)
  10. The application should now be viewable at http://homestead.test (or something similar e.g. 192.168.10.10)
  11. Enjoy browsing the application!

Other Documentation