Integrated system that supports the website, registration and runtime processes.
Uses Laravel 4.2. Please refer the official docs to better understand the code.
API that provides data for the website front-end. Backend web app for various managers.
-
Clone the repository.
-
Run
composer install
. If you don't have composer yet, get it here. It will install all the required dependencies. -
Fill in configuration details inside the folder
app/config/local
. All the configuration files you need to edit are in this folder. -
Enter your hostname to detect the local environment in
bootstrap/start.php
. (Under Windows, use the commandhostname
in command prompt to get it. The value is case-sensitive.) To make sure Laravel has detected the correct environment, run the commandphp artisan env
from the root folder. It should show the current environment aslocal
. -
To set up database automatically, run the command
php artisan migrate:refresh --seed
. It will automatically fill up the database with seed values. Check theapp/database/migrations
andapp/database/seeds
folder to change the database fields. -
This should set up the installation, and should work locally.
-
Fill up configuration details for the production environment under
app/config/production
. -
Export the database from phpMyAdmin and import it into the database on the server.
-
Copy only the
public
folder to the path on the web server insidepublic_html
. The rest of the files will be stored outside thepublic_html
folder. -
Copy the
app
,bootstrap
andvendor
folders into a directory outsidepublic_html
, saybackend_files
. -
Update the paths in
public/index.php
with the full file paths to the bootstrap folder. Example,/home/user_name/backend_files/bootstrap/...
. -
Update the public path in
bootstrap/paths.php
to point to theindex.php
insidepublic_html
. -
You should be ready to go, and the app will be live.
If you're working on improving this, here are a few suggestions.
- Modify the Edit Homepage section so that all content in the homepage can be managed from the backend.
- When signing up managers, change to username instead of email. (This will be easier for them)
- The registration software is included in the system. You may hide it initially by editing the side menu in layouts (
user.blade.php
). - Hospitality section can be improved a lot - it was done in a very short timeframe.
- There were a few additional features/fixes added on run-time to the Registration Software which are not documented. Look at the commits, and contact the last year's registration coordinators for details.
- Results are not yet implemented.
- Insert the colleges list from last year to database before you make the site live.
- Basic details of user roles are in
ManageController.php
under the functiongetRoleName
.