nextcloud-registration/lib/Service/MailService.php

<?php

declare(strict_types=1);

/**
 * SPDX-FileCopyrightText: 2017 Nextcloud GmbH and Nextcloud contributors
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */

namespace OCA\Registration\Service;

use OCA\Registration\Db\Registration;
use OCP\Defaults;
use OCP\IConfig;
use OCP\IGroupManager;
use OCP\IL10N;
use OCP\IURLGenerator;
use OCP\L10N\IFactory as IL10NFactory;
use OCP\Mail\IMailer;
use OCP\Util;
use Psr\Log\LoggerInterface;

class MailService {

	public function __construct(
		private IURLGenerator $urlGenerator,
		private IMailer $mailer,
		private Defaults $defaults,
		private IL10N $l10n,
		private IL10NFactory $l10nFactory,
		private IGroupManager $groupManager,
		private IConfig $config,
		private LoginFlowService $loginFlowService,
		private LoggerInterface $logger,
	) {
	}

	/**
	 * @param string $email
	 * @throws RegistrationException
	 */
	public function validateEmail(string $email): void {
		if (!$this->mailer->validateMailAddress($email)) {
			throw new RegistrationException($this->l10n->t('The email address you entered is not valid'));
		}
	}

	/**
	 * @param Registration $registration
	 * @throws RegistrationException
	 */
	public function sendTokenByMail(Registration $registration): void {
		$link = $this->urlGenerator->linkToRouteAbsolute('registration.register.showUserForm', [
			'secret' => $registration->getClientSecret(),
			'token' => $registration->getToken(),
		]);
		$subject = $this->l10n->t('Verify your %s registration request', [$this->defaults->getName()]);

		$template = $this->mailer->createEMailTemplate('registration_verify', [
			'link' => $link,
			'token' => $registration->getToken(),
			'sitename' => $this->defaults->getName(),
		]);

		$template->setSubject($subject);
		$template->addHeader();
		$template->addHeading($this->l10n->t('Registration'));

		$body = $this->l10n->t('Email address verified, you can now complete your registration.');
		if (!$this->loginFlowService->isUsingLoginFlow()) {
			$template->addBodyText(
				htmlspecialchars($body . ' ' . $this->l10n->t('Click the button below to continue.')),
				$body
			);
		} else {
			$template->addBodyText(
				$body
			);
		}

		// if the parameter is set through the settings panel add to body text
		$email_verification_hint = $this->config->getAppValue('registration', 'email_verification_hint');
		if (!empty($email_verification_hint)) {
			$template->addBodyText($email_verification_hint);
		};

		$template->addBodyText(
			$this->l10n->t('Verification code: %s', $registration->getToken())
		);

		if (!$this->loginFlowService->isUsingLoginFlow()) {
			$template->addBodyButton(
				$this->l10n->t('Continue registration'),
				$link
			);
		}
		$template->addFooter();

		$from = Util::getDefaultEmailAddress('register');
		$message = $this->mailer->createMessage();
		$message->setFrom([$from => $this->defaults->getName()]);
		$message->setTo([$registration->getEmail()]);
		$message->useTemplate($template);
		$failed_recipients = $this->mailer->send($message);
		if (!empty($failed_recipients)) {
			throw new RegistrationException($this->l10n->t('A problem occurred sending email, please contact your administrator.'));
		}
	}

	public function notifyAdmins(string $userId, ?string $userEMailAddress, bool $userIsEnabled, string $userGroupId): void {
		// Notify admin
		$adminUsers = $this->groupManager->get('admin')->getUsers();

		// if the user is disabled and belongs to a group
		// add subadmins of this group to notification list
		if (!$userIsEnabled && $userGroupId) {
			$group = $this->groupManager->get($userGroupId);
			$subAdmins = $this->groupManager->getSubAdmin()->getGroupsSubAdmins($group);
			foreach ($subAdmins as $subAdmin) {
				if (!in_array($subAdmin, $adminUsers, true)) {
					$adminUsers[] = $subAdmin;
				}
			}
		}

		foreach ($adminUsers as $adminUser) {
			$email = $adminUser->getEMailAddress();
			if ($email && $adminUser->isEnabled()) {
				$language = $this->l10nFactory->getUserLanguage($adminUser);

				try {
					$this->sendNewUserNotifyEmail([$email => $adminUser->getDisplayName()], $userId, $userEMailAddress, $userIsEnabled, $language);
				} catch (\Exception $e) {
					$this->logger->error('Sending admin notification email failed: ' . $e->getMessage());
				}
			}
		}
	}

	/**
	 * Sends new user notification email to given user list
	 *
	 * @param array $to
	 * @param string $username the new user
	 * @param bool $userIsEnabled the new user account is enabled
	 * @throws \Exception
	 */
	private function sendNewUserNotifyEmail(array $to, string $username, ?string $userEMailAddress, bool $userIsEnabled, string $language): void {
		$l = $this->l10nFactory->get('registration', $language);

		$link = $this->urlGenerator->linkToRouteAbsolute('settings.Users.usersListByGroup', [
			'group' => 'disabled',
		]);
		$template = $this->mailer->createEMailTemplate('registration_admin', [
			'link' => $link,
			'user' => $username,
			'sitename' => $this->defaults->getName(),
		]);

		$subject = $l->t('New user "%s" has created an account on %s', [$username, $this->defaults->getName()]);

		$template->setSubject($subject);
		$template->addHeader();
		$template->addHeading($l->t('New user registered'));

		if ($userIsEnabled) {
			$template->addBodyText(
				$l->t('"%1$s" (%2$s) registered a new account on %3$s.', [
					$username,
					$userEMailAddress ?? $l->t('no email address given'),
					$this->defaults->getName(),
				])
			);
		} else {
			$template->addBodyText(
				$l->t('"%1$s" (%2$s) registered a new account on %3$s and needs to be enabled.', [
					$username,
					$userEMailAddress ?? $l->t('no email address given'),
					$this->defaults->getName(),
				])
			);

			$template->addBodyButton(
				$l->t('Enable now'),
				$link
			);
		}
		$template->addFooter();

		$from = Util::getDefaultEmailAddress('register');
		$message = $this->mailer->createMessage();
		$message->setFrom([$from => $this->defaults->getName()]);
		$message->setTo($to);
		$message->useTemplate($template);
		$failedRecipients = $this->mailer->send($message);
		if (!empty($failedRecipients)) {
			throw new RegistrationException('Failed recipients: ' . print_r($failedRecipients, true));
		}
	}
}