Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 1.72 KB

README.md

File metadata and controls

49 lines (33 loc) · 1.72 KB

Kohana Admin module

Dependencies

Conventions

Controllers

All admin controller classes must start with Controller_Admin_ and extend (at least) Controller_Admin in order for ACL and templating to work.

In case you want a CRUD controller, you must only extend Controller_Admin_CRUD. Example:

class Controller_Admin_Topic extends Controller_Admin_CRUD {
	
	protected $_model = 'post';
	
}

$_model must be specified in CRUD controllers.

Views

All views must extend View_Admin_Layout in order to inherit Bootstrap templating capabilities. For CRUD operations, extend the related View:

  • View_Admin_Index (list of records)
  • View_Admin_Create (create new record)
  • View_Admin_Read (viewing single record)
  • View_Admin_Update (update single record)
  • View_Admin_Delete (delete single record)
  • View_Admin_DeleteMultiple (delete multiple records)

Usage

By default you don't need to add anything additionaly for direct model CRUD, just create the controller and that's it. Link will be automatically added to the header using Reflection.

If you need to add some custom actions, you will have to create a view model and template for them as well.

Permissions

This module relies on default Auth module to provide ACL (roles_users) but you can override this by extending the Controller_Admin::check_permissions() method in your child controller, e.g.

public static function check_permissions(Request $request)
{
	if ( ! something_wrong())
		throw new HTTP_Exception_403('Access denied.');
}