ahmedebead / cakelte
CakePHP 4.x AdminLTE 3.1 Theme.
Installs: 4
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Language:JavaScript
Type:cakephp-plugin
Requires
- php: >=7.2.0
- cakephp/cakephp: ^4.0
Requires (Dev)
- phpunit/phpunit: ^8.5 || ^9.3
README
What's the news
The CakephpLte was updated version to 3.1.0.
The CakePHP was updated version compatible to 4.2.0.
Installation
You can install using composer.
composer require ahmedebead/cakephp-4-lte
Copy Assets
After above command Run this command
bin/cake plugin assets symlink
Enable Plugin
// src/Application.php public function bootstrap() { $this->addPlugin('CakephpLte', ['autoload' => true, 'bootstrap' => true, 'routes' => true]); }
Enable Theme
// src/Controller/AppController.php use Cake\Event\EventInterface; public function beforeRender(EventInterface $event) { $this->viewBuilder()->setTheme('CakephpLte'); $this->viewBuilder()->setClassName('CakephpLte.CakephpLte'); }
Enable Form
// src/View/AppView.php public function initialize() { $this->loadHelper('Form', ['className' => 'CakephpLte.Form']); $this->loadHelper('Paginator', ['templates' => 'CakephpLte.paginator-templates']); }
Configure
// new config/cakephplte.php file return [ 'CakephpLteTheme' => [ 'title' => 'CakephpLte', 'logo' => [ 'mini' => '<b>AE</b>LT', 'large' => '<b>Admin</b>LTE' ], 'login' => [ 'show_remember' => true, 'show_register' => true, 'show_social' => true ], 'folder' => ROOT, 'skin' => 'blue' ] ]; // config/bootstrap.php Configure::load('cakelte', 'default');
RTL Support
Just add rtl css and js to your layout (if you overwrite it )
// Css <!-- Bootstrap 4 rtl --> echo $this->Html->css('CakephpLte./css/bootstrap.rtl.min.css'); <!-- Custom CSS rtl --> echo $this->Html->css('CakephpLte./css/rtl.css'); // JS <!-- Bootstrap 4 rtl --> echo $this->Html->script('CakephpLte./js/bootstrap.rtl.min.js');
or use rtl layout
$this->layout = 'CakephpLte.rtl';
What's the features
Layouts
There are 2 layout files.
- default it's the main layout
- rtl
RTL Support
View Blocks
There are 3 Blocks where you can extend your CakephpLteTheme.
- css
<?php echo $this->fetch('css'); ?>
One example is src/Template/Pages/home.ctp
:
<?php echo $this->Html->css('CakephpLte./bower_components/morris.js/morris', ['block' => 'css']); ?>
- script
<?php echo $this->fetch('script'); ?>
One example is src/Template/Pages/home.ctp
:
<?php echo $this->Html->script('CakephpLte./bower_components/morris.js/morris.min', ['block' => 'script']); ?>
- scriptBottom
<?php echo $this->fetch('scriptBottom'); ?>
One example is src/Template/Pages/home.ctp
:
<?php $this->start('scriptBottom'); ?> <script> $.widget.bridge('uibutton', $.ui.button); </script> <?php $this->end(); ?>
Elements
There are 7 element files.
- Element/
- aside/
- form
- sidebar-menu
- user-panel
- aside-control-sidebar
- aside-main-sidebar
- breadcrumb
- footer
- nav-top
- aside/
Flash Message
The theme is prepared to show Flash Messages.
<?php echo $this->Flash->render(); ?> <?php echo $this->Flash->render('auth'); ?>
Bake
One of the better Cake features. The theme is prepared to use Bake.
bin/cake bake all user --theme CakephpLte
View
- CakephpLteView
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.
- src/Template/Plugin/$theme/Plugin/$plugin/$prefix/
- src/Template/Plugin/$theme/Plugin/$plugin/
- src/Template/Plugin/$theme/$prefix/
- 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
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request