<?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;
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
*/
abstract class MailBuilder
{
+ /** @var string The default email banner in case nothing else is defined */
+ const DEFAULT_EMAIL_BANNER = 'images/friendica-32.png';
+
/** @var L10n */
protected $l10n;
/** @var IConfig */
protected $config;
/** @var BaseURL */
protected $baseUrl;
+ /** @var LoggerInterface */
+ protected $logger;
/** @var string */
protected $headers;
/** @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, ':')) {
/**
* 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;
}
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
*
{
if ((empty($this->recipientAddress)) &&
!empty($this->recipientUid)) {
- $user = User::getById($this->recipientUid, ['username', 'email']);
+ $user = User::getById($this->recipientUid, ['email']);
- if (!empty($user)) {
- $this->senderName = $user['username'];
- $this->senderAddress = $user['email'];
+ if (!empty($user['email'])) {
+ $this->recipientAddress = $user['email'];
}
}
+ if (empty($this->recipientAddress)) {
+ throw new InternalServerErrorException('Recipient address is missing.');
+ }
+
if (empty($this->senderAddress) || empty($this->senderName)) {
throw new InternalServerErrorException('Sender address or name is missing.');
}
// load the template for private message notifications
$tpl = Renderer::getMarkupTemplate('email/html.tpl');
$msgHtml = Renderer::replaceMacros($tpl, [
- '$banner' => $this->l10n->t('Friendica Notification'),
+ '$title' => $this->l10n->t('Friendica Notification'),
'$product' => FRIENDICA_PLATFORM,
'$htmlversion' => $msgHtml,
'$sitename' => $this->config->get('config', 'sitename'),
- '$siteurl' => $this->baseUrl->get(true),
+ '$banner' => $this->config->get('system', 'email_banner',
+ $this->baseUrl->get(true) . DIRECTORY_SEPARATOR . self::DEFAULT_EMAIL_BANNER),
]);
}