Custom e-mail view name + Documentation

Author: jrean

README.md

@@ -142,10 +142,16 @@ proper e-mail component configuration.
 ### E-mail View
 
 The user will receive an e-mail with a link leading to the `getVerification()`
-method (endpoint). Create a view for this e-mail at
-`resources/views/emails/user-verification.blade.php`. The view will receive the
-`$user` variable which contains the user details such as the verification
-token. Here is a sample e-mail view content to get you started with:
+method (endpoint). The view will receive a `$user` variable which contains the
+user details such as the verification token.
+
+By default the package sets the e-mail view as `emails.user-verification`.
+Create a view for this e-mail at `resources/views/emails/user-verification.blade.php`.
+
+If you want to customize the e-mail view location you can create the view file
+wherever you want and call `UserVerification::viewName('directory.your-view-name')`.
+
+Here is a sample e-mail view content to get you started with:
 **The link url must contain the verification token as parameter + (mandatory) a
 query string with the user's e-mail as parameter.**
 
@@ -245,16 +251,12 @@ The package offers a facade `UserVerification::`.
 ### Attributes/Properties
 
 To customize the package behaviour and the redirects you can implement and
-customize six (6) attributes/properties:
+customize six (5) attributes/properties:
 
 * `$redirectIfVerified = '/';`
 
 Where to reditect if the authenticated user is already verified.
 
-* `$redirectAfterTokenGeneration = '/';`
-
-Where to redirect after a successful verification token generation.
-
 * `$redirectAfterVerification = '/';`
 
 Where to redirect after a successful verification token verification.

src/Traits/RedirectsUsers.php

@@ -18,16 +18,6 @@ public function redirectIfVerified()
         return property_exists($this, 'redirectIfVerified') ? $this->redirectIfVerified : '/';
     }
 
-    /**
-     * Get the redirect path for a successful verification token generation.
-     *
-     * @return string
-     */
-    public function redirectAfterTokenGeneration()
-    {
-        return property_exists($this, 'redirectAfterTokenGeneration') ? $this->redirectAfterTokenGeneration : '/';
-    }
-
     /**
      * Get the redirect path for a successful verification token verification.
      *

src/Traits/VerifiesUsers.php

@@ -77,6 +77,16 @@ protected function verificationErrorView()
         return property_exists($this, 'verificationErrorView') ? $this->verificationErrorView : 'errors.user-verification';
     }
 
+    /**
+     * Get the verification e-mail view name.
+     *
+     * @return string
+     */
+    protected function verificationEmailView()
+    {
+        return property_exists($this, 'verificationEmailView') ? $this->verificationEmailView : 'emails.user-verification';
+    }
+
     /**
      * Get the user table name.
      *

src/UserVerification.php

@@ -32,6 +32,13 @@ class UserVerification
      */
     protected $schema;
 
+    /**
+     * E-mail view name.
+     *
+     * @var string
+     */
+    protected $emailView;
+
     /**
      * Create a new instance.
      *
@@ -41,8 +48,9 @@ class UserVerification
      */
     public function __construct(MailerContract $mailer, Builder $schema)
     {
-        $this->mailer = $mailer;
-        $this->schema = $schema;
+        $this->mailer    = $mailer;
+        $this->schema    = $schema;
+        $this->emailView = 'emails.user-verification';
     }
 
     /**
@@ -108,6 +116,19 @@ public function send(AuthenticatableContract $user, $subject = null, $from = nul
         return (boolean) $this->emailVerificationLink($user, $subject, $from, $name);
     }
 
+    /**
+     * Set the e-mail view name.
+     *
+     * @param  mixed  $name
+     * @return \Jrean\UserVerification
+     */
+    public function emailView($name)
+    {
+        $this->emailView = $name;
+
+        return $this;
+    }
+
     /**
      * Process the user verification for the given e-mail and token.
      *
@@ -224,7 +245,7 @@ protected function updateUser($user)
      */
     protected function emailVerificationLink(AuthenticatableContract $user, $subject, $from = null, $name = null)
     {
-        return $this->mailer->send('emails.user-verification', compact('user'), function ($m) use ($user, $subject, $from, $name) {
+        return $this->mailer->send($this->emailView, compact('user'), function ($m) use ($user, $subject, $from, $name) {
             if (! empty($from)) {
                 $m->from($from, $name);
             }