webplusmultimedia/filemanager

Manage files with this file manager made with alpinejs, livewire and tailwind CSS

V0.9.9 2023-03-22 11:00 UTC

README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Want to manage your files and directories in a file manager?

This one is for you. Here is the file manager made with alpineJs, Livewire and Tailwind CSS for Laravel.

This is a simple one, just adding files and directories to a root directory(default is medias) in your public storage path. You can change it in the filemanager config file.

img.png

Installation

You can install the package via composer:

composer require webplusmultimedia/filemanager

You can publish the config file and change the root directory if you want:

php artisan vendor:publish --tag="filemanager-config"

This is the contents of the published config file:

return [
    'root' => 'medias',
];

Optionally, you can publish the views, but not recommended because will failing at an future update.

php artisan vendor:publish --tag="filemanager-views"

Finaly, you need to compile your assets with FileManager ones like that :

/* before @tailwind base in your resources/css/app.css */
@import "./vendor/webplusmultimedia/filemanager/resources/dist/css/filemanager.css";
@tailwind base;
/*  in your resources/js/app.js */
import './vendor/webplusmultimedia/filemanager/resources/dist/js/filemanager'
/* put that line in content key on your tailwind.config.js */
content:[
    '*** Others paths ***',
    './vendor/webplusmultimedia/filemanager/resources/dist/js/Components/**/*.js'
]

Usage

For simple use in a blade view :

<div class="py-12">
    <div class="max-w-7xl mx-auto sm:px-6 lg:px-8" aria->
        <div class="bg-white overflow-hidden shadow-sm sm:rounded-lg">
            <div class="p-6 text-gray-900 ">
                <h1 class="text-2xl uppercase font-bold mb-6">{{ __("Téléversement de fichiers") }}</h1>
                <!-- the livewire component -->
                <livewire:filemanager/>
            </div>
        </div>
    </div>
</div>

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

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