feat(dashboard): added new FavouriteWidget to display favorite files in dashboard widget

* Added widget star icon
* run build/autoloaderchecker.sh
* removed unwanted IWidget and usersession
* renamed id
* renamed class to FavoriteWidget
* removed limit logic
* removed IAPIWidget
* ui fixes to remove rounded corners and make the ui/ux similar to recommendation widget.
* cs fix + composer fix no dev and review comments from Joas and Côme addressed
* added count and removed slice

Signed-off-by: yemkareems <yemkareems@gmail.com>
Co-authored-by: Ferdinand Thiessen <opensource@fthiessen.de>
Co-authored-by: Kate <26026535+provokateurin@users.noreply.github.com>

2 files changed, 138 insertions, 0 deletions

diff --git a/apps/files/lib/AppInfo/Application.php b/apps/files/lib/AppInfo/Application.php
index 84387983946..8d00912f7bb 100644
--- a/apps/files/lib/AppInfo/Application.php
+++ b/apps/files/lib/AppInfo/Application.php
@@ -13,6 +13,7 @@ use OCA\Files\Capabilities;
 use OCA\Files\Collaboration\Resources\Listener;
 use OCA\Files\Collaboration\Resources\ResourceProvider;
 use OCA\Files\Controller\ApiController;
+use OCA\Files\Dashboard\FavoriteWidget;
 use OCA\Files\DirectEditingCapabilities;
 use OCA\Files\Event\LoadSearchPlugins;
 use OCA\Files\Event\LoadSidebar;
@@ -123,6 +124,7 @@ class Application extends App implements IBootstrap {
 		$context->registerSearchProvider(FilesSearchProvider::class);
 
 		$context->registerNotifierService(Notifier::class);
+		$context->registerDashboardWidget(FavoriteWidget::class);
 	}
 
 	public function boot(IBootContext $context): void {
diff --git a/apps/files/lib/Dashboard/FavoriteWidget.php b/apps/files/lib/Dashboard/FavoriteWidget.php
new file mode 100644
index 00000000000..a36dd65c81b
--- /dev/null
+++ b/apps/files/lib/Dashboard/FavoriteWidget.php
@@ -0,0 +1,136 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Files\Dashboard;
+
+use OCA\Files\AppInfo\Application;
+use OCP\Dashboard\IAPIWidgetV2;
+use OCP\Dashboard\IButtonWidget;
+use OCP\Dashboard\IIconWidget;
+use OCP\Dashboard\IOptionWidget;
+use OCP\Dashboard\Model\WidgetButton;
+use OCP\Dashboard\Model\WidgetItem;
+use OCP\Dashboard\Model\WidgetItems;
+use OCP\Dashboard\Model\WidgetOptions;
+use OCP\Files\IMimeTypeDetector;
+use OCP\Files\IRootFolder;
+use OCP\IL10N;
+use OCP\IPreview;
+use OCP\ITagManager;
+use OCP\IURLGenerator;
+use OCP\IUserManager;
+
+class FavoriteWidget implements IIconWidget, IAPIWidgetV2, IButtonWidget, IOptionWidget {
+
+	public function __construct(
+		private readonly IL10N $l10n,
+		private readonly IURLGenerator $urlGenerator,
+		private readonly IMimeTypeDetector $mimeTypeDetector,
+		private readonly IUserManager $userManager,
+		private readonly ITagManager $tagManager,
+		private readonly IRootFolder $rootFolder,
+		private readonly IPreview $previewManager,
+	) {
+	}
+
+	public function getId(): string {
+		return Application::APP_ID . '-favorites';
+	}
+
+	public function getTitle(): string {
+		return $this->l10n->t('Favorite files');
+	}
+
+	public function getOrder(): int {
+		return 0;
+	}
+
+	public function getIconClass(): string {
+		return 'icon-star-dark';
+	}
+
+	public function getIconUrl(): string {
+		return $this->urlGenerator->getAbsoluteURL(
+			$this->urlGenerator->imagePath('core', 'actions/star.svg')
+		);
+	}
+
+	public function getUrl(): ?string {
+		return $this->urlGenerator->linkToRouteAbsolute('files.View.indexView', ['view' => 'favorites']);
+	}
+
+	public function load(): void {
+	}
+
+	public function getItems(string $userId, int $limit = 7): array {
+		$user = $this->userManager->get($userId);
+
+		if (!$user) {
+			return [];
+		}
+		$tags = $this->tagManager->load('files', [], false, $userId);
+		$favorites = $tags->getFavorites();
+		if (empty($favorites)) {
+			return [];
+		}
+		$favoriteNodes = [];
+		$userFolder = $this->rootFolder->getUserFolder($userId);
+		$count = 0;
+		foreach ($favorites as $favorite) {
+			$node = $userFolder->getFirstNodeById($favorite);
+			if ($node) {
+				$url = $this->urlGenerator->linkToRouteAbsolute(
+					'files.view.showFile', ['fileid' => $node->getId()]
+				);
+				$icon = $this->urlGenerator->linkToRouteAbsolute('core.Preview.getPreviewByFileId', [
+					'x' => 256,
+					'y' => 256,
+					'fileId' => $node->getId(),
+					'c' => $node->getEtag(),
+					'mimeFallback' => true,
+				]);
+				$favoriteNodes[] = new WidgetItem(
+					$node->getName(),
+					'',
+					$url,
+					$icon,
+					(string)$node->getCreationTime()
+				);
+				$count++;
+				if ($count >= $limit) {
+					break;
+				}
+			}
+		}
+
+		return $favoriteNodes;
+	}
+
+	public function getItemsV2(string $userId, ?string $since = null, int $limit = 7): WidgetItems {
+		$items = $this->getItems($userId, $limit);
+		return new WidgetItems(
+			$items,
+			count($items) === 0 ? $this->l10n->t('No favorites') : '',
+		);
+	}
+
+	public function getWidgetButtons(string $userId): array {
+		return [
+			new WidgetButton(
+				WidgetButton::TYPE_MORE,
+				$this->urlGenerator->linkToRouteAbsolute('files.View.indexView', ['view' => 'favorites']),
+				$this->l10n->t('More favorites')
+			),
+		];
+	}
+
+	public function getWidgetOptions(): WidgetOptions {
+		return new WidgetOptions(roundItemIcons: false);
+	}
+}