david-weber/dominion

A simple, clean admin package for Laravel 4 with no other dependencies.

Dominion

NOTICE: Unfortunately I will no longer be maintaining this repo.

A WIP admin package for Laravel 4 that has no dependencies other than Laravel 4. I would not call this production ready just yet, I am still finishing up some of the core modules., _(*1)

This is my first package and experience with Laravel, having switched from FuelPHP. I started this project to avoid having to create a new admin interface for each project, as I was previously doing. When I started this there weren't many admin packages for Laravel 4, and the few that there was were dependent on third-party packages or had jQuery UI or other components built into the frontend already. While not re-inventing the wheel is great, I am new to Laravel and want to use as much of the core code as possible and avoid third-party packages., _(*2)

All feedback is welcome and appreciated., _(*3)

Features

• Simple role and module based access control.
• Bootstrap 3 templating.
• Easy to extend admin interface.

Core Modules

• Module Groups - manage module groups.
• Modules - manage modules.
• Roles - manage user roles and their modules.
• Users - manage users.
• Log Viewer - view the application logs.

Road Map

• Unit Tests
• Functional Tests
• Auditing / Action Log
• More Coming Soon...

Getting Started

Configuration

1. Add the package to the require array in the file /composer.json:, _(*4)

   "david-weber/dominion": "dev-master", _(*5)

2. Change the model value in the file /app/config/auth.php to the following:, _(*6)

   'DavidWeber\Dominion\Models\User',, _(*7)

3. Add the following string to the providers array in the file /app/config/app.php:, _(*8)

   'DavidWeber\Dominion\DominionServiceProvider',, _(*9)

Installation

Run the following commands from your terminal / command prompt:, _(*10)

1. Publish Config, _(*11)

   php artisan config:publish david-weber/dominion, _(*12)

2. Publish Assets, _(*13)

   php artisan asset:publish "david-weber/dominion", _(*14)

3. Run Migrations, _(*15)

   php artisan migrate --package="david-weber/dominion", _(*16)

4. Run Seeders, _(*17)

   php artisan db:seed --class="DavidWeber\Dominion\Seeders\DatabaseSeeder", _(*18)

Admin Login

You can now browse to http://YourServer:ServerPort/AppRoot/admin, _(*19)

The default credentials are:, _(*20)

Username: admin, _(*21)

Password: password, _(*22)

Customization

1. Change the title, footer and logo in the file /app/config/packages/david-weber/dominion/config.php

Extending The Admin Interface

Modules

1. Create a controller which extends DominionController.
2. Create a Module Group entry via the admin GUI or with a seeder.
3. Create the Module entry via the admin GUI or with a seeder.
4. Assign the module to the user's role.
5. Views should extend 'dominion::templates.admin'

Theming The Admin Interface

Coming Soon..., _(*23)