From df956674f104262f2ccf03f4a36bd6366a500ba7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Alexandre=20Bult=C3=A9?= <alexandre@bulte.net>
Date: Thu, 3 Sep 2026 09:30:57 +0200
Subject: [PATCH 1/3] feat(resource): add external url override to
 ResourceViewer

---
 .../src/components/ResourceExplorer/ResourceExplorer.vue    | 4 ++++
 .../components/ResourceExplorer/ResourceExplorerViewer.vue  | 3 +++
 .../components/ResourceExplorer/ResourceViewerHeader.vue    | 6 ++++--
 .../components/ResourceExplorer/ResourceViewerSkeleton.vue  | 2 ++
 4 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/datagouv-components/src/components/ResourceExplorer/ResourceExplorer.vue b/datagouv-components/src/components/ResourceExplorer/ResourceExplorer.vue
index e6340f04b..adee94903 100644
--- a/datagouv-components/src/components/ResourceExplorer/ResourceExplorer.vue
+++ b/datagouv-components/src/components/ResourceExplorer/ResourceExplorer.vue
@@ -46,6 +46,7 @@
             :resources="flatResources"
             :resource-to="resourceTo"
             :explore-to="exploreTo"
+            :resource-external-url="resourceExternalUrl"
             replace
             :fullscreen
           />
@@ -56,6 +57,7 @@
               :resources="flatResources"
               :resource-to="resourceTo"
               :explore-to="exploreTo"
+              :resource-external-url="resourceExternalUrl"
               replace
               :fullscreen
             />
@@ -119,6 +121,8 @@ const props = withDefaults(defineProps<{
   // Inline mode only: link builder for the "Explorer" button in the viewer header
   // that opens the fullscreen explorer on the current resource.
   exploreTo?: (resource: Resource) => string
+  // Overrides the "Copier le lien" target.
+  resourceExternalUrl?: (resource: Resource) => string
 }>(), {
   noResultsImage: '',
   fullscreen: false,
diff --git a/datagouv-components/src/components/ResourceExplorer/ResourceExplorerViewer.vue b/datagouv-components/src/components/ResourceExplorer/ResourceExplorerViewer.vue
index c449ce094..cb8a81865 100644
--- a/datagouv-components/src/components/ResourceExplorer/ResourceExplorerViewer.vue
+++ b/datagouv-components/src/components/ResourceExplorer/ResourceExplorerViewer.vue
@@ -6,6 +6,7 @@
       :resources
       :resource-to
       :explore-to="exploreTo"
+      :resource-external-url="resourceExternalUrl"
       :replace
       :fullscreen
     />
@@ -217,6 +218,8 @@ const props = withDefaults(defineProps<{
   // When provided (inline mode), shows an "Explorer" button next to the download
   // action that opens the fullscreen explorer on the current resource.
   exploreTo?: (resource: Resource) => string
+  // Overrides the "Copier le lien" target.
+  resourceExternalUrl?: (resource: Resource) => string
   replace?: boolean
   // Fullscreen mode: make the viewer a flex column so the table fills down to the
   // bottom, and hide the inline download/visit/copy actions — they're shown in the
diff --git a/datagouv-components/src/components/ResourceExplorer/ResourceViewerHeader.vue b/datagouv-components/src/components/ResourceExplorer/ResourceViewerHeader.vue
index 0a7558064..5f97a6773 100644
--- a/datagouv-components/src/components/ResourceExplorer/ResourceViewerHeader.vue
+++ b/datagouv-components/src/components/ResourceExplorer/ResourceViewerHeader.vue
@@ -53,7 +53,7 @@
       <CopyButton
         :label="t('Copier le lien')"
         :copied-label="t('Lien copié !')"
-        :text="resourceExternalUrl"
+        :text="externalUrl"
         icon-only
         class="hidden shrink-0 md:inline-flex"
       />
@@ -110,6 +110,8 @@ const props = defineProps<{
   resources?: Resource[]
   resourceTo?: (resource: Resource) => RouteLocationRaw
   exploreTo?: (resource: Resource) => string
+  // Overrides the "Copier le lien" target.
+  resourceExternalUrl?: (resource: Resource) => string
   replace?: boolean
   // Fullscreen mode hides the inline actions — they live in the dataset context bar above.
   fullscreen?: boolean
@@ -118,5 +120,5 @@ const props = defineProps<{
 const { t } = useTranslation()
 
 const resourceFilesize = computed(() => getResourceFilesize(props.resource))
-const resourceExternalUrl = computed(() => getResourceExternalUrl(props.dataset, props.resource))
+const externalUrl = computed(() => props.resourceExternalUrl ? props.resourceExternalUrl(props.resource) : getResourceExternalUrl(props.dataset, props.resource))
 </script>
diff --git a/datagouv-components/src/components/ResourceExplorer/ResourceViewerSkeleton.vue b/datagouv-components/src/components/ResourceExplorer/ResourceViewerSkeleton.vue
index 5eb525b56..ef42bfa95 100644
--- a/datagouv-components/src/components/ResourceExplorer/ResourceViewerSkeleton.vue
+++ b/datagouv-components/src/components/ResourceExplorer/ResourceViewerSkeleton.vue
@@ -9,6 +9,7 @@
       :resources
       :resource-to
       :explore-to="exploreTo"
+      :resource-external-url="resourceExternalUrl"
       :replace
       :fullscreen
     />
@@ -80,6 +81,7 @@ const props = defineProps<{
   resources?: Resource[]
   resourceTo?: (resource: Resource) => RouteLocationRaw
   exploreTo?: (resource: Resource) => string
+  resourceExternalUrl?: (resource: Resource) => string
   replace?: boolean
   fullscreen?: boolean
 }>()

From 25f9cb044e8be0260526a2ea6fe3c76cb937a26b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Alexandre=20Bult=C3=A9?= <alexandre@bulte.net>
Date: Mon, 7 Sep 2026 15:25:51 +0200
Subject: [PATCH 2/3] use config instead of prop

---
 .../src/components/ResourceExplorer/ResourceExplorer.vue    | 4 ----
 .../components/ResourceExplorer/ResourceExplorerViewer.vue  | 3 ---
 .../components/ResourceExplorer/ResourceViewerHeader.vue    | 6 ++----
 .../components/ResourceExplorer/ResourceViewerSkeleton.vue  | 2 --
 datagouv-components/src/config.ts                           | 4 ++++
 datagouv-components/src/functions/resources.ts              | 3 +++
 6 files changed, 9 insertions(+), 13 deletions(-)

diff --git a/datagouv-components/src/components/ResourceExplorer/ResourceExplorer.vue b/datagouv-components/src/components/ResourceExplorer/ResourceExplorer.vue
index adee94903..e6340f04b 100644
--- a/datagouv-components/src/components/ResourceExplorer/ResourceExplorer.vue
+++ b/datagouv-components/src/components/ResourceExplorer/ResourceExplorer.vue
@@ -46,7 +46,6 @@
             :resources="flatResources"
             :resource-to="resourceTo"
             :explore-to="exploreTo"
-            :resource-external-url="resourceExternalUrl"
             replace
             :fullscreen
           />
@@ -57,7 +56,6 @@
               :resources="flatResources"
               :resource-to="resourceTo"
               :explore-to="exploreTo"
-              :resource-external-url="resourceExternalUrl"
               replace
               :fullscreen
             />
@@ -121,8 +119,6 @@ const props = withDefaults(defineProps<{
   // Inline mode only: link builder for the "Explorer" button in the viewer header
   // that opens the fullscreen explorer on the current resource.
   exploreTo?: (resource: Resource) => string
-  // Overrides the "Copier le lien" target.
-  resourceExternalUrl?: (resource: Resource) => string
 }>(), {
   noResultsImage: '',
   fullscreen: false,
diff --git a/datagouv-components/src/components/ResourceExplorer/ResourceExplorerViewer.vue b/datagouv-components/src/components/ResourceExplorer/ResourceExplorerViewer.vue
index cb8a81865..c449ce094 100644
--- a/datagouv-components/src/components/ResourceExplorer/ResourceExplorerViewer.vue
+++ b/datagouv-components/src/components/ResourceExplorer/ResourceExplorerViewer.vue
@@ -6,7 +6,6 @@
       :resources
       :resource-to
       :explore-to="exploreTo"
-      :resource-external-url="resourceExternalUrl"
       :replace
       :fullscreen
     />
@@ -218,8 +217,6 @@ const props = withDefaults(defineProps<{
   // When provided (inline mode), shows an "Explorer" button next to the download
   // action that opens the fullscreen explorer on the current resource.
   exploreTo?: (resource: Resource) => string
-  // Overrides the "Copier le lien" target.
-  resourceExternalUrl?: (resource: Resource) => string
   replace?: boolean
   // Fullscreen mode: make the viewer a flex column so the table fills down to the
   // bottom, and hide the inline download/visit/copy actions — they're shown in the
diff --git a/datagouv-components/src/components/ResourceExplorer/ResourceViewerHeader.vue b/datagouv-components/src/components/ResourceExplorer/ResourceViewerHeader.vue
index 5f97a6773..0a7558064 100644
--- a/datagouv-components/src/components/ResourceExplorer/ResourceViewerHeader.vue
+++ b/datagouv-components/src/components/ResourceExplorer/ResourceViewerHeader.vue
@@ -53,7 +53,7 @@
       <CopyButton
         :label="t('Copier le lien')"
         :copied-label="t('Lien copié !')"
-        :text="externalUrl"
+        :text="resourceExternalUrl"
         icon-only
         class="hidden shrink-0 md:inline-flex"
       />
@@ -110,8 +110,6 @@ const props = defineProps<{
   resources?: Resource[]
   resourceTo?: (resource: Resource) => RouteLocationRaw
   exploreTo?: (resource: Resource) => string
-  // Overrides the "Copier le lien" target.
-  resourceExternalUrl?: (resource: Resource) => string
   replace?: boolean
   // Fullscreen mode hides the inline actions — they live in the dataset context bar above.
   fullscreen?: boolean
@@ -120,5 +118,5 @@ const props = defineProps<{
 const { t } = useTranslation()
 
 const resourceFilesize = computed(() => getResourceFilesize(props.resource))
-const externalUrl = computed(() => props.resourceExternalUrl ? props.resourceExternalUrl(props.resource) : getResourceExternalUrl(props.dataset, props.resource))
+const resourceExternalUrl = computed(() => getResourceExternalUrl(props.dataset, props.resource))
 </script>
diff --git a/datagouv-components/src/components/ResourceExplorer/ResourceViewerSkeleton.vue b/datagouv-components/src/components/ResourceExplorer/ResourceViewerSkeleton.vue
index ef42bfa95..5eb525b56 100644
--- a/datagouv-components/src/components/ResourceExplorer/ResourceViewerSkeleton.vue
+++ b/datagouv-components/src/components/ResourceExplorer/ResourceViewerSkeleton.vue
@@ -9,7 +9,6 @@
       :resources
       :resource-to
       :explore-to="exploreTo"
-      :resource-external-url="resourceExternalUrl"
       :replace
       :fullscreen
     />
@@ -81,7 +80,6 @@ const props = defineProps<{
   resources?: Resource[]
   resourceTo?: (resource: Resource) => RouteLocationRaw
   exploreTo?: (resource: Resource) => string
-  resourceExternalUrl?: (resource: Resource) => string
   replace?: boolean
   fullscreen?: boolean
 }>()
diff --git a/datagouv-components/src/config.ts b/datagouv-components/src/config.ts
index 896dc1c98..371a9a2ff 100644
--- a/datagouv-components/src/config.ts
+++ b/datagouv-components/src/config.ts
@@ -1,6 +1,8 @@
 import { inject, type Component, type InjectionKey } from 'vue'
 import type { UseFetchFunction } from './functions/api.types'
 import type { $Fetch, FetchOptions } from 'ofetch'
+import type { Dataset, DatasetV2 } from './types/datasets'
+import type { CommunityResource, Resource } from './types/resources'
 
 export type PluginConfig = {
   name: string // Name of the application (ex: data.gouv.fr)
@@ -45,6 +47,8 @@ export type PluginConfig = {
   clientOnly?: Component | null
   searchDebounce?: number
   forumUrl?: string
+  /** Overrides the "Copier le lien" target built by `getResourceExternalUrl`. */
+  resourceExternalUrl?: (dataset: Dataset | DatasetV2 | Omit<Dataset, 'resources' | 'community_resources'>, resource: Resource | CommunityResource) => string
 }
 
 export const configKey = Symbol() as InjectionKey<PluginConfig>
diff --git a/datagouv-components/src/functions/resources.ts b/datagouv-components/src/functions/resources.ts
index 3e0b17c1e..eac0a474d 100644
--- a/datagouv-components/src/functions/resources.ts
+++ b/datagouv-components/src/functions/resources.ts
@@ -176,6 +176,9 @@ export function isCommunityResource(resource: Resource | CommunityResource): boo
 }
 
 export function getResourceExternalUrl(dataset: Dataset | DatasetV2 | Omit<Dataset, 'resources' | 'community_resources'>, resource: Resource | CommunityResource): string {
+  const config = useComponentsConfig()
+  if (config.resourceExternalUrl) return config.resourceExternalUrl(dataset, resource)
+
   return `${dataset.page}${isCommunityResource(resource) ? '/community-resources' : ''}?resource_id=${resource.id}`
 }
 

From 860512fb1cd345bae44d516fcb4794f97e71b9ee Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Alexandre=20Bult=C3=A9?= <alexandre@bulte.net>
Date: Mon, 7 Sep 2026 16:22:57 +0200
Subject: [PATCH 3/3] review fixes

---
 datagouv-components/src/config.ts              | 8 ++++++--
 datagouv-components/src/functions/resources.ts | 2 +-
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/datagouv-components/src/config.ts b/datagouv-components/src/config.ts
index 371a9a2ff..b05826500 100644
--- a/datagouv-components/src/config.ts
+++ b/datagouv-components/src/config.ts
@@ -47,8 +47,12 @@ export type PluginConfig = {
   clientOnly?: Component | null
   searchDebounce?: number
   forumUrl?: string
-  /** Overrides the "Copier le lien" target built by `getResourceExternalUrl`. */
-  resourceExternalUrl?: (dataset: Dataset | DatasetV2 | Omit<Dataset, 'resources' | 'community_resources'>, resource: Resource | CommunityResource) => string
+  /**
+   * Overrides the "Copier le lien" target built by `getResourceExternalUrl`.
+   * Must return an absolute URL: it is copied to the clipboard and used as an
+   * external, `_blank` link target.
+   */
+  getResourceExternalUrl?: (dataset: Dataset | DatasetV2 | Omit<Dataset, 'resources' | 'community_resources'>, resource: Resource | CommunityResource) => string
 }
 
 export const configKey = Symbol() as InjectionKey<PluginConfig>
diff --git a/datagouv-components/src/functions/resources.ts b/datagouv-components/src/functions/resources.ts
index eac0a474d..9d1d8e5c8 100644
--- a/datagouv-components/src/functions/resources.ts
+++ b/datagouv-components/src/functions/resources.ts
@@ -177,7 +177,7 @@ export function isCommunityResource(resource: Resource | CommunityResource): boo
 
 export function getResourceExternalUrl(dataset: Dataset | DatasetV2 | Omit<Dataset, 'resources' | 'community_resources'>, resource: Resource | CommunityResource): string {
   const config = useComponentsConfig()
-  if (config.resourceExternalUrl) return config.resourceExternalUrl(dataset, resource)
+  if (config.getResourceExternalUrl) return config.getResourceExternalUrl(dataset, resource)
 
   return `${dataset.page}${isCommunityResource(resource) ? '/community-resources' : ''}?resource_id=${resource.id}`
 }