[DURACOM-455] refactor config property, add example

Author: FrancescoMolinaro

config/config.example.yml

@@ -706,8 +706,18 @@ layout:
         default:
           icon: fas fa-project-diagram
           style: text-success
-  # If true the dowmload link in item page will rerendered as an advanced attachment, the view can be then configured with the config advancedAttachmentRendering
+  # If true the download link in item page will be rendered as an advanced attachment, the view can be then configured with the layout.advancedAttachmentRendering config
   showDownloadLinkAsAttachment: true
+  # Configuration for advanced attachment rendering in item pages. This controls how files are displayed when showDownloadLinkAsAttachment is enabled.
+  # Each configuration maps a bundle name to specific metadata fields that should be displayed alongside the file.
+  advancedAttachmentRendering:
+    - bundle: ORIGINAL
+      metadata:
+        - dc.description
+        - dc.title
+    - bundle: LICENSE
+      metadata:
+        - dc.rights
 
 # Configuration for customization of search results
 searchResults:

src/app/shared/bitstream-attachment/bitstream-attachment.component.ts

@@ -117,7 +117,7 @@ export class BitstreamAttachmentComponent implements OnInit {
     protected readonly route: ActivatedRoute,
     @Inject(APP_CONFIG) protected appConfig: AppConfig,
   ) {
-    this.metadataConfig = this.appConfig.advancedAttachmentRendering.metadata;
+    this.metadataConfig = this.appConfig.layout.advancedAttachmentRendering.metadata;
   }
 
   ngOnInit() {

src/config/app-config.interface.ts

@@ -6,7 +6,6 @@ import {
 import { AccessibilitySettingsConfig } from './accessibility-settings.config';
 import { ActuatorsConfig } from './actuators.config';
 import { AdminNotifyMetricsRow } from './admin-notify-metrics.config';
-import { AdvancedAttachmentRenderingConfig } from './advanced-attachment-rendering.config';
 import { AuthConfig } from './auth-config.interfaces';
 import { BrowseByConfig } from './browse-by-config.interface';
 import { BundleConfig } from './bundle-config.interface';
@@ -74,7 +73,6 @@ interface AppConfig extends Config {
   accessibility: AccessibilitySettingsConfig;
   layout: LayoutConfig;
   searchResult: SearchResultConfig;
-  advancedAttachmentRendering: AdvancedAttachmentRenderingConfig;
 }
 
 /**

src/config/default-app-config.ts

@@ -4,10 +4,7 @@ import { SearchResultConfig } from '@dspace/config/search-result-config.interfac
 import { AccessibilitySettingsConfig } from './accessibility-settings.config';
 import { ActuatorsConfig } from './actuators.config';
 import { AdminNotifyMetricsRow } from './admin-notify-metrics.config';
-import {
-  AdvancedAttachmentElementType,
-  AdvancedAttachmentRenderingConfig,
-} from './advanced-attachment-rendering.config';
+import { AdvancedAttachmentElementType } from './advanced-attachment-rendering.config';
 import { AppConfig } from './app-config.interface';
 import { AuthConfig } from './auth-config.interfaces';
 import { BrowseByConfig } from './browse-by-config.interface';
@@ -752,6 +749,41 @@ export class DefaultAppConfig implements AppConfig {
       },
     ],
     showDownloadLinkAsAttachment: true,
+    advancedAttachmentRendering: {
+      pagination: {
+        enabled: true,
+        elementsPerPage: 2,
+      },
+      metadata: [
+        {
+          name: 'dc.title',
+          type: AdvancedAttachmentElementType.Metadata,
+          truncatable: false,
+        },
+        {
+          name: 'dc.type',
+          type: AdvancedAttachmentElementType.Metadata,
+          truncatable: false,
+        },
+        {
+          name: 'dc.description',
+          type: AdvancedAttachmentElementType.Metadata,
+          truncatable: true,
+        },
+        {
+          name: 'size',
+          type: AdvancedAttachmentElementType.Attribute,
+        },
+        {
+          name: 'format',
+          type: AdvancedAttachmentElementType.Attribute,
+        },
+        {
+          name: 'checksum',
+          type: AdvancedAttachmentElementType.Attribute,
+        },
+      ],
+    },
   };
 
   // Search result configuration for authority metadata processing
@@ -787,40 +819,5 @@ export class DefaultAppConfig implements AppConfig {
     ],
   };
 
-  advancedAttachmentRendering: AdvancedAttachmentRenderingConfig = {
-    pagination: {
-      enabled: true,
-      elementsPerPage: 2,
-    },
-    metadata: [
-      {
-        name: 'dc.title',
-        type: AdvancedAttachmentElementType.Metadata,
-        truncatable: false,
-      },
-      {
-        name: 'dc.type',
-        type: AdvancedAttachmentElementType.Metadata,
-        truncatable: false,
-      },
-      {
-        name: 'dc.description',
-        type: AdvancedAttachmentElementType.Metadata,
-        truncatable: true,
-      },
-      {
-        name: 'size',
-        type: AdvancedAttachmentElementType.Attribute,
-      },
-      {
-        name: 'format',
-        type: AdvancedAttachmentElementType.Attribute,
-      },
-      {
-        name: 'checksum',
-        type: AdvancedAttachmentElementType.Attribute,
-      },
-    ],
-  };
 
 }

src/config/layout-config.interfaces.ts

@@ -1,3 +1,4 @@
+import { AdvancedAttachmentRenderingConfig } from './advanced-attachment-rendering.config';
 import { Config } from './config.interface';
 
 /**
@@ -67,4 +68,9 @@ export interface LayoutConfig extends Config {
    */
   authorityRef: AuthorityRefConfig[];
   showDownloadLinkAsAttachment: boolean;
+  /**
+   * Configuration for advanced attachment rendering features.
+   * Controls pagination and metadata display for bitstream attachments.
+   */
+  advancedAttachmentRendering: AdvancedAttachmentRenderingConfig;
 }

src/environments/environment.test.ts

@@ -547,15 +547,48 @@ export const environment: BuildConfig = {
       },
     ],
     showDownloadLinkAsAttachment: false,
+    advancedAttachmentRendering: {
+      pagination: {
+        enabled: true,
+        elementsPerPage: 2,
+      },
+      metadata: [
+        {
+          name: 'dc.title',
+          type: AdvancedAttachmentElementType.Metadata,
+          truncatable: false,
+        },
+        {
+          name: 'dc.type',
+          type: AdvancedAttachmentElementType.Metadata,
+          truncatable: false,
+        },
+        {
+          name: 'dc.description',
+          type: AdvancedAttachmentElementType.Metadata,
+          truncatable: true,
+        },
+        {
+          name: 'size',
+          type: AdvancedAttachmentElementType.Attribute,
+        },
+        {
+          name: 'format',
+          type: AdvancedAttachmentElementType.Attribute,
+        },
+        {
+          name: 'checksum',
+          type: AdvancedAttachmentElementType.Attribute,
+        },
+      ],
+    },
   },
 
   searchResult: {
     authorMetadata: ['dc.contributor.author', 'dc.creator', 'dc.contributor.*'],
     followAuthorityMaxItemLimit: 100,
-
     followAuthorityMetadataValuesLimit: 5,
-
-    followAuthorityMetadata:   [
+    followAuthorityMetadata: [
       {
         type: 'Publication',
         metadata: ['dc.contributor.author'],
@@ -570,40 +603,4 @@ export const environment: BuildConfig = {
       },
     ],
   },
-
-  advancedAttachmentRendering: {
-    pagination: {
-      enabled: true,
-      elementsPerPage: 2,
-    },
-    metadata: [
-      {
-        name: 'dc.title',
-        type: AdvancedAttachmentElementType.Metadata,
-        truncatable: false,
-      },
-      {
-        name: 'dc.type',
-        type: AdvancedAttachmentElementType.Metadata,
-        truncatable: false,
-      },
-      {
-        name: 'dc.description',
-        type: AdvancedAttachmentElementType.Metadata,
-        truncatable: true,
-      },
-      {
-        name: 'size',
-        type: AdvancedAttachmentElementType.Attribute,
-      },
-      {
-        name: 'format',
-        type: AdvancedAttachmentElementType.Attribute,
-      },
-      {
-        name: 'checksum',
-        type: AdvancedAttachmentElementType.Attribute,
-      },
-    ],
-  },
 };