Laravel Markdown 邮件中的动态页眉和页脚

Question

按照文档，我使用 markdown mailables 创建了自己的邮件模板： https ://laravel.com/docs/9.x/mail#generating-markdown-mailables

要点是我需要动态自定义页眉和页脚中的信息（在每种情况下都会有所不同）。我在 toMail 函数中传递的信息仅在我的自定义模板 neworder.blade.php 的范围内可用：

public function toMail($notifiable){
    $from = 'no-reply.'.$this->subdomain.'@'.env('APP_DOMAIN');
    return (new MailMessage)
    ->from($from)
    ->markdown('emails.neworder',
        [
            'name'=>$this->name,
            'order'=> $this->order,
            'emailbody'=> $this->emailbody,
            'headertitle' => $this->headertitle,
            'footertext' => $this->footertext
        ]
    );
}

按照相同的文档，我导出了 Markdown 邮件组件以使用此命令自定义它们：

php artisan vendor:publish --tag=laravel-mail

从这里我可以自定义文件，例如/vendor/mail/html/themes/header.blade.php，其中的修改有效地影响标头。我不明白的是如何传递我可以在这些文件范围内使用的变量，就像在 /views/email/neworder.blade.php 中 我需要在相应部分中有 headertitle 和 footertext 的值。

Answer 1

您无法使用 MailMessage 执行此操作。您需要创建一个 Mailable 类并将其传递到 Notification 的 toMail() 函数中。

1. 创建一个新的 Mailable 类。

2. 确保您的 Mailable 类使用您的 markdown Blade 模板文件。

3. 照常在 markdown() 函数中传递数据。

// app/Mail/NewOrderMail.php

public function build()
{
    return $this->markdown('emails.new-order', [
        'headerTitle' => 'Header title here',
        'footerText' => 'Footer text here',
    ]);
}

4. 在 Mailable 的 markdown Blade 模板文件中，可以将数据传递到布局文件，如下所示：

// resources/views/emails/new-order.blade.php

@component('mail::message', ['headerTitle' => $headerTitle, 'footerText' => $footerText])   
{{-- ...the rest of your email template... --}}
@endcomponent

5. 在 resources/views/vendor/mail/html/message 中.blade.php，将变量传递给您想要将数据传递到的每个 @component：

// resources/views/vendor/mail/html/message.blade.php

@component('mail::layout')

{{-- Header --}}
@slot('header')
@component('mail::header', ['url' => config('app.url'), 'headerTitle' => $headerTitle ?? config('app.name')])
{{ $headerTitle }}
@endcomponent
@endslot

{{-- ...the rest of your layout template... --}}

{{-- Footer --}}
@slot('footer')
@component('mail::footer', ['footerText' => $footerText ?? 'Default Text'])
{{ $footerText }}
@endcomponent
@endslot

@endcomponent

6. 在 中返回您的 Mailable 类toMail() 函数Notification 类：

// app/Notifications/NewOrderNotification.php

public function toMail($notifiable)
{
    return (new NewOrderMail($notifiable))->to($notifiable);
}

重要： 确保将 resources/views/vendor/mail/html/message 中的变量合并为空。 blade.php 布局文件，以确保当电子邮件模板文件未传递您在布局文件中定义的任何变量时，事情不会中断。

所有文件名仅用作示例。将它们替换为您自己的。

Answer 2

由于找不到更好的解决方案，我最终被迫使用会话变量，以便我可以在页眉和页脚模板中使用它们。

1. 设置您想要在 Http/Notifications/yourNotificationTemplate.php 的页脚/页眉中使用的会话变量：

    公共函数 toMail($notifying){
        session(['headertitle' => $this->headertitle]);
        session(['footertext' => $this->footertext]);
        $from = 'no-reply.'.$this->subdomain.'@'.env('APP_DOMAIN');
        返回（新邮件消息）
        ->来自（$来自）
        ->markdown('emails.neworder',
            [
                'name'=>$this->name,
                '订单'=> $这个->订单，
                '电子邮件正文'=> $this->电子邮件正文，
            ]
        ）；
    }
   

2. 然后您就可以在模板中的任何位置使用它。 /views/vendor/mail/thml/header.blade.php 中的 FE：

@php ($headertext = session('headertitle'))
<tr>
<td class="header">
@if (null!==(session('headertext')))
<h1>{{$headertext}}</h1>
@else
{{ $slot }}
@endif
</td>
</tr>