Skip to content

Latest commit

 

History

History
54 lines (46 loc) · 3.17 KB

events.md

File metadata and controls

54 lines (46 loc) · 3.17 KB

Events

This plugin will fire some global events that can be useful for interacting with other plugins.

Events Description
rainlab.user.beforeAuthenticate Before the user is attempting to authenticate using the Account component.
rainlab.user.authenticate Provides custom response logic after authentication.
rainlab.user.login The user has successfully signed in.
rainlab.user.logout The user has successfully signed out.
rainlab.user.lockout Provides custom logic when a login attempt has been rate limited.
rainlab.user.activate The user has verified their email address.
rainlab.user.deactivate The user has opted-out of the site by deactivating their account. This should be used to disable any content the user may want removed.
rainlab.user.beforeRegister Before the user's registration is processed. Passed the $input variable by reference to enable direct modifications to the user input.
rainlab.user.register Provides custom response logic after registration.
rainlab.user.passwordReset Provides custom logic for resetting a user password.
rainlab.user.beforeUpdate Before the user updates their profile from the Account component.
rainlab.user.update The user has updated their profile information.
rainlab.user.canDeleteUser Triggered before a user is deleted. This event should return true if the user has dependencies and should be soft deleted to retain those relationships and allow the user to be restored. Otherwise, it will be deleted forever.
rainlab.user.getNotificationVars Fires when sending a user notification to enable passing more variables to the email templates. Passes the $user model the template will be for.
rainlab.user.view.extendListToolbar Fires when the user listing page's toolbar is rendered.
rainlab.user.view.extendPreviewToolbar Fires when the user preview page's toolbar is rendered.
rainlab.user.view.extendPreviewTabs Provides an opportunity to add tabs to the user preview page in the admin panel. The event should return an array of [Tab Name => ~/path/to/partial.php]

Here is an example of hooking an event:

Event::listen('rainlab.user.deactivate', function($user) {
    // Hide all posts by the user
});

A common requirement is to adapt another to a legacy authentication system. In the example below, the WordPressLogin::check method would check the user password using an alternative hashing method, and if successful, update to the new one used by October.

Event::listen('rainlab.user.beforeAuthenticate', function($component, $credentials) {
    $email = $credentials['email'] ?? null;
    $password = $credentials['password'] ?? null;

    // Check that the user exists with the provided email
    $user = Auth::getProvider()->retrieveByCredentials(['email' => $email]);
    if (!$user) {
        return;
    }

    // The user is logging in with their old WordPress account
    // for the first time. Rehash their password using the new
    // October system.
    if (WordPressLogin::check($user->password, $password)) {
        $user->password = $user->password_confirmation = $password;
        $user->forceSave();
    }
});