From 50acb9957e81f75bb28747ad1434132c3c5cb752 Mon Sep 17 00:00:00 2001
From: Cees Bos <dev@ceesbos.nl>
Date: Wed, 19 Mar 2025 22:25:34 +0100
Subject: [PATCH 1/3] Add Linkding support

---
 docs/customservices.md               | 22 +++++++++
 src/components/services/Linkding.vue | 68 ++++++++++++++++++++++++++++
 2 files changed, 90 insertions(+)
 create mode 100644 src/components/services/Linkding.vue

diff --git a/docs/customservices.md b/docs/customservices.md
index 7ddaaaa..8274546 100644
--- a/docs/customservices.md
+++ b/docs/customservices.md
@@ -25,6 +25,7 @@ within Homer:
 - [Immich](#immich)
 - [Jellystat](#jellystat)
 - [Lidarr, Prowlarr, Sonarr, Readarr and Radarr](#lidarr-prowlarr-sonarr-readarr-and-radarr)
+- [Linkding](#linkding)
 - [Mealie](#mealie)
 - [Medusa](#medusa)
 - [Nextcloud](#nextcloud)
@@ -276,6 +277,27 @@ If you are using an older version of Radarr or Sonarr which don't support the ne
   legacyApi: true
 ```
 
+## Linkding
+
+This integration makes it possible to query Linkding and list multiple results from Linkding.   
+Linkding has to be configured with CORS enabled. Linkding does not support that, but a reverse proxy in front can fix that.   
+For example if you use Traefik, documentation about that is here: https://doc.traefik.io/traefik/middlewares/http/headers/#cors-headers   
+Examples for various servers can be found at https://enable-cors.org/server.html.   
+
+This integration supports at max 15 results from Linkding. But you can add it multiple times to you dashboard with different queries to retrieve what you need.
+
+```yaml
+      - name: "Linkding"
+        # Url to Linkding instance
+        url: https://ld.ceesbos.nl
+        token: "<add your secret token here>"
+        type: "Linkding"
+        # Maximum number of items returned by Linkding, minimal 1 and max 15
+        limit: 10 
+        # query to do on Linkding. User #tagname to search for tags
+        query: "#ToDo #Homer" 
+```
+
 ## Mealie
 
 First off make sure to remove an existing `subtitle` as it will take precedence if set. 
diff --git a/src/components/services/Linkding.vue b/src/components/services/Linkding.vue
new file mode 100644
index 0000000..840650a
--- /dev/null
+++ b/src/components/services/Linkding.vue
@@ -0,0 +1,68 @@
+<template>
+  <template v-for="bookmark in bookmarks">
+      <Generic :item="bookmark">
+    </Generic>
+  </template>
+</template>
+
+<script>
+import service from "@/mixins/service.js";
+import Generic from "./Generic.vue";
+
+export default {
+  name: "Linkding",
+  components: {
+    Generic,
+  },
+  mixins: [service],
+  props: {
+    item: Object
+  },
+  data: () => ({
+    bookmarks: [],
+  }),
+  computed: {
+    calculatedLimit: function () {
+      let limit = this.item.hasOwnProperty('limit') ? this.item['limit'] : 5;
+      return Math.min(Math.max(limit,1),15);
+    }
+  },
+  created() {
+    this.fetchBookmarks();
+  },
+  methods: {
+    fetchBookmarks: async function () {
+      const headers = {
+        Authorization: `Token ${this.item.token}`,
+        Accept: "application/json",
+      };
+
+      let limit = this.calculatedLimit;
+
+      let query = ''
+      if (this.item.query) {
+        query = `&q=${encodeURIComponent(this.item.query)}`;
+      }
+
+      let url = `/api/bookmarks/?limit=${limit}${query}`;
+
+      this.fetch(url, {
+        headers,
+      })
+          .then((ld_response) => {
+            this.bookmarks = ld_response.results.map(bookmark => ({
+              name: `${bookmark.title}`,
+              subtitle: `${bookmark.description}`,
+              url: bookmark.url,
+              logo: `${bookmark.favicon_url}`,
+              tag: `${bookmark.tag_names.join(" #")}`
+            }));
+          })
+          .catch((e) => {
+            console.log(e);
+            this.error = true;
+          });
+    },
+  },
+};
+</script>
\ No newline at end of file

From e1fdb0069b67490553f99dfddb06dfb7bbc0f1d9 Mon Sep 17 00:00:00 2001
From: Cees Bos <dev@ceesbos.nl>
Date: Thu, 20 Mar 2025 18:27:59 +0100
Subject: [PATCH 2/3] Fix issues in Linkding integration revealed by code check
 in the pipeline

---
 src/components/services/Linkding.vue | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/components/services/Linkding.vue b/src/components/services/Linkding.vue
index 840650a..97aab9a 100644
--- a/src/components/services/Linkding.vue
+++ b/src/components/services/Linkding.vue
@@ -1,5 +1,5 @@
 <template>
-  <template v-for="bookmark in bookmarks">
+  <template v-for="bookmark in bookmarks" :key="bookmark.name">
       <Generic :item="bookmark">
     </Generic>
   </template>
@@ -23,7 +23,7 @@ export default {
   }),
   computed: {
     calculatedLimit: function () {
-      let limit = this.item.hasOwnProperty('limit') ? this.item['limit'] : 5;
+      let limit = this.item.limit ? this.item.limit : 5;
       return Math.min(Math.max(limit,1),15);
     }
   },

From a63f9e2c7ce8698b8a11c889be7d746490ebfded Mon Sep 17 00:00:00 2001
From: Cees Bos <dev@ceesbos.nl>
Date: Tue, 1 Apr 2025 20:24:54 +0200
Subject: [PATCH 3/3] Rework Linkding integration based on feedback on the PR

---
 src/components/services/Linkding.vue | 47 +++++++++++++---------------
 1 file changed, 21 insertions(+), 26 deletions(-)

diff --git a/src/components/services/Linkding.vue b/src/components/services/Linkding.vue
index 97aab9a..0a9071d 100644
--- a/src/components/services/Linkding.vue
+++ b/src/components/services/Linkding.vue
@@ -1,8 +1,6 @@
 <template>
-  <template v-for="bookmark in bookmarks" :key="bookmark.name">
-      <Generic :item="bookmark">
-    </Generic>
-  </template>
+  <Generic v-for="bookmark in bookmarks" :key="bookmark.name" :item="bookmark">
+  </Generic>
 </template>
 
 <script>
@@ -16,16 +14,16 @@ export default {
   },
   mixins: [service],
   props: {
-    item: Object
+    item: Object,
   },
   data: () => ({
     bookmarks: [],
   }),
   computed: {
     calculatedLimit: function () {
-      let limit = this.item.limit ? this.item.limit : 5;
-      return Math.min(Math.max(limit,1),15);
-    }
+      const limit = parseInt(this.item.limit) || 5;
+      return Math.min(Math.max(limit, 1), 15);
+    },
   },
   created() {
     this.fetchBookmarks();
@@ -37,32 +35,29 @@ export default {
         Accept: "application/json",
       };
 
-      let limit = this.calculatedLimit;
-
-      let query = ''
+      let query = "";
       if (this.item.query) {
         query = `&q=${encodeURIComponent(this.item.query)}`;
       }
 
-      let url = `/api/bookmarks/?limit=${limit}${query}`;
+      let url = `/api/bookmarks/?limit=${this.calculatedLimit}${query}`;
 
       this.fetch(url, {
         headers,
       })
-          .then((ld_response) => {
-            this.bookmarks = ld_response.results.map(bookmark => ({
-              name: `${bookmark.title}`,
-              subtitle: `${bookmark.description}`,
-              url: bookmark.url,
-              logo: `${bookmark.favicon_url}`,
-              tag: `${bookmark.tag_names.join(" #")}`
-            }));
-          })
-          .catch((e) => {
-            console.log(e);
-            this.error = true;
-          });
+        .then((ld_response) => {
+          this.bookmarks = ld_response.results.map((bookmark) => ({
+            name: `${bookmark.title}`,
+            subtitle: `${bookmark.description}`,
+            url: bookmark.url,
+            logo: `${bookmark.favicon_url}`,
+            tag: `${bookmark.tag_names.join(" #")}`,
+          }));
+        })
+        .catch((e) => {
+          console.log(e);
+        });
     },
   },
 };
-</script>
\ No newline at end of file
+</script>