https://github.com/maiconpinto/cakephp-adminlte-theme
CakePHP AdminLTE Theme
https://github.com/maiconpinto/cakephp-adminlte-theme
adminlte cakephp cakephp-adminlte-theme theme
Last synced: 9 months ago
JSON representation
CakePHP AdminLTE Theme
- Host: GitHub
- URL: https://github.com/maiconpinto/cakephp-adminlte-theme
- Owner: maiconpinto
- License: mit
- Created: 2015-12-04T18:54:12.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-10-12T06:43:49.000Z (over 1 year ago)
- Last Synced: 2025-04-13T21:34:06.655Z (10 months ago)
- Topics: adminlte, cakephp, cakephp-adminlte-theme, theme
- Language: JavaScript
- Homepage: http://maiconpinto.github.io/cakephp-adminlte-theme/
- Size: 19.3 MB
- Stars: 177
- Watchers: 30
- Forks: 111
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CakePHP AdminLTE Theme (2.0.0)
**What's the news**
The AdminLTE was updated version to 2.4.5.
The CakePHP was updated version compatible to 4.0.0.
This release 2.0.0 is can be considered the stable version, as indicated in the [SemVer.org](https://semver.org/) recommendations.
### Installation
You can install using [composer](http://getcomposer.org).
```
composer require maiconpinto/cakephp-adminlte-theme
```
### Enable Plugin
```php
// src/Application.php
public function bootstrap()
{
$this->addPlugin('AdminLTE');
}
```
### Enable Theme
```php
// src/Controller/AppController.php
use Cake\Event\EventInterface;
public function beforeRender(EventInterface $event)
{
$this->viewBuilder()->setTheme('AdminLTE');
}
```
### Enable Form
```php
// src/View/AppView.php
public function initialize()
{
$this->loadHelper('Form', ['className' => 'AdminLTE.Form']);
}
```
### Configure
```php
// new config/adminlte.php file
return [
'Theme' => [
'title' => 'AdminLTE',
'logo' => [
'mini' => 'ALT',
'large' => 'AdminLTE'
],
'login' => [
'show_remember' => true,
'show_register' => true,
'show_social' => true
],
'folder' => ROOT,
'skin' => 'blue'
]
];
// config/bootstrap.php
Configure::load('adminlte', 'default');
```
# Customize Layout
If you want to [Customize Layout](https://github.com/maiconpinto/cakephp-adminlte-theme/wiki/Customize-Layout)
# What's the features
### Layouts
There are 10 layout files.
- boxed
- collapsed
- default **it's the main layout**
- documentation
- fixed
- lockscreen
- login
- print
- register
- top
### View Blocks
There are 3 Blocks where you can extend your theme.
- **css**
```php
fetch('css'); ?>
```
One example is `src/Template/Pages/home.ctp`:
```php
Html->css('AdminLTE./bower_components/morris.js/morris', ['block' => 'css']); ?>
```
- **script**
```php
fetch('script'); ?>
```
One example is `src/Template/Pages/home.ctp`:
```php
Html->script('AdminLTE./bower_components/morris.js/morris.min', ['block' => 'script']); ?>
```
- **scriptBottom**
```php
fetch('scriptBottom'); ?>
```
One example is `src/Template/Pages/home.ctp`:
```php
start('scriptBottom'); ?>
$.widget.bridge('uibutton', $.ui.button);
end(); ?>
```
### Elements
There are 7 element files.
- Element/
- aside/
- form
- sidebar-menu
- user-panel
- aside-control-sidebar
- aside-main-sidebar
- footer
- nav-top
### Flash Message
The theme is prepared to show Flash Messages.
```php
Flash->render(); ?>
Flash->render('auth'); ?>
```
### Bake
One of the better Cake features. The theme is prepared to use Bake.
```
bin/cake bake all user --theme AdminLTE
```
### View
- **AdminLTEView**
This is one the better theme feature. It change the pattern how Cake show view files.
Basically, you overwrite any theme, plugin and prefix files.
1. src/Template/Plugin/$theme/Plugin/$plugin/$prefix/
2. src/Template/Plugin/$theme/Plugin/$plugin/
3. src/Template/Plugin/$theme/$prefix/
4. src/Template/Plugin/$theme/
### FormHelper
FormHelper by default has format template based on Foundation template. This helper overwrite these templates.
### Behavior
- **DatepickerBehavior**
When you configure `App.defaultLocale` to `pt_BR` this Behavior is util.
### Locale
When you configure `App.defaultLocale` to `pt_BR` this Locale is util.
### Page debug
Added link to default page of CakePHP.
# Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request