oneduo/nova-file-manager

A handy file manager tool for Laravel Nova

Fund package maintenance!
oneduo

Installs: 107 323

Dependents: 2

Suggesters: 0

Security: 0

Stars: 137

Watchers: 5

Forks: 37

Open Issues: 15

v0.12.3 2024-08-08 14:25 UTC

README

Nova File Manager

Status License PHP Laravel Nova Latest Version on Packagist Total Downloads Downloads Run tests codecov

A file manager tool and field for Laravel Nova. Beautifully designed, and customizable, this tool will provide a plug'n'play solution for your file management needs.

Features :

โšก๏ธ Blazing fast
๐Ÿ“ฆ๏ธ Laravel Nova 4 compatible
๐Ÿ’… Built with Tailwindcss 3, Vue 3 and Pinia
๐Ÿชจ Rock solid codebase built with Typescript
๐Ÿ’ฝ Multi disk and filesystem support
๐Ÿงฉ Supports chunk and resumable uploads
๐Ÿ”ง Various customization and configuration options
๐Ÿ” A performant local search feature with Spotlight
๐Ÿคนโ€ Can save multiple assets from the same field
๐Ÿ” Access control and authorization gates
โœ‚๏ธ Built-in crop tool and image editor
๐Ÿ“‡ Built-in PDF viewer
๐Ÿ—‚๏ธ Drag and drop upload, with entire folder upload support
๐Ÿ—ƒ๏ธ Supports unzipping files
๐Ÿšฉ Onboarding tour for new users

Table of Contents

Getting Started

Prerequisites

This package requires the following :

  • PHP 8.0 or higher
  • Laravel Nova 4

Note If you plan on using this package with an S3 bucket, be mindful to follow the instructions for setting up an S3 storage disk.

Installing

To get started, you will need to install the following dependencies :

composer require oneduo/nova-file-manager

That's it, you're ready to go!

Configuration

You may publish the package's configuration by running the following command :

php artisan vendor:publish --tag="nova-file-manager-config"

Note You can find details about the configuration options in the configuration file section.

Usage

To get yourself started, you need to add the following tool to your NovaServiceProvider.php

// NovaServiceProvider.php

use Oneduo\NovaFileManager\NovaFileManager;

class NovaServiceProvider extends NovaApplicationServiceProvider
{
    // ...

    public function tools(): array
    {
        return [
            // ... any other tools
            NovaFileManager::make(),
        ];
    }
}

Now that the tool is registered, if you go back to your Nova dashboard, you should see a new navigation entry labeled " File Manager".

Once you've added the tool, you can start using it.

Go ahead and add a FileManager field to your Nova resource.

// app/Nova/User.php

use Oneduo\NovaFileManager\FileManager;

class User extends Resource
{
    // ...

    public function fields(NovaRequest $request): array
    {
        return [
            // ... any other fields
            FileManager::make(__('Avatar'), 'avatar'),
        ];
    }
}

You have now successfully added a File Manager field to your resource.

Configuration file

For a full list of updated configuration options, please refer to the full documentation at https://oneduo.github.io/nova-file-manager/configuration.html

Authors

See also the list of contributors who participated in this project.

Screenshots

You can find more screenshots here https://oneduo.github.io/nova-file-manager/screenshots.html.

Changelog

Please see CHANGELOG for more information what has changed recently.

Security

If you discover any security related issues, please email charaf@rezrazi.fr instead of using the issue tracker.

Contributing

Please see CONTRIBUTING for details.

Credits

License

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