feat(settings): add Administration Previews page

apps/settings/appinfo/info.xml

@@ -33,6 +33,7 @@
 		<admin>OCA\Settings\Settings\Admin\ArtificialIntelligence</admin>
 		<admin>OCA\Settings\Settings\Admin\Server</admin>
 		<admin>OCA\Settings\Settings\Admin\Sharing</admin>
+		<admin>OCA\Settings\Settings\Admin\Previews</admin>
 		<admin>OCA\Settings\Settings\Admin\Security</admin>
 		<admin>OCA\Settings\Settings\Admin\Delegation</admin>
 		<admin-section>OCA\Settings\Sections\Admin\Additional</admin-section>
@@ -45,6 +46,7 @@
 		<admin-section>OCA\Settings\Sections\Admin\Security</admin-section>
 		<admin-section>OCA\Settings\Sections\Admin\Server</admin-section>
 		<admin-section>OCA\Settings\Sections\Admin\Sharing</admin-section>
+		<admin-section>OCA\Settings\Sections\Admin\Previews</admin-section>
 		<admin-delegation>OCA\Settings\Settings\Admin\Users</admin-delegation>
 		<admin-delegation-section>OCA\Settings\Sections\Admin\Users</admin-delegation-section>
 		<personal>OCA\Settings\Settings\Personal\Additional</personal>

apps/settings/composer/composer/autoload_classmap.php

@@ -33,6 +33,7 @@
     'OCA\\Settings\\Controller\\MailSettingsController' => $baseDir . '/../lib/Controller/MailSettingsController.php',
     'OCA\\Settings\\Controller\\PersonalSettingsController' => $baseDir . '/../lib/Controller/PersonalSettingsController.php',
     'OCA\\Settings\\Controller\\PresetController' => $baseDir . '/../lib/Controller/PresetController.php',
+    'OCA\\Settings\\Controller\\PreviewAdminController' => $baseDir . '/../lib/Controller/PreviewAdminController.php',
     'OCA\\Settings\\Controller\\ReasonsController' => $baseDir . '/../lib/Controller/ReasonsController.php',
     'OCA\\Settings\\Controller\\TwoFactorSettingsController' => $baseDir . '/../lib/Controller/TwoFactorSettingsController.php',
     'OCA\\Settings\\Controller\\UsersController' => $baseDir . '/../lib/Controller/UsersController.php',
@@ -57,6 +58,7 @@
     'OCA\\Settings\\Sections\\Admin\\Office' => $baseDir . '/../lib/Sections/Admin/Office.php',
     'OCA\\Settings\\Sections\\Admin\\Overview' => $baseDir . '/../lib/Sections/Admin/Overview.php',
     'OCA\\Settings\\Sections\\Admin\\Presets' => $baseDir . '/../lib/Sections/Admin/Presets.php',
+    'OCA\\Settings\\Sections\\Admin\\Previews' => $baseDir . '/../lib/Sections/Admin/Previews.php',
     'OCA\\Settings\\Sections\\Admin\\Security' => $baseDir . '/../lib/Sections/Admin/Security.php',
     'OCA\\Settings\\Sections\\Admin\\Server' => $baseDir . '/../lib/Sections/Admin/Server.php',
     'OCA\\Settings\\Sections\\Admin\\Sharing' => $baseDir . '/../lib/Sections/Admin/Sharing.php',
@@ -77,6 +79,7 @@
     'OCA\\Settings\\Settings\\Admin\\MailProvider' => $baseDir . '/../lib/Settings/Admin/MailProvider.php',
     'OCA\\Settings\\Settings\\Admin\\Overview' => $baseDir . '/../lib/Settings/Admin/Overview.php',
     'OCA\\Settings\\Settings\\Admin\\Presets' => $baseDir . '/../lib/Settings/Admin/Presets.php',
+    'OCA\\Settings\\Settings\\Admin\\Previews' => $baseDir . '/../lib/Settings/Admin/Previews.php',
     'OCA\\Settings\\Settings\\Admin\\Security' => $baseDir . '/../lib/Settings/Admin/Security.php',
     'OCA\\Settings\\Settings\\Admin\\Server' => $baseDir . '/../lib/Settings/Admin/Server.php',
     'OCA\\Settings\\Settings\\Admin\\Sharing' => $baseDir . '/../lib/Settings/Admin/Sharing.php',

apps/settings/composer/composer/autoload_static.php

@@ -48,6 +48,7 @@ class ComposerStaticInitSettings
         'OCA\\Settings\\Controller\\MailSettingsController' => __DIR__ . '/..' . '/../lib/Controller/MailSettingsController.php',
         'OCA\\Settings\\Controller\\PersonalSettingsController' => __DIR__ . '/..' . '/../lib/Controller/PersonalSettingsController.php',
         'OCA\\Settings\\Controller\\PresetController' => __DIR__ . '/..' . '/../lib/Controller/PresetController.php',
+        'OCA\\Settings\\Controller\\PreviewAdminController' => __DIR__ . '/..' . '/../lib/Controller/PreviewAdminController.php',
         'OCA\\Settings\\Controller\\ReasonsController' => __DIR__ . '/..' . '/../lib/Controller/ReasonsController.php',
         'OCA\\Settings\\Controller\\TwoFactorSettingsController' => __DIR__ . '/..' . '/../lib/Controller/TwoFactorSettingsController.php',
         'OCA\\Settings\\Controller\\UsersController' => __DIR__ . '/..' . '/../lib/Controller/UsersController.php',
@@ -72,6 +73,7 @@ class ComposerStaticInitSettings
         'OCA\\Settings\\Sections\\Admin\\Office' => __DIR__ . '/..' . '/../lib/Sections/Admin/Office.php',
         'OCA\\Settings\\Sections\\Admin\\Overview' => __DIR__ . '/..' . '/../lib/Sections/Admin/Overview.php',
         'OCA\\Settings\\Sections\\Admin\\Presets' => __DIR__ . '/..' . '/../lib/Sections/Admin/Presets.php',
+        'OCA\\Settings\\Sections\\Admin\\Previews' => __DIR__ . '/..' . '/../lib/Sections/Admin/Previews.php',
         'OCA\\Settings\\Sections\\Admin\\Security' => __DIR__ . '/..' . '/../lib/Sections/Admin/Security.php',
         'OCA\\Settings\\Sections\\Admin\\Server' => __DIR__ . '/..' . '/../lib/Sections/Admin/Server.php',
         'OCA\\Settings\\Sections\\Admin\\Sharing' => __DIR__ . '/..' . '/../lib/Sections/Admin/Sharing.php',
@@ -92,6 +94,7 @@ class ComposerStaticInitSettings
         'OCA\\Settings\\Settings\\Admin\\MailProvider' => __DIR__ . '/..' . '/../lib/Settings/Admin/MailProvider.php',
         'OCA\\Settings\\Settings\\Admin\\Overview' => __DIR__ . '/..' . '/../lib/Settings/Admin/Overview.php',
         'OCA\\Settings\\Settings\\Admin\\Presets' => __DIR__ . '/..' . '/../lib/Settings/Admin/Presets.php',
+        'OCA\\Settings\\Settings\\Admin\\Previews' => __DIR__ . '/..' . '/../lib/Settings/Admin/Previews.php',
         'OCA\\Settings\\Settings\\Admin\\Security' => __DIR__ . '/..' . '/../lib/Settings/Admin/Security.php',
         'OCA\\Settings\\Settings\\Admin\\Server' => __DIR__ . '/..' . '/../lib/Settings/Admin/Server.php',
         'OCA\\Settings\\Settings\\Admin\\Sharing' => __DIR__ . '/..' . '/../lib/Settings/Admin/Sharing.php',

apps/settings/lib/Controller/PreviewAdminController.php

@@ -0,0 +1,112 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Settings\Controller;
+
+use OC\Preview\PreviewAdminConfig;
+use OCA\Settings\Settings\Admin\Previews;
+use OCP\AppFramework\Http;
+use OCP\AppFramework\Http\Attribute\ApiRoute;
+use OCP\AppFramework\Http\Attribute\AuthorizedAdminSetting;
+use OCP\AppFramework\Http\Attribute\OpenAPI;
+use OCP\AppFramework\Http\Attribute\PasswordConfirmationRequired;
+use OCP\AppFramework\Http\DataResponse;
+use OCP\AppFramework\OCS\OCSBadRequestException;
+use OCP\AppFramework\OCSController;
+use OCP\Http\Client\IClientService;
+use OCP\IRequest;
+use Psr\Log\LoggerInterface;
+
+#[OpenAPI(scope: OpenAPI::SCOPE_ADMINISTRATION)]
+class PreviewAdminController extends OCSController {
+	public function __construct(
+		string $appName,
+		IRequest $request,
+		private PreviewAdminConfig $previewAdminConfig,
+		private IClientService $clientService,
+		private LoggerInterface $logger,
+	) {
+		parent::__construct($appName, $request);
+	}
+
+	/**
+	 * Update preview administration settings
+	 *
+	 * @param array<string, mixed> $settings Preview settings to persist
+	 * @return DataResponse<Http::STATUS_OK, array<string, mixed>, array{}>
+	 * @throws OCSBadRequestException Invalid settings payload
+	 *
+	 * 200: Settings saved
+	 */
+	#[AuthorizedAdminSetting(settings: Previews::class)]
+	#[PasswordConfirmationRequired]
+	#[ApiRoute(verb: 'PUT', url: '/api/admin/previews')]
+	public function update(array $settings): DataResponse {
+		try {
+			$this->previewAdminConfig->setSettings($settings);
+		} catch (\InvalidArgumentException $e) {
+			throw new OCSBadRequestException($e->getMessage());
+		}
+
+		return new DataResponse($this->previewAdminConfig->getSettings());
+	}
+
+	/**
+	 * Test connectivity to an Imaginary preview service
+	 *
+	 * @param string|null $url Imaginary base URL
+	 * @param string|null $key Optional Imaginary API key
+	 * @return DataResponse<Http::STATUS_OK, array{status: string, httpCode?: int, error?: string}, array{}>
+	 * @throws OCSBadRequestException Invalid URL
+	 *
+	 * 200: Connection test completed
+	 */
+	#[AuthorizedAdminSetting(settings: Previews::class)]
+	#[ApiRoute(verb: 'POST', url: '/api/admin/previews/imaginary/test')]
+	public function testImaginary(?string $url = null, ?string $key = null): DataResponse {
+		try {
+			$target = $this->previewAdminConfig->validateImaginaryUrl($url ?? '');
+		} catch (\InvalidArgumentException $e) {
+			throw new OCSBadRequestException($e->getMessage());
+		}
+
+		if ($target === '') {
+			return new DataResponse([
+				'status' => 'unconfigured',
+			]);
+		}
+
+		try {
+			$client = $this->clientService->newClient();
+			$options = [
+				'timeout' => 3,
+				'connect_timeout' => 3,
+				'nextcloud' => ['allow_local_address' => true],
+			];
+			if (is_string($key) && $key !== '') {
+				$options['query'] = ['key' => $key];
+			}
+			$response = $client->get($target, $options);
+			$statusCode = $response->getStatusCode();
+			$reachable = $statusCode >= 200 && $statusCode < 500;
+			return new DataResponse([
+				'status' => $reachable ? 'reachable' : 'unreachable',
+				'httpCode' => $statusCode,
+			]);
+		} catch (\Throwable $e) {
+			$this->logger->info('Imaginary connection test failed', [
+				'exception' => $e,
+			]);
+			return new DataResponse([
+				'status' => 'unreachable',
+				'error' => $e->getMessage(),
+			]);
+		}
+	}
+}

apps/settings/lib/Sections/Admin/Previews.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Settings\Sections\Admin;
+
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\Settings\IIconSection;
+
+class Previews implements IIconSection {
+	public function __construct(
+		private IL10N $l,
+		private IURLGenerator $urlGenerator,
+	) {
+	}
+
+	#[\Override]
+	public function getIcon(): string {
+		return $this->urlGenerator->imagePath('settings', 'previews.svg');
+	}
+
+	#[\Override]
+	public function getID(): string {
+		return 'previews';
+	}
+
+	#[\Override]
+	public function getName(): string {
+		return $this->l->t('Previews');
+	}
+
+	#[\Override]
+	public function getPriority(): int {
+		return 6;
+	}
+}

apps/settings/lib/Settings/Admin/Previews.php

@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Settings\Settings\Admin;
+
+use OC\Preview\PreviewAdminConfig;
+use OCP\AppFramework\Http\TemplateResponse;
+use OCP\AppFramework\Services\IInitialState;
+use OCP\Settings\IDelegatedSettings;
+use OCP\Util;
+
+class Previews implements IDelegatedSettings {
+	public function __construct(
+		private PreviewAdminConfig $previewAdminConfig,
+		private IInitialState $initialState,
+		private string $appName,
+	) {
+	}
+
+	#[\Override]
+	public function getForm(): TemplateResponse {
+		$this->initialState->provideInitialState('previewsSettings', $this->previewAdminConfig->getSettings());
+		$this->initialState->provideInitialState('previewsDocumentation', 'https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/previews_configuration.html');
+
+		Util::addScript($this->appName, 'vue-settings-admin-previews');
+		return new TemplateResponse($this->appName, 'settings/admin/previews', [], '');
+	}
+
+	#[\Override]
+	public function getSection(): string {
+		return 'previews';
+	}
+
+	#[\Override]
+	public function getPriority(): int {
+		return 0;
+	}
+
+	#[\Override]
+	public function getAuthorizedAppConfig(): array {
+		return [
+			'preview' => ['/jpeg_quality/', '/webp_quality/'],
+		];
+	}
+
+	#[\Override]
+	public function getName(): ?string {
+		return null;
+	}
+}

apps/settings/src/admin-settings-previews.ts

@@ -0,0 +1,13 @@
+/*!
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+import Vue from 'vue'
+import AdminSettingsPreviews from './views/AdminSettingsPreviews.vue'
+
+export default new Vue({
+	name: 'AdminSettingsPreviewsSection',
+	el: '#vue-admin-settings-previews',
+	render: (h) => h(AdminSettingsPreviews),
+})