jeffersongoncalves / filament-topbar
A simple yet effective Filament plugin that automatically adds a customized topbar to your Filament admin panel. This plugin enhances your Filament panel's user experience by replacing the default topbar component with an improved version that displays navigation and user interface elements in strat
Installs: 2
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 0
Forks: 0
Open Issues: 0
Language:Blade
Requires
- php: ^8.2|^8.3
- filament/filament: ^3.0
- spatie/laravel-package-tools: ^1.14.0
Requires (Dev)
- larastan/larastan: ^3.0
- laravel/pint: ^1.21
- orchestra/testbench: ^9.0|^10.0
README
Filament Topbar
Description
A simple yet effective Filament plugin that automatically adds a customized topbar to your Filament admin panel. This plugin enhances your Filament panel's user experience by replacing the default topbar component with an improved version that displays navigation and user interface elements in strategic locations.
Preview
Features
- 🎨 Custom Topbar Component: Replaces the default Filament topbar with an enhanced version
- 🔧 Easy Integration: Automatically integrates with your existing Filament panels
- 🚀 Zero Configuration: Works out of the box after installation
- 📱 Responsive Design: Maintains Filament's responsive design principles
- 🔄 Backward Compatible: Preserves the original topbar functionality while adding enhancements
Requirements
- PHP 8.2 or higher
- Filament 3.x
Installation
You can install the package via composer:
composer require jeffersongoncalves/filament-topbar:^1.0
The package will automatically register its service provider and replace the default Filament topbar component.
Usage
Once installed, the package works automatically. No additional configuration is required. The enhanced topbar will be displayed in all your Filament admin panels.
$panel ->topbarNavigation();
How it works
The package:
- Backs up the original Filament topbar component as
filament-panels::topbar-backup
- Registers a new custom topbar component that replaces the default one
- Uses a custom Blade view that enhances the topbar functionality
Customization
If you need to customize the topbar view, you can publish the views:
php artisan vendor:publish --tag="filament-topbar-views"
This will publish the topbar view to resources/views/vendor/filament-topbar/components/topbar.blade.php
where you can modify it according to your needs.
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.