<code>addServiceListener</code> | <code>addServiceListener</code> | ||||
</InvalidArgument> | </InvalidArgument> | ||||
</file> | </file> | ||||
<file src="lib/private/Collaboration/Reference/RenderReferenceEventListener.php"> | |||||
<InvalidArgument occurrences="1"> | |||||
<code>addServiceListener</code> | |||||
</InvalidArgument> | |||||
</file> | |||||
<file src="lib/private/Command/CallableJob.php"> | <file src="lib/private/Command/CallableJob.php"> | ||||
<ParamNameMismatch occurrences="1"> | <ParamNameMismatch occurrences="1"> | ||||
<code>$serializedCallable</code> | <code>$serializedCallable</code> |
namespace OC\Core\Controller; | namespace OC\Core\Controller; | ||||
use OCP\AppFramework\Http\DataResponse; | use OCP\AppFramework\Http\DataResponse; | ||||
use OCP\Collaboration\Reference\IDiscoverableReferenceProvider; | |||||
use OCP\Collaboration\Reference\IReferenceManager; | use OCP\Collaboration\Reference\IReferenceManager; | ||||
use OCP\IRequest; | use OCP\IRequest; | ||||
class ReferenceApiController extends \OCP\AppFramework\OCSController { | class ReferenceApiController extends \OCP\AppFramework\OCSController { | ||||
private IReferenceManager $referenceManager; | private IReferenceManager $referenceManager; | ||||
private ?string $userId; | |||||
public function __construct(string $appName, IRequest $request, IReferenceManager $referenceManager) { | |||||
public function __construct(string $appName, | |||||
IRequest $request, | |||||
IReferenceManager $referenceManager, | |||||
?string $userId) { | |||||
parent::__construct($appName, $request); | parent::__construct($appName, $request); | ||||
$this->referenceManager = $referenceManager; | $this->referenceManager = $referenceManager; | ||||
$this->userId = $userId; | |||||
} | } | ||||
/** | /** | ||||
'references' => array_filter($result) | 'references' => array_filter($result) | ||||
]); | ]); | ||||
} | } | ||||
/** | |||||
* @NoAdminRequired | |||||
*/ | |||||
public function getProvidersInfo(): DataResponse { | |||||
$providers = $this->referenceManager->getDiscoverableProviders(); | |||||
$jsonProviders = array_map(static function (IDiscoverableReferenceProvider $provider) { | |||||
return $provider->jsonSerialize(); | |||||
}, $providers); | |||||
return new DataResponse($jsonProviders); | |||||
} | |||||
/** | |||||
* @NoAdminRequired | |||||
*/ | |||||
public function touchProvider(string $providerId, ?int $timestamp = null): DataResponse { | |||||
if ($this->userId !== null) { | |||||
$success = $this->referenceManager->touchProvider($this->userId, $providerId, $timestamp); | |||||
return new DataResponse(['success' => $success]); | |||||
} | |||||
return new DataResponse(['success' => false]); | |||||
} | |||||
} | } |
['root' => '/references', 'name' => 'ReferenceApi#resolveOne', 'url' => '/resolve', 'verb' => 'GET'], | ['root' => '/references', 'name' => 'ReferenceApi#resolveOne', 'url' => '/resolve', 'verb' => 'GET'], | ||||
['root' => '/references', 'name' => 'ReferenceApi#extract', 'url' => '/extract', 'verb' => 'POST'], | ['root' => '/references', 'name' => 'ReferenceApi#extract', 'url' => '/extract', 'verb' => 'POST'], | ||||
['root' => '/references', 'name' => 'ReferenceApi#resolve', 'url' => '/resolve', 'verb' => 'POST'], | ['root' => '/references', 'name' => 'ReferenceApi#resolve', 'url' => '/resolve', 'verb' => 'POST'], | ||||
['root' => '/references', 'name' => 'ReferenceApi#getProvidersInfo', 'url' => '/providers', 'verb' => 'GET'], | |||||
['root' => '/references', 'name' => 'ReferenceApi#touchProvider', 'url' => '/provider/{providerId}', 'verb' => 'PUT'], | |||||
['root' => '/profile', 'name' => 'ProfileApi#setVisibility', 'url' => '/{targetUserId}', 'verb' => 'PUT'], | ['root' => '/profile', 'name' => 'ProfileApi#setVisibility', 'url' => '/{targetUserId}', 'verb' => 'PUT'], | ||||
self::registerAccountHooks(); | self::registerAccountHooks(); | ||||
self::registerResourceCollectionHooks(); | self::registerResourceCollectionHooks(); | ||||
self::registerFileReferenceEventListener(); | self::registerFileReferenceEventListener(); | ||||
self::registerRenderReferenceEventListener(); | |||||
self::registerAppRestrictionsHooks(); | self::registerAppRestrictionsHooks(); | ||||
// Make sure that the application class is not loaded before the database is setup | // Make sure that the application class is not loaded before the database is setup | ||||
\OC\Collaboration\Reference\File\FileReferenceEventListener::register(Server::get(IEventDispatcher::class)); | \OC\Collaboration\Reference\File\FileReferenceEventListener::register(Server::get(IEventDispatcher::class)); | ||||
} | } | ||||
private static function registerRenderReferenceEventListener() { | |||||
\OC\Collaboration\Reference\RenderReferenceEventListener::register(Server::get(IEventDispatcher::class)); | |||||
} | |||||
/** | /** | ||||
* register hooks for sharing | * register hooks for sharing | ||||
*/ | */ |
'OCP\\Collaboration\\Collaborators\\ISearchPlugin' => $baseDir . '/lib/public/Collaboration/Collaborators/ISearchPlugin.php', | 'OCP\\Collaboration\\Collaborators\\ISearchPlugin' => $baseDir . '/lib/public/Collaboration/Collaborators/ISearchPlugin.php', | ||||
'OCP\\Collaboration\\Collaborators\\ISearchResult' => $baseDir . '/lib/public/Collaboration/Collaborators/ISearchResult.php', | 'OCP\\Collaboration\\Collaborators\\ISearchResult' => $baseDir . '/lib/public/Collaboration/Collaborators/ISearchResult.php', | ||||
'OCP\\Collaboration\\Collaborators\\SearchResultType' => $baseDir . '/lib/public/Collaboration/Collaborators/SearchResultType.php', | 'OCP\\Collaboration\\Collaborators\\SearchResultType' => $baseDir . '/lib/public/Collaboration/Collaborators/SearchResultType.php', | ||||
'OCP\\Collaboration\\Reference\\ADiscoverableReferenceProvider' => $baseDir . '/lib/public/Collaboration/Reference/ADiscoverableReferenceProvider.php', | |||||
'OCP\\Collaboration\\Reference\\IDiscoverableReferenceProvider' => $baseDir . '/lib/public/Collaboration/Reference/IDiscoverableReferenceProvider.php', | |||||
'OCP\\Collaboration\\Reference\\IReference' => $baseDir . '/lib/public/Collaboration/Reference/IReference.php', | 'OCP\\Collaboration\\Reference\\IReference' => $baseDir . '/lib/public/Collaboration/Reference/IReference.php', | ||||
'OCP\\Collaboration\\Reference\\IReferenceManager' => $baseDir . '/lib/public/Collaboration/Reference/IReferenceManager.php', | 'OCP\\Collaboration\\Reference\\IReferenceManager' => $baseDir . '/lib/public/Collaboration/Reference/IReferenceManager.php', | ||||
'OCP\\Collaboration\\Reference\\IReferenceProvider' => $baseDir . '/lib/public/Collaboration/Reference/IReferenceProvider.php', | 'OCP\\Collaboration\\Reference\\IReferenceProvider' => $baseDir . '/lib/public/Collaboration/Reference/IReferenceProvider.php', | ||||
'OCP\\Collaboration\\Reference\\ISearchableReferenceProvider' => $baseDir . '/lib/public/Collaboration/Reference/ISearchableReferenceProvider.php', | |||||
'OCP\\Collaboration\\Reference\\Reference' => $baseDir . '/lib/public/Collaboration/Reference/Reference.php', | 'OCP\\Collaboration\\Reference\\Reference' => $baseDir . '/lib/public/Collaboration/Reference/Reference.php', | ||||
'OCP\\Collaboration\\Reference\\RenderReferenceEvent' => $baseDir . '/lib/public/Collaboration/Reference/RenderReferenceEvent.php', | 'OCP\\Collaboration\\Reference\\RenderReferenceEvent' => $baseDir . '/lib/public/Collaboration/Reference/RenderReferenceEvent.php', | ||||
'OCP\\Collaboration\\Resources\\CollectionException' => $baseDir . '/lib/public/Collaboration/Resources/CollectionException.php', | 'OCP\\Collaboration\\Resources\\CollectionException' => $baseDir . '/lib/public/Collaboration/Resources/CollectionException.php', | ||||
'OC\\Collaboration\\Reference\\File\\FileReferenceProvider' => $baseDir . '/lib/private/Collaboration/Reference/File/FileReferenceProvider.php', | 'OC\\Collaboration\\Reference\\File\\FileReferenceProvider' => $baseDir . '/lib/private/Collaboration/Reference/File/FileReferenceProvider.php', | ||||
'OC\\Collaboration\\Reference\\LinkReferenceProvider' => $baseDir . '/lib/private/Collaboration/Reference/LinkReferenceProvider.php', | 'OC\\Collaboration\\Reference\\LinkReferenceProvider' => $baseDir . '/lib/private/Collaboration/Reference/LinkReferenceProvider.php', | ||||
'OC\\Collaboration\\Reference\\ReferenceManager' => $baseDir . '/lib/private/Collaboration/Reference/ReferenceManager.php', | 'OC\\Collaboration\\Reference\\ReferenceManager' => $baseDir . '/lib/private/Collaboration/Reference/ReferenceManager.php', | ||||
'OC\\Collaboration\\Reference\\RenderReferenceEventListener' => $baseDir . '/lib/private/Collaboration/Reference/RenderReferenceEventListener.php', | |||||
'OC\\Collaboration\\Resources\\Collection' => $baseDir . '/lib/private/Collaboration/Resources/Collection.php', | 'OC\\Collaboration\\Resources\\Collection' => $baseDir . '/lib/private/Collaboration/Resources/Collection.php', | ||||
'OC\\Collaboration\\Resources\\Listener' => $baseDir . '/lib/private/Collaboration/Resources/Listener.php', | 'OC\\Collaboration\\Resources\\Listener' => $baseDir . '/lib/private/Collaboration/Resources/Listener.php', | ||||
'OC\\Collaboration\\Resources\\Manager' => $baseDir . '/lib/private/Collaboration/Resources/Manager.php', | 'OC\\Collaboration\\Resources\\Manager' => $baseDir . '/lib/private/Collaboration/Resources/Manager.php', |
'OCP\\Collaboration\\Collaborators\\ISearchPlugin' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Collaborators/ISearchPlugin.php', | 'OCP\\Collaboration\\Collaborators\\ISearchPlugin' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Collaborators/ISearchPlugin.php', | ||||
'OCP\\Collaboration\\Collaborators\\ISearchResult' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Collaborators/ISearchResult.php', | 'OCP\\Collaboration\\Collaborators\\ISearchResult' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Collaborators/ISearchResult.php', | ||||
'OCP\\Collaboration\\Collaborators\\SearchResultType' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Collaborators/SearchResultType.php', | 'OCP\\Collaboration\\Collaborators\\SearchResultType' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Collaborators/SearchResultType.php', | ||||
'OCP\\Collaboration\\Reference\\ADiscoverableReferenceProvider' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/ADiscoverableReferenceProvider.php', | |||||
'OCP\\Collaboration\\Reference\\IDiscoverableReferenceProvider' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/IDiscoverableReferenceProvider.php', | |||||
'OCP\\Collaboration\\Reference\\IReference' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/IReference.php', | 'OCP\\Collaboration\\Reference\\IReference' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/IReference.php', | ||||
'OCP\\Collaboration\\Reference\\IReferenceManager' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/IReferenceManager.php', | 'OCP\\Collaboration\\Reference\\IReferenceManager' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/IReferenceManager.php', | ||||
'OCP\\Collaboration\\Reference\\IReferenceProvider' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/IReferenceProvider.php', | 'OCP\\Collaboration\\Reference\\IReferenceProvider' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/IReferenceProvider.php', | ||||
'OCP\\Collaboration\\Reference\\ISearchableReferenceProvider' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/ISearchableReferenceProvider.php', | |||||
'OCP\\Collaboration\\Reference\\Reference' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/Reference.php', | 'OCP\\Collaboration\\Reference\\Reference' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/Reference.php', | ||||
'OCP\\Collaboration\\Reference\\RenderReferenceEvent' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/RenderReferenceEvent.php', | 'OCP\\Collaboration\\Reference\\RenderReferenceEvent' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Reference/RenderReferenceEvent.php', | ||||
'OCP\\Collaboration\\Resources\\CollectionException' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Resources/CollectionException.php', | 'OCP\\Collaboration\\Resources\\CollectionException' => __DIR__ . '/../../..' . '/lib/public/Collaboration/Resources/CollectionException.php', | ||||
'OC\\Collaboration\\Reference\\File\\FileReferenceProvider' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Reference/File/FileReferenceProvider.php', | 'OC\\Collaboration\\Reference\\File\\FileReferenceProvider' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Reference/File/FileReferenceProvider.php', | ||||
'OC\\Collaboration\\Reference\\LinkReferenceProvider' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Reference/LinkReferenceProvider.php', | 'OC\\Collaboration\\Reference\\LinkReferenceProvider' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Reference/LinkReferenceProvider.php', | ||||
'OC\\Collaboration\\Reference\\ReferenceManager' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Reference/ReferenceManager.php', | 'OC\\Collaboration\\Reference\\ReferenceManager' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Reference/ReferenceManager.php', | ||||
'OC\\Collaboration\\Reference\\RenderReferenceEventListener' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Reference/RenderReferenceEventListener.php', | |||||
'OC\\Collaboration\\Resources\\Collection' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Resources/Collection.php', | 'OC\\Collaboration\\Resources\\Collection' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Resources/Collection.php', | ||||
'OC\\Collaboration\\Resources\\Listener' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Resources/Listener.php', | 'OC\\Collaboration\\Resources\\Listener' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Resources/Listener.php', | ||||
'OC\\Collaboration\\Resources\\Manager' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Resources/Manager.php', | 'OC\\Collaboration\\Resources\\Manager' => __DIR__ . '/../../..' . '/lib/private/Collaboration/Resources/Manager.php', |
use OCP\Collaboration\Reference\IReferenceManager; | use OCP\Collaboration\Reference\IReferenceManager; | ||||
use OCP\EventDispatcher\Event; | use OCP\EventDispatcher\Event; | ||||
use OCP\EventDispatcher\IEventDispatcher; | use OCP\EventDispatcher\IEventDispatcher; | ||||
use OCP\EventDispatcher\IEventListener; | |||||
use OCP\Files\Events\Node\NodeDeletedEvent; | use OCP\Files\Events\Node\NodeDeletedEvent; | ||||
use OCP\Share\Events\ShareCreatedEvent; | use OCP\Share\Events\ShareCreatedEvent; | ||||
use OCP\Share\Events\ShareDeletedEvent; | use OCP\Share\Events\ShareDeletedEvent; | ||||
class FileReferenceEventListener implements \OCP\EventDispatcher\IEventListener { | |||||
/** @template-implements IEventListener<Event|NodeDeletedEvent|ShareDeletedEvent|ShareCreatedEvent> */ | |||||
class FileReferenceEventListener implements IEventListener { | |||||
private IReferenceManager $manager; | private IReferenceManager $manager; | ||||
public function __construct(IReferenceManager $manager) { | public function __construct(IReferenceManager $manager) { |
use OC\AppFramework\Bootstrap\Coordinator; | use OC\AppFramework\Bootstrap\Coordinator; | ||||
use OC\Collaboration\Reference\File\FileReferenceProvider; | use OC\Collaboration\Reference\File\FileReferenceProvider; | ||||
use OCP\Collaboration\Reference\IDiscoverableReferenceProvider; | |||||
use OCP\Collaboration\Reference\IReference; | use OCP\Collaboration\Reference\IReference; | ||||
use OCP\Collaboration\Reference\IReferenceManager; | use OCP\Collaboration\Reference\IReferenceManager; | ||||
use OCP\Collaboration\Reference\IReferenceProvider; | use OCP\Collaboration\Reference\IReferenceProvider; | ||||
use OCP\Collaboration\Reference\Reference; | use OCP\Collaboration\Reference\Reference; | ||||
use OCP\ICache; | use OCP\ICache; | ||||
use OCP\ICacheFactory; | use OCP\ICacheFactory; | ||||
use OCP\IConfig; | |||||
use OCP\IURLGenerator; | use OCP\IURLGenerator; | ||||
use OCP\IUserSession; | |||||
use Psr\Container\ContainerInterface; | use Psr\Container\ContainerInterface; | ||||
use Psr\Log\LoggerInterface; | use Psr\Log\LoggerInterface; | ||||
use Throwable; | use Throwable; | ||||
private ContainerInterface $container; | private ContainerInterface $container; | ||||
private LinkReferenceProvider $linkReferenceProvider; | private LinkReferenceProvider $linkReferenceProvider; | ||||
private LoggerInterface $logger; | private LoggerInterface $logger; | ||||
private IConfig $config; | |||||
private IUserSession $userSession; | |||||
public function __construct(LinkReferenceProvider $linkReferenceProvider, ICacheFactory $cacheFactory, Coordinator $coordinator, ContainerInterface $container, LoggerInterface $logger) { | |||||
public function __construct(LinkReferenceProvider $linkReferenceProvider, | |||||
ICacheFactory $cacheFactory, | |||||
Coordinator $coordinator, | |||||
ContainerInterface $container, | |||||
LoggerInterface $logger, | |||||
IConfig $config, | |||||
IUserSession $userSession) { | |||||
$this->linkReferenceProvider = $linkReferenceProvider; | $this->linkReferenceProvider = $linkReferenceProvider; | ||||
$this->cache = $cacheFactory->createDistributed('reference'); | $this->cache = $cacheFactory->createDistributed('reference'); | ||||
$this->coordinator = $coordinator; | $this->coordinator = $coordinator; | ||||
$this->container = $container; | $this->container = $container; | ||||
$this->logger = $logger; | $this->logger = $logger; | ||||
$this->config = $config; | |||||
$this->userSession = $userSession; | |||||
} | } | ||||
/** | |||||
* Extract a list of URLs from a text | |||||
* | |||||
* @param string $text | |||||
* @return string[] | |||||
*/ | |||||
public function extractReferences(string $text): array { | public function extractReferences(string $text): array { | ||||
preg_match_all(IURLGenerator::URL_REGEX, $text, $matches); | preg_match_all(IURLGenerator::URL_REGEX, $text, $matches); | ||||
$references = $matches[0] ?? []; | $references = $matches[0] ?? []; | ||||
}, $references); | }, $references); | ||||
} | } | ||||
/** | |||||
* Try to get a cached reference object from a reference string | |||||
* | |||||
* @param string $referenceId | |||||
* @return IReference|null | |||||
*/ | |||||
public function getReferenceFromCache(string $referenceId): ?IReference { | public function getReferenceFromCache(string $referenceId): ?IReference { | ||||
$matchedProvider = $this->getMatchedProvider($referenceId); | $matchedProvider = $this->getMatchedProvider($referenceId); | ||||
return $this->getReferenceByCacheKey($cacheKey); | return $this->getReferenceByCacheKey($cacheKey); | ||||
} | } | ||||
/** | |||||
* Try to get a cached reference object from a full cache key | |||||
* | |||||
* @param string $cacheKey | |||||
* @return IReference|null | |||||
*/ | |||||
public function getReferenceByCacheKey(string $cacheKey): ?IReference { | public function getReferenceByCacheKey(string $cacheKey): ?IReference { | ||||
$cached = $this->cache->get($cacheKey); | $cached = $this->cache->get($cacheKey); | ||||
if ($cached) { | if ($cached) { | ||||
return null; | return null; | ||||
} | } | ||||
/** | |||||
* Get a reference object from a reference string with a matching provider | |||||
* Use a cached reference if possible | |||||
* | |||||
* @param string $referenceId | |||||
* @return IReference|null | |||||
*/ | |||||
public function resolveReference(string $referenceId): ?IReference { | public function resolveReference(string $referenceId): ?IReference { | ||||
$matchedProvider = $this->getMatchedProvider($referenceId); | $matchedProvider = $this->getMatchedProvider($referenceId); | ||||
return null; | return null; | ||||
} | } | ||||
/** | |||||
* Try to match a reference string with all the registered providers | |||||
* Fallback to the link reference provider (using OpenGraph) | |||||
* | |||||
* @param string $referenceId | |||||
* @return IReferenceProvider|null the first matching provider | |||||
*/ | |||||
private function getMatchedProvider(string $referenceId): ?IReferenceProvider { | private function getMatchedProvider(string $referenceId): ?IReferenceProvider { | ||||
$matchedProvider = null; | $matchedProvider = null; | ||||
foreach ($this->getProviders() as $provider) { | foreach ($this->getProviders() as $provider) { | ||||
return $matchedProvider; | return $matchedProvider; | ||||
} | } | ||||
/** | |||||
* Get a hashed full cache key from a key and prefix given by a provider | |||||
* | |||||
* @param IReferenceProvider $provider | |||||
* @param string $referenceId | |||||
* @return string | |||||
*/ | |||||
private function getFullCacheKey(IReferenceProvider $provider, string $referenceId): string { | private function getFullCacheKey(IReferenceProvider $provider, string $referenceId): string { | ||||
$cacheKey = $provider->getCacheKey($referenceId); | $cacheKey = $provider->getCacheKey($referenceId); | ||||
return md5($provider->getCachePrefix($referenceId)) . ( | return md5($provider->getCachePrefix($referenceId)) . ( | ||||
); | ); | ||||
} | } | ||||
/** | |||||
* Remove a specific cache entry from its key+prefix | |||||
* | |||||
* @param string $cachePrefix | |||||
* @param string|null $cacheKey | |||||
* @return void | |||||
*/ | |||||
public function invalidateCache(string $cachePrefix, ?string $cacheKey = null): void { | public function invalidateCache(string $cachePrefix, ?string $cacheKey = null): void { | ||||
if ($cacheKey === null) { | if ($cacheKey === null) { | ||||
$this->cache->clear(md5($cachePrefix)); | $this->cache->clear(md5($cachePrefix)); | ||||
return $this->providers; | return $this->providers; | ||||
} | } | ||||
/** | |||||
* @inheritDoc | |||||
*/ | |||||
public function getDiscoverableProviders(): array { | |||||
// preserve 0 based index to avoid returning an object in data responses | |||||
return array_values( | |||||
array_filter($this->getProviders(), static function (IReferenceProvider $provider) { | |||||
return $provider instanceof IDiscoverableReferenceProvider; | |||||
}) | |||||
); | |||||
} | |||||
/** | |||||
* @inheritDoc | |||||
*/ | |||||
public function touchProvider(string $userId, string $providerId, ?int $timestamp = null): bool { | |||||
$providers = $this->getDiscoverableProviders(); | |||||
$matchingProviders = array_filter($providers, static function (IDiscoverableReferenceProvider $provider) use ($providerId) { | |||||
return $provider->getId() === $providerId; | |||||
}); | |||||
if (!empty($matchingProviders)) { | |||||
if ($timestamp === null) { | |||||
$timestamp = time(); | |||||
} | |||||
$configKey = 'provider-last-use_' . $providerId; | |||||
$this->config->setUserValue($userId, 'references', $configKey, (string) $timestamp); | |||||
return true; | |||||
} | |||||
return false; | |||||
} | |||||
/** | |||||
* @inheritDoc | |||||
*/ | |||||
public function getUserProviderTimestamps(): array { | |||||
$user = $this->userSession->getUser(); | |||||
if ($user === null) { | |||||
return []; | |||||
} | |||||
$userId = $user->getUID(); | |||||
$keys = $this->config->getUserKeys($userId, 'references'); | |||||
$prefix = 'provider-last-use_'; | |||||
$keys = array_filter($keys, static function (string $key) use ($prefix) { | |||||
return str_starts_with($key, $prefix); | |||||
}); | |||||
$timestamps = []; | |||||
foreach ($keys as $key) { | |||||
$providerId = substr($key, strlen($prefix)); | |||||
$timestamp = (int) $this->config->getUserValue($userId, 'references', $key); | |||||
$timestamps[$providerId] = $timestamp; | |||||
} | |||||
return $timestamps; | |||||
} | |||||
} | } |
<?php | |||||
declare(strict_types=1); | |||||
/** | |||||
* @copyright Copyright (c) 2022 Julien Veyssier <eneiluj@posteo.net> | |||||
* | |||||
* @author Julien Veyssier <eneiluj@posteo.net> | |||||
* | |||||
* @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 OC\Collaboration\Reference; | |||||
use OCP\Collaboration\Reference\IDiscoverableReferenceProvider; | |||||
use OCP\Collaboration\Reference\IReferenceManager; | |||||
use OCP\Collaboration\Reference\RenderReferenceEvent; | |||||
use OCP\EventDispatcher\Event; | |||||
use OCP\EventDispatcher\IEventDispatcher; | |||||
use OCP\EventDispatcher\IEventListener; | |||||
use OCP\IInitialStateService; | |||||
/** @template-implements IEventListener<Event|RenderReferenceEvent> */ | |||||
class RenderReferenceEventListener implements IEventListener { | |||||
private IReferenceManager $manager; | |||||
private IInitialStateService $initialStateService; | |||||
public function __construct(IReferenceManager $manager, IInitialStateService $initialStateService) { | |||||
$this->manager = $manager; | |||||
$this->initialStateService = $initialStateService; | |||||
} | |||||
public static function register(IEventDispatcher $eventDispatcher): void { | |||||
$eventDispatcher->addServiceListener(RenderReferenceEvent::class, RenderReferenceEventListener::class); | |||||
} | |||||
/** | |||||
* @inheritDoc | |||||
*/ | |||||
public function handle(Event $event): void { | |||||
if (!($event instanceof RenderReferenceEvent)) { | |||||
return; | |||||
} | |||||
$providers = $this->manager->getDiscoverableProviders(); | |||||
$jsonProviders = array_map(static function (IDiscoverableReferenceProvider $provider) { | |||||
return $provider->jsonSerialize(); | |||||
}, $providers); | |||||
$this->initialStateService->provideInitialState('core', 'reference-provider-list', $jsonProviders); | |||||
$timestamps = $this->manager->getUserProviderTimestamps(); | |||||
$this->initialStateService->provideInitialState('core', 'reference-provider-timestamps', $timestamps); | |||||
} | |||||
} |
<?php | |||||
declare(strict_types=1); | |||||
/** | |||||
* @copyright Copyright (c) 2022 Julien Veyssier <eneiluj@posteo.net> | |||||
* | |||||
* @author Julien Veyssier <eneiluj@posteo.net> | |||||
* | |||||
* @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 OCP\Collaboration\Reference; | |||||
use JsonSerializable; | |||||
/** | |||||
* @since 26.0.0 | |||||
*/ | |||||
abstract class ADiscoverableReferenceProvider implements IDiscoverableReferenceProvider, JsonSerializable { | |||||
/** | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function jsonSerialize(): array { | |||||
$json = [ | |||||
'id' => $this->getId(), | |||||
'title' => $this->getTitle(), | |||||
'icon_url' => $this->getIconUrl(), | |||||
'order' => $this->getOrder(), | |||||
]; | |||||
if ($this instanceof ISearchableReferenceProvider) { | |||||
$json['search_providers_ids'] = $this->getSupportedSearchProviderIds(); | |||||
} | |||||
return $json; | |||||
} | |||||
} |
<?php | |||||
declare(strict_types=1); | |||||
/** | |||||
* @copyright Copyright (c) 2022 Julien Veyssier <eneiluj@posteo.net> | |||||
* | |||||
* @author Julien Veyssier <eneiluj@posteo.net> | |||||
* | |||||
* @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 OCP\Collaboration\Reference; | |||||
/** | |||||
* @since 26.0.0 | |||||
*/ | |||||
interface IDiscoverableReferenceProvider extends IReferenceProvider { | |||||
/** | |||||
* @return string Unique id that identifies the reference provider | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function getId(): string; | |||||
/** | |||||
* @return string User facing title of the widget | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function getTitle(): string; | |||||
/** | |||||
* @return int Initial order for reference provider sorting | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function getOrder(): int; | |||||
/** | |||||
* @return string url to an icon that can be displayed next to the reference provider title | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function getIconUrl(): string; | |||||
/** | |||||
* @return array representation of the provider | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function jsonSerialize(): array; | |||||
} |
* @since 25.0.0 | * @since 25.0.0 | ||||
*/ | */ | ||||
public function invalidateCache(string $cachePrefix, ?string $cacheKey = null): void; | public function invalidateCache(string $cachePrefix, ?string $cacheKey = null): void; | ||||
/** | |||||
* Get information on discoverable reference providers (id, title, icon and order) | |||||
* If the provider is searchable, also get the list of supported unified search providers | |||||
* | |||||
* @return IDiscoverableReferenceProvider[] | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function getDiscoverableProviders(): array; | |||||
/** | |||||
* Update or set the last used timestamp for a provider | |||||
* | |||||
* @param string $userId | |||||
* @param string $providerId | |||||
* @param int|null $timestamp use current timestamp if null | |||||
* @return bool | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function touchProvider(string $userId, string $providerId, ?int $timestamp = null): bool; | |||||
/** | |||||
* Get all known last used timestamps for reference providers | |||||
* | |||||
* @return int[] | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function getUserProviderTimestamps(): array; | |||||
} | } |
<?php | |||||
declare(strict_types=1); | |||||
/** | |||||
* @copyright Copyright (c) 2022 Julien Veyssier <eneiluj@posteo.net> | |||||
* | |||||
* @author Julien Veyssier <eneiluj@posteo.net> | |||||
* | |||||
* @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 OCP\Collaboration\Reference; | |||||
/** | |||||
* @since 26.0.0 | |||||
*/ | |||||
interface ISearchableReferenceProvider extends IDiscoverableReferenceProvider { | |||||
/** | |||||
* @return string[] list of search provider IDs that can be used by the vue-richtext picker | |||||
* @since 26.0.0 | |||||
*/ | |||||
public function getSupportedSearchProviderIds(): array; | |||||
} |