* * @author Joas Schilling * * @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\DAV\CalDAV\Activity\Provider; use OCA\DAV\CalDAV\CalDavBackend; use OCP\Activity\IEvent; use OCP\Activity\IProvider; use OCP\IGroup; use OCP\IGroupManager; use OCP\IL10N; use OCP\IUser; use OCP\IUserManager; abstract class Base implements IProvider { /** @var IUserManager */ protected $userManager; /** @var string[] */ protected $userDisplayNames = []; /** @var IGroupManager */ protected $groupManager; /** @var string[] */ protected $groupDisplayNames = []; /** * @param IUserManager $userManager * @param IGroupManager $groupManager */ public function __construct(IUserManager $userManager, IGroupManager $groupManager) { $this->userManager = $userManager; $this->groupManager = $groupManager; } /** * @param IEvent $event * @param string $subject * @param array $parameters */ protected function setSubjects(IEvent $event, $subject, array $parameters) { $placeholders = $replacements = []; foreach ($parameters as $placeholder => $parameter) { $placeholders[] = '{' . $placeholder . '}'; $replacements[] = $parameter['name']; } $event->setParsedSubject(str_replace($placeholders, $replacements, $subject)) ->setRichSubject($subject, $parameters); } /** * @param array $eventData * @return array */ protected function generateObjectParameter($eventData) { if (!is_array($eventData) || !isset($eventData['id']) || !isset($eventData['name'])) { throw new \InvalidArgumentException(); } return [ 'type' => 'calendar-event', 'id' => $eventData['id'], 'name' => $eventData['name'], ]; } /** * @param array $data * @param IL10N $l * @return array */ protected function generateCalendarParameter($data, IL10N $l) { if ($data['uri'] === CalDavBackend::PERSONAL_CALENDAR_URI && $data['name'] === CalDavBackend::PERSONAL_CALENDAR_NAME) { return [ 'type' => 'calendar', 'id' => $data['id'], 'name' => $l->t('Personal'), ]; } return [ 'type' => 'calendar', 'id' => $data['id'], 'name' => $data['name'], ]; } /** * @param int $id * @param string $name * @return array */ protected function generateLegacyCalendarParameter($id, $name) { return [ 'type' => 'calendar', 'id' => $id, 'name' => $name, ]; } /** * @param string $uid * @return array */ protected function generateUserParameter($uid) { if (!isset($this->userDisplayNames[$uid])) { $this->userDisplayNames[$uid] = $this->getUserDisplayName($uid); } return [ 'type' => 'user', 'id' => $uid, 'name' => $this->userDisplayNames[$uid], ]; } /** * @param string $uid * @return string */ protected function getUserDisplayName($uid) { $user = $this->userManager->get($uid); if ($user instanceof IUser) { return $user->getDisplayName(); } return $uid; } /** * @param string $gid * @return array */ protected function generateGroupParameter($gid) { 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($gid) { $group = $this->groupManager->get($gid); if ($group instanceof IGroup) { return $group->getDisplayName(); } return $gid; } }