]> git.mxchange.org Git - friendica.git/blobdiff - src/Util/EMailer/MailBuilder.php
Optimize "withMessage()" default
[friendica.git] / src / Util / EMailer / MailBuilder.php
index 2f8c199a50946528644371bc623130d1ab68b0a6..7bdb978c81fe00a984e019e9e6cff9deb1c5ecdc 100644 (file)
@@ -1,4 +1,23 @@
 <?php
+/**
+ * @copyright Copyright (C) 2020, Friendica
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
 
 namespace Friendica\Util\EMailer;
 
@@ -11,6 +30,7 @@ use Friendica\Model\User;
 use Friendica\Network\HTTPException\InternalServerErrorException;
 use Friendica\Object\Email;
 use Friendica\Object\EMail\IEmail;
+use Psr\Log\LoggerInterface;
 
 /**
  * A base class for building new emails
@@ -26,6 +46,8 @@ abstract class MailBuilder
        protected $config;
        /** @var BaseURL */
        protected $baseUrl;
+       /** @var LoggerInterface */
+       protected $logger;
 
        /** @var string */
        protected $headers;
@@ -42,11 +64,12 @@ abstract class MailBuilder
        /** @var int */
        protected $recipientUid = null;
 
-       public function __construct(L10n $l10n, BaseURL $baseUrl, IConfig $config)
+       public function __construct(L10n $l10n, BaseURL $baseUrl, IConfig $config, LoggerInterface $logger)
        {
                $this->l10n    = $l10n;
                $this->baseUrl = $baseUrl;
                $this->config  = $config;
+               $this->logger  = $logger;
 
                $hostname = $baseUrl->getHostname();
                if (strpos($hostname, ':')) {
@@ -86,13 +109,19 @@ abstract class MailBuilder
        /**
         * Adds the User ID to the email in case the mail sending needs additional properties of this user
         *
-        * @param int $uid The User ID
+        * @param array $user The user entity/array, for which the email should be sent
         *
         * @return static
+        * @todo Once the user array is replaced with a user entity, replace this array parameter as well
         */
-       public function forUser(int $uid)
+       public function forUser(array $user)
        {
-               $this->recipientUid = $uid;
+               $this->recipientUid = $user['uid'] ?? 0;
+               try {
+                       $this->l10n = $user['language'] ? $this->l10n->withLang($user['language']) : $this->l10n;
+               } catch (Exception $e) {
+                       $this->logger->warning('cannot use language.', ['user' => $user, 'exception' => $e]);
+               }
 
                return $this;
        }
@@ -129,6 +158,20 @@ abstract class MailBuilder
                return $this;
        }
 
+       /**
+        * Adds new headers to the default headers
+        *
+        * @param string $headers New headers
+        *
+        * @return static
+        */
+       public function addHeaders(string $headers)
+       {
+               $this->headers .= $headers;
+
+               return $this;
+       }
+
        /**
         * Build a email based on the given attributes
         *