* * @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 . * */ namespace OCA\FirstRunWizard\Notification; use OCP\IConfig; use OCP\IURLGenerator; use OCP\IUserManager; use OCP\L10N\IFactory; use OCP\Notification\IManager as INotificationManager; use OCP\Notification\INotification; use OCP\Notification\INotifier; use OCP\User\Backend\ISetPasswordBackend; class Notifier implements INotifier { /** @var IFactory */ protected $factory; /** @var IUserManager */ protected $userManager; /** @var INotificationManager */ protected $notificationManager; /** @var IURLGenerator */ protected $url; /** @var IConfig */ protected $config; public function __construct(IFactory $factory, IUserManager $userManager, INotificationManager $notificationManager, IURLGenerator $urlGenerator, IConfig $config) { $this->factory = $factory; $this->userManager = $userManager; $this->notificationManager = $notificationManager; $this->url = $urlGenerator; $this->config = $config; } /** * Identifier of the notifier, only use [a-z0-9_] * * @return string * @since 17.0.0 */ public function getID(): string { return 'firstrunwizard'; } /** * Human readable name describing the notifier * * @return string * @since 17.0.0 */ public function getName(): string { return $this->factory->get('firstrunwizard')->t('First run wizard'); } /** * @param INotification $notification * @param string $languageCode The code of the language that should be used to prepare the notification * @return INotification * @throws \InvalidArgumentException When the notification was not prepared by a notifier * @since 9.0.0 */ public function prepare(INotification $notification, string $languageCode): INotification { if ($notification->getApp() !== 'firstrunwizard') { // Not my app => throw throw new \InvalidArgumentException(); } switch ($notification->getSubject()) { case 'profile': $subject = $this->getSubject($notification, $languageCode); if ($subject === '') { // Everything done, mark the notification as processed... $this->notificationManager->markProcessed($notification); throw new \InvalidArgumentException(); } $notification->setParsedSubject($subject) ->setLink($this->url->linkToRouteAbsolute('settings.PersonalSettings.index')); return $notification; case 'apphint-calendar': case 'apphint-contacts': case 'apphint-mail': case 'apphint-spreed': case 'apphint-tasks': case 'apphint-deck': case 'apphint-notes': case 'apphint-social': case 'apphint-groupfolders': $app = $notification->getObjectId(); return $this->setAppHintDetails($notification, $languageCode, $app); default: // Unknown subject => Unknown notification => throw throw new \InvalidArgumentException(); } } /** * @param INotification $notification * @param string $languageCode * @return string */ protected function getSubject(INotification $notification, string $languageCode): string { $l = $this->factory->get('firstrunwizard', $languageCode); $user = $this->userManager->get($notification->getUser()); $email = $user->getEMailAddress(); if ($email === null || $email === '') { if ($this->config->getSystemValue('lost_password_link', '') || !$user->getBackend() instanceof ISetPasswordBackend) { return $l->t('Add your profile information! For example your email is needed to receive notifications.'); } return $l->t('Add your profile information! For example your email is needed to receive notifications and reset your password.'); } if ($user->canChangeDisplayName() && $user->getDisplayName() === $user->getUID()) { if ($user->canChangeAvatar() && $user->getAvatarImage(32) === null) { return $l->t('Add your profile information! Set a profile picture and full name for easier recognition across all features.'); } else { return $l->t('Add your profile information! Set a full name for easier recognition across all features.'); } } else { if ($user->canChangeAvatar() && $user->getAvatarImage(32) === null) { return $l->t('Add your profile information! Set a profile picture for easier recognition across all features.'); } else { return ''; } } } /** * @param INotification $notification * @param string $languageCode * @return INotification */ protected function setAppHintDetails(INotification $notification, $languageCode, $app) { $l = $this->factory->get('firstrunwizard', $languageCode); $appLink = ''; switch ($app) { case 'calendar': $notification->setParsedSubject($l->t('App recommendation: Nextcloud Calendar')); $notification->setParsedMessage($l->t('Schedule work & meetings, synced with all your devices.')); $appLink = '/organization/calendar'; break; case 'contacts': $notification->setParsedSubject($l->t('App recommendation: Nextcloud Contacts')); $notification->setParsedMessage($l->t('Keep your colleagues and friends in one place without leaking their private info.')); $appLink = '/organization/contacts'; break; case 'mail': $notification->setParsedSubject($l->t('App recommendation: Nextcloud Mail')); $notification->setParsedMessage($l->t('Simple email app nicely integrated with Files, Contacts and Calendar.')); $appLink = '/social/mail'; break; case 'tasks': $notification->setParsedSubject($l->t('App recommendation: Tasks')); $notification->setParsedMessage($l->t('Sync tasks from various devices with your Nextcloud and edit them online.')); $appLink = '/organization/tasks'; break; case 'deck': $notification->setParsedSubject($l->t('App recommendation: Deck')); $notification->setParsedMessage($l->t('Kanban style organization for personal planning and team projects.')); $appLink = '/organization/deck'; break; case 'notes': $notification->setParsedSubject($l->t('App recommendation: Notes')); $notification->setParsedMessage($l->t('Distraction-free notes and writing.')); $appLink = '/organization/notes'; break; case 'social': $notification->setParsedSubject($l->t('App recommendation: Social')); $notification->setParsedMessage($l->t('Nextcloud becomes part of the federated social networks.')); $appLink = '/social/social'; break; case 'groupfolders': $notification->setParsedSubject($l->t('App recommendation: Group folders')); $notification->setParsedMessage($l->t('Admin-configured folders shared by everyone in a group.')); $appLink = '/files/groupfolders'; break; } $notification ->setLink($this->url->linkToRouteAbsolute('settings.AppSettings.viewApps') . $appLink, 'GET') ->setIcon($this->url->getAbsoluteURL($this->url->imagePath('firstrunwizard', 'apps/'. $app . '.svg'))); return $notification; } }