Merge branch 'master' into 3.0

Author: jrean

README.md

@@ -86,6 +86,37 @@ To customize the migration, publish it with the following command:
 php artisan vendor:publish --provider="Jrean\UserVerification\UserVerificationServiceProvider" --tag="migrations"
 ```
 
+## Middleware
+
+### Default middleware
+
+This package ships with an optional middleware throwing a `UserNotVerifiedException`. You can setup the desired behaviour, for example a redirect to a specific page, in the `app\Exceptions\Handler.php`. Please refer to the [Laravel Documentation](https://laravel.com/docs/master/errors#the-exception-handler) to learn more about how to work with the exception handler.
+
+To register the default middleware add the following to the `$routeMiddleware` array within the `app/Http/Kernel.php` file:
+
+```php
+protected $routeMiddleware = [
+    // …
+    'isVerified' => Jrean\UserVerification\Middleware\IsVerified::class,
+```
+
+Apply the middleware on your routes:
+
+```php
+Route::group(['middleware' => ['web', 'isVerified']], function () {
+    …
+```
+
+### Custom middleware
+
+Create your own custom middleware using the following artisan command:
+
+```
+php artisan make:middleware IsVerified
+```
+
+For more details about middlewares, please refer to the [Laravel Documentation](https://laravel.com/docs/5.3/middleware).
+
 ## E-MAIL
 
 This package provides a method to send an e-mail with a link containing the verification token.
@@ -151,6 +182,10 @@ Wrong verification token.
 
 The given user is already verified.
 
+* `UserNotVerifiedException`
+
+The given user is not yet verified.
+
 * `UserNotFoundException`
 
 No user found for the given e-mail adresse.

src/Exceptions/UserNotVerifiedException.php

@@ -0,0 +1,19 @@
+<?php
+/**
+ * This file is part of Jrean\UserVerification package.
+ *
+ * (c) Jean Ragouin <[email protected]> <www.askjong.com>
+ */
+namespace Jrean\UserVerification\Exceptions;
+
+use Exception;
+
+class UserNotVerifiedException extends Exception
+{
+    /**
+     * The exception description.
+     *
+     * @var string
+     */
+    protected $message = 'This user is not verified.';
+}

src/Middleware/IsVerified.php

@@ -0,0 +1,31 @@
+<?php
+/**
+ * This file is part of Jrean\UserVerification package.
+ *
+ * (c) Jean Ragouin <[email protected]> <www.askjong.com>
+ */
+namespace Jrean\UserVerification\Middleware;
+
+use Closure;
+use Jrean\UserVerification\Exceptions\UserNotVerifiedException;
+
+class IsVerified
+{
+    /**
+     * Handle an incoming request.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @param  \Closure  $next
+     * @return mixed
+     *
+     * @throws Jrean\UserVerification\Exceptions\UserNotVerifiedException
+     */
+    public function handle($request, Closure $next)
+    {
+        if( ! $request->user()->verified){
+            throw new UserNotVerifiedException;
+        }
+
+        return $next($request);
+    }
+}