dmitrybubyakin / nova-medialibrary-field by dmitrybubyakin

Laravel Nova field for managing the Spatie media library.
342,087
258
5
Package Data
Maintainer Username: dmitrybubyakin
Maintainer Contact: dimabubyakin97@gmail.com (Dmitry Bubyakin)
Package Create Date: 2018-12-22
Package Last Update: 2024-01-26
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-03-27 03:24:38
Package Statistics
Total Downloads: 342,087
Monthly Downloads: 11,696
Daily Downloads: 537
Total Stars: 258
Total Watchers: 5
Total Forks: 60
Total Open Issues: 43

Medialibrary Field for Laravel Nova

Latest Version on Packagist Total Downloads

Laravel Nova field for managing the Spatie media library.

Features:

  • add media on update/create views
  • add existing media
  • crop media
  • sort media
  • display on the index view

Table of Contents

Screenshots

index view create view details view update view media actions media crop dialog media details dialog existing media dialog

Installation

This package can be installed via command:

composer require dmitrybubyakin/nova-medialibrary-field

Usage

Medialibrary::make($name, $collectionName = 'default', $diskName = ''),

Methods

Fields

Define custom fields for media. MediaFields is used by default.

Medialibrary::make('Media')->fields(function () {
    return [
        Text::make('File Name', 'file_name')
            ->rules('required', 'min:2'),

        Text::make('Tooltip', 'custom_properties->tooltip')
            ->rules('required', 'min:2'),

        GeneratedConversions::make('Conversions')
            ->withTooltips(),
    ];
})

AttachUsing

Called inside AttachController. AttachCallback is used by default. It accepts $fieldUuid which is used when a resource is not created. If you want to attach media on the create view, you should keep these lines in your callback.

Medialibrary::make('Media')
    ->attachUsing(function (HasMedia $model, UploadedFile $file, string $collectionName, string $diskName, string $fieldUuid) {
        if ($model instanceof TransientModel) {
            $collectionName = $fieldUuid;
        }

        $fileAdder = $model->addMedia($file);

        // do something

        $fileAdder->toMediaCollection($collectionName, $diskName);
    });

AttachExisting

Allow attaching existing media.

Medialibrary::make('Media')->attachExisting(); // display all media
Medialibrary::make('Media')->attachExisting('collectionName'); // display media from a specific collection
Medialibrary::make('Media')->attachExisting(function (Builder $query, Request $request, HasMedia $model) {
    $query->where(...);
});

MediaOnIndex

Display media on index

Medialibrary::make('Media')->mediaOnIndex(1);
Medialibrary::make('Media')->mediaOnIndex(function (HasMedia $resource, string $collectionName) {
    return $resource->media()->where('collection_name', $collectionName)->limit(5)->get();
});

DownloadUsing

Medialibrary::make('Media')->downloadUsing('conversionName');
Medialibrary::make('Media')->downloadUsing(function (Media $media) {
    return $media->getFullUrl();
});

PreviewUsing

Medialibrary::make('Media')->previewUsing('conversionName');
Medialibrary::make('Media')->previewUsing(function (Media $media) {
    return $media->getFullUrl('preview');
});

Tooltip

Medialibrary::make('Media')->tooltip('file_name');
Medialibrary::make('Media')->tooltip(function (Media $media) {
    return $media->getCustomProperty('tooltip');
});

Title

Medialibrary::make('Media')->title('name');
Medialibrary::make('Media')->title(function (Media $media) {
    return $media->name;
});

Croppable

https://github.com/fengyuanchen/cropperjs#options

Medialibrary::make('Media')->croppable('conversionName');
Medialibrary::make('Media')->croppable('conversionName', ['viewMode' => 3]);
Medialibrary::make('Media')->croppable('conversionName', function (Media $media) {
    return $media->getCustomProperty('croppable') ? ['viewMode' => 3] : null;
});

Single

https://docs.spatie.be/laravel-medialibrary/v7/working-with-media-collections/defining-media-collections/#single-file-collections

Medialibrary::make('Media')->single();

Accept

Medialibrary::make('Media')->accept('image/*');

MaxSizeInBytes

Medialibrary::make('Media')->maxSizeInBytes(1024 * 1024);

AttachOnDetails

Allows attaching files on the details view.

Medialibrary::make('Media')->attachOnDetails();

AttachRules

Medialibrary::make('Media')->attachRules('image', 'dimensions:min_width=500,min_height=500');

Autouploading

Medialibrary::make('Media')->autouploading();

Preview Customization

Medialibrary::make('Media')->withMeta([
    'indexPreviewClassList' => 'rounded w-8 h-8 ml-2',
    'detailsPreviewClassList' => 'w-32 h-24 rounded-b',
]);

Validation

Medialibrary::make('Media')
    ->rules('array', 'required') // applied to the media collection
    ->creationRules('min:2') // applied to the media collection
    ->updateRules('max:4') // applied to the media collection
    ->attachRules('image', 'dimensions:min_width=500,min_height=500'); // applied to media

Sorting

Medialibrary::make('Media')->sortable();

Authorization Gates 'view', 'update' and 'delete'

To view, update and delete uploaded media, you need to setup some gates. You can use the store and replace callbacks to store additional information to the custom_properties. The additional information can be used inside the gates for authorization.

Gate::define('view', function ($user, $media) {
    return true; // view granted
});

Gate::define('update', function ($user, $media) {
    return true; // update granted
});

Gate::define('delete', function ($user, $media) {
    return true; // deletion granted
});

You can also use the policy.

class MediaPolicy
{
    public function view(User $user, Media $media): bool
    {
        return true;
    }

    public function update(User $user, Media $media): bool
    {
        return true;
    }

    public function delete(User $user, Media $media): bool
    {
        return true;
    }
}

class AuthServiceProvider extends ServiceProvider
{
    protected $policies = [
        Media::class => MediaPolicy::class,
    ];

    //...
}

Translations

TODO

Changelog

Please see the CHANGELOG for more information about the most recent changed.

Alternatives

  • https://github.com/ebess/advanced-nova-media-library

License

The MIT License (MIT). Please see License File for more information.