@akemona-org/strapi-plugin-email 3.7.0

package/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2015-present Strapi Solutions SAS
+
+Portions of the Strapi software are licensed as follows:
+
+* All software that resides under an "ee/" directory (the “EE Software”), if that directory exists, is licensed under the license defined in "ee/LICENSE".
+
+* All software outside of the above-mentioned directories or restrictions above is available under the "MIT Expat" license as set forth below.
+
+MIT Expat License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# Strapi plugin
+
+---
+
+## Deprecation Warning :warning:
+
+Hello! We have some news to share,
+
+We’ve decided it’ll soon be time to end the support for `strapi-plugin-email`.
+
+After years of iterations, Strapi is going to V4 and we won’t maintain V3 packages when it’ll reach its end-of-support milestone (~end of Q3 2022).
+
+If you’ve been using `strapi-plugin-email` and have migrated to V4 (or if you want to), you can find the equivalent and updated version of this package at this [URL](https://github.com/strapi/strapi/tree/master/packages/core/email) and with the following name on NPM: `@strapi/plugin-email`.
+
+If you’ve contributed to the development of this package, thank you again for that! We hope to see you on the V4 soon.
+
+The Akemona team
+
+---
+
+> :warning: The Shipper Email may also need to be changed in the `Email Templates` tab on the admin panel for emails to send properly

package/admin/src/assets/images/logo.svg

@@ -0,0 +1 @@
+<svg width="24" height="17" xmlns="http://www.w3.org/2000/svg"><text transform="translate(-23 -9)" fill="#4B515A" fill-rule="evenodd" font-size="24" font-family="AppleColorEmoji, Apple Color Emoji"><tspan x="23" y="28">✉️</tspan></text></svg>

package/admin/src/containers/Settings/components.js

@@ -0,0 +1,16 @@
+import styled from 'styled-components';
+import { Button, Text as TextBase } from '@buffetjs/core';
+
+const Text = styled(TextBase)`
+  width: 100%;
+  padding: 0 15px 17px 15px;
+`;
+
+const AlignedButton = styled(Button)`
+  height: 34px;
+  padding-top: 3px;
+  margin: 29px 15px 0 15px;
+  min-width: unset;
+`;
+
+export { Text, AlignedButton };

package/admin/src/containers/Settings/index.js

@@ -0,0 +1,201 @@
+import React, { useState, useEffect, useRef } from 'react';
+import { useIntl, FormattedMessage } from 'react-intl';
+import { get } from 'lodash';
+import { Header } from '@buffetjs/custom';
+import { Envelope } from '@buffetjs/icons';
+import { colors } from '@buffetjs/styles';
+import {
+  FormBloc,
+  request,
+  SettingsPageTitle,
+  SizedInput,
+  getYupInnerErrors,
+  BaselineAlignment,
+  CheckPagePermissions,
+} from 'strapi-helper-plugin';
+import getTrad from '../../utils/getTrad';
+import { AlignedButton, Text } from './components';
+import schema from '../../utils/schema';
+import pluginPermissions from '../../permissions';
+
+const SettingsPage = () => {
+  const { formatMessage } = useIntl();
+  const [formErrors, setFormErrors] = useState({});
+  const [isTestButtonLoading, setIsTestButtonLoading] = useState(false);
+  const [showLoader, setShowLoader] = useState(false);
+  const [config, setConfig] = useState({
+    provider: '',
+    settings: { defaultFrom: '', defaultReplyTo: '', testAddress: '' },
+  });
+  const [providers, setProviders] = useState([]);
+  const [testAddress, setTestAddress] = useState();
+  const [testSuccess, setTestSuccess] = useState(false);
+  const isMounted = useRef(true);
+
+  const title = formatMessage({ id: getTrad('Settings.title') });
+
+  const handleSubmit = async event => {
+    event.preventDefault();
+    let errors = {};
+
+    try {
+      await schema.validate({ email: testAddress }, { abortEarly: false });
+
+      try {
+        setIsTestButtonLoading(true);
+
+        await request('/email/test', {
+          method: 'POST',
+          body: { to: testAddress },
+        });
+
+        setTestSuccess(true);
+
+        strapi.notification.success(
+          formatMessage({ id: getTrad('Settings.notification.test.success') }, { to: testAddress })
+        );
+      } catch (err) {
+        strapi.notification.error(
+          formatMessage({ id: getTrad('Settings.notification.test.error') }, { to: testAddress })
+        );
+      } finally {
+        if (isMounted.current) {
+          setIsTestButtonLoading(false);
+        }
+      }
+    } catch (error) {
+      errors = getYupInnerErrors(error);
+      setFormErrors(errors);
+      console.log(errors);
+    }
+  };
+
+  useEffect(() => {
+    const fetchEmailSettings = () => {
+      setShowLoader(true);
+
+      request('/email/settings', {
+        method: 'GET',
+      })
+        .then(data => {
+          setConfig(data.config);
+          setProviders([data.config.provider]);
+          setTestAddress(get(data, 'config.settings.testAddress'));
+        })
+        .catch(() =>
+          strapi.notification.error(
+            formatMessage({ id: getTrad('Settings.notification.config.error') })
+          )
+        )
+        .finally(() => setShowLoader(false));
+    };
+
+    fetchEmailSettings();
+  }, [formatMessage]);
+
+  useEffect(() => {
+    return () => {
+      isMounted.current = false;
+    };
+  }, []);
+
+  return (
+    <>
+      <CheckPagePermissions permissions={pluginPermissions.settings}>
+        <SettingsPageTitle name={title} />
+        <div>
+          <form onSubmit={handleSubmit}>
+            <Header
+              title={{ label: title }}
+              content={formatMessage({ id: getTrad('Settings.subTitle') })}
+              isLoading={showLoader}
+            />
+            <BaselineAlignment top size="3px" />
+            <FormBloc
+              title={formatMessage({ id: getTrad('Settings.form.title.config') })}
+              isLoading={showLoader}
+            >
+              <Text fontSize="md" lineHeight="18px">
+                <FormattedMessage
+                  id={getTrad('Settings.form.text.configuration')}
+                  values={{
+                    file: <code>./config/plugins.js</code>,
+                    link: (
+                      <a
+                        href="https://strapi.akemona.com/documentation/developer-docs/latest/development/plugins/email.html#configure-the-plugin"
+                        target="_blank"
+                        rel="noopener noreferrer"
+                      >
+                        link
+                      </a>
+                    ),
+                  }}
+                />
+              </Text>
+              <SizedInput
+                disabled
+                label={getTrad('Settings.form.label.defaultFrom')}
+                name="default-from"
+                placeholder={getTrad('Settings.form.placeholder.defaultFrom')}
+                size={{ xs: 6 }}
+                type="email"
+                value={config.settings.defaultFrom}
+              />
+              <SizedInput
+                disabled
+                label={getTrad('Settings.form.label.defaultReplyTo')}
+                name="default-reply-to"
+                placeholder={getTrad('Settings.form.placeholder.defaultReplyTo')}
+                size={{ xs: 6 }}
+                type="email"
+                value={config.settings.defaultReplyTo}
+              />
+              <SizedInput
+                disabled
+                label={getTrad('Settings.form.label.provider')}
+                name="provider"
+                options={providers}
+                size={{ xs: 6 }}
+                type="select"
+                value={`strapi-provider-email-${config.provider}`}
+              />
+            </FormBloc>
+            <BaselineAlignment top size="32px" />
+            <FormBloc
+              title={formatMessage({ id: getTrad('Settings.form.title.test') })}
+              isLoading={showLoader}
+            >
+              <SizedInput
+                label={getTrad('Settings.form.label.testAddress')}
+                name="test-address"
+                placeholder={getTrad('Settings.form.placeholder.testAddress')}
+                onChange={event => setTestAddress(event.target.value)}
+                size={{ xs: 6 }}
+                type="email"
+                value={testAddress}
+                error={formErrors.email}
+              />
+              <AlignedButton
+                color="success"
+                disabled={testSuccess}
+                icon={(
+                  <Envelope
+                    fill={testSuccess ? colors.button.disabled.color : null}
+                    style={{ verticalAlign: 'middle', marginRight: '10px' }}
+                  />
+                )}
+                isLoading={isTestButtonLoading}
+                style={{ fontWeight: 600 }}
+                type="submit"
+              >
+                {formatMessage({ id: getTrad('Settings.button.test-email') })}
+              </AlignedButton>
+            </FormBloc>
+          </form>
+        </div>
+      </CheckPagePermissions>
+    </>
+  );
+};
+
+export default SettingsPage;

package/admin/src/index.js

@@ -0,0 +1,63 @@
+// NOTE TO PLUGINS DEVELOPERS:
+// If you modify this file by adding new options to the plugin entry point
+// Here's the file: strapi/docs/3.x/plugin-development/frontend-field-api.md
+// Here's the file: strapi/docs/3.x/guides/registering-a-field-in-admin.md
+// Also the strapi-generate-plugins/files/admin/src/index.js needs to be updated
+// IF THE DOC IS NOT UPDATED THE PULL REQUEST WILL NOT BE MERGED
+
+import React from 'react';
+import { CheckPagePermissions } from 'strapi-helper-plugin';
+import pluginPkg from '../../package.json';
+import pluginId from './pluginId';
+import pluginLogo from './assets/images/logo.svg';
+import pluginPermissions from './permissions';
+import trads from './translations';
+import getTrad from './utils/getTrad';
+import SettingsPage from './containers/Settings';
+
+export default strapi => {
+  const pluginDescription = pluginPkg.strapi.description || pluginPkg.description;
+
+  const plugin = {
+    blockerComponent: null,
+    blockerComponentProps: {},
+    description: pluginDescription,
+    icon: pluginPkg.strapi.icon,
+    id: pluginId,
+    isReady: true,
+    initializer: () => null,
+    injectedComponents: [],
+    isRequired: pluginPkg.strapi.required || false,
+    layout: null,
+    lifecycles: () => {},
+    mainComponent: null,
+    name: pluginPkg.strapi.name,
+    pluginLogo,
+    preventComponentRendering: false,
+    trads,
+    settings: {
+      menuSection: {
+        id: pluginId,
+        title: getTrad('SettingsNav.section-label'),
+        links: [
+          {
+            title: {
+              id: getTrad('SettingsNav.link.settings'),
+              defaultMessage: 'Settings',
+            },
+            name: 'settings',
+            to: `${strapi.settingsBaseURL}/${pluginId}`,
+            Component: () => (
+              <CheckPagePermissions permissions={pluginPermissions.settings}>
+                <SettingsPage />
+              </CheckPagePermissions>
+            ),
+            permissions: pluginPermissions.settings,
+          },
+        ],
+      },
+    },
+  };
+
+  return strapi.registerPlugin(plugin);
+};

package/admin/src/permissions.js

@@ -0,0 +1,9 @@
+const pluginPermissions = {
+  // This permission regards the main component (App) and is used to tell
+  // If the plugin link should be displayed in the menu
+  // And also if the plugin is accessible. This use case is found when a user types the url of the
+  // plugin directly in the browser
+  settings: [{ action: 'plugins::email.settings.read', subject: null }],
+};
+
+export default pluginPermissions;

package/admin/src/pluginId.js

@@ -0,0 +1,5 @@
+import pluginPkg from '../../package.json';
+
+const pluginId = pluginPkg.name.replace(/^strapi-plugin-/i, '');
+
+export default pluginId;

package/admin/src/translations/ar.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "إرسال بريد.",
+  "plugin.description.short": "إرسال بريد."
+}

package/admin/src/translations/cs.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Odeslat e-maily.",
+  "plugin.description.short": "Odeslat e-maily."
+}

package/admin/src/translations/de.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Zum Versand von E-Mails.",
+  "plugin.description.short": "Zum Versand von E-Mails."
+}

package/admin/src/translations/dk.json

@@ -0,0 +1,4 @@
+{
+    "plugin.description.long": "Send e-mails.",
+    "plugin.description.short": "Send e-mails."
+}

package/admin/src/translations/en.json

@@ -0,0 +1,22 @@
+{
+  "plugin.description.long": "Send emails.",
+  "plugin.description.short": "Send emails.",
+  "SettingsNav.section-label": "Email plugin",
+  "SettingsNav.link.settings": "Email settings",
+  "Settings.title": "Email settings",
+  "Settings.subTitle": "Test the settings for the email plugin",
+  "Settings.button.test-email": "Test email",
+  "Settings.notification.test.success": "Email test succeeded, check the {to} mailbox",
+  "Settings.notification.test.error": "Failed to send a test mail to {to}",
+  "Settings.notification.config.error": "Failed to retrieve the email config",
+  "Settings.form.title.config": "Configuration",
+  "Settings.form.title.test": "Send a test email",
+  "Settings.form.label.provider": "Email provider",
+  "Settings.form.label.defaultFrom": "Default shipper email",
+  "Settings.form.label.defaultReplyTo": "Default response  email",
+  "Settings.form.label.testAddress": "Test delivery email address",
+  "Settings.form.placeholder.defaultFrom": "ex: Strapi No-Reply <no-reply@strapi.io>",
+  "Settings.form.placeholder.defaultReplyTo": "ex: Strapi <example@strapi.io>",
+  "Settings.form.placeholder.testAddress": "ex: developer@example.com",
+  "Settings.form.text.configuration": "The plugin is configured through the {file} file, checkout this {link} for the documentation."
+}

package/admin/src/translations/es.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Enviar correos electrónicos.",
+  "plugin.description.short": "Enviar correos electrónicos."
+}

package/admin/src/translations/fr.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Envoyez des emails.",
+  "plugin.description.short": "Envoyez des emails."
+}

package/admin/src/translations/id.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Kirim surel.",
+  "plugin.description.short": "Kirim surel."
+}

package/admin/src/translations/index.js

@@ -0,0 +1,53 @@
+import ar from './ar.json';
+import cs from './cs.json';
+import de from './de.json';
+import dk from './dk.json';
+import en from './en.json';
+import es from './es.json';
+import fr from './fr.json';
+import id from './id.json';
+import it from './it.json';
+import ja from './ja.json';
+import ko from './ko.json';
+import ms from './ms.json';
+import nl from './nl.json';
+import pl from './pl.json';
+import ptBR from './pt-BR.json';
+import pt from './pt.json';
+import ru from './ru.json';
+import th from './th.json';
+import tr from './tr.json';
+import uk from './uk.json';
+import vi from './vi.json';
+import zhHans from './zh-Hans.json';
+import zh from './zh.json';
+import sk from './sk.json';
+
+const trads = {
+  ar,
+  cs,
+  de,
+  dk,
+  en,
+  es,
+  fr,
+  id,
+  it,
+  ja,
+  ko,
+  ms,
+  nl,
+  pl,
+  'pt-BR': ptBR,
+  pt,
+  ru,
+  th,
+  tr,
+  uk,
+  vi,
+  'zh-Hans': zhHans,
+  zh,
+  sk,
+};
+
+export default trads;

package/admin/src/translations/it.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Invia le email.",
+  "plugin.description.short": "Invia le email."
+}

package/admin/src/translations/ja.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "メールを送る",
+  "plugin.description.short": "メールを送る"
+}

package/admin/src/translations/ko.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "이메일을 전송합니다.",
+  "plugin.description.short": "이메일을 전송합니다."
+}

package/admin/src/translations/ms.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Penghantaran E-mel.",
+  "plugin.description.short": "Penghantaran E-mel."
+}

package/admin/src/translations/nl.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Verstuur e-mails.",
+  "plugin.description.short": "Verstuur e-mails."
+}

package/admin/src/translations/pl.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Wysyłaj E-maile",
+  "plugin.description.short": "Wysyłaj E-maile"
+}

package/admin/src/translations/pt-BR.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Enviar emails.",
+  "plugin.description.short": "Enviar emails."
+}

package/admin/src/translations/pt.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Enviar emails.",
+  "plugin.description.short": "Enviar emails."
+}

package/admin/src/translations/ru.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Отправка почты.",
+  "plugin.description.short": "Отправка почты."
+}

package/admin/src/translations/sk.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Posielanie e-mailov.",
+  "plugin.description.short": "Posielanie e-mailov."
+}

package/admin/src/translations/th.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "ส่งอีเมล",
+  "plugin.description.short": "ส่งอีเมล"
+}

package/admin/src/translations/tr.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "E-posta gönder.",
+  "plugin.description.short": "E-posta gönder."
+}

package/admin/src/translations/uk.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Надсилайте листи електронною поштою.",
+  "plugin.description.short": "Надсилайте листи електронною поштою."
+}

package/admin/src/translations/vi.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "Gửi các email.",
+  "plugin.description.short": "Gửi các email."
+}

package/admin/src/translations/zh-Hans.json

@@ -0,0 +1,22 @@
+{
+  "plugin.description.long": "发送电子邮件。",
+  "plugin.description.short": "发送电子邮件。",
+  "SettingsNav.section-label": "邮件插件",
+  "SettingsNav.link.settings": "邮件设置",
+  "Settings.title": "邮件设置",
+  "Settings.subTitle": "邮件功能设置",
+  "Settings.button.test-email": "发送测试邮件",
+  "Settings.notification.test.success": "邮件测试成功，请查收 {to} 的收件箱。",
+  "Settings.notification.test.error": "给 {to} 的测试邮件发送失败。",
+  "Settings.notification.config.error": "获取邮件设置失败",
+  "Settings.form.title.config": "配置",
+  "Settings.form.title.test": "发送测试邮件",
+  "Settings.form.label.provider": "邮件发送方式（Provider）",
+  "Settings.form.label.defaultFrom": "默认发送邮箱",
+  "Settings.form.label.defaultReplyTo": "默认回复邮箱",
+  "Settings.form.label.testAddress": "请输入要接受测试邮件的邮箱地址",
+  "Settings.form.placeholder.defaultFrom": "如：Strapi No-Reply <no-reply@strapi.io>",
+  "Settings.form.placeholder.defaultReplyTo": "如：Strapi <example@strapi.io>",
+  "Settings.form.placeholder.testAddress": "如：developer@example.com",
+  "Settings.form.text.configuration": "插件配置文件：{file}，配置文档：{link}。"
+}

package/admin/src/translations/zh.json

@@ -0,0 +1,4 @@
+{
+  "plugin.description.long": "寄送電子郵件",
+  "plugin.description.short": "寄送電子郵件"
+}

package/admin/src/utils/getTrad.js

@@ -0,0 +1,5 @@
+import pluginId from '../pluginId';
+
+const getTrad = id => `${pluginId}.${id}`;
+
+export default getTrad;

package/admin/src/utils/schema.js

@@ -0,0 +1,11 @@
+import * as yup from 'yup';
+import { translatedErrors } from 'strapi-helper-plugin';
+
+const schema = yup.object().shape({
+  email: yup
+    .string()
+    .email(translatedErrors.email)
+    .required(translatedErrors.required),
+});
+
+export default schema;

package/config/functions/bootstrap.js

@@ -0,0 +1,34 @@
+'use strict';
+
+const _ = require('lodash');
+
+const createProvider = emailConfig => {
+  const providerName = _.toLower(emailConfig.provider);
+  let provider;
+  try {
+    provider = require(`strapi-provider-email-${providerName}`);
+  } catch (err) {
+    throw new Error(
+      `The provider package isn't installed. Please run \`npm install strapi-provider-email-${providerName}\` --save`
+    );
+  }
+  return provider.init(emailConfig.providerOptions, emailConfig.settings);
+};
+
+module.exports = async () => {
+  const emailConfig = _.get(strapi.plugins, 'email.config', {});
+  strapi.plugins.email.provider = createProvider(emailConfig);
+
+  // Add permissions
+  const actions = [
+    {
+      section: 'settings',
+      category: 'email',
+      displayName: 'Access the Email Settings page',
+      uid: 'settings.read',
+      pluginName: 'email',
+    },
+  ];
+
+  await strapi.admin.services.permission.actionProvider.registerMany(actions);
+};

package/config/routes.json

@@ -0,0 +1,49 @@
+{
+  "routes": [
+    {
+      "method": "POST",
+      "path": "/",
+      "handler": "Email.send",
+      "config": {
+        "policies": [],
+        "description": "Send an email",
+        "tag": {
+          "plugin": "email",
+          "name": "Email"
+        }
+      }
+    },
+    {
+      "method": "POST",
+      "path": "/test",
+      "handler": "Email.test",
+      "config": {
+        "policies": [
+          "admin::isAuthenticatedAdmin",
+          ["admin::hasPermissions", ["plugins::email.settings.read"]]
+        ],
+        "description": "Send an test email",
+        "tag": {
+          "plugin": "email",
+          "name": "Email"
+        }
+      }
+    },
+    {
+      "method": "GET",
+      "path": "/settings",
+      "handler": "Email.getSettings",
+      "config": {
+        "policies": [
+          "admin::isAuthenticatedAdmin",
+          ["admin::hasPermissions", ["plugins::email.settings.read"]]
+        ],
+        "description": "Get the email settings",
+        "tag": {
+          "plugin": "email",
+          "name": "Email"
+        }
+      }
+    }
+  ]
+}

package/config/settings.js

@@ -0,0 +1,9 @@
+'use strict';
+
+module.exports = {
+  provider: 'sendmail',
+  providerOptions: {},
+  settings: {
+    defaultFrom: 'Strapi <no-reply@strapi.io>',
+  },
+};

package/controllers/Email.js

@@ -0,0 +1,66 @@
+'use strict';
+
+const { isNil, pick } = require('lodash/fp');
+
+/**
+ * Email.js controller
+ *
+ * @description: A set of functions called "actions" of the `email` plugin.
+ */
+module.exports = {
+  async send(ctx) {
+    let options = ctx.request.body;
+    try {
+      await strapi.plugins.email.services.email.send(options);
+    } catch (e) {
+      if (e.statusCode === 400) {
+        return ctx.badRequest(e.message);
+      } else {
+        throw new Error(`Couldn't send email: ${e.message}.`);
+      }
+    }
+
+    // Send 200 `ok`
+    ctx.send({});
+  },
+
+  async test(ctx) {
+    const { to } = ctx.request.body;
+
+    if (isNil(to)) {
+      throw strapi.errors.badRequest(null, {
+        errors: [{ id: 'Email.to.empty', message: 'No recipient(s) are given' }],
+      });
+    }
+
+    const email = {
+      to: to,
+      subject: `Strapi test mail to: ${to}`,
+      text: `Great! You have correctly configured the Strapi email plugin with the ${strapi.plugins.email.config.provider} provider. \r\nFor documentation on how to use the email plugin checkout: https://strapi.akemona.com/documentation/developer-docs/latest/development/plugins/email.html`,
+    };
+
+    try {
+      await strapi.plugins.email.services.email.send(email);
+    } catch (e) {
+      if (e.statusCode === 400) {
+        return ctx.badRequest(e.message);
+      } else {
+        throw new Error(`Couldn't send test email: ${e.message}.`);
+      }
+    }
+
+    // Send 200 `ok`
+    ctx.send({});
+  },
+
+  async getSettings(ctx) {
+    const config = strapi.plugins.email.services.email.getProviderSettings();
+
+    ctx.send({
+      config: pick(
+        ['provider', 'settings.defaultFrom', 'settings.defaultReplyTo', 'settings.testAddress'],
+        config
+      ),
+    });
+  },
+};

package/documentation/1.0.0/overrides/email-Email.json

@@ -0,0 +1,67 @@
+{
+  "paths": {
+    "/email/": {
+      "post": {
+        "deprecated": false,
+        "description": "Send an email",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "from": {
+                    "type": "string",
+                    "format": "email"
+                  },
+                  "to": {
+                    "type": "string",
+                    "format": "email",
+                    "example": "user1@example.com"
+                  },
+                  "cc": {
+                    "type": "string",
+                    "format": "email",
+                    "example": "user2@example.com"
+                  },
+                  "bcc": {
+                    "type": "string",
+                    "format": "email",
+                    "example": "user3@example.com"
+                  },
+                  "replyTo": {
+                    "type": "string",
+                    "format": "email",
+                    "example": "user4@example.com"
+                  },
+                  "subject": {
+                    "type": "string",
+                    "example": "Lorem ipsum title"
+                  },
+                  "text": {
+                    "type": "string",
+                    "example": "Lorem ipsum"
+                  },
+                  "html": {
+                    "type": "string",
+                    "format": "html",
+                    "example": "<h1>Lorem ipsum</h1>"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "summary": "",
+        "tags": [
+          "Email"
+        ]
+      }
+    }
+  },
+  "tags": [
+    {
+      "name": "Email"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@akemona-org/strapi-plugin-email",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "3.7.0",
+  "description": "Easily configure your Strapi application to send emails.",
+  "strapi": {
+    "name": "Email",
+    "icon": "paper-plane",
+    "description": "email.plugin.description",
+    "required": true
+  },
+  "scripts": {
+    "test": "echo \"no tests yet\""
+  },
+  "dependencies": {
+    "@akemona-org/strapi-provider-email-sendmail": "3.7.0",
+    "@akemona-org/strapi-utils": "3.7.0",
+    "lodash": "4.17.21"
+  },
+  "devDependencies": {
+    "@akemona-org/strapi-helper-plugin": "3.7.0",
+    "rimraf": "3.0.2"
+  },
+  "author": {
+    "name": "Akemona team",
+    "email": "strapi@akemona.com",
+    "url": "https://strapi.akemona.com"
+  },
+  "maintainers": [
+    {
+      "name": "Akemona team",
+      "email": "strapi@akemona.com",
+      "url": "https://strapi.akemona.com"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/akemona/strapi.git"
+  },
+  "engines": {
+    "node": ">=10.16.0 <=14.x.x",
+    "npm": ">=6.0.0"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "gitHead": "129a8d6191b55810fd66448dcc47fee829df986c"
+}

package/services/Email.js

@@ -0,0 +1,44 @@
+'use strict';
+
+const _ = require('lodash');
+
+const getProviderSettings = () => {
+  return strapi.plugins.email.config;
+};
+
+const send = async options => {
+  return strapi.plugins.email.provider.send(options);
+};
+
+/**
+ * fill subject, text and html using lodash template
+ * @param {object} emailOptions - to, from and replyto...
+ * @param {object} emailTemplate - object containing attributes to fill
+ * @param {object} data - data used to fill the template
+ * @returns {{ subject, text, subject }}
+ */
+const sendTemplatedEmail = (emailOptions = {}, emailTemplate = {}, data = {}) => {
+  const attributes = ['subject', 'text', 'html'];
+  const missingAttributes = _.difference(attributes, Object.keys(emailTemplate));
+  if (missingAttributes.length > 0) {
+    throw new Error(
+      `Following attributes are missing from your email template : ${missingAttributes.join(', ')}`
+    );
+  }
+
+  const templatedAttributes = attributes.reduce(
+    (compiled, attribute) =>
+      emailTemplate[attribute]
+        ? Object.assign(compiled, { [attribute]: _.template(emailTemplate[attribute])(data) })
+        : compiled,
+    {}
+  );
+
+  return strapi.plugins.email.provider.send({ ...emailOptions, ...templatedAttributes });
+};
+
+module.exports = {
+  getProviderSettings,
+  send,
+  sendTemplatedEmail,
+};