Mail templates/views can now be localized

Plugin.php

@@ -37,6 +37,13 @@ public function pluginDetails()
 
     public function register()
     {
+        /* 
+         * Load localize version of mail templates (akin to localized CMS content files)
+         */
+        Event::listen('mailer.beforeAddContent', function ($mailer, $message, $view, $data, $raw, $plain) {
+            return EventRegistry::instance()->findLocalizedMailViewContent($mailer, $message, $view, $data, $raw, $plain);
+        }, 1);
+
         /*
          * Defer event with low priority to let others contribute before this registers.
          */

classes/EventRegistry.php

@@ -1,15 +1,17 @@
 <?php namespace RainLab\Translate\Classes;
 
-use Str;
+use App;
+use Exception;
 use File;
+use Str;
 use Cms\Classes\Page;
 use Cms\Classes\Content;
+use System\Classes\MailManager;
 use System\Classes\PluginManager;
 use RainLab\Translate\Models\Message;
 use RainLab\Translate\Models\Locale as LocaleModel;
 use RainLab\Translate\Classes\Translator;
 use RainLab\Translate\Classes\ThemeScanner;
-use Exception;
 
 /**
  * Registrant class for bootstrapping events
@@ -263,4 +265,77 @@ public function pruneTranslatedContentTemplates($templates)
             return !Str::endsWith($template->getBaseFileName(), $extensions);
         });
     }
+
+    /**
+     * Adds language suffixes to mail view files.
+     * @param  \October\Rain\Mail\Mailer $mailer
+     * @param  \Illuminate\Mail\Message $message
+     * @param  string $view
+     * @param  array $data
+     * @param  string $raw
+     * @param  string $plain
+     * @return string|null
+     */
+    public function findLocalizedMailViewContent($mailer, $message, $view, $data, $raw, $plain)
+    {
+        // There is no need to localize raw templates
+        if (!empty($raw)) {
+            return null;
+        }
+
+        $locale = !empty($data['_current_locale']) ? $data['_current_locale'] : App::getLocale();
+
+        $factory = $mailer->getViewFactory();
+
+        if (isset($view)) {
+            $view = $this->getLocalizedView($factory, $view, $locale);
+        }
+
+        if (isset($plain)) {
+            $plain = $this->getLocalizedView($factory, $plain, $locale);
+        }
+
+        $code = $view ?: $plain;
+        if (empty($code)) {
+            return null;
+        }
+
+        $plainOnly = empty($view);
+
+        $result = MailManager::instance()->addContentToMailer($message, $code, $data, $plainOnly);
+        if ($result) {
+            // prevent the caller who fired the event from continuing to send the mail.
+            return false;
+        }
+    }
+
+
+    /**
+     * Search mail view files based on locale
+     * @param  \October\Rain\Mail\Mailer $mailer
+     * @param  \Illuminate\Mail\Message $message
+     * @param  string $code
+     * @param  string $locale
+     * @return string|null
+     */
+    public function getLocalizedView($factory, $code, $locale)
+    {
+        $locale = strtolower($locale);
+
+        $searchPaths[] = $locale;
+
+        if (str_contains($locale, '-')) {
+            list($lang) = explode('-', $locale);
+            $searchPaths[] = $lang;
+        }
+
+        foreach ($searchPaths as $path) {
+            $localizedView = sprintf('%s-%s', $code, $path);
+
+            if ($factory->exists($localizedView)) {
+                return $localizedView;
+            }
+        }
+        return null;
+    }
 }