Katubo

An e-commerce web application for indigenous people where-in every product tells a story.

Team Members

• Joeylene Rivera
• Robert Federico
• Karl Macadangdang

Getting Started

Pre-requisite

• XAMPP
• NPM
• Git / Git Bash
• Composer
• Familiar with mySQL and PHP

Installation

1. Clone the Repository
2. Setting up a Virtual Host
3. Database Configuration
4. Populating the Database with some dummy data (optional)
5. Check the App

1. Clone the Repository

a. Go to C:/xampp/htdocs

cd 'C:/xampp/htdocs'

b. Clone the Repository

git clone https://github.com/bluehacks2020/Team-Ha-Hackdog.git

c. Go to the katubo directory

cd 'katubo'

d. Install Dependencies

composer install

2. Setting up a Virtual Host

a. Go to C:/xampp/apache/conf/extra/httpd-vhosts.conf. Edit then save.

# At the bottom of the file

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs"
    ServerName localhost
</VirtualHost>

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/katubo/public"
    ServerName katubo.me
</VirtualHost>

b. Open Notepad as Administrator. Then Open File: C:/Windows/System32/drivers/etc/hosts. Edit then save.

# At the bottom of the file

127.0.0.1 localhost
127.0.0.1 katubo.me

3. Database Configuration

a. Run both Apache and mySQL in the XAMPP Control Panel.

b. Go to localhost/phpmyadmin in your browser. Then login and create a database named katubo. In the main directory of katubo, find .env.example. Open it and update the database information below. After that, save it as .env.

Note

The default credentials for the phpMyAdmin are:

username: root

password:

You can leave the password blank.

APP_NAME=Katubo
...
DB_DATABASE=katubo
DB_USERNAME=myUsername
DB_PASSWORD=myPassword

c. Generate the Application Key

php artisan key:generate

d. Reset the Database if you have already ran the Database Migration at least once, else proceed to the next step.

php artisan migrate:reset

e. Run the Database Migration

php artisan migrate

4. Populating the Database with some dummy data (optional)

a. Populate the Database by running the Database Seeder. A dummy data has been provided.

composer dump-autoload

php artisan db:seed

b. Create a symbolic link:

php artisan storage:link

c. In the root directory of the repository, go to public/img/storage. Copy products to public/storage/.

d After that you're all set! You may now use the dummy accounts.

5. Check the App

a. Open a browser and go to katubo.me. Make sure that both Apache and MySQL are running on the XAMPP Control Panel.

b. Try to login.

c. Congrats! You're all set.

Main Techs

• HTML, CSS, JavaScript, PHP and MySQL
• Laravel - The web framework used
• jQuery - JavaScript library
• Bootstrap - CSS Framework

OS Techs

• Argon Laravel Dashboard - Frontend Preset for Laravel
• AOS - Animate on Scroll

Citations and Reference

• Unsplash
• Indigenous people seek markets for products
• Fast Facts: Indigenous Peoples in the Philippines