* @author Christoph Wurst * @author John Molakvoæ (skjnldsv) * @author Julius Härtl * @author Lukas Reschke * @author Michael Weimann * @author Morris Jobke * @author Robin Appelman * @author Roeland Jago Douma * @author Thomas Müller * * @license AGPL-3.0 * * This code is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License, version 3, * as published by the Free Software Foundation. * * 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, version 3, * along with this program. If not, see * */ namespace OC\Avatar; use OC\User\Manager; use OC\User\NoUserException; use OCP\Accounts\IAccountManager; use OCP\Files\IAppData; use OCP\Files\NotFoundException; use OCP\Files\NotPermittedException; use OCP\IAvatar; use OCP\IAvatarManager; use OCP\IConfig; use OCP\IL10N; use OCP\ILogger; use OCP\IUserSession; /** * This class implements methods to access Avatar functionality */ class AvatarManager implements IAvatarManager { /** @var IUserSession */ private $userSession; /** @var Manager */ private $userManager; /** @var IAppData */ private $appData; /** @var IL10N */ private $l; /** @var ILogger */ private $logger; /** @var IConfig */ private $config; /** @var IAccountManager */ private $accountManager; /** * AvatarManager constructor. * * @param Manager $userManager * @param IAppData $appData * @param IL10N $l * @param ILogger $logger * @param IConfig $config * @param IUserSession $userSession */ public function __construct( IUserSession $userSession, Manager $userManager, IAppData $appData, IL10N $l, ILogger $logger, IConfig $config, IAccountManager $accountManager) { $this->userSession = $userSession; $this->userManager = $userManager; $this->appData = $appData; $this->l = $l; $this->logger = $logger; $this->config = $config; $this->accountManager = $accountManager; } /** * return a user specific instance of \OCP\IAvatar * @see \OCP\IAvatar * @param string $userId the ownCloud user id * @return \OCP\IAvatar * @throws \Exception In case the username is potentially dangerous * @throws NotFoundException In case there is no user folder yet */ public function getAvatar(string $userId) : IAvatar { $user = $this->userManager->get($userId); if ($user === null) { throw new \Exception('user does not exist'); } // sanitize userID - fixes casing issue (needed for the filesystem stuff that is done below) $userId = $user->getUID(); $requestingUser = null; if ($this->userSession !== null) { $requestingUser = $this->userSession->getUser(); } try { $folder = $this->appData->getFolder($userId); } catch (NotFoundException $e) { $folder = $this->appData->newFolder($userId); } // requesting in public page if ($requestingUser === null) { $account = $this->accountManager->getAccount($user); $avatarProperties = $account->getProperty(IAccountManager::PROPERTY_AVATAR); $avatarScope = $avatarProperties->getScope(); // v2-private scope hides the avatar from public access if ($avatarScope === IAccountManager::SCOPE_PRIVATE) { // use a placeholder avatar which caches the generated images return new PlaceholderAvatar($folder, $user, $this->logger); } } return new UserAvatar($folder, $this->l, $user, $this->logger, $this->config); } /** * Clear generated avatars */ public function clearCachedAvatars() { $users = $this->config->getUsersForUserValue('avatar', 'generated', 'true'); foreach ($users as $userId) { try { $folder = $this->appData->getFolder($userId); $folder->delete(); } catch (NotFoundException $e) { $this->logger->debug("No cache for the user $userId. Ignoring..."); } $this->config->setUserValue($userId, 'avatar', 'generated', 'false'); } } public function deleteUserAvatar(string $userId): void { try { $folder = $this->appData->getFolder($userId); $folder->delete(); } catch (NotFoundException $e) { $this->logger->debug("No cache for the user $userId. Ignoring avatar deletion"); } catch (NotPermittedException $e) { $this->logger->error("Unable to delete user avatars for $userId. gnoring avatar deletion"); } catch (NoUserException $e) { $this->logger->debug("User $userId not found. gnoring avatar deletion"); } $this->config->deleteUserValue($userId, 'avatar', 'generated'); } /** * Returns a GuestAvatar. * * @param string $name The guest name, e.g. "Albert". * @return IAvatar */ public function getGuestAvatar(string $name): IAvatar { return new GuestAvatar($name, $this->logger); } }