Skip to content

CakeDC/users

Repository files navigation

CakeDC Users Plugin

Build Status Coverage Status Total Downloads Latest Stable Version License

The Users plugin for CakePHP provides a comprehensive, extensible solution for user management, authentication, and authorization. It's designed to get you up and running with a full-featured user system in minutes, while remaining flexible enough for complex, custom applications.

Versions and branches

CakePHP CakeDC Users Plugin Tag Notes
^5.3 16.x 16.0.0 Stable (Current)
^5.0 15.x 15.1.3 Stable
^5.0 14.x 14.3.4 Stable
^4.5 13.x 13.0.1 Stable
^4.3 11.x 11.1.0 Stable
^4.0 9.x 9.0.5 Stable
^3.7 8.x 8.5.1 Stable

Key Features

  • User Lifecycle: Registration, email validation, profile management, and password reset.
  • Authentication: Login/Logout, "Remember Me" (Cookie), and Magic Link (one-click login).
  • Social Login: Facebook, Twitter, Instagram, Google, LinkedIn (via OpenID Connect), Amazon, GitHub.
  • Security & 2FA:
    • One-Time Password (OTP) for Two-Factor Authentication.
    • Webauthn (Yubico Key, TouchID, etc.) for Two-Factor Authentication.
    • Account lockout policy after failed attempts.
    • Password strength meter.
    • reCaptcha v2 and v3 support.
  • Authorization: Integrated RBAC (Role-Based Access Control) and Superuser support via CakeDC/auth.
  • Extensibility: Easily extend Controllers, Models (Tables/Entities), Mailers, and Templates.
  • Admin Management: Out-of-the-box CRUD for user management.

Requirements

  • CakePHP 5.0+
  • PHP 8.1+

Quick Start (Installation)

  1. Install via Composer:
    composer require cakedc/users
  2. Load the Plugin: In your src/Application.php:
    public function bootstrap(): void
    {
        parent::bootstrap();
        $this->addPlugin('CakeDC/Users');
    }
  3. Run Migrations:
    bin/cake migrations migrate -p CakeDC/Users
  4. Create a Superuser:
    bin/cake users add_superuser

Documentation

For full installation details, configuration options, and tutorials, please visit the Documentation.

Support

Contributing

We welcome contributions! Please review our Contribution Guidelines and the CakeDC Plugin Standard.

License

Copyright 2010 - Present Cake Development Corporation (CakeDC). All rights reserved.

Licensed under the MIT License. Redistributions of the source code must retain the copyright notice.