Instalação
Você pode instalar usando composer através do comando a seguir., (*1)
composer require cakephp-brasil/twitter-bootstrap
Certifique-se de carregar o plugin em config/bootstrap.php., (*2)
Plugin::load('TwitterBootstrap');
Como usar
Apenas adicione --theme TwitterBootstrap
no final do comando, por exemplo:, (*3)
bin\cake bake all MyModel --theme TwitterBootstrap
Em src/View/AppView.php adicionar $this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);
dentro de initialize()
, desta forma:, (*4)
public function initialize()
{
$this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);
}
Layout padrão
Para ativar o layout
Informe $this->viewBuilder()->theme('TwitterBootstrap');
no seu controller (por exemplo, AppController para usar em qualquer página)., (*5)
Em src/View/AppView.php adicionar $this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);
dentro de initialize()
, desta forma:, (*6)
Para alterar o título
No AppController apenas informe com $this->set('project_name', 'Título que você quer')
., (*7)
Crie um arquivo chamado nav-bar-right.ctp dentro de src/Template/Element (você pode copiar o modelo dentro de vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element), (*8)
Ou veja a Publicando as views necessárias automaticamente, (*9)
Crie um arquivo chamado nav-bar-left.ctp dentro de src/Template/Element (você pode copiar o modelo dentro de vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element), (*10)
Ou veja a Publicando as views necessárias automaticamente, (*11)
AdminLTE
Como ativar o layout
Informe $this->viewBuilder()->theme('TwitterBootstrap');
no seu controller (por exemplo, AppController para usar em qualquer página) e em seguida ativar o tema usando $this->viewBuilder()->layout('adminlte');
., (*12)
Em src/View/AppView.php adicionar $this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);
dentro de initialize()
, desta forma:, (*13)
public function initialize()
{
$this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);
}
Crie um arquivo chamado header.ctp dentro de src/Template/Element/adminlte (você pode copiar o modelo dentro de vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte), pode ser necessário criar o diretório adminlte., (*14)
Ou veja a Publicando as views necessárias automaticamente, (*15)
Para alterar a lateral esquerda
Crie um arquivo chamado sidebar.ctp dentro de src/Template/Element/adminlte (você pode copiar o modelo dentro de vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte), pode ser necessário criar o diretório adminlte., (*16)
Ou veja a Publicando as views necessárias automaticamente, (*17)
Para alterar o rodapé
Crie um arquivo chamado footer.ctp dentro de src/Template/Element/adminlte (você pode copiar o modelo dentro de vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte), pode ser necessário criar o diretório adminlte., (*18)
Ou veja a Publicando as views necessárias automaticamente, (*19)
Para alterar o bloco de conteúdo
Crie um arquivo chamado content.ctp dentro de src/Template/Element/adminlte (você pode copiar o modelo dentro de vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte), pode ser necessário criar o diretório adminlte., (*20)
Ou veja a Publicando as views necessárias automaticamente, (*21)
Para alterar o menu direito (aparece quando clica no link da roda dentada no topo)
Crie um arquivo chamado control_sidebar.ctp dentro de src/Template/Element/adminlte (você pode copiar o modelo dentro de vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte), pode ser necessário criar o diretório adminlte., (*22)
Ou veja a Publicando as views necessárias automaticamente, (*23)
Para desativar crie esta view vazia e remova o link no topo., (*24)
Publicando as views acima necessárias automaticamente
Contribuição do @josimar-lemos, (*25)
Tava achando muito trabalhoso (programador preguiçoso on) ter que copiar e colar os Elements do Tema toda vez que precisava mexer neles.., (*26)
Criei um Shell para facilitar o processo, coloquei só uma opção para copiar todos os Elements de uma vez, mas posso incrementar isso aí se quiserem., (*27)
Para testar:, (*28)
$ cd path-to-project
$ bin/cake TwitterBootstrap.publish
Ou:, (*29)
$ cd path-to-project
$ bin/cake TwitterBootstrap.publish all
------ Fim da nota, (*30)
Para contribuir
Faça um fork deste projeto, altere e envie um pull request, não esqueça de sugerir recursos., (*31)