PHPackages                             agenciafmd/filament-banners - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. agenciafmd/filament-banners

ActiveLibrary[Admin Panels](/categories/admin)

agenciafmd/filament-banners
===========================

Filament - Banners

095PHP

Since Jun 20Pushed 2w agoCompare

[ Source](https://github.com/agenciafmd/filament-banners)[ Packagist](https://packagist.org/packages/agenciafmd/filament-banners)[ RSS](/packages/agenciafmd-filament-banners/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Filament Banners
================

[](#filament-banners)

[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE.md)

O pacote **Filament Banners** permite gerenciar e exibir banners de forma dinâmica no seu projeto. Ele oferece suporte para múltiplas localizações, campos personalizados (meta), suporte a imagens responsivas (desktop, notebook, mobile) e vídeos.

Instalação
----------

[](#instalação)

Você pode instalar o pacote via composer:

```
composer require agenciafmd/filament-banners
```

Execute as migrações:

```
php artisan migrate
```

Publique o arquivo de configuração (opcional):

```
php artisan vendor:publish --tag="filament-banners:config"
```

Registro no Filament
--------------------

[](#registro-no-filament)

Para habilitar o recurso no painel administrativo, adicione o plugin ao seu painel:

```
use Agenciafmd\Faqs\BannersPlugin;

return [
    'plugins' => [
        BannersPlugin::class,
    ],
];
```

Configuração
------------

[](#configuração)

No arquivo `config/filament-banners.php`, você pode definir as localizações dos banners. Cada localização pode ter configurações específicas de imagens e campos extras (meta).

```
'locations' => [
    'home' => [
        'label' => 'Home',
        'files' => [
            'desktop' => [
                'visible' => true,
                'width' => 1920,
                'height' => 1080,
                'ratio' => ['16:9'],
                'media' => '(min-width: 1400px)',
            ],
            // ... outras resoluções
        ],
        'meta' => [
            [
                'type' => \Agenciafmd\Banners\Enums\Meta::TEXT,
                'label' => 'Título',
                'name' => 'title',
            ],
        ],
    ],
],
```

Uso no Frontend
---------------

[](#uso-no-frontend)

O pacote disponibiliza um componente Blade para facilitar a exibição dos banners.

### Componente de Banner

[](#componente-de-banner)

Você pode usar o componente em qualquer arquivo Blade:

```

```

### Parâmetros do Componente

[](#parâmetros-do-componente)

- `quantity`: Quantidade de banners a serem exibidos (padrão: 3).
- `location`: Localização definida no arquivo de configuração (padrão: 'home').
- `random`: Se os banners devem ser exibidos em ordem aleatória (padrão: false).

Campos Adicionais (Meta)
------------------------

[](#campos-adicionais-meta)

Você pode adicionar campos extras aos banners através da configuração. Os tipos suportados no `Enums\Meta` são:

- `TEXT`
- `SELECT`
- `REPEATER`

Estes campos estarão disponíveis na variável `$banners` retornada para a view dentro da chave `meta`.

```
@foreach($banners as $banner)
    {{ $banner['meta']['title'] ?? $banner['name'] }}
@endforeach
```

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance63

Regular maintenance activity

Popularity12

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/7e4d60ba30f409161026fd37c5a106cc32c4e4d29411f805553623cca632dd72?d=identicon)[agenciafmd](/maintainers/agenciafmd)

---

Top Contributors

[![irineujunior](https://avatars.githubusercontent.com/u/260451?v=4)](https://github.com/irineujunior "irineujunior (9 commits)")[![joaopaulofmd](https://avatars.githubusercontent.com/u/170440826?v=4)](https://github.com/joaopaulofmd "joaopaulofmd (9 commits)")

### Embed Badge

![Health badge](/badges/agenciafmd-filament-banners/health.svg)

```
[![Health](https://phpackages.com/badges/agenciafmd-filament-banners/health.svg)](https://phpackages.com/packages/agenciafmd-filament-banners)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)