migrate therinaldos.com data

wedding-pics/apps/dav/lib/CardDAV/Activity/Backend.php

@@ -0,0 +1,507 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2021 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ *
+ * @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 <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\DAV\CardDAV\Activity;
+
+use OCA\DAV\CardDAV\Activity\Provider\Addressbook;
+use OCP\Activity\IEvent;
+use OCP\Activity\IManager as IActivityManager;
+use OCP\App\IAppManager;
+use OCP\IGroup;
+use OCP\IGroupManager;
+use OCP\IUser;
+use OCP\IUserManager;
+use OCP\IUserSession;
+use Sabre\CardDAV\Plugin;
+use Sabre\VObject\Reader;
+
+class Backend {
+
+	/** @var IActivityManager */
+	protected $activityManager;
+
+	/** @var IGroupManager */
+	protected $groupManager;
+
+	/** @var IUserSession */
+	protected $userSession;
+
+	/** @var IAppManager */
+	protected $appManager;
+
+	/** @var IUserManager */
+	protected $userManager;
+
+	public function __construct(IActivityManager $activityManager,
+		IGroupManager $groupManager,
+		IUserSession $userSession,
+		IAppManager $appManager,
+		IUserManager $userManager) {
+		$this->activityManager = $activityManager;
+		$this->groupManager = $groupManager;
+		$this->userSession = $userSession;
+		$this->appManager = $appManager;
+		$this->userManager = $userManager;
+	}
+
+	/**
+	 * Creates activities when an addressbook was creates
+	 *
+	 * @param array $addressbookData
+	 */
+	public function onAddressbookCreate(array $addressbookData): void {
+		$this->triggerAddressbookActivity(Addressbook::SUBJECT_ADD, $addressbookData);
+	}
+
+	/**
+	 * Creates activities when a calendar was updated
+	 *
+	 * @param array $addressbookData
+	 * @param array $shares
+	 * @param array $properties
+	 */
+	public function onAddressbookUpdate(array $addressbookData, array $shares, array $properties): void {
+		$this->triggerAddressbookActivity(Addressbook::SUBJECT_UPDATE, $addressbookData, $shares, $properties);
+	}
+
+	/**
+	 * Creates activities when a calendar was deleted
+	 *
+	 * @param array $addressbookData
+	 * @param array $shares
+	 */
+	public function onAddressbookDelete(array $addressbookData, array $shares): void {
+		$this->triggerAddressbookActivity(Addressbook::SUBJECT_DELETE, $addressbookData, $shares);
+	}
+
+	/**
+	 * Creates activities for all related users when a calendar was touched
+	 *
+	 * @param string $action
+	 * @param array $addressbookData
+	 * @param array $shares
+	 * @param array $changedProperties
+	 */
+	protected function triggerAddressbookActivity(string $action, array $addressbookData, array $shares = [], array $changedProperties = []): void {
+		if (!isset($addressbookData['principaluri'])) {
+			return;
+		}
+
+		$principalUri = $addressbookData['principaluri'];
+
+		// We are not interested in changes from the system addressbook
+		if ($principalUri === 'principals/system/system') {
+			return;
+		}
+
+		$principal = explode('/', $principalUri);
+		$owner = array_pop($principal);
+
+		$currentUser = $this->userSession->getUser();
+		if ($currentUser instanceof IUser) {
+			$currentUser = $currentUser->getUID();
+		} else {
+			$currentUser = $owner;
+		}
+
+		$event = $this->activityManager->generateEvent();
+		$event->setApp('dav')
+			->setObject('addressbook', (int) $addressbookData['id'])
+			->setType('contacts')
+			->setAuthor($currentUser);
+
+		$changedVisibleInformation = array_intersect([
+			'{DAV:}displayname',
+			'{' . Plugin::NS_CARDDAV . '}addressbook-description',
+		], array_keys($changedProperties));
+
+		if (empty($shares) || ($action === Addressbook::SUBJECT_UPDATE && empty($changedVisibleInformation))) {
+			$users = [$owner];
+		} else {
+			$users = $this->getUsersForShares($shares);
+			$users[] = $owner;
+		}
+
+		foreach ($users as $user) {
+			if ($action === Addressbook::SUBJECT_DELETE && !$this->userManager->userExists($user)) {
+				// Avoid creating addressbook_delete activities for deleted users
+				continue;
+			}
+
+			$event->setAffectedUser($user)
+				->setSubject(
+					$user === $currentUser ? $action . '_self' : $action,
+					[
+						'actor' => $currentUser,
+						'addressbook' => [
+							'id' => (int) $addressbookData['id'],
+							'uri' => $addressbookData['uri'],
+							'name' => $addressbookData['{DAV:}displayname'],
+						],
+					]
+				);
+			$this->activityManager->publish($event);
+		}
+	}
+
+	/**
+	 * Creates activities for all related users when an addressbook was (un-)shared
+	 *
+	 * @param array $addressbookData
+	 * @param array $shares
+	 * @param array $add
+	 * @param array $remove
+	 */
+	public function onAddressbookUpdateShares(array $addressbookData, array $shares, array $add, array $remove): void {
+		$principal = explode('/', $addressbookData['principaluri']);
+		$owner = $principal[2];
+
+		$currentUser = $this->userSession->getUser();
+		if ($currentUser instanceof IUser) {
+			$currentUser = $currentUser->getUID();
+		} else {
+			$currentUser = $owner;
+		}
+
+		$event = $this->activityManager->generateEvent();
+		$event->setApp('dav')
+			->setObject('addressbook', (int) $addressbookData['id'])
+			->setType('contacts')
+			->setAuthor($currentUser);
+
+		foreach ($remove as $principal) {
+			// principal:principals/users/test
+			$parts = explode(':', $principal, 2);
+			if ($parts[0] !== 'principal') {
+				continue;
+			}
+			$principal = explode('/', $parts[1]);
+
+			if ($principal[1] === 'users') {
+				$this->triggerActivityUser(
+					$principal[2],
+					$event,
+					$addressbookData,
+					Addressbook::SUBJECT_UNSHARE_USER,
+					Addressbook::SUBJECT_DELETE . '_self'
+				);
+
+				if ($owner !== $principal[2]) {
+					$parameters = [
+						'actor' => $event->getAuthor(),
+						'addressbook' => [
+							'id' => (int) $addressbookData['id'],
+							'uri' => $addressbookData['uri'],
+							'name' => $addressbookData['{DAV:}displayname'],
+						],
+						'user' => $principal[2],
+					];
+
+					if ($owner === $event->getAuthor()) {
+						$subject = Addressbook::SUBJECT_UNSHARE_USER . '_you';
+					} elseif ($principal[2] === $event->getAuthor()) {
+						$subject = Addressbook::SUBJECT_UNSHARE_USER . '_self';
+					} else {
+						$event->setAffectedUser($event->getAuthor())
+							->setSubject(Addressbook::SUBJECT_UNSHARE_USER . '_you', $parameters);
+						$this->activityManager->publish($event);
+
+						$subject = Addressbook::SUBJECT_UNSHARE_USER . '_by';
+					}
+
+					$event->setAffectedUser($owner)
+						->setSubject($subject, $parameters);
+					$this->activityManager->publish($event);
+				}
+			} elseif ($principal[1] === 'groups') {
+				$this->triggerActivityGroup($principal[2], $event, $addressbookData, Addressbook::SUBJECT_UNSHARE_USER);
+
+				$parameters = [
+					'actor' => $event->getAuthor(),
+					'addressbook' => [
+						'id' => (int) $addressbookData['id'],
+						'uri' => $addressbookData['uri'],
+						'name' => $addressbookData['{DAV:}displayname'],
+					],
+					'group' => $principal[2],
+				];
+
+				if ($owner === $event->getAuthor()) {
+					$subject = Addressbook::SUBJECT_UNSHARE_GROUP . '_you';
+				} else {
+					$event->setAffectedUser($event->getAuthor())
+						->setSubject(Addressbook::SUBJECT_UNSHARE_GROUP . '_you', $parameters);
+					$this->activityManager->publish($event);
+
+					$subject = Addressbook::SUBJECT_UNSHARE_GROUP . '_by';
+				}
+
+				$event->setAffectedUser($owner)
+					->setSubject($subject, $parameters);
+				$this->activityManager->publish($event);
+			}
+		}
+
+		foreach ($add as $share) {
+			if ($this->isAlreadyShared($share['href'], $shares)) {
+				continue;
+			}
+
+			// principal:principals/users/test
+			$parts = explode(':', $share['href'], 2);
+			if ($parts[0] !== 'principal') {
+				continue;
+			}
+			$principal = explode('/', $parts[1]);
+
+			if ($principal[1] === 'users') {
+				$this->triggerActivityUser($principal[2], $event, $addressbookData, Addressbook::SUBJECT_SHARE_USER);
+
+				if ($owner !== $principal[2]) {
+					$parameters = [
+						'actor' => $event->getAuthor(),
+						'addressbook' => [
+							'id' => (int) $addressbookData['id'],
+							'uri' => $addressbookData['uri'],
+							'name' => $addressbookData['{DAV:}displayname'],
+						],
+						'user' => $principal[2],
+					];
+
+					if ($owner === $event->getAuthor()) {
+						$subject = Addressbook::SUBJECT_SHARE_USER . '_you';
+					} else {
+						$event->setAffectedUser($event->getAuthor())
+							->setSubject(Addressbook::SUBJECT_SHARE_USER . '_you', $parameters);
+						$this->activityManager->publish($event);
+
+						$subject = Addressbook::SUBJECT_SHARE_USER . '_by';
+					}
+
+					$event->setAffectedUser($owner)
+						->setSubject($subject, $parameters);
+					$this->activityManager->publish($event);
+				}
+			} elseif ($principal[1] === 'groups') {
+				$this->triggerActivityGroup($principal[2], $event, $addressbookData, Addressbook::SUBJECT_SHARE_USER);
+
+				$parameters = [
+					'actor' => $event->getAuthor(),
+					'addressbook' => [
+						'id' => (int) $addressbookData['id'],
+						'uri' => $addressbookData['uri'],
+						'name' => $addressbookData['{DAV:}displayname'],
+					],
+					'group' => $principal[2],
+				];
+
+				if ($owner === $event->getAuthor()) {
+					$subject = Addressbook::SUBJECT_SHARE_GROUP . '_you';
+				} else {
+					$event->setAffectedUser($event->getAuthor())
+						->setSubject(Addressbook::SUBJECT_SHARE_GROUP . '_you', $parameters);
+					$this->activityManager->publish($event);
+
+					$subject = Addressbook::SUBJECT_SHARE_GROUP . '_by';
+				}
+
+				$event->setAffectedUser($owner)
+					->setSubject($subject, $parameters);
+				$this->activityManager->publish($event);
+			}
+		}
+	}
+
+	/**
+	 * Checks if a calendar is already shared with a principal
+	 *
+	 * @param string $principal
+	 * @param array[] $shares
+	 * @return bool
+	 */
+	protected function isAlreadyShared(string $principal, array $shares): bool {
+		foreach ($shares as $share) {
+			if ($principal === $share['href']) {
+				return true;
+			}
+		}
+
+		return false;
+	}
+
+	/**
+	 * Creates the given activity for all members of the given group
+	 *
+	 * @param string $gid
+	 * @param IEvent $event
+	 * @param array $properties
+	 * @param string $subject
+	 */
+	protected function triggerActivityGroup(string $gid, IEvent $event, array $properties, string $subject): void {
+		$group = $this->groupManager->get($gid);
+
+		if ($group instanceof IGroup) {
+			foreach ($group->getUsers() as $user) {
+				// Exclude current user
+				if ($user->getUID() !== $event->getAuthor()) {
+					$this->triggerActivityUser($user->getUID(), $event, $properties, $subject);
+				}
+			}
+		}
+	}
+
+	/**
+	 * Creates the given activity for the given user
+	 *
+	 * @param string $user
+	 * @param IEvent $event
+	 * @param array $properties
+	 * @param string $subject
+	 * @param string $subjectSelf
+	 */
+	protected function triggerActivityUser(string $user, IEvent $event, array $properties, string $subject, string $subjectSelf = ''): void {
+		$event->setAffectedUser($user)
+			->setSubject(
+				$user === $event->getAuthor() && $subjectSelf ? $subjectSelf : $subject,
+				[
+					'actor' => $event->getAuthor(),
+					'addressbook' => [
+						'id' => (int) $properties['id'],
+						'uri' => $properties['uri'],
+						'name' => $properties['{DAV:}displayname'],
+					],
+				]
+			);
+
+		$this->activityManager->publish($event);
+	}
+
+	/**
+	 * Creates activities when a card was created/updated/deleted
+	 *
+	 * @param string $action
+	 * @param array $addressbookData
+	 * @param array $shares
+	 * @param array $cardData
+	 */
+	public function triggerCardActivity(string $action, array $addressbookData, array $shares, array $cardData): void {
+		if (!isset($addressbookData['principaluri'])) {
+			return;
+		}
+
+		$principalUri = $addressbookData['principaluri'];
+
+		// We are not interested in changes from the system addressbook
+		if ($principalUri === 'principals/system/system') {
+			return;
+		}
+
+		$principal = explode('/', $principalUri);
+		$owner = array_pop($principal);
+
+		$currentUser = $this->userSession->getUser();
+		if ($currentUser instanceof IUser) {
+			$currentUser = $currentUser->getUID();
+		} else {
+			$currentUser = $owner;
+		}
+
+		$card = $this->getCardNameAndId($cardData);
+
+		$event = $this->activityManager->generateEvent();
+		$event->setApp('dav')
+			->setObject('addressbook', (int) $addressbookData['id'])
+			->setType('contacts')
+			->setAuthor($currentUser);
+
+		$users = $this->getUsersForShares($shares);
+		$users[] = $owner;
+
+		// Users for share can return the owner itself if the calendar is published
+		foreach (array_unique($users) as $user) {
+			$params = [
+				'actor' => $event->getAuthor(),
+				'addressbook' => [
+					'id' => (int) $addressbookData['id'],
+					'uri' => $addressbookData['uri'],
+					'name' => $addressbookData['{DAV:}displayname'],
+				],
+				'card' => [
+					'id' => $card['id'],
+					'name' => $card['name'],
+				],
+			];
+
+
+			$event->setAffectedUser($user)
+				->setSubject(
+					$user === $currentUser ? $action . '_self' : $action,
+					$params
+				);
+
+			$this->activityManager->publish($event);
+		}
+	}
+
+	/**
+	 * @param array $cardData
+	 * @return string[]
+	 */
+	protected function getCardNameAndId(array $cardData): array {
+		$vObject = Reader::read($cardData['carddata']);
+		return ['id' => (string) $vObject->UID, 'name' => (string) ($vObject->FN ?? '')];
+	}
+
+	/**
+	 * Get all users that have access to a given calendar
+	 *
+	 * @param array $shares
+	 * @return string[]
+	 */
+	protected function getUsersForShares(array $shares): array {
+		$users = $groups = [];
+		foreach ($shares as $share) {
+			$principal = explode('/', $share['{http://owncloud.org/ns}principal']);
+			if ($principal[1] === 'users') {
+				$users[] = $principal[2];
+			} elseif ($principal[1] === 'groups') {
+				$groups[] = $principal[2];
+			}
+		}
+
+		if (!empty($groups)) {
+			foreach ($groups as $gid) {
+				$group = $this->groupManager->get($gid);
+				if ($group instanceof IGroup) {
+					foreach ($group->getUsers() as $user) {
+						$users[] = $user->getUID();
+					}
+				}
+			}
+		}
+
+		return array_unique($users);
+	}
+}

wedding-pics/apps/dav/lib/CardDAV/Activity/Filter.php

@@ -0,0 +1,86 @@
+<?php
+/**
+ * @copyright Copyright (c) 2021 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ *
+ * @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 <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\DAV\CardDAV\Activity;
+
+use OCP\Activity\IFilter;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+
+class Filter implements IFilter {
+
+	/** @var IL10N */
+	protected $l;
+
+	/** @var IURLGenerator */
+	protected $url;
+
+	public function __construct(IL10N $l, IURLGenerator $url) {
+		$this->l = $l;
+		$this->url = $url;
+	}
+
+	/**
+	 * @return string Lowercase a-z and underscore only identifier
+	 */
+	public function getIdentifier(): string {
+		return 'contacts';
+	}
+
+	/**
+	 * @return string A translated string
+	 */
+	public function getName(): string {
+		return $this->l->t('Contacts');
+	}
+
+	/**
+	 * @return int whether the filter should be rather on the top or bottom of
+	 * the admin section. The filters are arranged in ascending order of the
+	 * priority values. It is required to return a value between 0 and 100.
+	 */
+	public function getPriority(): int {
+		return 40;
+	}
+
+	/**
+	 * @return string Full URL to an icon, empty string when none is given
+	 */
+	public function getIcon(): string {
+		return $this->url->getAbsoluteURL($this->url->imagePath('core', 'places/contacts.svg'));
+	}
+
+	/**
+	 * @param string[] $types
+	 * @return string[] An array of allowed apps from which activities should be displayed
+	 */
+	public function filterTypes(array $types): array {
+		return array_intersect(['contacts'], $types);
+	}
+
+	/**
+	 * @return string[] An array of allowed apps from which activities should be displayed
+	 */
+	public function allowedApps(): array {
+		return [];
+	}
+}

wedding-pics/apps/dav/lib/CardDAV/Activity/Provider/Addressbook.php

@@ -0,0 +1,191 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2021 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ *
+ * @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 <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\DAV\CardDAV\Activity\Provider;
+
+use OCP\Activity\IEvent;
+use OCP\Activity\IEventMerger;
+use OCP\Activity\IManager;
+use OCP\IGroupManager;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\IUserManager;
+use OCP\L10N\IFactory;
+
+class Addressbook extends Base {
+	public const SUBJECT_ADD = 'addressbook_add';
+	public const SUBJECT_UPDATE = 'addressbook_update';
+	public const SUBJECT_DELETE = 'addressbook_delete';
+	public const SUBJECT_SHARE_USER = 'addressbook_user_share';
+	public const SUBJECT_SHARE_GROUP = 'addressbook_group_share';
+	public const SUBJECT_UNSHARE_USER = 'addressbook_user_unshare';
+	public const SUBJECT_UNSHARE_GROUP = 'addressbook_group_unshare';
+
+	/** @var IFactory */
+	protected $languageFactory;
+
+	/** @var IManager */
+	protected $activityManager;
+
+	/** @var IEventMerger */
+	protected $eventMerger;
+
+	public function __construct(IFactory $languageFactory,
+		IURLGenerator $url,
+		IManager $activityManager,
+		IUserManager $userManager,
+		IGroupManager $groupManager,
+		IEventMerger $eventMerger) {
+		parent::__construct($userManager, $groupManager, $url);
+		$this->languageFactory = $languageFactory;
+		$this->activityManager = $activityManager;
+		$this->eventMerger = $eventMerger;
+	}
+
+	/**
+	 * @param string $language
+	 * @param IEvent $event
+	 * @param IEvent|null $previousEvent
+	 * @return IEvent
+	 * @throws \InvalidArgumentException
+	 */
+	public function parse($language, IEvent $event, IEvent $previousEvent = null): IEvent {
+		if ($event->getApp() !== 'dav' || $event->getType() !== 'contacts') {
+			throw new \InvalidArgumentException();
+		}
+
+		$l = $this->languageFactory->get('dav', $language);
+
+		if ($this->activityManager->getRequirePNG()) {
+			$event->setIcon($this->url->getAbsoluteURL($this->url->imagePath('core', 'places/contacts-dark.png')));
+		} else {
+			$event->setIcon($this->url->getAbsoluteURL($this->url->imagePath('core', 'places/contacts.svg')));
+		}
+
+		if ($event->getSubject() === self::SUBJECT_ADD) {
+			$subject = $l->t('{actor} created address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_ADD . '_self') {
+			$subject = $l->t('You created address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_DELETE) {
+			$subject = $l->t('{actor} deleted address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_DELETE . '_self') {
+			$subject = $l->t('You deleted address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_UPDATE) {
+			$subject = $l->t('{actor} updated address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_UPDATE . '_self') {
+			$subject = $l->t('You updated address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_SHARE_USER) {
+			$subject = $l->t('{actor} shared address book {addressbook} with you');
+		} elseif ($event->getSubject() === self::SUBJECT_SHARE_USER . '_you') {
+			$subject = $l->t('You shared address book {addressbook} with {user}');
+		} elseif ($event->getSubject() === self::SUBJECT_SHARE_USER . '_by') {
+			$subject = $l->t('{actor} shared address book {addressbook} with {user}');
+		} elseif ($event->getSubject() === self::SUBJECT_UNSHARE_USER) {
+			$subject = $l->t('{actor} unshared address book {addressbook} from you');
+		} elseif ($event->getSubject() === self::SUBJECT_UNSHARE_USER . '_you') {
+			$subject = $l->t('You unshared address book {addressbook} from {user}');
+		} elseif ($event->getSubject() === self::SUBJECT_UNSHARE_USER . '_by') {
+			$subject = $l->t('{actor} unshared address book {addressbook} from {user}');
+		} elseif ($event->getSubject() === self::SUBJECT_UNSHARE_USER . '_self') {
+			$subject = $l->t('{actor} unshared address book {addressbook} from themselves');
+		} elseif ($event->getSubject() === self::SUBJECT_SHARE_GROUP . '_you') {
+			$subject = $l->t('You shared address book {addressbook} with group {group}');
+		} elseif ($event->getSubject() === self::SUBJECT_SHARE_GROUP . '_by') {
+			$subject = $l->t('{actor} shared address book {addressbook} with group {group}');
+		} elseif ($event->getSubject() === self::SUBJECT_UNSHARE_GROUP . '_you') {
+			$subject = $l->t('You unshared address book {addressbook} from group {group}');
+		} elseif ($event->getSubject() === self::SUBJECT_UNSHARE_GROUP . '_by') {
+			$subject = $l->t('{actor} unshared address book {addressbook} from group {group}');
+		} else {
+			throw new \InvalidArgumentException();
+		}
+
+		$parsedParameters = $this->getParameters($event, $l);
+		$this->setSubjects($event, $subject, $parsedParameters);
+
+		$event = $this->eventMerger->mergeEvents('addressbook', $event, $previousEvent);
+
+		if ($event->getChildEvent() === null) {
+			if (isset($parsedParameters['user'])) {
+				// Couldn't group by calendar, maybe we can group by users
+				$event = $this->eventMerger->mergeEvents('user', $event, $previousEvent);
+			} elseif (isset($parsedParameters['group'])) {
+				// Couldn't group by calendar, maybe we can group by groups
+				$event = $this->eventMerger->mergeEvents('group', $event, $previousEvent);
+			}
+		}
+
+		return $event;
+	}
+
+	protected function getParameters(IEvent $event, IL10N $l): array {
+		$subject = $event->getSubject();
+		$parameters = $event->getSubjectParameters();
+
+		switch ($subject) {
+			case self::SUBJECT_ADD:
+			case self::SUBJECT_ADD . '_self':
+			case self::SUBJECT_DELETE:
+			case self::SUBJECT_DELETE . '_self':
+			case self::SUBJECT_UPDATE:
+			case self::SUBJECT_UPDATE . '_self':
+			case self::SUBJECT_SHARE_USER:
+			case self::SUBJECT_UNSHARE_USER:
+			case self::SUBJECT_UNSHARE_USER . '_self':
+				return [
+					'actor' => $this->generateUserParameter($parameters['actor']),
+					'addressbook' => $this->generateAddressbookParameter($parameters['addressbook'], $l),
+				];
+			case self::SUBJECT_SHARE_USER . '_you':
+			case self::SUBJECT_UNSHARE_USER . '_you':
+				return [
+					'addressbook' => $this->generateAddressbookParameter($parameters['addressbook'], $l),
+					'user' => $this->generateUserParameter($parameters['user']),
+				];
+			case self::SUBJECT_SHARE_USER . '_by':
+			case self::SUBJECT_UNSHARE_USER . '_by':
+				return [
+					'actor' => $this->generateUserParameter($parameters['actor']),
+					'addressbook' => $this->generateAddressbookParameter($parameters['addressbook'], $l),
+					'user' => $this->generateUserParameter($parameters['user']),
+				];
+			case self::SUBJECT_SHARE_GROUP . '_you':
+			case self::SUBJECT_UNSHARE_GROUP . '_you':
+				return [
+					'addressbook' => $this->generateAddressbookParameter($parameters['addressbook'], $l),
+					'group' => $this->generateGroupParameter($parameters['group']),
+				];
+			case self::SUBJECT_SHARE_GROUP . '_by':
+			case self::SUBJECT_UNSHARE_GROUP . '_by':
+				return [
+					'actor' => $this->generateUserParameter($parameters['actor']),
+					'addressbook' => $this->generateAddressbookParameter($parameters['addressbook'], $l),
+					'group' => $this->generateGroupParameter($parameters['group']),
+				];
+		}
+
+		throw new \InvalidArgumentException();
+	}
+}

wedding-pics/apps/dav/lib/CardDAV/Activity/Provider/Base.php

@@ -0,0 +1,122 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2021 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ *
+ * @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 <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\DAV\CardDAV\Activity\Provider;
+
+use OCA\DAV\CardDAV\CardDavBackend;
+use OCP\Activity\IEvent;
+use OCP\Activity\IProvider;
+use OCP\IGroup;
+use OCP\IGroupManager;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\IUserManager;
+
+abstract class Base implements IProvider {
+	/** @var IUserManager */
+	protected $userManager;
+
+	/** @var string[]  */
+	protected $userDisplayNames = [];
+
+	/** @var IGroupManager */
+	protected $groupManager;
+
+	/** @var string[] */
+	protected $groupDisplayNames = [];
+
+	/** @var IURLGenerator */
+	protected $url;
+
+	public function __construct(IUserManager $userManager,
+		IGroupManager $groupManager,
+		IURLGenerator $urlGenerator) {
+		$this->userManager = $userManager;
+		$this->groupManager = $groupManager;
+		$this->url = $urlGenerator;
+	}
+
+	protected function setSubjects(IEvent $event, string $subject, array $parameters): void {
+		$event->setRichSubject($subject, $parameters);
+	}
+
+	/**
+	 * @param array $data
+	 * @param IL10N $l
+	 * @return array
+	 */
+	protected function generateAddressbookParameter(array $data, IL10N $l): array {
+		if ($data['uri'] === CardDavBackend::PERSONAL_ADDRESSBOOK_URI &&
+			$data['name'] === CardDavBackend::PERSONAL_ADDRESSBOOK_NAME) {
+			return [
+				'type' => 'addressbook',
+				'id' => $data['id'],
+				'name' => $l->t('Personal'),
+			];
+		}
+
+		return [
+			'type' => 'addressbook',
+			'id' => $data['id'],
+			'name' => $data['name'],
+		];
+	}
+
+	protected function generateUserParameter(string $uid): array {
+		return [
+			'type' => 'user',
+			'id' => $uid,
+			'name' => $this->userManager->getDisplayName($uid) ?? $uid,
+		];
+	}
+
+	/**
+	 * @param string $gid
+	 * @return array
+	 */
+	protected function generateGroupParameter(string $gid): array {
+		if (!isset($this->groupDisplayNames[$gid])) {
+			$this->groupDisplayNames[$gid] = $this->getGroupDisplayName($gid);
+		}
+
+		return [
+			'type' => 'user-group',
+			'id' => $gid,
+			'name' => $this->groupDisplayNames[$gid],
+		];
+	}
+
+	/**
+	 * @param string $gid
+	 * @return string
+	 */
+	protected function getGroupDisplayName(string $gid): string {
+		$group = $this->groupManager->get($gid);
+		if ($group instanceof IGroup) {
+			return $group->getDisplayName();
+		}
+		return $gid;
+	}
+}

wedding-pics/apps/dav/lib/CardDAV/Activity/Provider/Card.php

@@ -0,0 +1,144 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2021 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ *
+ * @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 <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\DAV\CardDAV\Activity\Provider;
+
+use OCP\Activity\IEvent;
+use OCP\Activity\IEventMerger;
+use OCP\Activity\IManager;
+use OCP\App\IAppManager;
+use OCP\IGroupManager;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\IUserManager;
+use OCP\L10N\IFactory;
+
+class Card extends Base {
+	public const SUBJECT_ADD = 'card_add';
+	public const SUBJECT_UPDATE = 'card_update';
+	public const SUBJECT_DELETE = 'card_delete';
+
+	/** @var IFactory */
+	protected $languageFactory;
+
+	/** @var IManager */
+	protected $activityManager;
+
+	/** @var IEventMerger */
+	protected $eventMerger;
+
+	/** @var IAppManager */
+	protected $appManager;
+
+	public function __construct(IFactory $languageFactory,
+		IURLGenerator $url,
+		IManager $activityManager,
+		IUserManager $userManager,
+		IGroupManager $groupManager,
+		IEventMerger $eventMerger,
+		IAppManager $appManager) {
+		parent::__construct($userManager, $groupManager, $url);
+		$this->languageFactory = $languageFactory;
+		$this->activityManager = $activityManager;
+		$this->eventMerger = $eventMerger;
+		$this->appManager = $appManager;
+	}
+
+	/**
+	 * @param string $language
+	 * @param IEvent $event
+	 * @param IEvent|null $previousEvent
+	 * @return IEvent
+	 * @throws \InvalidArgumentException
+	 */
+	public function parse($language, IEvent $event, IEvent $previousEvent = null): IEvent {
+		if ($event->getApp() !== 'dav' || $event->getType() !== 'contacts') {
+			throw new \InvalidArgumentException();
+		}
+
+		$l = $this->languageFactory->get('dav', $language);
+
+		if ($this->activityManager->getRequirePNG()) {
+			$event->setIcon($this->url->getAbsoluteURL($this->url->imagePath('core', 'places/contacts-dark.png')));
+		} else {
+			$event->setIcon($this->url->getAbsoluteURL($this->url->imagePath('core', 'places/contacts.svg')));
+		}
+
+		if ($event->getSubject() === self::SUBJECT_ADD) {
+			$subject = $l->t('{actor} created contact {card} in address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_ADD . '_self') {
+			$subject = $l->t('You created contact {card} in address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_DELETE) {
+			$subject = $l->t('{actor} deleted contact {card} from address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_DELETE . '_self') {
+			$subject = $l->t('You deleted contact {card} from address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_UPDATE) {
+			$subject = $l->t('{actor} updated contact {card} in address book {addressbook}');
+		} elseif ($event->getSubject() === self::SUBJECT_UPDATE . '_self') {
+			$subject = $l->t('You updated contact {card} in address book {addressbook}');
+		} else {
+			throw new \InvalidArgumentException();
+		}
+
+		$parsedParameters = $this->getParameters($event, $l);
+		$this->setSubjects($event, $subject, $parsedParameters);
+
+		$event = $this->eventMerger->mergeEvents('card', $event, $previousEvent);
+		return $event;
+	}
+
+	protected function getParameters(IEvent $event, IL10N $l): array {
+		$subject = $event->getSubject();
+		$parameters = $event->getSubjectParameters();
+
+		switch ($subject) {
+			case self::SUBJECT_ADD:
+			case self::SUBJECT_DELETE:
+			case self::SUBJECT_UPDATE:
+				return [
+					'actor' => $this->generateUserParameter($parameters['actor']),
+					'addressbook' => $this->generateAddressbookParameter($parameters['addressbook'], $l),
+					'card' => $this->generateCardParameter($parameters['card']),
+				];
+			case self::SUBJECT_ADD . '_self':
+			case self::SUBJECT_DELETE . '_self':
+			case self::SUBJECT_UPDATE . '_self':
+				return [
+					'addressbook' => $this->generateAddressbookParameter($parameters['addressbook'], $l),
+					'card' => $this->generateCardParameter($parameters['card']),
+				];
+		}
+
+		throw new \InvalidArgumentException();
+	}
+
+	private function generateCardParameter(array $cardData): array {
+		return [
+			'type' => 'addressbook-contact',
+			'id' => $cardData['id'],
+			'name' => $cardData['name'],
+		];
+	}
+}

wedding-pics/apps/dav/lib/CardDAV/Activity/Setting.php

@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2021 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ *
+ * @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 <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\DAV\CardDAV\Activity;
+
+use OCA\DAV\CalDAV\Activity\Setting\CalDAVSetting;
+
+class Setting extends CalDAVSetting {
+	/**
+	 * @return string Lowercase a-z and underscore only identifier
+	 */
+	public function getIdentifier(): string {
+		return 'contacts';
+	}
+
+	/**
+	 * @return string A translated string
+	 */
+	public function getName(): string {
+		return $this->l->t('A <strong>contact</strong> or <strong>address book</strong> was modified');
+	}
+
+	/**
+	 * @return int whether the filter should be rather on the top or bottom of
+	 * the admin section. The filters are arranged in ascending order of the
+	 * priority values. It is required to return a value between 0 and 100.
+	 */
+	public function getPriority(): int {
+		return 50;
+	}
+
+	/**
+	 * @return bool True when the option can be changed for the stream
+	 */
+	public function canChangeStream(): bool {
+		return true;
+	}
+
+	/**
+	 * @return bool True when the option can be changed for the stream
+	 */
+	public function isDefaultEnabledStream(): bool {
+		return true;
+	}
+
+	/**
+	 * @return bool True when the option can be changed for the mail
+	 */
+	public function canChangeMail(): bool {
+		return true;
+	}
+
+	/**
+	 * @return bool True when the option can be changed for the stream
+	 */
+	public function isDefaultEnabledMail(): bool {
+		return false;
+	}
+}