mcms/package-admin

The admin interface

Admin

This is the admin package for Mcms. It's build on Angular material but you can go ahead and use any framework you like., _(*1)

Install

Via Composer, _(*2)

``` bash $ composer require mcms/package-admin, <sub>(*3)</sub>

## Usage
Add this service provider to config/app.php
``` Mcms\Admin\AdminServiceProvider::class, ```
and this alias for convenience
``` 'ModuleRegistry' => Mcms\Admin\Facades\ModuleRegistryFacade::class, ```

You can register a new admin module like so
``` php
ModuleRegistry::registerModule('{package-name}/admin.package.json');
print_r(ModuleRegistry::get());

Then you should publish your admin.package.json like so, <sub>(*4)</sub>

    $this->publishes([
        __DIR__ . '/../config/admin.package.json' => storage_path('app/package-pages/admin.package.json'),
    ], 'admin-package');

And here is a sample of the admin.package.json, <sub>(*5)</sub>

{
  "name" : "My package name",
  "package" : "package-name",
  "modules" : [
    "my.angular.module.name"
  ],
  "files" : {
    "js" : [
      "package-name/js/script-compiled.js"
    ],
    "css" : [
    ]
  }
}

Finally, make sure you publish all your files in the right folder in the public dir., <sub>(*6)</sub>

Get the processed registry with, <sub>(*7)</sub>

``` php $files = ModuleRegistry::processRegistry();, <sub>(*8)</sub>

## Angular ACL

The role method can take multiple roles like

, <sub>(*9)</sub>

Roles support inheritance, so if you are a Super User
with level 4, and the base requirement is an admin
with level 3, you are good to go as a Super User inherits
from admins

If however, Super User and admin are of the same level,
then inheritance does not apply anymore. Use the multiple
roles notation for when you want similar level of users
to pass the check (moderator - publisher or user - author)


- Need to move angular templates into the right public dir (use gulp in dev)
- Need to tell angular where the template public dir is

## Extending an angular module
We need to make use of the ModuleExtender service. Add a new module to the registry
like so :

ModuleExtender.register('pages', ModuleExtender.newPackage({
    id : 'extendedModule',
    label : 'Extended Module',
    order : 99,
    file : Config.templatesDir + 'temp.html'
}));

First argument should be the module name and second the extension. Usually,
we should have a component in that file but since you inherit from the 
template injection you could get away with something small.

Then in your module you gain the extended functionality by adding it to your
tabs or whatever render method like so: 

vm.tabs = ModuleExtender.extend('pages', vm.tabs); ```, <sub>(*10)</sub>

First argument is the module name and the second your existing tabs which will be concatenated with the additional ones and re-ordered., <sub>(*11)</sub>