PHPackages                             brammo/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. brammo/admin

ActiveCakephp-plugin[Admin Panels](/categories/admin)

brammo/admin
============

Admin dashboard plugin for CakePHP

1.3.0(1mo ago)04MITPHPPHP &gt;=8.1

Since Nov 25Pushed 1mo agoCompare

[ Source](https://github.com/brammo/admin)[ Packagist](https://packagist.org/packages/brammo/admin)[ Docs](https://github.com/brammo/admin)[ RSS](/packages/brammo-admin/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (20)Versions (4)Used By (0)

Brammo Admin Plugin
===================

[](#brammo-admin-plugin)

Admin dashboard plugin for CakePHP 5 with Bootstrap UI integration.

Requirements
------------

[](#requirements)

- PHP 8.1 or higher
- CakePHP 5.0 or higher
- CakePHP Authentication plugin 3.0 or higher

Installation
------------

[](#installation)

Install via Composer:

```
composer require brammo/admin
```

Loading the Plugin
------------------

[](#loading-the-plugin)

Load the plugin in your application's `src/Application.php`:

```
public function bootstrap(): void
{
    parent::bootstrap();

    $this->addPlugin('Brammo/Admin');
}
```

Features
--------

[](#features)

### View Helpers

[](#view-helpers)

The plugin provides several view helpers to simplify UI development:

- **ButtonHelper** - Generate Bootstrap-styled buttons with icons

See [docs/HELPERS.md](docs/HELPERS.md) for detailed documentation and examples.

### Controllers

[](#controllers)

#### UserController

[](#usercontroller)

Provides user profile management:

- `profile()` - View and edit user profile

#### FileManagerController

[](#filemanagercontroller)

Built-in file and image manager with upload, browse, and management capabilities.

See [docs/FILEMANAGER.md](docs/FILEMANAGER.md) for detailed documentation.

### Authentication

[](#authentication)

The plugin integrates with CakePHP Authentication and Brammo Auth plugin for user management and authentication.

Configuration
-------------

[](#configuration)

All configuration options are documented in [docs/CONFIGURATION.md](docs/CONFIGURATION.md), including:

- Internationalization
- Brand customization
- Home link
- Sidebar menu
- Layout assets (CSS, JavaScript, fonts)

Development
-----------

[](#development)

### Running Tests

[](#running-tests)

```
# Run all tests
composer test

# Run with verbose output
vendor/bin/phpunit --testdox
```

### Static Analysis

[](#static-analysis)

The project uses both PHPStan and Psalm for static code analysis:

```
# Run PHPStan (level 8)
composer stan

# Run Psalm (level 1)
composer psalm

# Run all checks (tests + static analysis)
composer check
```

See [docs/PHPSTAN.md](docs/PHPSTAN.md) and [docs/PSALM.md](docs/PSALM.md) for detailed documentation.

### Code Quality

[](#code-quality)

- **PHPStan Level**: 8 (strictest)
- **Psalm Level**: 1 (strictest)
- **Test Coverage**: 45 tests, 120 assertions
- **PHP Version**: 8.1+

Directory Structure
-------------------

[](#directory-structure)

```
brammo/admin/
├── config/              # Plugin configuration
├── docs/                # Documentation
├── resources/           # Resources (translations, etc.)
│   └── locales/         # Translation files
├── src/                 # Source code
│   ├── Controller/      # Controllers
│   ├── Model/           # Models (Entity, Table)
│   ├── View/            # View classes and helpers
│   │   └── Helper/      # View helpers
│   └── Plugin.php       # Plugin bootstrap
├── templates/           # Templates
│   ├── element/         # Template elements
│   ├── layout/          # Layouts
│   └── User/            # User views
├── tests/               # Test suite
│   ├── Fixture/         # Test fixtures
│   └── TestCase/        # Test cases
└── webroot/             # Public assets
    ├── css/             # Stylesheets
    └── js/              # JavaScript files

```

Contributing
------------

[](#contributing)

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes
4. Run tests and static analysis (`composer check`)
5. Commit your changes (`git commit -am 'Add amazing feature'`)
6. Push to the branch (`git push origin feature/amazing-feature`)
7. Create a Pull Request

### Code Standards

[](#code-standards)

- Follow PSR-12 coding standards
- Write tests for new features
- Ensure all tests pass
- Maintain PHPStan level 8 and Psalm level 1 compliance
- Add type hints to all methods

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Author
------

[](#author)

**Roman Sidorkin**

- Email:
- GitHub: [@brammo](https://github.com/brammo)

Related Projects
----------------

[](#related-projects)

- [brammo/auth](https://github.com/brammo/auth) - Authentication plugin for CakePHP

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance90

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 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 ~64 days

Total

3

Last Release

46d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/71d3e402b895916793618f083d30b98a4d2b78aa4159b4029546dedf8f2864d4?d=identicon)[brammo](/maintainers/brammo)

---

Top Contributors

[![brammo](https://avatars.githubusercontent.com/u/4863506?v=4)](https://github.com/brammo "brammo (59 commits)")

---

Tags

plugincakephpdashboardadmin

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[dereuromark/cakephp-setup

A CakePHP plugin containing lots of useful management tools

36162.8k2](/packages/dereuromark-cakephp-setup)[dereuromark/cakephp-translate

A CakePHP plugin for managing translations

1710.4k](/packages/dereuromark-cakephp-translate)[superv/platform

SuperV Platform Package

2411.6k5](/packages/superv-platform)

PHPackages © 2026

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