Introduction

Requirement

We recommend to use MAMP PRO (https://www.mamp.info/en/) instead of Xampp to create develop environment. With MAMP, you can easy to add/manage virtual domain like flex-home.local.

  • Apache, nginx, or another compatible web server.
  • PHP >= 7.2 >> Higher
  • MySQL Database server
  • PDO PHP Extension
  • OpenSSL PHP Extension
  • Mbstring PHP Extension
  • Exif PHP Extension
  • Fileinfo Extension
  • XML PHP Extension
  • Ctype PHP Extension
  • JSON PHP Extension
  • Tokenizer PHP Extension
  • Module Re_write server
  • PHP_CURL Module Enable

{warning} On this project, I use the latest Laravel version (currently 6.x). Please go to Laravel documentation page for more information.

Install on hosting

  • Upload all files into public_html.
  • Create a database and import data from database.sql (it's located in source code).
  • Create .env from .env.example and update your database information.

Install locally or in VPS

Install manually

  • Create .env file from .env-example and update your configuration

  • Run php artisan migrate to create database structure with no sample data or import default database from database.sql if you need sample data.

  • Run php artisan cms:user:create to create admin user

  • Run php artisan vendor:publish --tag=cms-public --force

  • Run php artisan cms:theme:activate flex-home

  • Go to Admin -> Plugins then activate all plugins

  • Run the first test with command php artisan serve. Open http://localhost:8000, you should see home page of Flex Home

If you need sample data, you can import it from database.sql

FlexHome should run on a virtual host. Create a virtual host like cms.local to run FlexHome. Follow these steps to see how to config virtual host: Setup virtual host.

Install by UI

Installation steps:

  • Access to your-domain.com/install to start install Flex Home. Welcome

  • Check server's requirements Check requirements

  • Config database information Config database

  • Create admin account Create admin account

  • Finish Finish

{note} After finished installation, please login to admin (/admin) and go to Plugins then activate all plugins to use.

Note: If you install it locally, you can run php artisan serve to start server then access to http://localhost:8000/install to start install by UI.

Note

This site can only be run at domain name, not folder link.

On your localhost, setting virtual host. Something like http://flex-home.local is ok.

Cannot use as http://localhost/flex-home/....

Please remove public in your domain also, you can point your domain to public folder

or use .httaccess (https://stackoverflow.com/questions/23837933/how-can-i-remove-public-index-php-in-the-url-generated-laravel)

Follow these steps to see how to config virtual host: Setup virtual host.

Well done! Now, you can login to the dashboard by access to your_domain_site/admin.

Username: botble
Password: 159357

Enjoy!