octobro/oc-boilerplate

v3 2022-06-08 03:25 UTC

This package is not auto-updated.

Last update: 2024-04-17 17:56:20 UTC


README

by Octobro

OctoberCMS is a powerful CMS based on Laravel PHP Framework.

Requirements

  1. PHP >= 7.4
  2. Composer 2
  3. October CMS License Key (auth.json)

Getting Started

  1. Clone to your base project directory.

    git clone --depth 1 https://github.com/octobroid/oc-boilerplate.git <project-name>
    
  2. Go to the project folder and don't forget to remove .git folder. Create your own repository.

    cd <project-name>
    rm -rf ./.git
    git init
    
  3. Put the auth.json to the root directory for your access to download the October CMS library. Don't forget to remove it from .gitignore if you already set up the project.

  4. Install composer dependencies.

    composer install
    
  5. Create configuration file .env (copy from .env.example) and set the database configuration.

    DB_HOST=localhost
    DB_DATABASE=<database-name>
    DB_USERNAME=<database-user>
    DB_PASSWORD=<database-password>
    
  6. Migrate October database.

    php artisan october:migrate
    
  7. For security reason, please generate new application key.

    php artisan key:generate
    
  8. To enable Laravel Horizon, run the command below to generate the assets.

    php artisan horizon:assets
    

Plugins

In this boilerplate, we've installed:

  1. RainLab.User
  2. RainLab.Sitemap
  3. RainLab.Pages
  4. Mja.Mail
  5. Jacob.Horizon

More plugins that we recommend (not installed yet):

  1. RainLab.Blog
  2. RainLab.Translate
  3. Responsiv.Uploader

To install plugin, run the command:

php artisan plugin:install <plugin-name>

Frontend Theme

We implement the minimalist CSS library Pico.css.

Coding Standards

Please follow the following guide: