library kobalt

hoppermagic/kobalt

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

Set of admin views and functionality to speed up development of small custom Content Management Systems built in Laravel...., _(*1)

Steps for using, _(*2)

If it doesn't auto discover, _(*3)

Config/app.php, _(*4)

Hoppermagic\Kobalt\KobaltServiceProvider::class

Package will automatically add the following but you might want to add these in config.app, _(*5)

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

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

Setup db preferences, _(*6)

Run the standard laravel auth generator, _(*7)

php artisan make:auth
php artisan migrate

Register yourself, disable the auth routes in web.php, _(*8)

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

Remember to comment out the Auth::routes(), _(*10)

From 5.8 it wont show register if the route doesn't exist., _(*11)

app.blade.php also contains a reference to the register route, so need to comment out, _(*12)

// 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, _(*13)

could put these in their own admin.php file....., _(*14)

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, _(*15)

Controllers\Auth\LoginController, _(*16)

Controllers\Auth\RegisterController, _(*17)

Controllers\Auth\ResetPasswordController, _(*18)

Middleware\RedirectIfAuthenticated, _(*19)

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

Css and Js links in admin template, _(*20)

app.blade.php, _(*21)

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


or

View Composer, _(*22)

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., _(*23)

Publish assets, _(*24)

admin js,, _(*25)

admin enhancements - Handy place for tiny_mce setup, select2 etc, _(*26)

css, _(*27)

admin images, _(*28)

admin nav partial, _(*29)

admin template, _(*30)

need to update this file with the latest structure from app.blade.php Pull in local version of tiny mce, _(*31)

use force to overwrite, _(*32)

after publishing amend the nav partial, _(*33)

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

Publish all admin views, _(*34)

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

Publish just the css and js, _(*35)

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

If you need to recompile the js/css, _(*36)

npm run production

Create model, admin controller, form and request, _(*37)

Will create RabbitController etc, _(*38)

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

//!TODO config/app.php, _(*39)

//!TODO Notes about editable, deleteable, addable, _(*40)

Forms, _(*41)

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

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

Form fields on desktop will be 60% width unless, _(*43)

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

Rich text fields, _(*44)

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