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:

http://seu-projeto.test/admin/menu-builder

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:

📄 Licença

O AdminLTE Menu Builder é um software open-source sob a licença MIT.