hoppermagic/kobalt

Set of reusable views and code to help building small scale Laravel backends

v1.0.15 2022-10-05 10:24 UTC

Requires

• kris/laravel-form-builder: ^1.51.2
• laracasts/flash: ^3.0

MIT

• leigh kayley

README

Set of admin views and functionality to speed up development of small custom Content Management Systems built in Laravel....

Steps for using

If it doesn't auto discover

Config/app.php

Hoppermagic\Kobalt\KobaltServiceProvider::class

Package will automatically add the following but you might want to add these in config.app

Kris\LaravelFormBuilder\FormBuilderServiceProvider::class,
Laracasts\Flash\FlashServiceProvider::class,

'FormBuilder' => Kris\LaravelFormBuilder\Facades\FormBuilder::class,
'Flash'	=> Laracasts\Flash\Flash::class,

Setup db preferences

Run the standard laravel auth generator

php artisan make:auth
php artisan migrate

Register yourself, disable the auth routes in web.php

Add the non-registration routes from Router.php (auth method) to web.php

Remember to comment out the Auth::routes()

From 5.8 it wont show register if the route doesn't exist.

app.blade.php also contains a reference to the register route, so need to comment out

// From 5.8?
 
Auth::routes(['register', false]);

OR

//!TODO MAKE SURE YOU USE THE ONES FROM ROUTER.PHP
// Authentication Routes...
Route::get('login', 'Auth\LoginController@showLoginForm')->name('login');
Route::post('login', 'Auth\LoginController@login');
Route::post('logout', 'Auth\LoginController@logout')->name('logout');

// Password Reset Routes...
Route::get('password/reset', 'Auth\ForgotPasswordController@showLinkRequestForm')->name('password.request');
Route::post('password/email', 'Auth\ForgotPasswordController@sendResetLinkEmail')->name('password.email');
Route::get('password/reset/{token}', 'Auth\ResetPasswordController@showResetForm')->name('password.reset');
Route::post('password/reset', 'Auth\ResetPasswordController@reset');

Admin area web routes

could put these in their own admin.php file.....

Route::group([
        'namespace' => 'Admin',
        'prefix' => 'admin',
        'as' => 'admin.']
    ,function(){

        // STORIES
        Route::get('story/{story}/confirmdel', [
            'as' => 'story.confirmdel',
            'uses' => 'StoriesController@confirmDelete'
        ]);
        Route::resource('/story', 'StoriesController', [
            'except' => ['show'],
        ]);

        // STORY IMAGES
        Route::get('story/{story}/storyimage/{storyimage}/confirmdel', [
            'as' => 'story.{story}.storyimage.{storyimage}.confirmdel',
            'uses' => 'StoryImageController@confirmDelete'
        ]);
        Route::get('/story/{story}/storyimage/createbulk', 'StoryImageController@createBulkUpload')->name('storyimage.createbulk');
        Route::post('/story/{story}/storyimage/storebulk', 'StoryImageController@storeBulkUpload')->name('storyimage.storebulk');
        Route::resource('/story/{story}/storyimage', 'StoryImageController', [
            'except' => ['show','index'],
        ]);
        
        // Stories ajax routes
        Route::post('story/{story}/edit/imageload', 'StoriesController@imageGalleryLoad');
        Route::post('story/{story}/edit/imagesort', 'StoriesController@imageGallerySort');
        Route::post('story/sort', 'StoriesController@overviewSort');
    }
);

Make sure the following are pointing to the admin homepage

Controllers\Auth\LoginController

Controllers\Auth\RegisterController

Controllers\Auth\ResetPasswordController

Middleware\RedirectIfAuthenticated

protected $redirectTo = '/admin/overviewpage'; // Admin landing page

Css and Js links in admin template

app.blade.php

<link href="{{ asset('css/admin.css') }}" rel="stylesheet">
<script src="{{ asset('js/admin.js') }}"></script>

or

<script src="{{ asset('js/admin.js') }}" defer></script>

View Composer

FYI, KobaltServiceProvider makes sure the active variable is available in the admin nav partial, its pushing in segment(2) so make sure this is what you want. Undecided if this is a good thing.

Publish assets

admin js,

admin enhancements - Handy place for tiny_mce setup, select2 etc

css

admin images

admin nav partial

admin template

need to update this file with the latest structure from app.blade.php Pull in local version of tiny mce

use force to overwrite

after publishing amend the nav partial

php artisan vendor:publish --provider="Hoppermagic\Kobalt\KobaltServiceProvider" --tag=default --force

Publish all admin views

php artisan vendor:publish --provider="Hoppermagic\Kobalt\KobaltServiceProvider" --tag=admin-views --force

Publish just the css and js

php artisan vendor:publish --provider="Hoppermagic\Kobalt\KobaltServiceProvider" --tag=css-js --force

If you need to recompile the js/css

npm run production

Create model, admin controller, form and request

Will create RabbitController etc

php artisan make:ko-resources Rabbit
php artisan make:ko-controller Rabbit
php artisan make:ko-form Rabbit

//!TODO config/app.php

//!TODO Notes about editable, deleteable, addable

Forms

Form Builder Static type is now escaped, so if you need to pass a view in need to use unescaped static.

$this->addCustomField('unescaped-static', 'Hoppermagic\Kobalt\Forms\Fields\UnescapedStaticType');

Form fields on desktop will be 60% width unless

'attr' => [
    'class' => 'form-control full-width'
],

Rich text fields

'attr' => [
    'class' => 'rich-text'
],