README

Este é um painel de administração de módulos para projetos em Yii2.

Funcionalidades

• 📦 Lista todos os módulos registrados (config/modules.php)
• ➕ Permite adicionar novos módulos via interface
• 🔍 Visualiza a estrutura de cada módulo:
  • Module.php
  • Controllers
  • Models
  • Views
  • Layouts
• ⚙️ Exibe o conteúdo do config/web.php

Instalação via Composer

composer require kairiroberto/yii2-modulo-admin

Instalação via Composer (repositório Git)

composer config repositories.yii2-modulo-admin vcs https://github.com/kairiroberto/yii2-modulo-admin
composer require kairiroberto/yii2-modulo-admin:dev-main

Instalação via app\modules

Baixa controllers/ModuloController.php, views/modulo/add.php, views/modulo/index.php, views/modulo/view.php e Module.php, corrigir os namespace das classes ModuloController e Module, finalmente, configurar o modulo no config/web.php.

Configuração Inicial

# Crie o arquivo de módulos se não existir
nano config/modules.php

Conteúdo:

<?php
return [];

# Garanta que a pasta de sessões existe e tem permissão
mkdir -p runtime/sessions
chmod -R 777 runtime/sessions

Ativação no Yii2

No arquivo config/web.php, registre o módulo e os array dos módulos que vão ser criados:

$config['modules']['moduloadmin'] = [
    'class' => 'kairiroberto\\moduloadmin\\Module',
];

$config['modules'] = array_merge(
    $config['modules'],
    require __DIR__ . '/modules.php'
);

Execução

php yii serve

Acesse no navegador:

http://localhost:8080/index.php?r=moduloadmin/modulo/index

Uso

1. Clique em "Adicionar Módulo"
2. Informe:
   • Nome do módulo (ex: teste)
   • Classe do módulo (ex: app\\modules\\teste\\Module)
3. Clique em "Ver Estrutura"
4. O sistema criará:
   • modules/teste/
   • Module.php
   • Subpastas padrão: controllers/, models/, views/layouts/
5. O sistema permite selecionar uma tabela do banco de dados e gerar automaticamente a estrutura MVC (Model, Controller e Views) utilizando o Gii embutido no próprio módulo.

Telas

Se quiser gerar automaticamente um Controller ou uma View base, abra uma issue ou envie um PR. ♥️