Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/protonemedia/laravel-verify-new-email
This package adds support for verifying new email addresses: when a user updates its email address, it won't replace the old one until the new one is verified.
https://github.com/protonemedia/laravel-verify-new-email
email-verification laravel laravel-framework mail-verification
Last synced: about 8 hours ago
JSON representation
This package adds support for verifying new email addresses: when a user updates its email address, it won't replace the old one until the new one is verified.
- Host: GitHub
- URL: https://github.com/protonemedia/laravel-verify-new-email
- Owner: protonemedia
- License: mit
- Created: 2019-12-29T10:44:35.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-20T13:56:34.000Z (4 months ago)
- Last Synced: 2024-10-29T17:14:15.391Z (about 2 months ago)
- Topics: email-verification, laravel, laravel-framework, mail-verification
- Language: PHP
- Homepage: https://protone.media/en/blog/an-add-on-to-laravels-built-in-email-verification-only-update-a-users-email-address-if-the-new-one-is-verified-as-well
- Size: 83 KB
- Stars: 404
- Watchers: 8
- Forks: 30
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# Laravel Verify New Email
[](https://packagist.org/packages/protonemedia/laravel-verify-new-email)
[](https://scrutinizer-ci.com/g/protonemedia/laravel-verify-new-email)
[](https://packagist.org/packages/protonemedia/laravel-verify-new-email)
Laravel supports verifying email addresses out of the box. This package adds support for verifying *new* email addresses. When a user updates its email address, it won't replace the old one until the new one is verified. Super easy to set up, still fully customizable. If you want it can be used as a drop-in replacement for the built-in Email Verification features as this package supports unauthenticated verification and auto-login. Support for Laravel 9.0 and higher and requires PHP 8.2 or higher.
## Sponsor Us
[
](https://inertiaui.com/inertia-table?utm_source=github&utm_campaign=laravel-verify-new-email)
❤️ We proudly support the community by developing Laravel packages and giving them away for free. If this package saves you time or if you're relying on it professionally, please consider [sponsoring the maintenance and development](https://github.com/sponsors/pascalbaljet) and check out our latest premium package: [Inertia Table](https://inertiaui.com/inertia-table?utm_source=github&utm_campaign=laravel-verify-new-email). Keeping track of issues and pull requests takes time, but we're happy to help!
## Blogpost
If you want to know more about the background of this package, please read [the blog post](https://protone.media/en/blog/an-add-on-to-laravels-built-in-email-verification-only-update-a-users-email-address-if-the-new-one-is-verified-as-well).
## Requirements
* PHP 8.2 or higher
* Laravel 10 or higher
## Installation
You can install the package via composer:
```bash
composer require protonemedia/laravel-verify-new-email
```
## Configuration
Publish the database migration, config file and email view:
```bash
php artisan vendor:publish --provider="ProtoneMedia\LaravelVerifyNewEmail\ServiceProvider"
```
You can set the redirect path in the `verify-new-email.php` config file. The user will be redirected to this path after verification.
The expire time of the verification URLs can be changed by updating the `auth.verification.expire` setting and defaults to 60 minutes.
## Usage
Add the `MustVerifyNewEmail` trait to your `User` model and make sure it implements the framework's `MustVerifyEmail` interface as well.
``` php
newEmail('[email protected]');
// returns the currently pending email address that needs to be verified.
$user->getPendingEmail();
// resends the verification mail for '[email protected]'.
$user->resendPendingEmailVerificationMail();
// deletes the pending email address
$user->clearPendingEmail();
```
The `newEmail` method doesn't update the user, its current email address stays current until the new one if verified. It stores a token (associated with the user and new email address) in the `pending_user_emails` table. Once the user verifies the email address by clicking the link in the mail, the user model will be updated and the token will be removed from the `pending_user_emails` table.
The `resendPendingEmailVerificationMail` does the same, it just grabs the new email address from the previous attempt.
### Login after verification
The user that verified its email address will be logged in automatically. You can disable this by changing the `login_after_verification` configuration setting to `false`.
### Overriding the default Laravel Email Verification
The default [Laravel implementation](https://laravel.com/docs/master/verification) requires the user to be logged in before it can verify its email address. If you want to use this package's logic to handle that first verification flow as well, override the `sendEmailVerificationNotification` method as shown below.
``` php
newEmail($this->getEmailForVerification());
}
}
```
### Customization
You can change the content of the verification mail by editing the published views which can be found in the `resources/views/vendor/verify-new-email` folder. The `verifyNewEmail.blade.php` view will be sent when verifying *updated* email addresses. The `verifyFirstEmail.blade.php` view will be sent when a User verifies its initial email address for the first time (after registering). Alternatively, you set your own custom Mailables classes in the config file:
``` php
\ProtoneMedia\LaravelVerifyNewEmail\Mail\VerifyFirstEmail::class,
'mailable_for_new_email' => \ProtoneMedia\LaravelVerifyNewEmail\Mail\VerifyNewEmail::class,
];
```
You can also override the `sendPendingEmailVerificationMail` method to change the behaviour of sending the verification mail:
``` php
'user.email.verify',
];
```
### Testing
``` bash
composer test
```
### Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
## Other Laravel packages
* [`Inertia Table`](https://inertiaui.com/inertia-table?utm_source=github&utm_campaign=laravel-verify-new-email): The Ultimate Table for Inertia.js with built-in Query Builder.
* [`Laravel Blade On Demand`](https://github.com/protonemedia/laravel-blade-on-demand): Laravel package to compile Blade templates in memory.
* [`Laravel Cross Eloquent Search`](https://github.com/protonemedia/laravel-cross-eloquent-search): Laravel package to search through multiple Eloquent models.
* [`Laravel Eloquent Scope as Select`](https://github.com/protonemedia/laravel-eloquent-scope-as-select): Stop duplicating your Eloquent query scopes and constraints in PHP. This package lets you re-use your query scopes and constraints by adding them as a subquery.
* [`Laravel FFMpeg`](https://github.com/protonemedia/laravel-ffmpeg): This package provides an integration with FFmpeg for Laravel. The storage of the files is handled by Laravel's Filesystem.
* [`Laravel MinIO Testing Tools`](https://github.com/protonemedia/laravel-minio-testing-tools): Run your tests against a MinIO S3 server.
* [`Laravel Mixins`](https://github.com/protonemedia/laravel-mixins): A collection of Laravel goodies.
* [`Laravel Paddle`](https://github.com/protonemedia/laravel-paddle): Paddle.com API integration for Laravel with support for webhooks/events.
* [`Laravel Task Runner`](https://github.com/protonemedia/laravel-task-runner): Write Shell scripts like Blade Components and run them locally or on a remote server.
* [`Laravel XSS Protection`](https://github.com/protonemedia/laravel-xss-protection): Laravel Middleware to protect your app against Cross-site scripting (XSS). It sanitizes request input, and it can sanatize Blade echo statements.
### Security
If you discover any security-related issues, please email [email protected] instead of using the issue tracker.
## Credits
- [Pascal Baljet](https://github.com/pascalbaljetmedia)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.