Download the PHP package label305/auja-laravel without Composer

Auja for Laravel

Deprecated

This repo will no longer be maintained and will be deleted in the start of 2017.

About

Auja is an easy-to-use, easy-to-implement admin interface. It provides an easy and intuitive way for you to view and manipulate your data, so you can focus on more important matters. Auja is designed to be both user-friendly and developer-friendly by providing you with tools to setup your admin interface in a couple of minutes.

The Auja javascript frontend provides the graphical user interface. To determine its content, it relies on a JSON web-service you implement. Auja-PHP in turn, provides an Object Oriented approach to provide these JSON messages from a PHP application. In this repository you will find a Laravel implementation which you can use to setup Auja for your Laravel project.

Related repositories

• Auja - The frontend JavaScript GUI
• Auja PHP Development Kit - A web service development kit for communicating with the Auja javascript frontend

Installation and Setup

Because Auja uses both a library for the PHP backand and a library for the JavaScript frontend there a few more steps required to install Auja that you may be used to with other libraries.

1. npm.

2. Modify the gulpfile.js so all Auja's assets and scripts are placed in the correct folders when running gulp.

3. Install the Auja javascript files through bower. When installing through bower the gulp command is automaticly called by bower.

4. Install the Auja Laravel library through composer. The library depends on Auja-PHP which is a API wrapper for communicating with the javascript frontend.

5. Publish the Auja config file and main view

6. Add the AdminServiceProvider, AujaFacade and AujaRouteFacade to your app.php config file.

7. Customize the auja-laravel/config.php file and specify the models you wish to be included in the Admin interface.

8. Create a app/controllers/Admin/ClubsController.php or app/Http/Controllers/Admin/ClubsController.php, to manage the Clubs in your admin interface. You can do this for all your models. Here is an example:

9. Now setup the routes for the administration panel.

10. Tip: add the following lines to your .gitignore:

Setup Laravel to work with Bower and Gulp

1. Make sure node.js and npm are installed.

2. Intall bower and gulp.

3. Make sure you have setup the .bowerrc file for Laravel and gulp. By the way these are the Laravel 5 defaults but will work on other versions as well.

4. Install the javascript dependencies that are included in Laravel 5 by default. If you work with another version add the package.json file to your projects root.

   And run:

5. Setup the gulpfile.js in your projects root.

6. Now you're all setup. Laravel 5 also includes a bower.json file but placing this file is not mandatory for other versions.

Custom Model Configurations

You can provide your own subclasses of ModelConfig to the Auja config file in the models key. This way you can customize icons for example.

1. Create a new class that extends ModelConfig, for example UserConfig.

2. Modify the auja-laravel/config.php file to reference this new class.

Custom Auja Support Controller

By default Auja provides a default support controller to handle authentication and providing the main interface manifest. If you want your own AujaSupportController to handle authentication you can implement your own. Create a YourSupportController.php. This file contains information on what kind of information the admin area should contain and how administrators authenticate.

1. Set route to null in the configucation and create your own route to the controller.

2. Create the YourSupportController.php file and make sure it implements AujaSupportControllerInterface.

License

Copyright 2014 Label305 B.V.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.