PHPackages rainlab/user-plugin - 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. rainlab/user-plugin ActiveOctober-plugin[Authentication & Authorization](/categories/authentication) rainlab/user-plugin =================== User plugin for October CMS v3.4.0(1mo ago)11954.3k↓37.5%158[10 issues](https://github.com/rainlab/user-plugin/issues)11proprietaryPHPPHP ^8.0.2CI failing Since Oct 2Pushed 2mo ago20 watchersCompare [ Source](https://github.com/rainlab/user-plugin)[ Packagist](https://packagist.org/packages/rainlab/user-plugin)[ Docs](https://octobercms.com/plugin/rainlab-user)[ RSS](/packages/rainlab-user-plugin/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (9)Dependencies (12)Versions (42)Used By (11)Security (1) Front-end user plugin ===================== [](#front-end-user-plugin) Front-end user management for October CMS. View this plugin on the October CMS marketplace: - Requirements ------------ [](#requirements) - October CMS 3.6 or above - The [AJAX Framework](https://docs.octobercms.com/3.x/cms/ajax/introduction.html) to be included in your layout/page Installation Instructions ------------------------- [](#installation-instructions) Run the following to install this plugin: ``` php artisan plugin:install RainLab.User ``` To uninstall this plugin: ``` php artisan plugin:remove RainLab.User ``` ### Older Versions [](#older-versions) If you are using **October CMS v3.0 - v3.5**, install v2.1 with the following commands: ``` composer require rainlab/user-plugin "^2.1" ``` If you are using **October CMS v1.0 - v2.3**, install v1.7 with the following commands: ``` composer require rainlab/user-plugin "^1.7" ``` ### Sample Theme [](#sample-theme) We recommend installing this plugin with the `RainLab.Vanilla` theme to demonstrate its functionality. - For extra functionality, consider also installing the `RainLab.UserPlus` plugin. - Managing Users -------------- [](#managing-users) Users are managed on the Users tab found in the admin panel. Each user provides minimal data fields - **First Name**, **Last Name**, **Email** and **Password**. The Name can represent either the person's first name or their full name, making the Last Name field optional, depending on the complexity of your site. Below the **Email** field is an checkbox to block all outgoing mail sent to the user. This is a useful feature for accounts with an email address that is bouncing mail or has reported spam. When checked, no mail will ever be sent to this address, except for the mail template used for resetting the password. Plugin Settings --------------- [](#plugin-settings) This plugin creates a Settings menu item, found by navigating to **Settings > Users > User Settings**. This page allows the setting of common features, described in more detail below. #### Sign In [](#sign-in) By default a User will sign in to the site using their email address as a unique identifier. You may use a unique login name instead by changing the **Login Attribute** value to Username. This will introduce a new field called **Username** for each user, allowing them to specify their own short name or alias for identification. Both the Email address and Username must be unique to the user. As a security precaution, you may restrict users from having sessions across multiple devices at the same time. Enable the **Prevent Concurrent Sessions** setting to use this feature. When a user signs in to their account, it will automatically sign out the user for all other sessions. #### Registration [](#registration) Registration to the site is allowed by default. If you are running a closed site, or need to temporarily disable registration, you may disable this feature by switching **Allow user registration** to the OFF setting. #### Notifications [](#notifications) When a user is first activated, they can be sent a welcome email. To activate the welcome email, select "Notify User" and an email template from the **User Message Template** dropdown. The default message template used is `user:welcome_email` and you can customize this by selecting **Mail > Mail Templates** from the settings menu. The same applies for notifying the system administrators when a new user joins, with the "Notify Administrators" checkbox. The administrators to notify are selected using **Notify Admin Group** dropdown. Documentation ------------- [](#documentation) ### Getting Started [](#getting-started) - [Introduction](./docs/introduction.md) - [Events](./docs/events.md) ### Components [](#components) - [Session](./docs/component-session.md) - [Account](./docs/component-account.md) - [Authentication](./docs/component-authentication.md) - [Registration](./docs/component-registration.md) - [Reset Password](./docs/component-reset-password.md) ### Services [](#services) - [Auth Manager](./docs/auth-manager.md) - [Impersonation](./docs/auth-impersonation.md) - [Bearer Tokens](./docs/auth-bearer-tokens.md) ### License [](#license) This plugin is an official extension of the October CMS platform and is free to use if you have a platform license. See [EULA license](LICENSE.md) for more details. ### Health Score 65 — FairBetter than 99% of packages Maintenance84 Actively maintained with recent releases Popularity47 Moderate usage in the ecosystem Community42 Growing community involvement Maturity80 Battle-tested with a long release history Bus Factor1 Top contributor holds 66.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. ### Release Activity Cadence Every ~66 days Recently: every ~27 days Total 38 Last Release 51d ago Major Versions v1.7.2 → v2.0.02023-02-21 v2.1.0 → v3.0.02024-05-06 2.x-dev → v3.2.02024-12-10 PHP version history (2 changes)v1.5.0PHP >=5.5.9 v2.1.0PHP ^8.0.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/106532?v=4)[october](/maintainers/october)[@october](https://github.com/october) --- Top Contributors [![daftspunk](https://avatars.githubusercontent.com/u/1392869?v=4)](https://github.com/daftspunk "daftspunk (524 commits)")[![octoberapp](https://avatars.githubusercontent.com/u/6543374?v=4)](https://github.com/octoberapp "octoberapp (82 commits)")[![LukeTowers](https://avatars.githubusercontent.com/u/7253840?v=4)](https://github.com/LukeTowers "LukeTowers (33 commits)")[![gergo85](https://avatars.githubusercontent.com/u/2959112?v=4)](https://github.com/gergo85 "gergo85 (30 commits)")[![bennothommo](https://avatars.githubusercontent.com/u/15900351?v=4)](https://github.com/bennothommo "bennothommo (15 commits)")[![dzapek](https://avatars.githubusercontent.com/u/54842490?v=4)](https://github.com/dzapek "dzapek (9 commits)")[![TheServat](https://avatars.githubusercontent.com/u/12908537?v=4)](https://github.com/TheServat "TheServat (8 commits)")[![vojtasvoboda](https://avatars.githubusercontent.com/u/374917?v=4)](https://github.com/vojtasvoboda "vojtasvoboda (8 commits)")[![alekseybobkov](https://avatars.githubusercontent.com/u/481606?v=4)](https://github.com/alekseybobkov "alekseybobkov (8 commits)")[![samgeorges](https://avatars.githubusercontent.com/u/4927493?v=4)](https://github.com/samgeorges "samgeorges (7 commits)")[![gabsource](https://avatars.githubusercontent.com/u/1851314?v=4)](https://github.com/gabsource "gabsource (7 commits)")[![yapsr](https://avatars.githubusercontent.com/u/3018553?v=4)](https://github.com/yapsr "yapsr (4 commits)")[![jan-vince](https://avatars.githubusercontent.com/u/1104383?v=4)](https://github.com/jan-vince "jan-vince (4 commits)")[![rubenvanerk](https://avatars.githubusercontent.com/u/20305359?v=4)](https://github.com/rubenvanerk "rubenvanerk (4 commits)")[![scottbedard](https://avatars.githubusercontent.com/u/7980426?v=4)](https://github.com/scottbedard "scottbedard (4 commits)")[![kOld](https://avatars.githubusercontent.com/u/280738?v=4)](https://github.com/kOld "kOld (3 commits)")[![Metallizzer](https://avatars.githubusercontent.com/u/691719?v=4)](https://github.com/Metallizzer "Metallizzer (3 commits)")[![egerstudios](https://avatars.githubusercontent.com/u/196057125?v=4)](https://github.com/egerstudios "egerstudios (3 commits)")[![WebVPF](https://avatars.githubusercontent.com/u/61043464?v=4)](https://github.com/WebVPF "WebVPF (3 commits)")[![buuug7](https://avatars.githubusercontent.com/u/12119289?v=4)](https://github.com/buuug7 "buuug7 (3 commits)") --- Tags useroctoberoctobercms ### Embed Badge ![Health badge](/badges/rainlab-user-plugin/health.svg) ``` [![Health](https://phpackages.com/badges/rainlab-user-plugin/health.svg)](https://phpackages.com/packages/rainlab-user-plugin) ``` ### Alternatives [jeffgreco13/filament-breezy A custom package for Filament with login flow, profile and teams support. 1.0k1.7M41](/packages/jeffgreco13-filament-breezy)[rainlab/builder-plugin Builder plugin for October CMS 17147.2k1](/packages/rainlab-builder-plugin)[rainlab/translate-plugin Translate plugin for October CMS 12666.5k9](/packages/rainlab-translate-plugin)[rainlab/pages-plugin Pages plugin for October CMS 12252.4k4](/packages/rainlab-pages-plugin)[stephenjude/filament-two-factor-authentication Filament Two Factor Authentication: Google 2FA + Passkey Authentication 81158.7k4](/packages/stephenjude-filament-two-factor-authentication)[rainlab/userplus-plugin User plus plugin for October CMS 168.8k2](/packages/rainlab-userplus-plugin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)