Initial commit.

(Not finished yet).

Author: Maikuolan

assets/config.yml

@@ -0,0 +1,65 @@
+##\
+# This file is a part of the phpMussel\PHPMailer package.
+# Homepage: https://phpmussel.github.io/
+#
+# PHPMUSSEL COPYRIGHT 2013 AND BEYOND BY THE PHPMUSSEL TEAM.
+#
+# License: GNU/GPLv2
+# @see LICENSE.txt
+#
+# This file: Configuration defaults file (last modified: 2020.06.14).
+##/
+
+phpmailer:
+ event_log:
+  type: "string"
+  default: ""
+ enable_two_factor:
+  type: "bool"
+  default: false
+ enable_notifications:
+  type: "bool"
+  default: false
+ skip_auth_process:
+  type: "bool"
+  default: false
+ host:
+  type: "string"
+  default: ""
+ port:
+  type: "int"
+  default: 587
+ smtp_secure:
+  type: "string"
+  default: "default"
+  choices:
+   default: "-"
+   tls: "TLS"
+   ssl: "SSL"
+ smtp_auth:
+  type: "bool"
+  default: true
+ username:
+  type: "string"
+  default: ""
+  autocomplete: "username"
+ password:
+  type: "string"
+  default: ""
+  autocomplete: "current-password"
+ set_from_address:
+  type: "email"
+  default: ""
+  autocomplete: "email"
+ set_from_name:
+  type: "string"
+  default: ""
+  autocomplete: "name"
+ add_reply_to_address:
+  type: "email"
+  default: ""
+  autocomplete: "email"
+ add_reply_to_name:
+  type: "string"
+  default: ""
+  autocomplete: "name"

composer.json

@@ -0,0 +1,36 @@
+{
+    "name": "phpmussel/phpmailer",
+    "description": "Uses PHPMailer to provide 2FA and email notifications support for phpMussel v3+",
+    "homepage": "https://phpmussel.github.io/",
+    "license": "GPL-2.0-or-later",
+    "support": {
+        "chat": "https://gitter.im/phpMussel2/Lobby",
+        "issues": "https://github.com/phpMussel/Plugin-PHPMailer/issues",
+        "source": "https://github.com/phpMussel/Plugin-PHPMailer",
+        "docs": "https://github.com/phpMussel/Docs"
+    },
+    "require": {
+        "php": ">=7.2.0",
+        "maikuolan/common": "^2.3",
+        "phpmussel/core": "^3.0",
+        "phpmailer/phpmailer": "^3.0"
+    },
+    "suggest": {
+        "phpmussel/frontend": "^3.0",
+        "phpmussel/web": "^3.0"
+    },
+    "require-dev": {
+        "codeception/codeception": "^2.3",
+        "symfony/event-dispatcher": "3.4.28"
+    },
+    "autoload": {
+        "psr-4": {
+            "phpMussel\\PHPMailer\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "phpMussel\\PHPMailer\\Tests\\": "tests/"
+        }
+    }
+}

l10n/en.yml

@@ -0,0 +1,17 @@
+##\
+# This file is a part of the phpMussel\PHPMailer package.
+# Homepage: https://phpmussel.github.io/
+#
+# PHPMUSSEL COPYRIGHT 2013 AND BEYOND BY THE PHPMUSSEL TEAM.
+#
+# License: GNU/GPLv2
+# @see LICENSE.txt
+#
+# This file: English language data (last modified: 2020.06.14).
+##/
+
+Apples:
+ - "There is %s apple on the tree."
+ - "There are %s apples on the tree."
+Foo: "Bar"
+Hello: "World"

src/PHPMailer.php

@@ -0,0 +1,92 @@
+<?php
+/**
+ * This file is a part of the phpMussel\PHPMailer package.
+ * Homepage: https://phpmussel.github.io/
+ *
+ * PHPMUSSEL COPYRIGHT 2013 AND BEYOND BY THE PHPMUSSEL TEAM.
+ *
+ * License: GNU/GPLv2
+ * @see LICENSE.txt
+ *
+ * This file: PHPMailer-phpMussel linker (last modified: 2020.06.14).
+ */
+
+namespace phpMussel\PHPMailer;
+
+class PHPMailer
+{
+    /**
+     * @var \phpMussel\Core\Loader The instantiated loader object.
+     */
+    private $Loader;
+
+    /**
+     * @var string The path to the core asset files.
+     */
+    private $AssetsPath = __DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'assets' . DIRECTORY_SEPARATOR;
+
+    /**
+     * @var string The path to the core L10N files.
+     */
+    private $L10NPath = __DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'l10n' . DIRECTORY_SEPARATOR;
+
+    /**
+     * Construct the linker instance.
+     *
+     * @param \phpMussel\Core\Loader $Loader The instantiated loader object, passed by reference.
+     */
+    public function __construct(\phpMussel\Core\Loader &$Loader)
+    {
+        /** Link the loader to this instance. */
+        $this->Loader = &$Loader;
+
+        /** Load configuration defaults and perform fallbacks. */
+        if (
+            is_readable($this->AssetsPath . 'config.yml') &&
+            $Configuration = $this->Loader->readFile($this->AssetsPath . 'config.yml')
+        ) {
+            $Defaults = [];
+            $this->Loader->YAML->process($Configuration, $Defaults);
+            if (isset($Defaults)) {
+                $this->Loader->fallback($Defaults);
+            }
+        }
+
+        /** Load L10N data. */
+        $this->Loader->loadL10N($this->Loader->L10NPath);
+
+        /**
+         * Writes to the PHPMailer event log.
+         *
+         * @param string $Data What to write.
+         * @return bool True on success; False on failure.
+         */
+        $this->Loader->Events->addHandler('writeToPHPMailerEventLog', function (string $Data): bool {
+            /** Guard. */
+            if (!$this->Loader->Configuration['phpmailer']['event_log']) {
+                return false;
+            }
+
+            /** Applies formatting for dynamic log filenames. */
+            $EventLog = $this->Loader->timeFormat($this->Loader->Time, $this->Loader->Configuration['phpmailer']['event_log']);
+
+            $WriteMode = (!file_exists($this->AssetsPath . $EventLog) || (
+                $this->Loader->Configuration['core']['truncate'] > 0 &&
+                filesize($this->AssetsPath . $EventLog) >= $this->readBytes($this->Loader->Configuration['core']['truncate'])
+            )) ? 'w' : 'a';
+
+            /** Build the path to the log and write it. */
+            if ($phpMussel['BuildLogPath']($EventLog)) {
+                $Handle = fopen($this->AssetsPath . $EventLog, $WriteMode);
+                fwrite($Handle, $Data);
+                fclose($Handle);
+                if ($WriteMode === 'w') {
+                    $phpMussel['LogRotation']($this->Loader->Configuration['phpmailer']['event_log']);
+                }
+                return true;
+            }
+
+            return false;
+        });
+    }
+}