Front-end user management for October CMS.
Requirements
- October CMS 3.6 or above
- The AJAX Framework to be included in your layout/page
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
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
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
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
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
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 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
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.
The following plugins extend or depend on the plugin
Forum
A simple embeddable forum
Forum
A simple embeddable forum
Social Login
Log in with your social media accounts!
Social Login
Log in with your social media accounts!
PrivateFiles
Share downloads only with the users you want.
PrivateFiles
Share downloads only with the users you want.
BlogProtect
Restrict RainLab Blog Post viewers by category permission
BlogProtect
Restrict RainLab Blog Post viewers by category permission
Profile
Social information, User directory, V-Card downloading, Avatar gallery, Frontend profile forms.
Profile
Social information, User directory, V-Card downloading, Avatar gallery, Frontend profile forms.
User Plus
This plugin extend the RainLab User plugin to some new fields.
User Plus
This plugin extend the RainLab User plugin to some new fields.
CellPhone
Stores cell phone information for front end users and allows other users to message them
CellPhone
Stores cell phone information for front end users and allows other users to message them
User Select
Powerful yet user friendly way to choose multiple users
User Select
Powerful yet user friendly way to choose multiple users
Social
Social Login plugin for Facebook, Google, LinkedIn, Github and Microsoft using OAuth
Social
Social Login plugin for Facebook, Google, LinkedIn, Github and Microsoft using OAuth
OctoCart
The Best October eCommerce/shop Platform
OctoCart
The Best October eCommerce/shop Platform
User Support
Ticket system for communicating with users
User Support
Ticket system for communicating with users
Code login
Front-end password/code authentication without username. Best for creating secret section.
Code login
Front-end password/code authentication without username. Best for creating secret section.
User Plus+
Adds extra features to the User plugin.
User Plus+
Adds extra features to the User plugin.
User import/export
Import and export feature for User plugin.
User import/export
Import and export feature for User plugin.
User Access Log
Logs users accesses and makes nice graphs.
User Access Log
Logs users accesses and makes nice graphs.
Passage Permission and Roles System
Fast, Efficient permissions and roles system for your site pages and resources.
Passage Permission and Roles System
Fast, Efficient permissions and roles system for your site pages and resources.
User PDF export
Export user's profile to PDF in one click.
User PDF export
Export user's profile to PDF in one click.
User SideMenu
Adds side menu for User plugin.
User SideMenu
Adds side menu for User plugin.
Pay
Invoicing and Accounting
Pay
Invoicing and Accounting
Blog Front Editor
Delegate Blog Posting to Authorized Front-end Users
Blog Front Editor
Delegate Blog Posting to Authorized Front-end Users
Login As User
Logs you in as a certain frontend or backend user.
Login As User
Logs you in as a certain frontend or backend user.
User Extended
User Extended Core adds Roles, Settings, Timezones, Route Management, Profiles, and Utilities to Rainlab.User
User Extended
User Extended Core adds Roles, Settings, Timezones, Route Management, Profiles, and Utilities to Rainlab.User
JWT Auth API
JSON Web Token Authentication for your OctoberCMS API integrated with RainLab.User
JWT Auth API
JSON Web Token Authentication for your OctoberCMS API integrated with RainLab.User
Comments
A plugin for discussing published content. Features email reply notifications and a reload free posting experi...
Comments
A plugin for discussing published content. Features email reply notifications and a reload free posting experi...
Binding management for WeChat
Binding management for WeChat
Cashier
Plugin to handle Stripe and Braintree payments using Laravel Cashier
Cashier
Plugin to handle Stripe and Braintree payments using Laravel Cashier
Cumulus Core
The heart and start point of any Cumulus application
Cumulus Core
The heart and start point of any Cumulus application
Favorites
Adds a favorite feature to your October models.
Favorites
Adds a favorite feature to your October models.
Two-Factor Auth Front-end
Extends RainLab.User with possibility to add 2-factor protection for user account
Two-Factor Auth Front-end
Extends RainLab.User with possibility to add 2-factor protection for user account
PagSeguro
Component for PagSeguro payment service
PagSeguro
Component for PagSeguro payment service
Favorite Button Plugin
provide Favorite Button and Favorite List Component
Favorite Button Plugin
provide Favorite Button and Favorite List Component
Responsive Vote for October CMS
Responsive Poll/Vote, Support Anonymous, recaptcha
Responsive Vote for October CMS
Responsive Poll/Vote, Support Anonymous, recaptcha
CRM Pro
The professional Customer Relations Manager (CRM) for October
CRM Pro
The professional Customer Relations Manager (CRM) for October
Mall
E-commerce shop solution for October CMS
Mall
E-commerce shop solution for October CMS
Skip Maintenance
Adds the possibility to skip the maintenance page for frontend user by using authentification.
Skip Maintenance
Adds the possibility to skip the maintenance page for frontend user by using authentification.
Add user group on register
Assign user group to a user when the user registers
Add user group on register
Assign user group to a user when the user registers
Pyrolancer
A freelance marketplace for online and remote workers.
Pyrolancer
A freelance marketplace for online and remote workers.
Blog Comments
Add comment section to blog post! Available for registered users and guests.
Blog Comments
Add comment section to blog post! Available for registered users and guests.
Guestbook
Guestbook for your website with Markdown syntax and smiles.
Guestbook
Guestbook for your website with Markdown syntax and smiles.
Access
Single page application for login and registration
Access
Single page application for login and registration
Social Connect
Allows visitors to register/sign in with their social accounts. Based on Socialite.
Social Connect
Allows visitors to register/sign in with their social accounts. Based on Socialite.
SocialAuth
Social Auth plugin for OctoberCMS by Ceyleon
SocialAuth
Social Auth plugin for OctoberCMS by Ceyleon
Ideas Ecommerce
Simple, powerful, flexible shopping cart
Ideas Ecommerce
Simple, powerful, flexible shopping cart
Members Pro
Monetize your content with subscriptions
Members Pro
Monetize your content with subscriptions
Invoice Pro
Create invoices that you can email or download as PDF and pay online
Invoice Pro
Create invoices that you can email or download as PDF and pay online
Menu Item Session Check
Hide menu item(s) by checking RainLab Session component on referenced CMS layout or page
Menu Item Session Check
Hide menu item(s) by checking RainLab Session component on referenced CMS layout or page
Commentable
Provides pre-moderateable comments for your site.
Commentable
Provides pre-moderateable comments for your site.
uCollect
Create surveys quickly with ease
uCollect
Create surveys quickly with ease
Disable Password Auth
Disable password for specific users. Forces the use of another auth method.
Disable Password Auth
Disable password for specific users. Forces the use of another auth method.
Helpdesk
An issue tracking system built to assist your customer support team
Helpdesk
An issue tracking system built to assist your customer support team
Synapse LMS Pro
A Learning Management System for October.
Synapse LMS Pro
A Learning Management System for October.
Badges Lite
Assign SVG badges to users
Badges Lite
Assign SVG badges to users
Roles for RainLab.User
RainLab.User adapter for Roles plugin: access rights based on roles hierarchy
Roles for RainLab.User
RainLab.User adapter for Roles plugin: access rights based on roles hierarchy
Job Portal
Create your very own job portal and connect employers and talents
Job Portal
Create your very own job portal and connect employers and talents
Likes
Provides a system of likes and dislikes for custom models
Likes
Provides a system of likes and dislikes for custom models
Member Bill
Membership / Package Sales System
Member Bill
Membership / Package Sales System
Conditions Users
RainLab User integration for Sixgweb Conditions Plugin
Conditions Users
RainLab User integration for Sixgweb Conditions Plugin
Attributize Users
RainLab User integration for Sixgweb Attributize Plugin
Attributize Users
RainLab User integration for Sixgweb Attributize Plugin
Gamify
Add gamification in OctoberCMS with reputation point and badges support
Gamify
Add gamification in OctoberCMS with reputation point and badges support
Webhook
Webhooks allow external services to be notified when certain events happen. When the specified events happen,...
Webhook
Webhooks allow external services to be notified when certain events happen. When the specified events happen,...
Forgot Password
Allows users who have forgotten their password to unlock, retrieve, or reset it.
Forgot Password
Allows users who have forgotten their password to unlock, retrieve, or reset it.
OctoVisit
A plugin to keep track of your pages & understand your audience.A clean way to track your pages & understand y...
OctoVisit
A plugin to keep track of your pages & understand your audience.A clean way to track your pages & understand y...
Online Campus
Online Courses for October CMS
Online Campus
Online Courses for October CMS
The following themes use this plugin
Vanilla
Vanilla
A plain starter template that implements account management, a blog and community forum.
Relax
Relax
A fictional site called House of Chairs that demonstrates how to build a client-friendly website.
JK Shop Bootstrap
JK Shop Bootstrap
JK Shop Empty Bootstrap
Octaskin
Octaskin
Free Modern and Clean OctoberCMS Theme based on Materialize CSS.
OctoCart
OctoCart
It is the perfect theme for your next OctoCart project.
Multipurpose Theme with PAGE BUILDER - Success
Multipurpose Theme with PAGE BUILDER - Success
Octobercms Multipurpose Theme with easy Page Builder system
Shopaholic Theme with PAGE BUILDER - Agora
Shopaholic Theme with PAGE BUILDER - Agora
Octobercms Ecommerce Theme with Powerful Eshop & Blog Capabilities and an easy Page Builder system.
Modular Theme with PAGE BUILDER - Clear
Modular Theme with PAGE BUILDER - Clear
Octobercms Multipurpose Theme with Powerful Settings and an easy CRUD Generator - Page Builder system
Mall Demo Theme
Mall Demo Theme
Official starter theme for the Mall e-commerce plugin
Freelance
Freelance
A freelance marketplace website for remote and freelance workers.
PAGE BUILDER - Modular Theme
PAGE BUILDER - Modular Theme
Convenient page builder with 50+ blocks
DeepITer Blog Theme
DeepITer Blog Theme
Personal blogger theme base on OctoberCMS.
Ultimate Website Builder - CREATOR Theme Bundle
Ultimate Website Builder - CREATOR Theme Bundle
The Ultimate Octobercms Theme Bundle with Advanced Page Builder & Powerful Component Blocks
Purpose
Purpose
A multipurpose and contemporary flat design OctoberCMS theme with rich animations With Native Page Builder
eMarket - Advanced E-Commerce Octobercms theme
eMarket - Advanced E-Commerce Octobercms theme
Premium Ecommerce Octobercms theme based on OFFLINE Mall Plugin
AdminLTE24Pro
AdminLTE24Pro
AdminLTEPro is a fully responsive administration template. Highly customizable and easy to use.
Bootstrap 5 Mall Starter
Bootstrap 5 Mall Starter
Unofficial Bootstrap 5 starter theme for the Mall e-commerce plugin, based on the original Mall Starter theme
Online Courses
Online Courses
October CMS Theme to use with the Campus plugin
- Introduction - explains how to get started using the User plugin
- Events - lists all the available events found in this plugin
- Components - lists all the available components found in this plugin
- Session - checks the user session and includes the user object on the page
- Account - user management form for updating profile and security details
- Authentication - provides services for logging a user in
- Registration - provides services for registering a user
- Reset Password - confirms and resets the user with a new password
- Services
- Auth Manager - services for managing the user session
- Impersonation - extra services for impersonating users
- Bearer Tokens - extra services for JWT authentication
-
CL Chan
Found the plugin useful on 26 Mar, 2021
Same here. I can get morphtomany works but morphmany / morphto is not working...
Still no clue
-
Kolen Ferms
Found the plugin useful on 22 Feb, 2021
having this issue when filtering user groups:
SQLSTATE[23000]: Integrity constraint violation: 1052 Column 'id' in where clause is ambiguous (SQL: select count(*) as aggregate from `users` where exists (select * from `user_groups` inner join `users_groups` on `user_groups`.`id` = `users_groups`.`user_group_id` where `users`.`id` = `users_groups`.`user_id` and `id` in (1, 2)))
this line here:
public function scopeFilterByGroup($query, $filter) { return $query->whereHas('groups', function($group) use ($filter) { $group->whereIn('id', $filter); }); }
should've been:
public function scopeFilterByGroup($query, $filter) { return $query->whereHas('groups', function($group) use ($filter) { $group->whereIn('users.id', $filter); }); }
-
Ostlancer FZE LLC
Found the plugin useful on 16 Feb, 2021
I have find this plugin useful.
-
Matthew Bryson
Found the plugin useful on 20 Oct, 2020
Nice simple plugin with easily extendable options. My go to user management plugin!
-
Aydiev Mansur
Found the plugin useful on 8 Jun, 2020
Usually i work with a 2 plugins Davask dump +, and User This is useful plugins for quick development especially when you create a forums or blogs.
-
Juan David Marin
Found the plugin useful on 16 May, 2020
Excellent plugin, works fine, Thanks.
Developers! Developers! Developers! Developers!
-
karamat hussain
Found the plugin useful on 24 Mar, 2020
best for basics purpose but documentation need to add more detials
-
Jacco van den Berg | Bureau Berg
Found the plugin not useful on 17 Jan, 2020
Doesn't support PHP 7.2. and not properly developed.
-
Endi Hariadi
Found the plugin useful on 24 Dec, 2019
OK. Very helpful plugin
-
O. Villani
Found the plugin not useful on 10 Nov, 2019
October has an amazing potential for becoming a #1 CMS and an Application Development System. But at the moment a lot of these capabilities are not implemented state of the art.
The user plugin is quite typical for that. One the one hand easy to install, easy to use and working properly. On the other hand the real potential for practical use is not given. As for example: no user extendable fields, no expandable user rights and of course no relational tables. Thanks to Ivan Doric and his YouTube tutorials one can learn how to do so - but the old fashioned way. (So sadly I had to decide to dismiss the user plugin and write our own one)
Anyhow with these steps forward October could be one of the best systems I know. I am observing now the development for almost two years, but I am missing hints for these crucial steps - still hoping they will come soon! May be a more active community would be helpful? (eg see the bug and feature system of LimeSurvey)
-
assa
Found the plugin useful on 23 Jul, 2019
How can I add a subcategory to the main category? Your health is good, if you have a problem with your plugin.
-
Otto Zelenka
Found the plugin not useful on 10 May, 2019
Im new in October and this plugin don't work for me properly. Other plugin concern news work good but this no. Im added to the partial file by components and then include to the homepage and nothing show. What doing I badly way?
thank you
-
Ompmega
Found the plugin useful on 23 Apr, 2019
No issues at all. Very basic account management, but easy to extend with more features.
-
Michael van Dijk
Found the plugin not useful on 7 Mar, 2019
not clear for with plugin it is, now i see when i buy it that it is only for jkshop
-
Luis Medina
Found the plugin useful on 20 Feb, 2019
Awesome plugin, powerful and easy customizable.
-
Martin Testov
Found the plugin useful on 14 Feb, 2019
Hi, why is used "->lists(" ? I must change it to "->pluck(", because I have problem after instaling laravel-firebird.
Error was: Call to undefined method Illuminate\Database\Query\Builder::lists()
-
Jean Perez
Found the plugin useful on 7 Nov, 2018
Needs more options and features
-
Shohabbos
Found the plugin useful on 6 Nov, 2018
Awesome plugin!
-
Richard Clark
Found the plugin useful on 26 Oct, 2018
Great Plugin
-
Oleg Pashkovsky
Found the plugin useful on 21 Jun, 2018
Maybe it will help some one If you use custom layout:
-
do not forget to add {% framework extra %} at the end of layout. Otherwise AJAX will not work
-
add at the (!) top of layout file [account] redirect = "dashboard" paramCode = "code" forceSecure = 0
Otherwise you will get onRegister and onSignin not found
-
-
Johnny Wen
Found the plugin useful on 1 Jun, 2018
amazing plugin !
-
Douwe Fledderus
Found the plugin useful on 29 May, 2018
Lovely theme with a nice and easy to use page builder. Used this theme for developing a new website for a client. At the same time I was discovering and learning the October Content Management System. While walking this path, I noticed that the support of the theme-developer is excellent ...
-
Marcos Lopez
Found the plugin useful on 12 May, 2018
This plugin is awesome! Thanks
-
Lucas Zamora
Found the plugin useful on 17 Apr, 2018
Excellent plugin, it fulfills its function!
-
Nick Humphries
Found the plugin useful on 14 Mar, 2018
Future updates to come, this is the foundation for an epic site-wide alert system
-
Zoltán Frigy
Found the plugin useful on 8 Feb, 2018
Guys, it's nice to have so many localizations, but none of the form partials use them. (For example the login partial). I see you had a lot of work with the loc files, but your plugin only use the half of them , because in the templates the text is hardwired. Except this, the plugin is great.
-
Hekmat
Found the plugin useful on 31 Dec, 2017
it's marvelous.!!!
-
Ericson Segba Weah
Found the plugin useful on 26 Dec, 2017
This is the most useful plugin I have ever encountered and I am developer as well!!
-
rithymok
Found the plugin useful on 14 Dec, 2017
Hi. I got issue on this plugin. Forgot-password function not working. It seems error like this: Class name is not registered for the component "resetPass". Check the component plugin. Please help me.
-
Jasper Bruienne
Found the plugin not useful on 30 Nov, 2017
Doing exactly as demonstrated in the video tutorials to get this plugin working it just not seems to work. Installing the plugin, adding the user component to a page. After registering the page is refreshed, fields are empty and no user is being created in the backend....what can I possibly be doing wrong while it seems so simple?
Help?
-
A. Rizhenkov
Found the plugin useful on 28 Nov, 2017
A huge time saving!
-
David Watson
Found the plugin useful on 28 Nov, 2017
perfect and easily extendable
-
Jacek Jasinski
Found the plugin useful on 7 Aug, 2017
xDxDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
-
Herzon Garlan
Found the plugin useful on 6 Jun, 2017
This plugin works well for single contact form or if you have the patience to redo everything if you have multiple forms each page. Though very useful it lacks some of the need functionality that will make it a great plugins like:
- Duplicate Forms - So you can only add/remove needed fields
- Export Forms - this is a must specially when you need to test your forms locally and exporting them to your production, well you can do this by going directly to database but that forfeits the purpose of having a CMS.
- Docs need to be updated and more examples will be helpful (e.g. Date pickers using bootstrap)
- Better formatting, though you can get around using bootstrap
Overall, I'm happy with the plugin
-
Cleosetric
Found the plugin useful on 15 Apr, 2017
Hello, i want to ask, how to check if the user is have role admin? is that {% if user.groups %} ? but that's not work at all.
-
Devin Green
Found the plugin useful on 13 Apr, 2017
Awesome plugin
-
rick taylor
Found the plugin useful on 11 Apr, 2017
The user plugin will be required by the vast majority of sites for commenting on content and helping to prevent spamming. Adding the plugin to the base installation gives a massive advantage to sites that require user access. Although it could be more detailed, it is a good framework which can be expanded upon.
-
Nelson S. Otazo
Found the plugin useful on 23 Mar, 2017
Very useful and flexible
-
Tobias Dalhof
Found the plugin useful on 24 Sep, 2016
Great plugin.
For all who are struggeling with the activation url: Check your route!
url = "/your/route/:code?" [account] paramCode = "code"
-
Christian McQuilkin
Found the plugin not useful on 22 Jul, 2016
Too many plugins relying on this one plugin, having to extend everything in the boot section of the Plugin.php, Cannot extend models because of this reliance. ( I was able to override the auth facade, however relations remain unable to be overridden because of the the extending features).
Its a good plugin, but the fact that every other plugin has a developer being forced to use it really does not work out well. Its a huge barrier that needs to be fixed, mainly issue with extending needs to be fixed.
-
SA Vikas Sharma
Found the plugin useful on 21 Jul, 2016
This plugin really good but in register page I am facing ajax error
"AJAX handler 'onRegister' was not found." How solve this?
-
yangzie
Found the plugin useful on 17 Jul, 2016
How should I do when the user login redirect the Previous page not the home or '/'?
-
Tim Marner
Found the plugin useful on 27 Jun, 2016
the activation email link simply goes back to the signup form. But doesn't actually active the account. is this a bug?
-
Manuel Sandoval H
Found the plugin useful on 22 Jun, 2016
well... but how to make a login form for validate users
-
Cr2a
Found the plugin useful on 29 May, 2016
this plugin realy good but how i can add a disconect (logout) button ?
-
Valentin
Found the plugin useful on 26 May, 2016
Very good plugin but can someone tell me how to hide the registration form? I have set up the settings to deactivate the registration but it is still being displayed.
I would like to only display the login form.
Thanks
-
Billy Z Duke
Found the plugin useful on 14 May, 2016
As a PHP user for over 15 years and a Laravel advocate for the past 3, I've gotta say I'm really loving OctoberCMS. I had built and maintained my own PHP web framework for years, but when it became to unwieldy to continue to maintain, I searched high and low for something that would replace all the functionality I'd spent so long creating, and October, thus far, has delivered in spades. The User plugin is a basic scaffolding for end user accounts, written cleanly and simply enough that it is easy to extend once you wrap your head around October's coding conventions. I started using October on a project-for-hire, but as soon as I finish that up, I'll be redesigning two of my personal sites using October as well.
-
Jean Marc BRUNO
Found the plugin useful on 26 Apr, 2016
Very usefull plugin, It would be useful to integrate the captcha directly in this plugin
-
Konand
Found the plugin useful on 13 Apr, 2016
Hey! I've found some issues with this plugin. When I enters the plugin's settings (/backend/system/settings/update/rainlab/user/settings), it throws an exeption: 'Call to undefined method October\Rain\Database\QueryBuilder::listAllTemplates()'. What's wrong? I just install the plugin and that's all, don't even start to use it..
-
Jorge andrade
Found the plugin useful on 8 Apr, 2016
very usesul
-
Scott Bedard
Found the plugin useful on 24 Mar, 2016
Good plugin
-
Boris Dehoumon
Found the plugin useful on 22 Mar, 2016
Hi, Thanks for this plugin. It's amazing. But I did't find the registration page and user authentication. You can help me please. Thanks you.
-
Sildeman Dourado Araújo
Found the plugin useful on 10 Feb, 2016
Great plugin with ACL control.
-
Coffeecup
Found the plugin useful on 1 Dec, 2015
Simple and Fast. Really useful.
-
Andreas Kosmowicz
Found the plugin useful on 3 Nov, 2015
Like the Plugin
-
Forgotten Dream
Found the plugin useful on 15 Oct, 2015
Nice, but not enough extendable :)
-
Derek James Foster
Found the plugin useful on 8 Oct, 2015
Seems great so far. Haven't really needed to use much of it at the moment so I'll bring my true review back in the next month or so.
-
Luke Aull
Found the plugin useful on 21 Sep, 2015
Very useful. Was the backbone of just about every site I've made with October
-
xl1034
Found the plugin useful on 29 Jul, 2015
ioCare, thank you for {% framework %}. It was veru helpful.
-
Slavi
Found the plugin useful on 20 Jul, 2015
I'm unable to update user information from the front end. It does work only on the backend
-
imunisasi
Found the plugin useful on 12 Jul, 2015
good one for basic component (must have)
-
Matiss Janis Aboltins
Found the plugin useful on 9 Jul, 2015
Great plugin! Thanks!
-
Agus Suryanto
Found the plugin useful on 22 Jun, 2015
thats greatt...
-
Jarot Eko Saputra
Found the plugin useful on 3 Jun, 2015
Awesome !!! :)
-
DariNeraka
Found the plugin useful on 28 May, 2015
Very good and helping a lot.
-
Chad Cantrell
Found the plugin useful on 26 May, 2015
Very useful plugin. would use again.
-
Alexander / Aebian
Found the plugin useful on 26 May, 2015
Works as designed, keep up the good work!
-
ioCare
Found the plugin useful on 3 May, 2015
{% framework %} is required to be added in layout for this thing to work.for ajax calls. It should have been mentioned in docs in case if some one is designing pages from scratch.
-
Sylvert
Found the plugin useful on 1 Mar, 2015
I have a doubt, with User::count() i have the number of registered users. but how i can get this:
- Users connecteds
- Guest users
-
Szabó Gergő
Found the plugin useful on 15 Jan, 2015
Excellent plugin!
-
Tim Savory
Found the plugin useful on 10 Jan, 2015
f you desire to login with username instead of email address, then provided username is added to the registration form (in additon to email) and the login form (instead of email) then the documentation suggests it will work. However, registration saves the username as the email address, regardless of what username is specified. The only way I have managed to solve this is to make the following one line addition to the plugin code {Rainlab/User/Models/User}:
protected $fillable = [ 'name', 'login', 'email', 'password', 'password_confirmation', 'company', 'phone', 'street_addr', 'city', 'zip', 'country', 'state', 'username' // NOTE I HAVE ADDED THIS ];
Hope this helps and can be added in future updates.
-
Tim Savory
Found the plugin useful on 9 Jan, 2015
The plugin has good functionality but not very nice error handling/display. I got round this by editing Account.php (which was a last resort as will now need to be careful when plugin is updated)....The areas of changed code are in function onSignin() as below:
$validation = Validator::make($data, $rules); if ($validation->fails()) { $flash_message = ""; $messages = $validation->messages(); foreach ($messages->all() as $message) { if ($flash_message != "") $flash_message = $flash_message . " and "; $flash_message = $flash_message . $message; } Flash::error($flash_message); return Redirect::to('account'); } /* * Authenticate user (MODIFIED for FLASH MESSAGES) */ try { $user = Auth::authenticate([ 'login' => array_get($data, 'login'), 'password' => array_get($data, 'password') ], true); } catch (Exception $ex) { Flash::error($ex->getMessage()); return Redirect::to('account'); //redirect back to login if errors } /* * Redirect to the intended page after successful sign in */ $redirectUrl = $this->pageUrl($this->property('redirect')); Flash::error('User authenticated! ' . $user); if ($redirectUrl = post('redirect', $redirectUrl)) return Redirect::intended($redirectUrl);
-
Patryk Srozak
Found the plugin useful on 17 Dec, 2014
found.
-
Patryk Srozak
Found the plugin useful on 17 Dec, 2014
Hy, Iam a noob and start with OC-CMS. My Question is: where i can class the login / sign form?
-
Matt Baylor
Found the plugin useful on 14 Oct, 2014
Super easy, great documentation
-
Keios
Found the plugin useful on 15 Sep, 2014
Very useful plugin. It just lacks nicer error messages, but apart from that I find it really useful and I am very glad I don't have to use drupal or joomla anymore for user-oriented portals.
-
Daniel81
Found the plugin useful on 24 May, 2014
@Hariadi Hinta / @ OctoDevel
This issue should now be fixed.
-
3.1.3 |
Translation updates Aug 12, 2024 |
---|---|
3.1.2 |
Translation updates Aug 09, 2024 |
3.1.1 |
Fixes compatibility with Mall plugin Jul 22, 2024 |
3.1.0 |
New email verification logic Jun 25, 2024 |
3.0.7 |
Fixes missing notification variables in mail templates Jun 14, 2024 |
3.0.5 |
Adds permission for viewing user activity log Jun 04, 2024 |
3.0.4 |
Fixes bug in JWT authentication check May 14, 2024 |
3.0.0 |
Major Upgrade to User Plugin May 06, 2024 |
2.1.0 |
Adds bearer token (JWT) support to session component May 08, 2023 |
2.0.0 |
Compatibility with October v3 and above Feb 21, 2023 |
1.7.2 |
Stability fixes Feb 13, 2023 |
1.7.1 |
Fixes compatibility with legacy sites Feb 13, 2023 |
1.7.0 |
Add password policy Feb 13, 2023 |
1.6.4 |
Fixes bulk action button with October v3 Jan 23, 2023 |
1.6.3 |
Fixes mail blocker logic Oct 28, 2022 |
1.6.2 |
Improve support with October v3 May 13, 2022 |
1.6.1 |
Adds component property for resetPage in ResetPassword component. Jan 02, 2022 |
1.6.0 |
Apply persistence settings on activation and registration. Fixes last seen touched when impersonating. Fixes user suspension not clearing. Aug 19, 2021 |
1.5.5 |
Updated settings icon and description. Aug 19, 2021 |
1.5.4 |
Multiple translation improvements. Added view events to extend user preview and user listing toolbars. Oct 07, 2020 |
1.5.3 |
Fixes a bug in the user update functionality if password is not changed. Added highlighting for banned users in user list. Jan 10, 2020 |
1.5.2 |
Whitespace from usernames is now trimmed, allowed for username to be added to Reset Password mail templates. Sep 13, 2019 |
1.5.1 |
User IP addresses are now logged. Introduce registration throttle. Sep 01, 2019 |
1.5.0 |
!!! Required password length is now a minimum of 8 characters. Previous passwords will not be affected until the next password change. Jun 22, 2019 |
1.4.8 |
Fixes a bug where calling MailBlocker::removeBlock could remove all mail blocks for the user. Jun 06, 2019 |
1.4.7 |
Fixes redirect bug in Account component / Update translations and separate user and group management. Apr 11, 2019 |
1.4.6 |
Fixes Auth::register method signature mismatch with core OctoberCMS Auth library May 22, 2018 |
1.4.5 |
Added token fallback process to Account / Reset Password components when parameter is missing. Nov 26, 2017 |
1.4.4 |
Fixes bug where impersonation touches the last seen timestamp. Nov 21, 2017 |
1.4.3 |
Fixes session handling for AJAX requests. Oct 16, 2017 |
1.4.2 |
Fixes security bug in Password Reset component. Oct 02, 2017 |
1.4.1 |
Added support for user impersonation. Jul 28, 2017 |
1.4.0 |
!!! The Notifications tab in User settings has been removed. Jul 28, 2017 |
1.3.4 |
Added force secure protocol property to the account component. Dec 15, 2016 |
1.3.3 |
Allow prevention of concurrent user sessions via the user settings. Nov 17, 2016 |
1.3.2 |
Minor fix to the Auth::register method. Sep 17, 2016 |
1.3.1 |
User notification variables can now be extended. Sep 08, 2016 |
1.3.0 |
Introduced guest user accounts. Sep 08, 2016 |
1.2.9 |
Add invitation mail for new accounts created in the back-end. Sep 08, 2016 |
1.2.8 |
Add date range filter to users list. Introduced a logout event. Jul 25, 2016 |
1.2.7 |
Minor fix to user timestamp attributes. Jul 06, 2016 |
1.2.6 |
Add a dedicated last seen column for users. Jun 29, 2016 |
1.2.5 |
Database maintenance. Updated all timestamp columns to be nullable. Apr 29, 2016 |
1.2.4 |
Added a checkbox for blocking all mail sent to the user. Apr 28, 2016 |
1.2.3 |
Included some descriptive paragraphs in the Reset Password component markup. Feb 13, 2016 |
1.2.2 |
Add bulk action button to user list. Feb 08, 2016 |
1.2.1 |
New feature for checking if a user is recently active/online. Dec 29, 2015 |
1.2.0 |
Users can now deactivate their own accounts. Dec 11, 2015 |
1.1.5 |
Adds a new permission to hide the User settings menu item. Dec 11, 2015 |
1.1.4 |
User list can be filtered by the group they belong to. Dec 11, 2015 |
1.1.3 |
Adds a super user flag to the users table, reserved for future use. Nov 27, 2015 |
1.1.2 |
A raw URL can now be passed as the redirect property in the Account component. Sep 27, 2015 |
1.1.1 |
Users can now be added to groups. Sep 25, 2015 |
1.1.0 |
!!! Profile fields and Locations have been removed. Sep 25, 2015 |
1.0.16 |
Require permissions for settings page too. Apr 28, 2015 |
1.0.15 |
Adds last name column to users table (surname). Feb 20, 2015 |
1.0.14 |
Minor improvements to the code. Feb 13, 2015 |
1.0.13 |
Minor fix to the Account sign in logic. Oct 31, 2014 |
1.0.12 |
Create a dedicated setting for choosing the login mode. Oct 08, 2014 |
1.0.11 |
Users now have an optional login field that defaults to the email field. Sep 13, 2014 |
1.0.10 |
Adds administrator-only activation mode. Sep 13, 2014 |
1.0.9 |
Adds new welcome mail message for users and administrators. Sep 13, 2014 |
1.0.8 |
Updated the Settings page Jul 27, 2014 |
1.0.7 |
Adds default country and state fields to Settings page Jul 12, 2014 |
1.0.6 |
Added Mail Blocker utility so users can block specific mail templates Jul 05, 2014 |
1.0.5 |
Added contact details for users Jul 03, 2014 |
1.0.4 |
Improvements to user-interface for Location manager Jun 06, 2014 |
1.0.3 |
Fixes various bugs May 28, 2014 |
1.0.2 |
Add seed data for countries and states May 12, 2014 |
1.0.1 |
Initialize plugin Apr 04, 2014 |
Upgrading from User v2 to v3
This guide can be used to help migrate from RainLab.User v1-v2 to v3. Some theme changes are required to since there are new components.
Please make sure you have a database and website backup before performing the upgrade.
Upgrade Instructions
-
Make sure you are running October CMS v3.6 or greater.
-
Run
php artisan plugin:install rainlab.user
to request the latest version (you do not need to uninstall v2 first). -
Continue using this plugin as normal.
-
Clean up unused table data using
php artisan user:migratev1
(optional).
Previewing Changes
We recommend installing the RainLab.Vanilla
theme to demonstrate the latest functionality.
Compatible Plugins
If you are using the following plugins, please upgrade them to v2.0 at the same time as this plugin:
Package | New Version |
---|---|
rainlab/forum-plugin |
^2.0 |
rainlab/location-plugin |
^2.0 |
rainlab/userplus-plugin |
^2.0 |
rainlab/notify-plugin |
Optional |
If you are using the rainlab/notify-plugin
for sending the new user notifications, you may uninstall this plugin since these notifications are now included in the user settings.
Key Differences
-
Laravel's authentication system is used as the underlying technology.
-
Two-Factor authentication is provided out of the box.
-
A User Log has been implemented to track and audit user actions, such as changing email address.
-
An Address Book component has been added to the UserPlus plugin.
-
The Forum plugin has the ability to "Poke" users to demonstrate the
notifications
component.
Breaking Changes
Renamed Settings Model
The RainLab\User\Models\Settings
model has been renamed to RainLab\User\Models\Setting
for consistency with the core system design.
Renamed JWT Auth Method
The Auth::checkBearerToken
has been renamed to Auth::loginUsingBearerToken
to be more descriptive of its outcome. The Auth::checkBearerToken
method still exists and will return the user or false
, instead of logging in the user internally.
Account Component Split Up
The functionality of the Account
component has been split in to three components:
Component | Purpose |
---|---|
Account |
Update user details, enable two factor, delete sessions, delete the user account |
Authentication |
Authenticate a user |
Registration |
Register a new user |
Session Component
The allowedUserGroups
property has been removed from the Session
component. This can be supplemented by some Twig code:
{% if not user.inGroup('premium-users') %} {% do redirect('account/login') %} {% endif }
Require Activation is Removed
The "Require Activation" functionality has been removed from the settings page for simplicity. The replacement approach below is more flexible, since custom pages or banners can be used based on the requirements.
A user can be checked if they are verified using Twig:
{% if not user.hasVerifiedEmail %} {% do redirect('account/login') %} {% endif %}
Checking administrator approval is possible by creating an "Approved User" user group and placing approved users in that group.
Alternatively, by extending the users database table with a is_approved
field. Then check in Twig:
{% if not user.is_approved %} {% do redirect('account/login') %} {% endif %}
MailBlocker model replaced by UserPreference
The RainLab\User\Models\MailBlocker
model has been replaced by RainLab\User\Models\UserPreference
. The classes function differently and UserPreference
is more generic for controlling user preferences.
Events Updated
The following event names have changed:
- New events added to the events documentation.
- Removed rainlab.user.reactivate event, since users can no longer reactivate their account without help from an administrator.
Feedback
If there are any changes you would like us to include to make upgrading easier, let us know and we can accommodate them in a new release.
Thanks for reading.