README

Installation

Add the following additional configuration to composer.json file of your project laravel (the composer.json file in the root project laravel).

"minimum-stability": "dev",

for example we can add it under "type" configuration :

{
    . . .
    "type": "project",
    "minimum-stability": "dev",
    "require": {
        . . .
    },
    . . .
}

note :

Just now this step is needed only because for now the webcore-base does not have a release version, later this will be discarded, after the release version has been published.

Well, to install the webcore on the existing Laravel Project is as follows :

composer require dandisy/webcore-base:dev-master

Publishing

This step will copy the webcore codes that you can customize into the laravel project.

php artisan vendor:publish --tag=webcore --force

Setup Laratrust

Webcore use laratrust as Role Based Access Control (RBAC), run the following artisan command to setting up it's package :

php artisan laratrust:setup

Dumping

Dump the composer packages

composer dump-autoload

Migrating & Seeding

Do the migration and seed

php artisan migrate --seed

Note :

if in this step you get an error SQLSTATE[42000], add the following to the boot() function in app/Providers/AppServiceProvider.php

\Illuminate\Support\Facades\Schema::defaultStringLength(191);

so, that way your AppServerProvider becomes :

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
    * Bootstrap any application services.
    *
    * @return void
    */
    public function boot()
    {
        \Illuminate\Support\Facades\Schema::defaultStringLength(191);
    }

    /**
    * Register any application services.
    *
    * @return void
    */
    public function register()
    {
        //
    }
}

then, after editing the AppServerProvider, run again the following :

php artisan migrate:fresh --seed

Linking Storage

Webcore includes file manager, to handle files that you upload. As well as laravel by default, these uploaded files will be stored in the storage folder, to be able to access these files, following Laravel's explanation we need to create a symbolic link in the public folder, as follows :

php artisan storage:link

Usage

After being confused to follow the step by step above, now webcore has been integrated with your laravel project.

Now you can try entering the admin webcore page at http://your-domain/admin with the following login accounts:

username/email :
    * superadministrator@app.com
    * administrator@app.com
    * user@app.com

password for all accounts : password

To try generator you can start generating admin page for manage (CRUD) of our pages, by running the following artisan command :

php artisan generate:api_scaffold Page --fieldsFile=Page.json --datatables=true --prefix=admin --logs

The command will generate all the code to CRUD into the Page table, including the migration file and its table with the schema as defined in the resources/model_schemas/Page.json file.

You can also try to generate CRUD interactively via the command line, without the need to set up the json file as a schema definition first, for example:

php artisan generate:api_scaffold Post --datatables=true --prefix=admin --logs

then if you prompted

Field: (name db_type html_type options) []:
>

you must input the name of fields, data type of the field in database, the type of html input form and last is options for the field but this is optional. for example you can try :

title text text

then you will be prompted

 Enter validations:  []:
 >

for this we will try to enter

required

which means that this field is needed to be filled in.

next we will be prompted repeatedly. And we can try, the following :

description text text-editor

the last

image text file-manager

then

exit

dandisy / webcore-base

Maintainers

Details