laravel-package finetune

finetune/finetune

The Finetune CMS. Built on the laravel framework

, _(*1)

Finetune Content Management System

, _(*2)

Laravel Installation, _(*3)

This is a laravel plugin for laravel 5.4 or greater, to install laravel follow this guide https://laravel.com/docs/5.4/installation., _(*4)

To quickly install laravel, use this command, _(*5)

composer create-project --prefer-dist laravel/laravel ., _(*6)

This creates a default laravel installation in the folder your in, it presumes you have composer, if you don't follow the laravel installation guide linked above., _(*7)

Install Finetune, _(*8)

Install Finetune via composer is the easiest way :, _(*9)

composer require finetune/finetune:dev-master, _(*10)

There are different releases to choose from check the github page for more information on releases., _(*11)

Once installed you need to add the finetune service provider and the route service provider, the route service provider always needs to below the finetune service provider and any finetune plugins, but above the laravel AppServiceProvider. This allows the finetune routes to take precedence over the laravel routes file., _(*12)

Finetune\Finetune\FinetuneServiceProvider::class, Finetune\Finetune\FinetuneRoutesServiceProvider::class,, _(*13)

Once these are installed you need to run some artisan commands, this will publish all the config, views and migrations you need to use finetune., _(*14)

php artisan vendor:publish --force, _(*15)

You need to overwrite the files already present so we use the force tag to insure this, if you have made any config apart from the config/app.php then you will need to add it again., _(*16)

Installing the database, _(*17)

As this uses laravel any database that laravel supports finetune supports to, you configure your database in the same way as laravel, you can follow the laravel install guide (https://laravel.com/docs/5.5/database) or follow these steps (in this example we are using mysql with the username and database name of finetune), _(*18)

1) Login to mysql via a command line : mysql -u finetune -p, _(*19)

2) Create database : CREATE DATABASE finetune;, _(*20)

3) Exit from mysql terminal : exit;, _(*21)

Then configure your environment settings in the .env file, this is found in your root project area where you install laravel., _(*22)

There will be settings that look like this, _(*23)

DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=homestead DB_USERNAME=homestead DB_PASSWORD=secret, _(*24)

You need to configure these settings for your database settings, for the user and database above it would be:, _(*25)

DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=finetune DB_USERNAME=finetune DB_PASSWORD=secret, _(*26)

Once thats complete it's time to make a session table using laravels migration and then run the migrations, _(*27)

php artisan session:table php artisan migrate, _(*28)

This will then add all the tables to the database you need, now its time to run the install script., _(*29)

Install script, _(*30)

The final stage, this is where we add our superadmin user and the first sites domain, we will be using http:://www.finetunecms.co.uk for this example, you should just replace the information with your own., _(*31)

In the Command line interface type, _(*32)

php artisan finetune:install, _(*33)

This will start the install script, will seed the database with some default content to help you on your way to create your first website., _(*34)

It will ask a few questions the first bit is about your superadmin user, the following is the questions it asks and the data we used to create superadmin, _(*35)

Username, _(*36)

Superadmin, _(*37)

Firstname, _(*38)

Super, _(*39)

Lastname, _(*40)

admin, _(*41)

Email, _(*42)

Superadmin@admin.com, _(*43)

Password, _(*44)

secret, _(*45)

This will now add your superadmin to the database to allow you to login with finetune., _(*46)

The next part of the setup script will create your first site, _(*47)

Title of the new site, _(*48)

FientuneCMS, _(*49)

The dscpn of the new site, _(*50)

FinetuneCMS allows you to install a user friendly cms on top of laravel, _(*51)

The tag of the new site, _(*52)

finetune, _(*53)

Company Name, _(*54)

finetune, _(*55)

Company Person, _(*56)

Christopher Thompson, _(*57)

Company Email, _(*58)

chris@finetunecms.co.uk, _(*59)

Company Street, _(*60)

123 Somewhere road, _(*61)

Company Town, _(*62)

Finetune Town, _(*63)

Company Postcode, _(*64)

12345, _(*65)

Company Tel, _(*66)

000000, _(*67)

Company Region, _(*68)

United Kingdom, _(*69)

This information is required at this time but can be changed later, it doesn't have much validation on it so you can input any string., _(*70)

Once this is complete it will make the uploads folder with the site tag in your storage area of the laravel application, this will store all your images and files that need to be used., _(*71)

We now need to add permissions for laravel's bootstrap and the storage directory, I would recommend these on *nix OS's, _(*72)

sudo chgrp -R www-data storage bootstrap/cache, _(*73)

sudo chmod -R ug+rwx storage bootstrap/cache, _(*74)

Web server, _(*75)

Now you have completed the finetune install you need to setup a webserver, you will need to configure your webserver with certain cetains to get pretty urls, follow the laravel guide here https://laravel.com/docs/5.5/installation#web-server-configuration, _(*76)