make Forms available in unified search

Signed-off-by: Christian Hartmann <[email protected]>

lib/AppInfo/Application.php

@@ -14,6 +14,7 @@
 use OCA\Forms\FormsMigrator;
 use OCA\Forms\Listener\AnalyticsDatasourceListener;
 use OCA\Forms\Listener\UserDeletedListener;
+use OCA\Forms\Search\SearchProvider;
 use OCP\AppFramework\App;
 use OCP\AppFramework\Bootstrap\IBootContext;
 use OCP\AppFramework\Bootstrap\IBootstrap;
@@ -42,6 +43,7 @@ public function register(IRegistrationContext $context): void {
 		$context->registerCapability(Capabilities::class);
 		$context->registerEventListener(UserDeletedEvent::class, UserDeletedListener::class);
 		$context->registerEventListener(DatasourceEvent::class, AnalyticsDatasourceListener::class);
+		$context->registerSearchProvider(SearchProvider::class);
 		$context->registerUserMigrator(FormsMigrator::class);
 	}
 

lib/Db/FormMapper.php

@@ -97,9 +97,10 @@ public function findByHash(string $hash): Form {
 	 * @param string[] $groups IDs of groups the user is memeber of
 	 * @param string[] $teams IDs of teams the user is memeber of
 	 * @param bool $filterShown Set to false to also include forms shared but not visible on sidebar
+	 * @param string $queryTerm optional: The search query for universal search
 	 * @return Form[]
 	 */
-	public function findSharedForms(string $userId, array $groups = [], array $teams = [], bool $filterShown = true): array {
+	public function findSharedForms(string $userId, array $groups = [], array $teams = [], bool $filterShown = true, ?string $queryTerm = null): array {
 		$qbShares = $this->db->getQueryBuilder();
 		$qbForms = $this->db->getQueryBuilder();
 
@@ -156,16 +157,22 @@ public function findSharedForms(string $userId, array $groups = [], array $teams
 			->addOrderBy('last_updated', 'DESC')
 			->addOrderBy('created', 'DESC');
 
+		if ($queryTerm) {
+			$qbForms->andWhere($qbForms->expr()->like('title', $qbForms->createNamedParameter('%' . $queryTerm . '%')) .
+				' OR ' . $qbForms->expr()->like('description', $qbForms->createNamedParameter('%' . $queryTerm . '%')));
+		}
+
 		// We need to add the parameters from the shared forms IDs select to the final select query
 		$qbForms->setParameters($qbShares->getParameters(), $qbShares->getParameterTypes());
 
 		return $this->findEntities($qbForms);
 	}
 
 	/**
+	 * @param string $queryTerm optional: The search query for universal search
 	 * @return Form[]
 	 */
-	public function findAllByOwnerId(string $ownerId): array {
+	public function findAllByOwnerId(string $ownerId, ?string $queryTerm = null): array {
 		$qb = $this->db->getQueryBuilder();
 
 		$qb->select('*')
@@ -177,6 +184,11 @@ public function findAllByOwnerId(string $ownerId): array {
 			->addOrderBy('last_updated', 'DESC')
 			->addOrderBy('created', 'DESC');
 
+		if ($queryTerm) {
+			$qb->andWhere($qb->expr()->like('title', $qb->createNamedParameter('%' . $queryTerm . '%')) .
+				' OR ' . $qb->expr()->like('description', $qb->createNamedParameter('%' . $queryTerm . '%')));
+		}
+
 		return $this->findEntities($qb);
 	}
 

lib/Search/FormsSearchResultEntry.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2025 Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Forms\Search;
+
+use OCA\Forms\Db\Form;
+use OCP\Search\SearchResultEntry;
+
+class FormsSearchResultEntry extends SearchResultEntry {
+	public function __construct(Form $form, string $formUrl) {
+		parent::__construct('', $form->getTitle(), $form->getDescription(), $formUrl, 'forms-dark');
+	}
+}

lib/Search/SearchProvider.php

@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2025 Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Forms\Search;
+
+use OCA\Forms\AppInfo\Application;
+use OCA\Forms\Db\Form;
+use OCA\Forms\Service\FormsService;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\IUser;
+use OCP\Search\IProvider;
+use OCP\Search\ISearchQuery;
+use OCP\Search\SearchResult;
+
+class SearchProvider implements IProvider {
+	/**
+	 * @psalm-suppress PossiblyUnusedMethod
+	 */
+	public function __construct(
+		private IL10N $l10n,
+		private IURLGenerator $urlGenerator,
+		private FormsService $formsService,
+	) {
+	}
+
+	public function getId(): string {
+		return 'forms';
+	}
+
+	public function getName(): string {
+		return $this->l10n->t('Forms');
+	}
+
+	public function search(IUser $user, ISearchQuery $query): SearchResult {
+		$forms = $this->formsService->search($query);
+
+		$results = array_map(function (Form $form) {
+			$formUrl = $this->urlGenerator->linkToRoute('forms.page.views', ['hash' => $form->getHash(), 'view' => 'submit']);
+			return [
+				'object' => $form,
+				'entry' => new FormsSearchResultEntry($form, $formUrl)
+			];
+		}, $forms);
+
+		$resultEntries = array_map(function (array $result) {
+			return $result['entry'];
+		}, $results);
+
+		return SearchResult::complete(
+			$this->l10n->t('Forms'),
+			$resultEntries
+		);
+	}
+
+	public function getOrder(string $route, array $routeParameters): int {
+		if (str_contains($route, Application::APP_ID)) {
+			// Active app, prefer my results
+			return -1;
+		}
+		return 77;
+	}
+}

lib/Service/FormsService.php

@@ -29,6 +29,7 @@
 use OCP\IUser;
 use OCP\IUserManager;
 use OCP\IUserSession;
+use OCP\Search\ISearchQuery;
 use OCP\Security\ISecureRandom;
 use OCP\Share\IShare;
 
@@ -698,6 +699,33 @@ public function areExtraSettingsValid(array $extraSettings, string $questionType
 		return true;
 	}
 
+	/**
+	 * Get list of forms
+	 *
+	 * @param ISearchQuery $query the query to search the forms
+	 * @return Form[] list of forms that match the query
+	 */
+	public function search(ISearchQuery $query): array {
+		$formsList = [];
+		$groups = $this->groupManager->getUserGroupIds($this->currentUser);
+		$teams = $this->circlesService->getUserTeamIds($this->currentUser->getUID());
+
+		try {
+			$ownedForms = $this->formMapper->findAllByOwnerId($this->currentUser->getUID(), $query->getTerm());
+			$sharedForms = $this->formMapper->findSharedForms(
+				$this->currentUser->getUID(),
+				$groups,
+				$teams,
+				true,
+				$query->getTerm()
+			);
+			$formsList = array_merge($ownedForms, $sharedForms);
+		} catch (DoesNotExistException $e) {
+			// silent catch
+		}
+		return $formsList;
+	}
+
 	public function getFilePath(Form $form): ?string {
 		$fileId = $form->getFileId();