Merge pull request #10 from timkelty/toMail-multiple

Allow toMail channel to accept an array for sending multiple emails.

README.md

@@ -193,7 +193,7 @@ return [
 
 If a notification supports being sent as an email, you should define a `toMail` method on the notification class. This method will receive a `$notifiable` object that contains everything you defined in your `via` method.
 
-The `toMail` function should return a `craft\mail\Message` instance. Let's take a look at an example toMail method:
+The `toMail` function should return a `craft\mail\Message` instance. You may also return an array of `craft\mail\Message` instances if you wish to send multiple emails. Let's take a look at an example toMail method:
 
 ```php
 public function toMail($notifiable)

src/channels/MailChannel.php

@@ -25,12 +25,15 @@ class MailChannel
      */
     public function send(string $notifiable, Notification $notification)
     {
-        $message = $notification->toMail($notifiable);
+        $channelResult = $notification->toMail($notifiable);
+        $messages = is_array($channelResult) ? $channelResult : [$channelResult];
 
-        if (! $message instanceof Message) {
-            throw new \Exception("Message needs to be an instance of craft\mail\Message");
-        }
+        foreach ($messages as $message) {
+            if (! $message instanceof Message) {
+                throw new \Exception("Message needs to be an instance of craft\mail\Message");
+            }
 
-        $message->send();
+            $message->send();
+        }
     }
 }