syscover/pulsar-core

Core package

Pulsar Core App for Laravel

, _(*1)

Pulsar is an application that generates a control panel where you start creating custom solutions, provides the resources necessary for any web application., _(*2)

Installation

1 - After install Laravel framework, execute on console:, _(*3)

composer require syscover/pulsar-core

Register service provider, on file config/app.php add to providers array**, _(*4)

/*
 * DH2 Application Service Providers...
 */
Syscover\Core\CoreServiceProvider::class,

2 - Execute publish command, _(*5)

php artisan vendor:publish --provider="Syscover\Core\CoreServiceProvider"

3 - And execute migrations, _(*6)

php artisan migrate

4 - Execute command to create encryption keys fot laravel passport, _(*7)

php artisan passport:install

5 - Add Passport::routes method within the boot method of your app/Providers/AuthServiceProvider, _(*8)

This method will register the routes necessary to issue access tokens and revoke access tokens, clients, and personal access tokens, _(*9)

use Laravel\Passport\Passport;

/**
 * Register any authentication / authorization services.
 *
 * @return void
 */
public function boot()
{
    $this->registerPolicies();

    Passport::routes();  // add laravel passport routes
}

6 - Don't forget to register CORS in your server, the following example is for apache server, _(*10)

Header add Access-Control-Allow-Origin "*"
Header add Access-Control-Allow-Headers "authorization, origin, x-requested-with, content-type"
Header add Access-Control-Expose-Headers "authorization"
Header add Access-Control-Allow-Methods "PUT, GET, POST, DELETE, OPTIONS"

7 - You may need to extend both the PHP memory on your server as well as the upload limit, _(*11)

php_value post_max_size 1000M
php_value upload_max_filesize 1000M
php_value memory_limit 256M

8 - create link to storage folder, _(*12)

php artisan storage:link

9 - Execute publish command, _(*13)

php artisan vendor:publish --provider="Nuwave\Lighthouse\LighthouseServiceProvider"
php artisan vendor:publish --provider="Syscover\Core\CoreServiceProvider"

10 - Set GraphQl middleware, _(*14)

In config/lighthouse.php add to route => middleware array, _(*15)

'middleware' => ['api', 'client'],

and add the validation handler in error_handlers, _(*16)

'error_handlers' => [
    ...
    \Syscover\Core\GraphQL\Execution\ExtensionValidationErrorHandler::class,
    ...
],

11 - Consumption of the API from localhost To consume API resources from your own domain you can use the following route., _(*17)

https://yourdomian.com/graphql/localhost

You will need to send CSRF token in your requests to verify that you make the requests from laravel., _(*18)

12 - Add scss In file in resources/assets/sass/app.scss you can add utilities scss files, _(*19)

// Material
@import "../../../vendor/syscover/pulsar-core/src/resources/sass/material/elevations";

// Partials
@import "../../../vendor/syscover/pulsar-core/src/resources/sass/partials/forms";
@import "../../../vendor/syscover/pulsar-core/src/resources/sass/partials/typography";
@import "../../../vendor/syscover/pulsar-core/src/resources/sass/partials/helpers";
@import "../../../vendor/syscover/pulsar-core/src/resources/sass/partials/cookies-consent";
@import "../../../vendor/syscover/pulsar-core/src/resources/sass/partials/vue";

if you use Laravel Mix set this code, _(*20)

mix
    .styles([
        ...
        'vendor/syscover/pulsar-core/src/assets/vendor/bootstrap/css/bootstrap.min.css',
        ...
    ], 'public/css/all.css')
    .sass([
        ...
        'vendor/syscover/pulsar-core/src/assets/scss/app.scss',
        ...
    ], 'public/css/app.css')
    .scripts([
        ...
        'vendor/syscover/pulsar-core/src/resources/vendor/polyfill/array.prototype.find.js',
        'vendor/syscover/pulsar-core/src/resources/vendor/polyfill/array.prototype.foreach.js',
        'vendor/syscover/pulsar-core/src/resources/vendor/territories/js/jquery.territories.js',
        'vendor/syscover/pulsar-core/src/resources/vendor/check-postal-code/jquery.check-postal-code.js',
        'vendor/syscover/pulsar-core/src/resources/vendor/jquery-validation/jquery.validate.min.js',
        'vendor/syscover/pulsar-core/src/resources/vendor/jquery-validation/additional-methods.min.js',
        'vendor/syscover/pulsar-core/src/resources/vendor/js-cookie/src/js.cookie.js',
        'vendor/syscover/pulsar-core/src/resources/vendor/cookie-consent/cookie-consent.js'
        ...
    ], 'public/js/all.js')