Download the PHP package rodsaseg/laravel-saseg without Composer

Laravel Web Installer | A Web Installer Package

• 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

1. From your projects root folder in terminal run:

2. Register the package

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

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

4. 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:

5. Run the migrations

6. 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);
}

7. 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:

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

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 :

Contributing

Stay tunned

Changelog

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