DEV Community: Mior Muhammad Zaki

Extending default Fields on Laravel Nova

Mior Muhammad Zaki — Tue, 22 Dec 2020 07:43:48 +0000

Each project doesn't always expect the same set of default and you might have a requirement to customise Laravel Nova default behavior. For example setting default datetime format for DateTime field.

Imagine you have the following scenario:

use Laravel\Nova\Fields\DateTime;

DateTime::make('Created At')->sortable()->format('D-M-yyyy H:m'),
DateTime::make('Updated At')->sortable()->format('D-M-yyyy H:m'),

Instead of writing ->sortable()->format('D-M-yyyy H:m') for each field you can override the field by adding App\Nova\Fields\DateTime and add the following code:

<?php

namespace App\Nova\Fields;

class DateTime extends \Laravel\Nova\Fields\DateTime 
{
    /**
     * Create a new field.
     *
     * @param  string  $name
     * @param  string|null  $attribute
     * @param  mixed|null  $resolveCallback
     * @return void
     */
    public function __construct($name, $attribute = null, $resolveCallback = null)
    {
        parent::__construct($name, $attribute, $resolveCallback);

        $this->sortable()->format('D-M-yyyy H:m');
    }
}

And your fields can be simplify to:

use App\Nova\Fields\DateTime;

DateTime::make('Created At'),
DateTime::make('Updated At'),

By-passing Laravel Nova catch-all routes

Mior Muhammad Zaki — Sat, 19 Dec 2020 07:04:39 +0000

Laravel Nova routes by default will register a catch-all route to intercept all GET requests and propagate it to Vue router.

However if you application need to define alternative catch-all routes as well for SPA or any other requirement you should be able to handle it via Laravel Fallback Routes

Route::fallback(function ($fallbackPlaceholder) {
    // ...
});

If you need to more control instead of $fallbackPlaceholder, you need to register the route manually and ends with where() and fallback():

Route::get('/{locale}/{page}', function ($locale, $page) {
    // 
})->where('locale', 'en|es')->fallback();

Using Minio on Laravel + Vapor Locally

Mior Muhammad Zaki — Thu, 19 Nov 2020 01:10:25 +0000

Testing Laravel Vapor application with file uploads locally can be tricky. It is possible to setup S3 bucket to receive file from localhost by adding required CORS configuration but now you have the alternative of using Minio.

Prequisite

Setup laravel/vapor-core using Composer.
Setup laravel-vapor using NPM to allow file uploading.

Setup Minio

You can setup Minio locally using Docker or Homestead, however for this demonstration I will be using Takeout. Remember that you need to update config/filesystems.php to include minio disk configuration:

        'minio' => [
            'driver' => 's3',
            'key' => env('AWS_ACCESS_KEY_ID'),
            'secret' => env('AWS_SECRET_ACCESS_KEY'),
            'region' => env('AWS_DEFAULT_REGION'),
            'bucket' => env('AWS_BUCKET'),
            'endpoint' => env('AWS_ENDPOINT'),
            'url' => env('AWS_URL'),
            'use_path_style_endpoint' => true,
        ],

Also don't forget to update .env:

FILESYSTEM_DRIVER=minio
FILESYSTEM_CLOUD=minio

AWS_ACCESS_KEY_ID=minioadmin
AWS_SECRET_ACCESS_KEY=minioadmin
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=local
AWS_ENDPOINT=http://127.0.0.1:9000

Setup Laravel

Next we need to setup Laravel to authorize file uploads. You can refer to Storage > Authorization documentation. For testing you can just do the following on AppServiceProvider:

if ($this->app->isLocal()) {
    Gate::define('uploadFiles', fn ($user) => true);
}

Finally you need to map SignedStorageUrlController with the following files:

use App\Http\Controllers\SignedStorageUrlController;
use Laravel\Vapor\Contracts\SignedStorageUrlController as SignedStorageUrlControllerContract;

if ($this->app->isLocal()) {
    $this->app->singleton(
        SignedStorageUrlControllerContract::class, 
        SignedStorageUrlController::class
    );
}

And the following Gist should be published to app/Http/Controller/SignedStorageUrlController.php: