moszkva/angie

Laravel Angular routing manager. Generates angular routing rules and services from serverside routing rules.

Saturday, March 29, 2014
by Moszkva
Repository
1 Watchers
2 Stars
27 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
8 Versions
0 % Grown

The README.md

Angie

Laravel-Angular routing manager. Generates angular routing rules from serverside routing rules and services., _(*1)

https://packagist.org/packages/moszkva/angie, _(*2)

Features

Generates angular routing rules from serverside routing rules
Generates angular services for basic data transfer.
Namespace resolving in controller's name.

Installation

Installation via composer, _(*3)

{
   "require-dev": {
        "moszkva/angie": "dev-master"
   }
}

Usage

After installation you must register AngieServiceProvider in your config/app.php:, _(*4)


'providers' => array(....,
                     ....,
                     'Moszkva\Angie\AngieServiceProvider'),
'aliases' => array(.....,
                   .....,
                    'Angie' => 'Moszkva\Angie\Facades\Angie'));

and you must register routing rules for angie:, _(*5)


// Angie BEGIN

Route::get('angie/get/routing', function()
{
    return Angie::renderRouterProviderStatment('<YourAppName>', '/angie/test');
});

Route::get('angie/get/services', function()
{
    return Angie::renderServices('<YourAppName>');
});


// Angie END

and you must place these in your index.html after each other angular scripts:, _(*6)

<!--Angie BEGIN-->
<script src="angie/get/routing"></script>
<script src="angie/get/services"></script>
<!--Angie END-->

How works the angie?

Generates angular routeprovider statment. Above example:

<YourAppName>.config(['$routeProvider',
    function($routeProvider) {
            $routeProvider
            .when("/angie/test",{"controller":"AngieTestController","templateUrl":"angie/test"})
            .when("/angie/test/create",{"controller":"AngieTestController","templateUrl":"angie/test/create"})
            .when("/angie/test/:test",{"controller":"AngieTestController","templateUrl":"angie/test/' + $routeParams.test + '"})
            .when("/angie/test/:test/edit",{"controller":"AngieTestController","templateUrl":"angie/test/' + $routeParams.test + '/edit"})
            .when("//",{"controller":"TestController","templateUrl":"/"})
            .otherwise({"redirectTo":"/angie/test"})}]);

Generates angular services for basic data transfer:

var <YourAppName>Services= angular.module('<YourAppName>Services', ['ngResource']);

AngieTestControllerService.insert(properties);      
AngieTestControllerService.update(properties);
AngieTestControllerService.delete(id);
AngieTestControllerService.show(id);
AngieTestControllerService.list(id, params); // params is optional.

Very important constraint for valid service generation: - Laravel routing rules by controller must be unique. Example:, _(*7)

Valid configuration (AnotherAngieTestController is subclass of AngieTestController):, _(*8)

Route::resource('angie/test', 'AngieTestController');
Route::resource('angie/test2', 'AnotherAngieTestController');

Invalid configuration:, _(*9)

Route::resource('angie/test', 'AngieTestController');
Route::resource('angie/test2', 'AngieTestController');

Namespace resolving:, _(*10)

Laravel route rule:

    Route::resource('/test', 'Test\Angie\TestController')

Controller name in generated routprovider statement:

    TestAngieTestController

Service name in generated service statement:

    TestAngieTestControllerService