Download the PHP package cyberline/filament-navigation-footermenu without Composer

Filament Navigation Footer Menu

A Filament v4, v5 panel plugin that adds a configurable footer navigation block to your panel:

• Sidebar mode (default navigation): a collapsible group at the bottom of the sidebar, aligned with Filament’s native navigation styling. Items expand upward so the trigger stays at the bottom (useful above the user area).
• Top navigation mode ($panel->topNavigation()): a compact icon trigger with a dropdown menu, placed in the top bar with correct spacing next to the user menu.

Styling uses Filament’s own components and CSS tokens, so light/dark mode matches the rest of your panel.

Requirements

Installation

1. Install the package

From Packagist:

From a GitHub/VCS repository (before Packagist, or for forks):

Local path repository (monorepo or development):

Stable installs: this package declares a concrete version in composer.json so projects with "minimum-stability": "stable" can require it without treating the VCS checkout as dev-main.

2. Register the Laravel service provider

The package registers FooterMenuServiceProvider via Composer’s extra.laravel.providers for package discovery.

In fresh clones or CI, if bootstrap/cache/packages.php is missing or package:discover did not run, you may see:

No hint path defined for [filament-navigation-footermenu].

Alternatively, ensure composer install / php artisan package:discover completes successfully after every deploy.

3. Register the Filament plugin on your panel

In your PanelProvider (e.g. app/Providers/Filament/AdminPanelProvider.php), add the plugin to the panel’s plugins array:

No ->register() call on the plugin is required beyond Filament’s normal plugin registration on the panel.

Publishing (optional)

Publish and customize config, views, or translations:

After publishing views, your copies live under resources/views/vendor/filament-navigation-footermenu/.

Configuration

Default values are merged from config/filament-navigation-footermenu.php.

You can leave everything in config, override everything in the panel, or mix (plugin fluent API wins over config for the options you set).

Usage

Fluent API (FooterMenuPlugin)

All chainable methods return static for fluent configuration.

Example – separator from main nav (Tailwind classes):

Fluent item API (FooterMenuItem)

Resolved row shape (useful inside custom Blade): label, icon, url, open_in_new_tab, badge, badge_color, badge_tooltip.

Array-based items

Arrays are normalized to FooterMenuItem internally. Supported keys:

Example:

Dynamic items with Closure

Custom Blade view

Point the plugin at your own view:

Your view is included with the following variables (non-exhaustive):

When a custom view is set, the plugin still renders the outer shell (sidebar group / dropdown); your view replaces the default list of links only.

Behaviour & layout

Sidebar (default navigation)

• Registered on PanelsRenderHook::SIDEBAR_FOOTER.
• Renders below other sidebar footer content (e.g. user menu when shown in the sidebar), matching Filament’s footer hook order.
• Uses Filament sidebar group / item classes so spacing matches the main navigation.

Top navigation

• When the panel uses top navigation, the plugin does not render in the sidebar footer hook for that panel state.
• Primary placement: PanelsRenderHook::USER_MENU_AFTER — output sits inside .fi-topbar-end, so Filament’s gap-x-4 applies between the user menu and your trigger (no overlap with the avatar).
• Fallback: if there is no user menu in the topbar (userMenu(false) or user menu only in the sidebar), the plugin renders on PanelsRenderHook::TOPBAR_END instead, with extra margin so the trigger does not collide with adjacent controls.

The topbar trigger is an x-filament::icon-button with a circular hit area and hover styles consistent with Filament.

Visibility and tenancy

The plugin does not render when:

• the user is not authenticated in the current panel context, or
• the panel has tenancy enabled and no tenant is resolved yet, or
• ->visible(false) (or a Closure resolving to false) is set on the plugin.

Use ->visible() for feature flags, permissions, or environment-specific menus.

Translations

The package ships with English and German language files under the filament-navigation-footermenu translation namespace.

Example:

Publish if you need to override strings per app.

Tailwind / Vite (Filament theme)

This package’s Blade views use Tailwind utility classes (for example px-6, pb-3, flex) alongside Filament’s fi-* classes. Filament’s default pre-built panel CSS is compiled from Filament’s own sources only; it does not scan vendor/cyberline/filament-navigation-footermenu, so those utilities may be missing in the browser unless your app compiles a custom Filament theme that includes this package in Tailwind’s content scan.

Required steps (Filament v4+ with Vite)

1. Create a panel theme CSS file (e.g. resources/css/filament/{panel-id}/theme.css). The Filament stub pattern is:

   Adjust relative paths if your file lives elsewhere.

2. Register the theme on your panel in PanelProvider:

3. Add the theme to Vite in vite.config.js (Laravel Vite input array) so it is built with npm run build / npm run dev.

4. Rebuild assets after upgrading this package, editing its views, or changing Tailwind classes in the theme (npm run build, or keep npm run dev running).

If you publish views

After php artisan vendor:publish --tag=filament-navigation-footermenu-views, add an @source line for your app copy so Tailwind scans the published blades, for example:

You can keep or remove the vendor @source depending on whether you still load views from the package.

Optional: avoid a custom theme

You can avoid relying on extra Tailwind utilities by using only Filament’s documented fi-* patterns and inline styles the default bundle already includes, or by shipping a tiny non-Tailwind CSS file — but the default package views expect a theme build that scans them as above.

License

MIT — see LICENSE.md.