mirror of
https://github.com/nextcloud/server.git
synced 2025-02-14 21:09:20 +00:00
311 lines
8.2 KiB
PHP
311 lines
8.2 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* SPDX-FileCopyrightText: 2019 Nextcloud GmbH and Nextcloud contributors
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*/
|
|
namespace OCA\DAV\CalDAV\Reminder;
|
|
|
|
use DateTime;
|
|
use OCA\DAV\AppInfo\Application;
|
|
use OCP\AppFramework\Utility\ITimeFactory;
|
|
use OCP\IL10N;
|
|
use OCP\IURLGenerator;
|
|
use OCP\L10N\IFactory;
|
|
use OCP\Notification\AlreadyProcessedException;
|
|
use OCP\Notification\INotification;
|
|
use OCP\Notification\INotifier;
|
|
use OCP\Notification\UnknownNotificationException;
|
|
|
|
/**
|
|
* Class Notifier
|
|
*
|
|
* @package OCA\DAV\CalDAV\Reminder
|
|
*/
|
|
class Notifier implements INotifier {
|
|
|
|
/** @var IL10N */
|
|
private $l10n;
|
|
|
|
/**
|
|
* Notifier constructor.
|
|
*
|
|
* @param IFactory $l10nFactory
|
|
* @param IURLGenerator $urlGenerator
|
|
* @param ITimeFactory $timeFactory
|
|
*/
|
|
public function __construct(
|
|
private IFactory $l10nFactory,
|
|
private IURLGenerator $urlGenerator,
|
|
private ITimeFactory $timeFactory,
|
|
) {
|
|
}
|
|
|
|
/**
|
|
* Identifier of the notifier, only use [a-z0-9_]
|
|
*
|
|
* @return string
|
|
* @since 17.0.0
|
|
*/
|
|
public function getID():string {
|
|
return Application::APP_ID;
|
|
}
|
|
|
|
/**
|
|
* Human readable name describing the notifier
|
|
*
|
|
* @return string
|
|
* @since 17.0.0
|
|
*/
|
|
public function getName():string {
|
|
return $this->l10nFactory->get('dav')->t('Calendar');
|
|
}
|
|
|
|
/**
|
|
* Prepare sending the notification
|
|
*
|
|
* @param INotification $notification
|
|
* @param string $languageCode The code of the language that should be used to prepare the notification
|
|
* @return INotification
|
|
* @throws UnknownNotificationException
|
|
*/
|
|
public function prepare(INotification $notification,
|
|
string $languageCode):INotification {
|
|
if ($notification->getApp() !== Application::APP_ID) {
|
|
throw new UnknownNotificationException('Notification not from this app');
|
|
}
|
|
|
|
// Read the language from the notification
|
|
$this->l10n = $this->l10nFactory->get('dav', $languageCode);
|
|
|
|
// Handle notifier subjects
|
|
switch ($notification->getSubject()) {
|
|
case 'calendar_reminder':
|
|
return $this->prepareReminderNotification($notification);
|
|
|
|
default:
|
|
throw new UnknownNotificationException('Unknown subject');
|
|
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param INotification $notification
|
|
* @return INotification
|
|
*/
|
|
private function prepareReminderNotification(INotification $notification):INotification {
|
|
$imagePath = $this->urlGenerator->imagePath('core', 'places/calendar.svg');
|
|
$iconUrl = $this->urlGenerator->getAbsoluteURL($imagePath);
|
|
$notification->setIcon($iconUrl);
|
|
|
|
$this->prepareNotificationSubject($notification);
|
|
$this->prepareNotificationMessage($notification);
|
|
|
|
return $notification;
|
|
}
|
|
|
|
/**
|
|
* Sets the notification subject based on the parameters set in PushProvider
|
|
*
|
|
* @param INotification $notification
|
|
*/
|
|
private function prepareNotificationSubject(INotification $notification): void {
|
|
$parameters = $notification->getSubjectParameters();
|
|
|
|
$startTime = \DateTime::createFromFormat(\DateTimeInterface::ATOM, $parameters['start_atom']);
|
|
$now = $this->timeFactory->getDateTime();
|
|
$title = $this->getTitleFromParameters($parameters);
|
|
|
|
$diff = $startTime->diff($now);
|
|
if ($diff === false) {
|
|
return;
|
|
}
|
|
|
|
$components = [];
|
|
if ($diff->y) {
|
|
$components[] = $this->l10n->n('%n year', '%n years', $diff->y);
|
|
}
|
|
if ($diff->m) {
|
|
$components[] = $this->l10n->n('%n month', '%n months', $diff->m);
|
|
}
|
|
if ($diff->d) {
|
|
$components[] = $this->l10n->n('%n day', '%n days', $diff->d);
|
|
}
|
|
if ($diff->h) {
|
|
$components[] = $this->l10n->n('%n hour', '%n hours', $diff->h);
|
|
}
|
|
if ($diff->i) {
|
|
$components[] = $this->l10n->n('%n minute', '%n minutes', $diff->i);
|
|
}
|
|
|
|
if (count($components) > 0 && !$this->hasPhpDatetimeDiffBug()) {
|
|
// Limiting to the first three components to prevent
|
|
// the string from getting too long
|
|
$firstThreeComponents = array_slice($components, 0, 2);
|
|
$diffLabel = implode(', ', $firstThreeComponents);
|
|
|
|
if ($diff->invert) {
|
|
$title = $this->l10n->t('%s (in %s)', [$title, $diffLabel]);
|
|
} else {
|
|
$title = $this->l10n->t('%s (%s ago)', [$title, $diffLabel]);
|
|
}
|
|
}
|
|
|
|
$notification->setParsedSubject($title);
|
|
}
|
|
|
|
/**
|
|
* @see https://github.com/nextcloud/server/issues/41615
|
|
* @see https://github.com/php/php-src/issues/9699
|
|
*/
|
|
private function hasPhpDatetimeDiffBug(): bool {
|
|
$d1 = DateTime::createFromFormat(\DateTimeInterface::ATOM, '2023-11-22T11:52:00+01:00');
|
|
$d2 = new DateTime('2023-11-22T10:52:03', new \DateTimeZone('UTC'));
|
|
|
|
// The difference is 3 seconds, not -1year+11months+…
|
|
return $d1->diff($d2)->y < 0;
|
|
}
|
|
|
|
/**
|
|
* Sets the notification message based on the parameters set in PushProvider
|
|
*
|
|
* @param INotification $notification
|
|
*/
|
|
private function prepareNotificationMessage(INotification $notification): void {
|
|
$parameters = $notification->getMessageParameters();
|
|
|
|
$description = [
|
|
$this->l10n->t('Calendar: %s', $parameters['calendar_displayname']),
|
|
$this->l10n->t('Date: %s', $this->generateDateString($parameters)),
|
|
];
|
|
if ($parameters['description']) {
|
|
$description[] = $this->l10n->t('Description: %s', $parameters['description']);
|
|
}
|
|
if ($parameters['location']) {
|
|
$description[] = $this->l10n->t('Where: %s', $parameters['location']);
|
|
}
|
|
|
|
$message = implode("\r\n", $description);
|
|
$notification->setParsedMessage($message);
|
|
}
|
|
|
|
/**
|
|
* @param array $parameters
|
|
* @return string
|
|
*/
|
|
private function getTitleFromParameters(array $parameters):string {
|
|
return $parameters['title'] ?? $this->l10n->t('Untitled event');
|
|
}
|
|
|
|
/**
|
|
* @param array $parameters
|
|
* @return string
|
|
* @throws \Exception
|
|
*/
|
|
private function generateDateString(array $parameters):string {
|
|
$startDateTime = DateTime::createFromFormat(\DateTimeInterface::ATOM, $parameters['start_atom']);
|
|
$endDateTime = DateTime::createFromFormat(\DateTimeInterface::ATOM, $parameters['end_atom']);
|
|
|
|
// If the event has already ended, dismiss the notification
|
|
if ($endDateTime < $this->timeFactory->getDateTime()) {
|
|
throw new AlreadyProcessedException();
|
|
}
|
|
|
|
$isAllDay = $parameters['all_day'];
|
|
$diff = $startDateTime->diff($endDateTime);
|
|
|
|
if ($isAllDay) {
|
|
// One day event
|
|
if ($diff->days === 1) {
|
|
return $this->getDateString($startDateTime);
|
|
}
|
|
|
|
return implode(' - ', [
|
|
$this->getDateString($startDateTime),
|
|
$this->getDateString($endDateTime),
|
|
]);
|
|
}
|
|
|
|
$startTimezone = $endTimezone = null;
|
|
if (!$parameters['start_is_floating']) {
|
|
$startTimezone = $parameters['start_timezone'];
|
|
$endTimezone = $parameters['end_timezone'];
|
|
}
|
|
|
|
$localeStart = implode(', ', [
|
|
$this->getWeekDayName($startDateTime),
|
|
$this->getDateTimeString($startDateTime)
|
|
]);
|
|
|
|
// always show full date with timezone if timezones are different
|
|
if ($startTimezone !== $endTimezone) {
|
|
$localeEnd = implode(', ', [
|
|
$this->getWeekDayName($endDateTime),
|
|
$this->getDateTimeString($endDateTime)
|
|
]);
|
|
|
|
return $localeStart
|
|
. ' (' . $startTimezone . ') '
|
|
. ' - '
|
|
. $localeEnd
|
|
. ' (' . $endTimezone . ')';
|
|
}
|
|
|
|
// Show only the time if the day is the same
|
|
$localeEnd = $this->isDayEqual($startDateTime, $endDateTime)
|
|
? $this->getTimeString($endDateTime)
|
|
: implode(', ', [
|
|
$this->getWeekDayName($endDateTime),
|
|
$this->getDateTimeString($endDateTime)
|
|
]);
|
|
|
|
return $localeStart
|
|
. ' - '
|
|
. $localeEnd
|
|
. ' (' . $startTimezone . ')';
|
|
}
|
|
|
|
/**
|
|
* @param DateTime $dtStart
|
|
* @param DateTime $dtEnd
|
|
* @return bool
|
|
*/
|
|
private function isDayEqual(DateTime $dtStart,
|
|
DateTime $dtEnd):bool {
|
|
return $dtStart->format('Y-m-d') === $dtEnd->format('Y-m-d');
|
|
}
|
|
|
|
/**
|
|
* @param DateTime $dt
|
|
* @return string
|
|
*/
|
|
private function getWeekDayName(DateTime $dt):string {
|
|
return (string)$this->l10n->l('weekdayName', $dt, ['width' => 'abbreviated']);
|
|
}
|
|
|
|
/**
|
|
* @param DateTime $dt
|
|
* @return string
|
|
*/
|
|
private function getDateString(DateTime $dt):string {
|
|
return (string)$this->l10n->l('date', $dt, ['width' => 'medium']);
|
|
}
|
|
|
|
/**
|
|
* @param DateTime $dt
|
|
* @return string
|
|
*/
|
|
private function getDateTimeString(DateTime $dt):string {
|
|
return (string)$this->l10n->l('datetime', $dt, ['width' => 'medium|short']);
|
|
}
|
|
|
|
/**
|
|
* @param DateTime $dt
|
|
* @return string
|
|
*/
|
|
private function getTimeString(DateTime $dt):string {
|
|
return (string)$this->l10n->l('time', $dt, ['width' => 'short']);
|
|
}
|
|
}
|