README

About
Requirements
Installation
Middleware
PermissionKey
Routes
Usage
Contributing
License

About

Do you want your clients to be able to install a Laravel project just like they do with WordPress or any other CMS? This Laravel package allows users who don't use Composer, SSH etc to install your application just by following the setup wizard. The current features are :

Check For Server Requirements.
Check For Folders Permissions.
Ability to set database information.
- .env text editor
- .env form wizard
Migrate The Database.
Seed The Tables.

Requirements

Laravel 5.8.*

Installation

From your projects root folder in terminal run:

    composer require rodsaseg/laravel-saseg

Laravel 5.5 and up Uses package auto discovery feature, no need to edit the config/app.php file.

Publish the packages views, config file, assets, and language files by running the following from your projects root folder:

	#default Views and Controllers
    php artisan vendor:publish --tag=laravelsaseg

	#Spatie Permission
    php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"

	#Spatie Media Library
    php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="migrations"

	#DataTables
    php artisan vendor:publish --tag=datatables

	#Laravel Installer
    php artisan vendor:publish --tag=laravelinstaller

	#Laravel Migrations Laravel Saseg
    php artisan vendor:publish --provider="Rodsaseg\LaravelSaseg\Providers\LaravelSasegServiceProvider" --tag="migrations"

Clear your config cache. This package requires access to the permission config. Generally it's bad practice to do config-caching in a development environment. If you've been caching configurations locally, clear your config cache with either of these commands:

	php artisan optimize:clear
	# or
	php artisan config:clear

Run the migrations

	php artisan migrate

	composer dump-autoload

Run the seeders

Update run() function in DatabaseSeeder.php. Add the next lines:

public function run()
{
    $this->call(UsersTableSeeder::class);
    $this->call(PermissionSeeder::class);
    $this->call(RolesTableSeeder::class);
    $this->call(ModelHasRolesTableSeeder::class);
	$this->call(RoleHasPermissionsTableSeeder::class);
}

	php artisan db:seed

	php artisan cache:forget spatie.permission.cache

Dependencies npm

Add these dependencies to your project

"dependencies": {
    "bootstrap-datepicker": "^1.9.0",
    "datatables.net": "^1.10.23",
    "datatables.net-bs4": "^1.10.23",
    "datatables.net-buttons": "^1.6.5",
    "datatables.net-buttons-bs4": "^1.6.5",
    "dropzone": "^5.7.0",
    "jquery-scroll-lock": "^3.1.3",
    "jquery.scrollbar": "^0.2.11",
    "js-cookie": "^2.2.1",
    "sortablejs": "^1.13.0",
    "sweetalert2": "^10.14.0",
    "trumbowyg": "^2.23.0"
}

add this line to your webpack.mix.js:

	mix.js('resources/js/vendor/panel/scripts/index.js', 'public/panel/assets/js/main.js');

	php artisan vendor:publish --tag=fm-config

	php artisan vendor:publish --tag=fm-assets --force

Update leftPath and rightPath from your config/file-manager.php

    /**
     * Default path for left manager
     *
     * null - root directory
     */
    'leftPath' => 'media',

    /**
     * Default path for right manager
     *
     * null - root directory
     */
    'rightPath' => 'media',

Middleware

Update the redirect function inside Middleware/Authenticate.php with:

if (! $request->expectsJson()) {
	if(preg_match("/\bpanel\b/", $request->route()->getName())){
		return route('panel.unauthenticated');
	}else{
		session()->flash('login', true);
		return route('/');
	}
}

Preparing Your Models

The HasRoles and HasMediaTrait trait must be added to the User model to enable this package's features.

Thus, a typical basic User model would have these basic minimum requirements:

use Illuminate\Foundation\Auth\User as Authenticatable;
use Spatie\Permission\Traits\HasRoles;
use Spatie\MediaLibrary\HasMedia\HasMedia;
use Spatie\MediaLibrary\HasMedia\HasMediaTrait;

class User extends Authenticatable implements HasMedia
{
	use HasRoles;
	use HasMediaTrait;

	// ...
}

To associate media with a model, the model must implement the following interface and trait:

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Spatie\MediaLibrary\HasMedia\HasMedia;
use Spatie\MediaLibrary\HasMedia\HasMediaTrait;

class News extends Model implements HasMedia
{
	use HasMediaTrait;
	...
}

PermissionKey

Add the next alias inside config/app.php:

'aliases' => [
	...
    'PermissionKey' => App\Providers\PermissionKey::class
]

Here, you can define your models and the corresponding permissions.

Routes

These routes would be available for proper installation or update

/install
/update

Usage

Install Routes Notes
- In order to install your application, go to the /install route and follow the instructions.
- Once the installation has ran the empty file installed will be placed into the /storage directory. If this file is present the route /install will abort to the 404 page.
Update Route Notes
- In order to update your application, go to the /update route and follow the instructions.
- The /update routes countes how many migration files exist in the /database/migrations folder and compares that count against the migrations table. If the files count is greater then the /update route will render, otherwise, the page will abort to the 404 page.
Additional Files and folders published to your project :

File	File Information
`config/installer.php`	In here you can set the requirements along with the folders permissions for your application to run, by default the array cotaines the default requirements for a basic Laravel app.
`public/panel`	All the assets necesary for the panel
`public/installer/assets`	This folder contains a css folder and inside of it you will find a `main.css` file, this file is responsible for the styling of your installer, you can overide the default styling and add your own.
`resources/views/vendor/installer`	This folder contains the HTML code for your installer, it is 100% customizable, give it a look and see how nice/clean it is.
`resources/lang/en/installer_messages.php`	This file holds all the messages/text, currently only English is available, if your application is in another language, you can copy/past it in your language folder and modify it the way you want.

Contributing

Stay tunned

Changelog

Please see CHANGELOG for more information on what has changed recently.

rodsaseg / laravel-saseg

Maintainers

Details