Download the PHP package mostafaznv/nova-file-artisan without Composer

Nova File Artisan

Nova File Artisan is a package that integrates Larupload with Laravel Nova. Larupload is a file uploader for Laravel, which is based on ORM and allows users to upload images, videos, audios, and other known file formats.

With Nova File Artisan, you can use the features of both packages to create a admin panel for your Laravel project. You can upload and display various types of files (such as images, videos, audio, etc.) in your Nova resources. You can also transform your files (such as resizing, cropping, compressing, etc.) using Larupload's methods. You can also set your upload settings (such as disk, path, visibility, etc.) using Larupload's options.

Nova File Artisan is simple to install and use, and it supports multiple file systems (such as local, s3, sftp, etc.).

Demo

I am on an open-source journey 🚀, and I wish I could solely focus on my development path without worrying about my financial situation. However, as life is not perfect, I have to consider other factors.

Therefore, if you decide to use my packages, please kindly consider making a donation. Any amount, no matter how small, goes a long way and is greatly appreciated. 🍺

Some features for Nova Artisan Field:

• Display a wide variety of file types, such as video, audio, and HLS, with exceptional quality.
• Automatic resizing and cropping of photos and videos.
• Automatic creation of multiple sizes for videos and images.
• Support for creating and displaying HTTP Live Streaming (HLS) from video sources.
• Automatic generation of cover images for video files.
• Ability to upload a custom cover for each file.
• Built-in support for image optimization.
• Extraction of image width and height.
• Extraction of video width, height, and duration.
• Extraction of audio duration.
• Extraction of the dominant color from images and videos.
• Download button for each file style.
• Compatibility with various storage drivers.
• Video processing through a queue system.
• Ready for integration with a REST API.
• All Larupload features are accessible in Nova File Artisan.

Requirements:

• PHP 8.2 or higher
• Larupload 1.0.4 or higher
• Laravel 10.4.1 or higher
• Nova 4.27 or higher

Installation and Usage

[!NOTE]
Ensure that you have already installed and configured the Larupload package in your Laravel application. If you haven't done so, please refer to the Larupload documentation for instructions on installation and usage. It's important to create attachments for each model before proceeding with Nova File Artisan.

1. Install the package via composer:

2. Publish config file:

3. Prepare Migration & Model (for more information, see Larupload documentation)

Migration

Model

4. Prepare Nova Resource

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

Get Attachment Metadata

You can print extracted metadata from your files using NovaFileArtisanMeta field. This field is a read-only field, and it is only used to display metadata.

Working with Covers

Covers are automatically generated for videos and images, but you also have the option to upload custom covers for these and any other file types.

However, there may be occasions when you need to hide the cover on the details page or even remove the cover uploader from the form. You can achieve this by using the hideCoverFromDetail and hideCoverUploader methods.

Hide Cover Uploader

Hide Cover From Detail Page

Notes

Pruning Files

Nova's prunable method does not work with NovaFileArtisan field as expected. As you may know, in Larupload, there is an option to turn on/off preserve-files. This option is used to prevent files from being deleted when the model is deleted from the database, and it aligns with the behavior expected from the prunable method. Therefore, if you want to keep files when the model is deleted, you should set preserve-files to true. You can do this either in your Larupload configuration file or in your file attachment instance.

I am on an open-source journey 🚀, and I wish I could solely focus on my development path without worrying about my financial situation. However, as life is not perfect, I have to consider other factors.

Therefore, if you decide to use my packages, please kindly consider making a donation. Any amount, no matter how small, goes a long way and is greatly appreciated. 🍺

Demo:

https://github.com/mostafaznv/nova-file-artisan/assets/7619687/20af12ab-0ba1-4767-9b0c-e4a49a0b8e5b

License

This software is released under The MIT License (MIT).