PHPackages                             mcms/package-admin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. mcms/package-admin

ActiveLibrary[Admin Panels](/categories/admin)

mcms/package-admin
==================

The admin interface

v0.1.1(4y ago)096MIT

Since Dec 12Compare

[ Source](https://github.com/mbouclas/mcms-admin)[ Packagist](https://packagist.org/packages/mcms/package-admin)[ RSS](/packages/mcms-package-admin/feed)WikiDiscussions Synced 2d ago

READMEChangelogDependencies (1)Versions (32)Used By (0)

Admin
=====

[](#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.

Install
-------

[](#install)

Via Composer

```
$ composer require mcms/package-admin
```

Usage
-----

[](#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

```
ModuleRegistry::registerModule('{package-name}/admin.package.json');
print_r(ModuleRegistry::get());
```

Then you should publish your admin.package.json like so

```
    $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

```
{
  "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.

Get the processed registry with

```
$files = ModuleRegistry::processRegistry();
```

Angular ACL
-----------

[](#angular-acl)

```
Can create users
Is of level 2 and above
Is admin or above

```

The role method can take multiple roles like

```
Is admin

```

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
---------------------------

[](#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);

```

First argument is the module name and the second your existing tabs which will be concatenated with the additional ones and re-ordered.

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~67 days

Recently: every ~287 days

Total

30

Last Release

1537d ago

PHP version history (3 changes)v0.0.1PHP ~5.5|~7.0

v0.0.24PHP ~5.5|~8.0

v0.0.25PHP >=5.6.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/642742?v=4)[Michael Bouclas](/maintainers/mbouclas)[@mbouclas](https://github.com/mbouclas)

---

Top Contributors

[![mbouclas](https://avatars.githubusercontent.com/u/642742?v=4)](https://github.com/mbouclas "mbouclas (30 commits)")

### Embed Badge

![Health badge](/badges/mcms-package-admin/health.svg)

```
[![Health](https://phpackages.com/badges/mcms-package-admin/health.svg)](https://phpackages.com/packages/mcms-package-admin)
```

###  Alternatives

[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[october/rain

October Rain Library

1601.7M80](/packages/october-rain)[code16/sharp

Laravel Content Management Framework

79164.7k7](/packages/code16-sharp)[symfony/ux-cropperjs

Cropper.js integration for Symfony

19346.6k3](/packages/symfony-ux-cropperjs)[eveseat/web

SeAT Web Interface

2623.5k155](/packages/eveseat-web)[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1235.9k20](/packages/fleetbase-core-api)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)