Skip to content

Installation

Jeff Simons Decena edited this page Sep 26, 2018 · 24 revisions

Suggested Production installation

  • Sign-up with DigitalOcean and get $10 discount! Create a droplet with LEMP stack config

Admin dashboard login credentials:

Breaking changes

Suggested Local Development Environment

What you need

** Notes: Turn on VT-x on your machine: **

BUILD AND COMPILE ASSETS

  • If you haven't install node, install it now

  • Run: npm install

  • Then: npm run dev and wait for it to compile (currently, only admin assets are being compiled)

Installation Globally

  • Open your terminal and run vagrant box add laravel/homestead

  • Type cd ~ && git clone https://github.com/laravel/homestead.git Homestead

  • Go to ~/Homestead and run bash init.sh for Unix/Linux and init.bat for windows

  • Create the project with cd ~ && composer create-project jsdecena/laracom

  • Modify your Homestead.yml file in ~/.homestead folder with

folders:
    - map: ~/Code
      to: /home/vagrant/Code

sites:
    - map: homestead.app
      to: /home/vagrant/Code/laracom/public

Just make sure you have Code folder in your home directory. If you have other workspace folders, change the Code with your folder.

  • Then run vagrant up --provision

  • Wait until the provisioning is finished then you can go to http://192.168.10.10

OPTIONAL You can also set the IP and name to /etc/hosts like this 192.168.10.10 homestead.app so you can go to http://homestead.app

Native PHP server

  • You just need to run php artisan serve and it will open a browser for you

How to configure your e-commerce

  • Go HOMESTEAD directory via the terminal: cd ~/Homestead the run vagrant ssh

  • Once inside vagrant, cd to your project folder: cd ~/Homestead/Code/<project folder> and do composer install

  • Copy .env.example cp .env.example .env

  • If you are on homestead, default details DB connections are:

    • DB_CONNECTION=mysql
    • DB_HOST=192.168.10.10
    • DB_PORT=3306
    • DB_DATABASE=homestead
    • DB_USERNAME=homestead
    • DB_PASSWORD=secret
  • Run migration and seed default data with php artisan migrate --seed

  • Symlink the storage folder to public. Run php artisan storage:link. This is important to display the uploaded images

  • If you run your app with php artisan serve connect to your installed db connection

Other settings

  • By default, Paypal (Express Checkout) is the default payment gateway. You must configure the credentials in the payment methods admin:

    • Account ID = xxxxx-facilitator@email.com
    • Client ID = xxxx
    • Client Secret = xxxx
    • Payment URL = https://api.sandbox.paypal.com
    • Mode = sandbox or live
  • MailChimp Newsletter settings should be set in .env

    • MAILCHIMP_API_KEY=
    • MAILCHIMP_LIST_ID=
  • Set your mail server in the .env

    • MAIL_DRIVER=smtp
    • MAIL_HOST=smtp.mailtrap.io
    • MAIL_PORT=2525
    • MAIL_USERNAME=
    • MAIL_PASSWORD=
  • Set your shop default config

    • SHIPPING_COST=0
    • TAX_RATE=10
    • DEFAULT_CURRENCY=USD

Production installation

  • There are many ways to install it on your server. If you need help, you can message me for my service. Thanks!

That should be it! 🎉 If anything else for clarification, you can email ✉️ or message me. 😄

If you find this app useful, with a kind heart, consider a donation or by me a coffee