thomaz / adminlte-menu
Um construtor de menus dinâmico para Laravel e AdminLTE v4
Maintainers
Requires
- php: ^8.2
- illuminate/support: ^10.0|^11.0|^12.0|^13.0
README
Um pacote completo, dinâmico e flexível (Plug & Play) para gerenciar menus do AdminLTE v4 no Laravel. Este pacote fornece um Painel de Controle nativo (CRUD) permitindo que você ou o administrador do sistema gerencie links, rotas, submenus e configurações visuais diretamente do banco de dados, sem precisar editar arquivos de configuração manualmente.
🚀 Requisitos
- Laravel 12.x ou 13.x
- PHP 8.2+
- AdminLTE 4 & Bootstrap 5 (Para o layout frontend)
📦 Instalação
Você pode instalar o pacote via composer:
composer require thomaz/adminlte-menu
Após a instalação, execute as migrations para criar as tabelas necessárias de configuração e itens de menu:
php artisan migrate
🛠️ Como Usar
Renderizando o Menu
Abra o arquivo principal do seu layout (onde a barra lateral do AdminLTE fica, geralmente sidebar.blade.php ou app.blade.php) e remova todo o HTML estático da tag 'aside'.
Substitua por um simples Componente Blade:
Pronto! O pacote irá buscar as configurações e renderizar todo o menu dinamicamente.
O Construtor de Menus (Painel de Controle)
O pacote já vem com um CRUD visual pronto para usar. Basta acessar a seguinte URL no seu navegador:
Nesta interface, você pode:
- Adicionar Itens e Submenus: Cadastrar links via URL direta (ex: /financeiro) ou via Route Name (ex: financeiro.index).
- Customizar Cores e Layout: Mudar a cor de fundo da Sidebar (Dark, Azul, Claro, Verde) e o Tema (Dark Mode / Light Mode).
- Alterar Marca: Definir o Nome do Sistema e configurar a Logomarca.
🎨 Customização (Opcional)
O pacote foi desenhado para ser completamente adaptável ao seu projeto.
Publicando a View do Construtor
Por padrão, a interface /admin/menu-builder usa um layout independente. Se você quiser que o construtor carregue dentro do layout nativo do seu sistema (com seu cabeçalho e rodapé), você pode publicar a view:
php artisan vendor:publish --tag=adminlte-menu-builder
Acesse o arquivo publicado em resources/views/vendor/adminlte-menu/builder/index.blade.php e altere a tag padrão para o seu layout, por exemplo: @extends('layouts.app').
Publicando os Componentes Visuais do Menu
Se você precisar alterar a forma como os links do menu do AdminLTE são gerados (adicionar badges, novos ícones, etc.), você pode publicar as views dos nodes:
php artisan vendor:publish --tag=adminlte-menu-views
⚙️ Variáveis de Configuração Disponíveis no Banco
O pacote gerencia tudo de forma limpa numa tabela Key-Value. As opções atualmente mapeadas no Painel de Controle são:
| Chave | Descrição | Exemplo de Valores |
|---|---|---|
| brand_name | Nome exibido na parte superior da Sidebar | "Keep Ur Money" |
| brand_logo | URL ou caminho relativo (na pasta public) da imagem de Logo | "/images/logo.png" |
| sidebar_bg | Cor de background principal da Sidebar | "bg-dark", "bg-primary", "bg-white" |
| theme | Tema base de componentes (Dark ou Light mode) | "dark", "light" |
📄 Licença
O AdminLTE Menu Builder é um software open-source sob a licença MIT.