README-windows.md

Guia para instalação no Windows

Chamarei o aplicativo de clientes e suporei a instalação em:

Em
c:\xampp\htdocs\clientes

Ajuste caso esteja instalando em outro diretório.

Criar um banco de dados chamado cliente para testes iniciais

Instalação do CakePHP 3 (Atualmente sem suporte ao Cake 4)

cd c:\xampp\htdocs
composer create-project --prefer-dist cakephp/app clientes
cd clientes

Instalação do Plugin

composer require ribafs/admin-br

Habilitar o Plugin

bin\cake plugin load AdminBr --bootstrap 

Pequena correção no PaginatorHelper

Até a versão 1.25 havia um pequneo problema na paginação, ficando com uma quebra de linha. Acontece que o colega https://github.com/eduardoves me mandou as recomendações para corrigir e agora tá beleza

Acesse a pasta onde instalou o Cake e edite o arquivo: vendor/friendsofcake/bootstrap-ui/src/View/Helper/PaginatorHelper.php Então comente as linhas seguintes: 59, 69, 70 e 71 Obrigado Eduardo. :)

Configurações

Banco de dados – config/app.pgp, configure user, senha e banco:

            'username' => 'root',
            'password' => 'root',
            'database' => 'cliente',

Em 'Error' =>
Troque - 'errorLevel' => E_ALL,
por
'errorLevel' => E_ALL & ~E_USER_DEPRECATED & E_USER_NOTICE,

Rotas – config\routes.php, comente esta linha abaixo:

Comente esta linhs
$routes->connect('/pages/*', ['controller' => 'Pages', 'action' => 'display']);

E adicione esta:
    $routes->connect('/', ['controller' => 'Users', 'action' => 'login']);

Executar o composer no plugin

cd c:\xampp\htdocs\clientes
composer dump-autoload -d vendor\ribafs\admin-br

Execute a migration

cd c:\xampp\htdocs\clientes)
bin\cake migrations migrate -p AdminBr
bin\cake migrations seed -p AdminBr

Geração do Código com o bake

cd clientes
bin\cake bake all groups -t AdminBr
bin\cake bake all users -t AdminBr
bin\cake bake all permissions -t AdminBr
bin\cake bake all customers -t AdminBr

Testes de uso do aplicativo

http://localhost/clientes

Ao abrir no navegador vemos:

Existem 4 usuários cadastrados:

super – manda chuva, pode tudo
admin – somente pode tudo nas tabelas administrativas: users, groups e permissions
manager – pode tudo somente na tabela customers
user – não pode nada, somente logar. Requer liberação de permissões

Obs.: a senha de cada um é esta:

super – abc123S@
admin – abc123A@
manager – abc123M@
user – abc123U@

Observe que as senhas tem um padrão para facilitar a memorização:

• Parte fixa para todos – abc123
• Primeira letra do login em maiúscula
• Todos finalizam com @

Mais Detalhes?

Veja o tutorial para customização do aplicativo com mais informações:

https://github.com/ribafs/admin-br/blob/master/TUTORIAL.md