From b591fa95ae1e89abcbbfaf4c96ff7db4e588cc2c Mon Sep 17 00:00:00 2001
From: Aditya Chandel <8075870+adityachandelgit@users.noreply.github.com>
Date: Sun, 5 Oct 2025 14:08:37 -0600
Subject: [PATCH] Add OPDS setup and usage documentation (#1274)

---
 .../src/app/settings/opds-settings-v2/opds-settings-v2.html | 6 ++++++
 .../src/app/settings/opds-settings-v2/opds-settings-v2.scss | 5 +++++
 .../src/app/settings/opds-settings-v2/opds-settings-v2.ts   | 4 ++++
 3 files changed, 15 insertions(+)

diff --git a/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.html b/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.html
index 502182df..d7de68a0 100644
--- a/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.html
+++ b/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.html
@@ -3,6 +3,12 @@
     <h2 class="settings-title">
       <i class="pi pi-server"></i>
       OPDS Settings (New)
+      <i class="pi pi-external-link external-link-icon"
+         pTooltip="Click to view OPDS setup documentation"
+         tooltipPosition="right"
+         (click)="navigateToOpdsDoc()"
+         style="cursor: pointer;">
+      </i>
     </h2>
     <p class="settings-description">
       Manage your OPDS credentials and control how your book collection is shared with reading apps.
diff --git a/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.scss b/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.scss
index 1cf145cb..0675ec01 100644
--- a/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.scss
+++ b/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.scss
@@ -34,6 +34,11 @@
     color: var(--p-primary-color);
     font-size: 1.25rem;
   }
+
+  .external-link-icon {
+    color: #0ea5e9 !important;
+    font-size: 0.875rem !important;
+  }
 }
 
 .settings-description {
diff --git a/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.ts b/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.ts
index d0b2e5f2..29af37e5 100644
--- a/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.ts
+++ b/booklore-ui/src/app/settings/opds-settings-v2/opds-settings-v2.ts
@@ -203,6 +203,10 @@ export class OpdsSettingsV2 implements OnInit, OnDestroy {
     this.messageService.add({severity, summary, detail});
   }
 
+  navigateToOpdsDoc(): void {
+    window.open('https://booklore-app.github.io/booklore-docs/docs/integration/opds', '_blank');
+  }
+
   ngOnDestroy(): void {
     this.destroy$.next();
     this.destroy$.complete();