docs(oauth): add link to oauth documentation

Signed-off-by: Daniel Kesselberg <[email protected]>

Author: kesselb

lib/Settings/AdminSettings.php

@@ -17,6 +17,7 @@
 use OCA\Mail\Service\Classification\ClassificationSettingsService;
 use OCA\Mail\Service\Provisioning\Manager as ProvisioningManager;
 use OCP\AppFramework\Http\TemplateResponse;
+use OCP\Defaults;
 use OCP\IConfig;
 use OCP\IInitialStateService;
 use OCP\LDAP\ILDAPProvider;
@@ -40,14 +41,17 @@ class AdminSettings implements ISettings {
 	private AiIntegrationsService $aiIntegrationsService;
 	private ClassificationSettingsService $classificationSettingsService;
 
-	public function __construct(IInitialStateService $initialStateService,
+	public function __construct(
+		IInitialStateService $initialStateService,
 		ProvisioningManager $provisioningManager,
 		AntiSpamService $antiSpamService,
 		GoogleIntegration $googleIntegration,
 		MicrosoftIntegration $microsoftIntegration,
 		IConfig $config,
 		AiIntegrationsService $aiIntegrationsService,
-		ClassificationSettingsService $classificationSettingsService) {
+		ClassificationSettingsService $classificationSettingsService,
+		private Defaults $themingDefaults,
+	) {
 		$this->initialStateService = $initialStateService;
 		$this->provisioningManager = $provisioningManager;
 		$this->antiSpamService = $antiSpamService;
@@ -138,6 +142,11 @@ static function () {
 			'microsoft_oauth_redirect_url',
 			$this->microsoftIntegration->getRedirectUrl(),
 		);
+		$this->initialStateService->provideInitialState(
+			Application::APP_ID,
+			'microsoft_oauth_docs',
+			$this->themingDefaults->buildDocLinkToKey('admin-groupware-oauth-microsoft'),
+		);
 
 		$this->initialStateService->provideInitialState(
 			Application::APP_ID,

src/components/settings/AdminSettings.vue

@@ -223,33 +223,16 @@
 		</div>
 		<div class="app-description">
 			<h3>
-				{{
-					t(
-						'mail',
-						'Microsoft integration'
-					)
-				}}
+				{{ t('mail', 'Microsoft integration') }}
 			</h3>
 			<article>
 				<p>
-					{{
-						t(
-							'mail',
-							'Microsoft allows users to access their email via IMAP. For security reasons this access is only possible with an OAuth 2.0 connection.'
-						)
-					}}
+					{{ t('mail', 'Microsoft requires you to access your emails via IMAP using OAuth 2.0 authentication. To do this, you need to register an app with Microsoft Entra ID, formerly known as Microsoft Azure Active Directory.') }}
 				</p>
 				<p>
-					{{
-						t(
-							'mail',
-							'You have to register a new app in the Microsoft Azure Active Directory portal. Add the URL {url} as redirect URI.',
-							{
-								url: microsoftOauthRedirectUrl,
-							}
-						)
-					}}
+					{{ t('mail', 'Redirect URI') }}: <code>{{ microsoftOauthRedirectUrl }}</code>
 				</p>
+				<a :href="microsoftOauthDocs" target="_blank" rel="noopener noreferrer">{{ t('mail', 'For more details, please click here to open our documentation.') }}</a>
 			</article>
 			<MicrosoftAdminOauthSettings :tenant-id="microsoftOauthTenantId" :client-id="microsoftOauthClientId" />
 		</div>
@@ -345,6 +328,7 @@ export default {
 			googleOauthRedirectUrl,
 			microsoftOauthTenantId,
 			microsoftOauthClientId,
+			microsoftOauthDocs: loadState('mail', 'microsoft_oauth_docs'),
 			microsoftOauthRedirectUrl,
 			preview: {
 				provisioningDomain: '',