Mail templates in Laravel - Mini Project: Build & Apply

Mail templates

📖 Scenario: You are building a simple Laravel application that sends welcome emails to new users. To make the emails look nice and consistent, you will create a mail template.This template will include a greeting, a message body, and a footer with contact information.

🎯 Goal: Create a Laravel mail template using Blade syntax that can be reused for sending welcome emails.

📋 What You'll Learn

Create a Blade mail template file named welcome.blade.php in the resources/views/emails directory

Add a variable $userName to display the user's name in the greeting

Include a message body with a welcome text

Add a footer with contact email [e-mail]

Use proper Blade syntax for variables and HTML structure

💡 Why This Matters

🌍 Real World

Mail templates are used in real applications to send consistent, styled emails to users for notifications, welcomes, password resets, and more.

💼 Career

Knowing how to create and use mail templates in Laravel is essential for backend developers working on user communication features.

1

Create the mail template file with HTML structure

Create a Blade template file named welcome.blade.php inside resources/views/emails. Add the basic HTML structure with <html>, <body>, and a <h1> tag containing the text Welcome Email.

Laravel

Welcome Email

Hint

Start by writing the basic HTML tags inside the Blade template file.

2

Add a greeting with the user's name variable

Inside the body tag, add a greeting using an <h2> tag that says Hello, {{ $userName }}! using Blade syntax to display the $userName variable.

Laravel

Welcome Email
Hello, {{ $userName }}!

Hint

Use Blade double curly braces to insert the $userName variable inside the greeting.

3

Add the welcome message body

Below the greeting, add a paragraph <p> with the text: Thank you for joining our platform. We are excited to have you!

Laravel

Welcome Email
Hello, {{ $userName }}!
Thank you for joining our platform. We are excited to have you!

Hint

Add a paragraph tag with the welcome message text below the greeting.

4

Add a footer with contact information

At the bottom of the body, add a footer paragraph <p> with the text: Contact us at [e-mail].

Laravel

Welcome Email
Hello, {{ $userName }}!
Thank you for joining our platform. We are excited to have you!
Contact us at [e-mail]

Hint

Add a paragraph at the end of the body with the contact email.

Practice

1. What is the main purpose of using mail templates in Laravel?

easy

A. To create reusable and consistent email designs

B. To store user passwords securely

C. To manage database migrations

D. To handle HTTP requests routing

Solution

1. Step 1: Understand mail templates role

   Mail templates are used to design emails that can be reused for sending consistent messages.

2. Step 2: Compare with other options

   Options B, C, and D relate to security, database, and routing, which are unrelated to mail templates.

3. Final Answer:

   To create reusable and consistent email designs -> Option A

4. Quick Check:

   Mail templates = reusable email designs [OK]

Hint: Mail templates are for email design reuse [OK]

Common Mistakes:

• Confusing mail templates with database or routing features
• Thinking mail templates handle security
• Assuming mail templates manage HTTP requests

2. Which artisan command creates a new mail class with a markdown template in Laravel?

easy

A. php artisan make:mail -m

B. php artisan make:mail --markdown

C. php artisan mail:create --template

D. php artisan make:mail --template

Solution

1. Step 1: Recall the correct artisan command

   The correct command to create a mail class with a markdown template is php artisan make:mail MailName --markdown.

2. Step 2: Check other options

   Options B, C, and D are incorrect because they use wrong flags or commands that do not exist.

3. Final Answer:

   php artisan make:mail --markdown -> Option B

4. Quick Check:

   Correct artisan command = php artisan make:mail --markdown [OK]

Hint: Use --markdown flag with make:mail command [OK]

Common Mistakes:

• Using shorthand -m which is invalid here
• Trying non-existent commands like mail:create
• Using --template instead of --markdown

3. Given this mail class snippet, what will be the value of $this->name inside the markdown template?

class WelcomeMail extends Mailable {
    public $name;
    public function __construct($name) {
        $this->name = $name;
    }
    public function build() {
        return $this->markdown('emails.welcome')->with(['name' => $this->name]);
    }
}

If you send new WelcomeMail('Alice'), what is $name in the template?

medium

A. 'Alice'

B. null

C. 'name'

D. An error occurs

Solution

1. Step 1: Understand constructor assignment

   The constructor sets $this->name to the passed value 'Alice'.

2. Step 2: Check data passed to template

   The with() method passes ['name' => $this->name], so 'Alice' is passed as 'name'.

3. Final Answer:

   'Alice' -> Option A

4. Quick Check:

   Passed name = 'Alice' [OK]

Hint: Constructor sets property, with() passes it to template [OK]

Common Mistakes:

• Assuming $name is null if not explicitly set in build()
• Confusing property name with string 'name'
• Expecting an error due to missing data

4. Identify the error in this mail class code snippet:

class NotifyUser extends Mailable {
    public function build() {
        return $this->markdown('emails.notify')->with('user', $user);
    }
}

medium

A. with() method requires an array, not two arguments

B. The markdown method should be markdownView()

C. Variable $user is undefined in build() method

D. Class must extend Mail instead of Mailable

Solution

1. Step 1: Check variable usage in build()

   The variable $user is used but not defined or passed to the method.

2. Step 2: Verify method names and parameters

   markdown() is correct; with() accepts key-value pairs or array, so usage is okay if $user existed.

3. Final Answer:

   Variable $user is undefined in build() method -> Option C

4. Quick Check:

   Undefined variable $user causes error [OK]

Hint: Check all variables are defined before use [OK]

Common Mistakes:

• Assuming with() needs only arrays
• Thinking markdown() method name is wrong
• Confusing Mailable with Mail class

5. You want to send a mail with a markdown template that shows a list of products. Which approach correctly passes the products array to the template?

hard

A. Pass products as a constructor argument but do not use with()

B. Set a private property $products but do not pass it to the template

C. Call markdown('emails.products', $products) directly

D. Use with(['products' => $products]) in the build() method

Solution

1. Step 1: Understand data passing to templates

   Data must be passed explicitly using with() or public properties.

2. Step 2: Evaluate each option

   Use with(['products' => $products]) in the build() method correctly uses with() to pass the products array. Pass products as a constructor argument but do not use with() misses passing data to template. Call markdown('emails.products', $products) directly uses wrong markdown method signature. Set a private property $products but do not pass data sets property but does not pass data.

3. Final Answer:

   Use with(['products' => $products]) in the build() method -> Option D

4. Quick Check:

   Pass data with with() method [OK]

Hint: Always pass data with with() or public properties [OK]

Common Mistakes:

• Not passing data to template after setting property
• Using markdown() with wrong parameters
• Assuming constructor argument auto-passes data