- How do I install Filament EasyFooter in a Laravel project with Filament v4 or v5?
- Run `composer require devonab/filament-easy-footer:^2.0` and publish the config with `php artisan vendor:publish --tag=filament-easy-footer-config`. Then add the plugin to your `AppServiceProvider` or `FilamentPanelProvider` using `EasyFooterPlugin::make()`. Ensure you’re on the `main` branch for compatibility.
- Can I use this package with Filament v3?
- Yes, but you must install version `1.x` via `composer require devonab/filament-easy-footer:^1.0` and switch to the `filament-v3` branch. The package maintains separate branches for Filament v3–v5 compatibility.
- What Laravel versions does this package support?
- The package supports Laravel 10 and 11. It’s designed specifically for Filament v3–v5, so ensure your Laravel version aligns with your Filament version (e.g., Filament v4 requires Laravel 9+).
- Do I need a custom Filament theme to style the footer?
- Yes, the package requires a custom Filament theme for styling. If you don’t have one, you’ll need to create a minimal theme (e.g., by publishing Filament’s assets and extending `theme.css`). The package provides default Tailwind CSS styles, but they rely on your theme for integration.
- How do I add a logo and links to the footer?
- Configure the logo via `withLogo('path/to/logo.svg', 'https://example.com')` and links using `withLinks([['label' => 'Docs', 'url' => '...']])` in your plugin initialization. The package supports up to 3 custom links by default.
- Can I hide the footer on specific pages, like the login page?
- Yes, use the `hiddenFromPages()` method to exclude pages, e.g., `EasyFooterPlugin::make()->hiddenFromPages(['admin/login', 'admin/register'])`. This is useful for security or UX reasons.
- How do I enable GitHub version and load time display?
- Publish the config file (`php artisan vendor:publish --tag=filament-easy-footer-config`) and set `github_version_enabled` and `load_time_enabled` to `true`. For GitHub versions, add a personal access token to the config for private repositories.
- Are there any performance concerns with the load time metric?
- The load time metric adds minimal overhead, as it uses PHP’s `microtime()` for measurement. If performance is critical, disable it via the config (`load_time_enabled: false`). It’s primarily cosmetic and doesn’t impact core functionality.
- What if I need more than 3 custom links in the footer?
- The package limits custom links to 3 by design. For more links, you’d need to fork the package or create a custom footer component using Filament’s render hooks (e.g., `panels::footer`). The plugin’s simplicity trades off flexibility for ease of use.
- How do I test this package in a CI/CD pipeline?
- Run `php artisan test` in your Laravel project to execute the package’s built-in tests. The package includes workflows for testing and code style checks, so ensure your CI environment matches the package’s PHP (8.1+) and Laravel requirements.