PHPackages                             cakemanager/cakephp-users - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. cakemanager/cakephp-users

ActiveCakephp-plugin[Authentication & Authorization](/categories/authentication)

cakemanager/cakephp-users
=========================

Users plugin for CakePHP

52428[2 issues](https://github.com/cakemanager/cakephp-users/issues)PHP

Since Sep 19Pushed 9y ago6 watchersCompare

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

READMEChangelogDependenciesVersions (1)Used By (0)

Users plugin for CakePHP
========================

[](#users-plugin-for-cakephp)

> Note: This is a non-stable plugin for CakePHP 3.x at this time. It is currently under development and should be considered experimental.

Table of Contents
-----------------

[](#table-of-contents)

- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Configurations](#configurations)
- [UserManager Component](#usermanager-component)
- [CakeAdmin](#cakeadmin)
- [Keep in Touch](#keep-in-touch)

Features
--------

[](#features)

- [CakeAdmin](https://github.com/cakemanager/cakephp-cakeadmin) compatible
- Forgot Password functionality
- Role-management (Set up your own roles)
- E-mail integration
- Easy to install

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

[](#installation)

You can install this plugin into your CakePHP application using [composer](http://getcomposer.org).

The recommended way to install composer packages is:

```
composer require cakemanager/cakephp-users

```

Now load the plugin with the command:

```
$ bin/cake plugin load -r -b Users

```

Run the database migrations with:

```
$ bin/cake migrations migrate --plugin Users

```

Usage
-----

[](#usage)

Using the users-plugin is very easy. Use the following code in your `AppController`:

```
public function initialize()
{
    parent::initialize();
    $this->loadComponent('Users.UserManager');
}

```

You can change configurations of the `AuthComponent` with `$this->Users->config('auth.*settings*);` or `$this->Auth->config()` (after loading the `UserManagement` component).

From now on you will be able to register and login. Use the [CakeAdmin Plugin](https://github.com/cakemanager/cakephp-cakeadmin) to manage your roles and users easily.

Configurations
--------------

[](#configurations)

The following configurations are available. All configurations can be set via `Configure::write()` in your `config/bootstrap.php` file.

### Users.fields

[](#usersfields)

By default you will register and login with `email` and `password`. When you want to use your own fields, like `username` and `passwrd` you can use the following:

```
Configure::write('Users.fields', [
    'username' => 'username',
    'password' => 'passwrd'
]);

```

### Users.email

[](#usersemail)

There are some configurations for email:

- `Users.email.from` - Array to define the sender. Default `['admin@cakemanager.org' => 'Bob | CakeManager']`.
- `Users.email.transport` - The transport to use. Default set to `default`.
- `Users.email.afterRegister.subject` - The subject of the email sent when an user has been registered.
- `Users.email.afterForgot.subject` - The subject of the email sent when an user forgot his password.

### Users.defaultController

[](#usersdefaultcontroller)

The plugin has a default controller which contains all default user-related actions (login, logout, reset, forgot). There may be times that you want to use your own controller. You can disable the default built-in controller by setting `Users.defaultController` to `false`:

```
Configure::write('Users.defaultController', false);

```

When you do this, the routes for the plugin are not set, and trying to reach te controller will fail because you will be redirected to the previous location.

> Note: This feature can be helpfull by using the user-management only for your [API](https://github.com/cakemanager/cakephp-api).

UserManager Component
---------------------

[](#usermanager-component)

The UserManager Component default handles the Auth for your app. However, this component is also helpful to add user- related actions to your system! By calling the login-function (`$this->UserManager->login()`) you are using the login-action. The same is for:

- `login()` - Logs the user in.
- `logout()` - Logs the user off.
- `activate($email, $requestKey)` - Activates the user. Don't forget to pass the variables.
- `forgot` - User leaves his e-mailaddress to receive an e-mail to set a new password.
- `reset($email, $requestKey)` - Creates a new password for the user. Don't forget to pass the variables.

This methods can be helpful when you want to customize your user-related actions.

> Note: Don't forget to set the `Users.defaultController` configuration to `false`, mentioned above!

CakeAdmin
---------

[](#cakeadmin)

The plugin is [CakeAdmin](https://github.com/cakemanager/cakephp-cakeadmin) compatible! This means that the Users and Roles can be managed in the Admin panel of the CakeAdmin plugin.

Keep in touch
-------------

[](#keep-in-touch)

If you need some help or got ideas for this plugin, feel free to chat at [Gitter](https://gitter.im/cakemanager/cakephp-users).

Pull Requests are always more than welcome!

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance12

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.8% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/db071075007a1fb258b395c5e618b3e2409fdf69a07006ae0d847a38be3d8ade?d=identicon)[bobmulder](/maintainers/bobmulder)

---

Top Contributors

[![bobmulder](https://avatars.githubusercontent.com/u/5465074?v=4)](https://github.com/bobmulder "bobmulder (24 commits)")[![martonmiklos](https://avatars.githubusercontent.com/u/1609182?v=4)](https://github.com/martonmiklos "martonmiklos (4 commits)")[![leoruhland](https://avatars.githubusercontent.com/u/1785552?v=4)](https://github.com/leoruhland "leoruhland (1 commits)")

### Embed Badge

![Health badge](/badges/cakemanager-cakephp-users/health.svg)

```
[![Health](https://phpackages.com/badges/cakemanager-cakephp-users/health.svg)](https://phpackages.com/packages/cakemanager-cakephp-users)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[gesdinet/jwt-refresh-token-bundle

Implements a refresh token system over Json Web Tokens in Symfony

70516.4M35](/packages/gesdinet-jwt-refresh-token-bundle)[illuminate/auth

The Illuminate Auth package.

9327.3M1.0k](/packages/illuminate-auth)[beatswitch/lock

A flexible, driver based Acl package for PHP 5.4+

870304.7k2](/packages/beatswitch-lock)[amocrm/amocrm-api-library

amoCRM API Client

182728.5k6](/packages/amocrm-amocrm-api-library)[vonage/jwt

A standalone package for creating JWTs for Vonage APIs

424.1M4](/packages/vonage-jwt)

PHPackages © 2026

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