always-open/laravel-auth-notifications

A Laravel package to notify your users when their password, two-factor authentication, or login status changes.

v1.0.1 2022-08-20 04:35 UTC

This package is auto-updated.

Last update: 2024-11-20 09:34:08 UTC


README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

A Laravel package to notify your users when their password, two-factor authentication, or login status changes.

Installation

You can install the package via composer:

composer require always-open/laravel-auth-notifications

You can publish the config file with:

php artisan vendor:publish --provider="AlwaysOpen\AuthNotifications\AuthNotificationsServiceProvider" --tag="laravel-auth-notifications-config"

Usage

By default all of the notifications are turned off. To enable them, declare the appropriate environment variable like AUTH_NOTIFICATIONS_LOGIN_VALIDATED=true. Framework login events track the Illuminate\Auth\Events\Validated, Illuminate\Auth\Events\Failed, and Illuminate\Auth\Events\Lockout events.

For credential notifications, we are simply watching the user model for changes. If you'd rather fire those events manually, set the corresponding field to a blank string and dispatch AlwaysOpen\AuthNotifications\Events\LoginWasChanged, AlwaysOpen\AuthNotifications\Events\PasswordWasChanged, AlwaysOpen\AuthNotifications\Events\TwoFactorWasEnabled, or AlwaysOpen\AuthNotifications\Events\TwoFactorWasDisabled with the only parameter being the user object to send to.

You may also override the notifications that are sent by creating your own notifications via php artisan make:notification and overriding the class defined in the config/auth-notifications.php.

Testing

composer test

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.