A variety of utilities that are common and useful for several of our plugins and application.
This plugin is developed by Qobo for Qobrix. It can be used as standalone CakePHP plugin, or as part of the project-template-cakephp installation.
Install the pugin with composer:
composer require qobo/cakephp-utils
Load the plugin:
bin/cake plugin load Qobo/Utils --bootstrap
Check that the plugin is loaded:
bin/cake plugin loaded
The above should output the list of loaded plugins, with Qobo/Utils
being
one of them.
One of the primary objectives of this plugin is to simplify the loading and configuration of the AdminLTE theme CakePHP plugin. Here is what you need to set it up.
Load the AdminLTE plugin:
bin/cake plugin load AdminLTE --routes --bootstrap
Load AdminLTE plugin configuration at the bottom of config/bootstrap.php
:
Configure::load('admin_lte', 'default');
Here is an example configuration you can stick into config/admin_lte.php
:
<?php
return [
'Theme' => [
'folder' => ROOT,
'title' => 'My App',
'logo' => [
// This will be displayed when main menu is collapsed.
// You can use an <img> tag in here or anything else you want.
'mini' => 'A',
// This will be displayed when main menu is expanded.
// You can use an <img> tag in here or anything else you want.
'large' => 'My App',
],
'login' => [
'show_remember' => true,
'show_register' => false,
'show_social' => false,
],
],
];
Load AdminLTE theme in beforeRender()
method of src/Controller/AppController.php
:
// At the top of the file, together with other use statements:
use Cake\Core\Configure;
public function beforeRender(Event $event)
{
$this->viewBuilder()->theme('AdminLTE');
$this->set('theme', Configure::read('Theme'));
// $this->set('user', $this->Auth->user());
$this->set('user', []);
}
Load AdminLTE Form Helper in initialize()
method of src/View/AppView.php
:
public function initialize()
{
$this->loadHelper('Form', ['className' => 'AdminLTE.Form']);
}
For more information on initializing and configuring the AdminLTE theme, see plugin documentation