michaeld555/filament-explorer

A powerful file, folder, and media browser with an integrated code editor for Laravel Filament.

v1.0.0 2025-03-24 04:09 UTC

This package is auto-updated.

Last update: 2025-03-24 04:14:11 UTC


README

Latest Version on Packagist Total Downloads

Overview

Filament File Explorer is a file explorer and media browser that includes an integrated code editor. It allows you to access and manage server files directly from the Filament panel.

Warning

This package is intended for super-admins only. It provides unrestricted access to all files and directories on the server and should not be made available to regular users.

📥 Installation

To install the package, run the following command in your terminal:

composer require michaeld555/filament-explorer

After installation, run the setup command:

php artisan filament-explorer:install

Then, register the plugin in your panel provider file located at /app/Providers/Filament/YourPanelProvider.php:

->plugin(
    \Michaeld555\FilamentExplorer\FilamentExplorerPlugin::make()
        ->hiddenFolders([
            base_path('app')
        ])
        ->hiddenFiles([
            base_path('.env')
        ])
        ->hiddenExtensions([
            "php"
        ])
        ->allowCreateFolder()
        ->allowEditFile()
        ->allowCreateNewFile()
        ->allowRenameFile()
        ->allowDeleteFile()
        ->allowMarkdown()
        ->allowCode()
        ->allowPreview()
        ->hideFromPanel() // Optionally, hide menu navigation from the panel
        ->basePath(base_path())
)

📦 Publishing Assets

If you need to customize some configurations, you can publish the package files using the following commands:

📄 Configuration file:

php artisan vendor:publish --tag="filament-explorer-config"

🎨 View files:

php artisan vendor:publish --tag="filament-explorer-views"

🌍 Language files:

php artisan vendor:publish --tag="filament-explorer-lang"

📜 Changelog

See the CHANGELOG for more details on recent changes.

👥 Credits

📄 License

This project is licensed under the MIT License. See the LICENSE.md file for more details.