Using Acquia DAM media in Drupal Canvas

Using Acquia DAM media in Drupal Canvas

1. Access your site.

2. On the top right, click Edit to open Drupal Canvas.
3. On the top center, click the page title to open the navigator.
4. Select the page where you want to add an image.
5. In the toolbar on the left, click the Library (+) icon to open the Component Library.
6. Drag the Image component, use the purple guideline to position it, and drop it where you want it on the page.

7. In the right sidebar, click Add media.

   Note

   If the system prompts you to authenticate with Acquia DAM (Widen), click Authenticate. The system requires this authentication step only the first time you access the media.

8. Verify that Acquia DAM (Widen) is selected in the Select media source dropdown.

9. Search and select the required image, and then click Insert selected.

   The selected Acquia DAM (Widen) image is added to the page.

10. Select Save to save your changes or Publish to make the page live.

Adding an Acquia DAM (Widen) video

Add Acquia DAM (Widen) video assets to a page through the DAM Video component. The component renders a native HTML video player and resolves the video directly from Acquia DAM (Widen) CDN without additional configuration.

To add an Acquia DAM (Widen) video to a page in Drupal Canvas:

1. Access your site.
2. On the top right, select Edit to open Drupal Canvas.
3. On the top center, select the page title to open the navigator.
4. Navigate to the page where you want to add a video.
5. In the toolbar on the left, select the Library (+) icon to open the Component Library.
6. Drag the DAM Video component, use the purple guideline to position it, and drop it where you want it on the page.

7. In the right sidebar, select Add media.

   Note

   If the system prompts you to authenticate with Acquia DAM (Widen), click Authenticate. The system requires this authentication step only the first time you access the media.

8. Verify that Acquia DAM (Widen) is selected in the Select media source list.

9. Search and select the required video, and then select Insert selected.

   The selected Acquia DAM (Widen) video is added to the page.

10. Select Save to save your changes or Publish to make the page live. 

Configuring video playback

After video insertion, adjust the playback behavior from the Settings tab in the right panel.

The DAM Video component provides the following options:

• Show Controls: Displays the native playback controls such as play, pause, volume, and timeline. This option is enabled by default.
• Autoplay: Starts playing the video when the page loads. This option is disabled by default. Most browsers require the video to be muted for autoplay to take effect.
• Loop: Restarts the video after it reaches the end. This option is disabled by default.
• Muted: Plays the video without audio. This option is disabled by default.

• Play Inline: Plays the video directly inside the component on the page to prevent a full-screen display. This option is important on iOS and mobile devices, where videos open in the native full-screen player by default. Enable this option to force the video to remain embedded in the page layout.

  The Acquia DAM (Widen) asset provides the poster image of the video and displays it before the video plays.

Downloaded video assets

If the Acquia DAM (Widen) media type is configured to download assets, the DAM Video component serves the video from the local file that Source CMS downloaded. If a downloaded file is not available, the component falls back to streaming the video directly from Acquia DAM (Widen) CDN. This behavior requires no additional action.

Adding an Acquia DAM (Widen) document

Source CMS supports Acquia DAM (Widen) documents and PDFs in Drupal Canvas. Content authors place document components on a page, select assets directly from Acquia DAM (Widen), and deliver high-performance download or view links powered by Acquia DAM (Widen) CDN.

Document delivery and download behavior

Drupal Canvas uses direct Acquia DAM (Widen) CDN URLs to deliver document assets on a page:

• High performance CDN delivery: Links point directly to Acquia DAM (Widen) CDN, such as https://[domain].widen.net/, to eliminate local server storage overhead and to avoid extra API lookup latency.
• PDF files: Selecting a PDF link opens the file in a new browser tab or starts a download, depending on the browser configuration of the visitor.
• Office and other documents such as Word, Excel, and PowerPoint: Selecting the link starts a download of the original file to the local machine of the visitor.
• Interchangeable sources: The Document component accepts Acquia DAM (Widen) documents and assets from the local Drupal Media Library interchangeably. 

Supported file types

Drupal Canvas supports the document prop type for the following file formats:

Adding an Acquia DAM (Widen) document to a page

To add an Acquia DAM (Widen) document to a page in Drupal Canvas:

1. Access your site.

2. On the top right, select Edit to open Drupal Canvas.
3. On the top center, select the page title to open the navigator.
4. Select the page where you want to add the document.
5. In the toolbar on the left, select the Library (+) icon to open the Component Library.
6. Drag the Document or Document Link component, use the purple guidelines to position it, and drop it where you want it on the page.

7. In the right sidebar, select Add media.

   Note

   If the system prompts you to authenticate with Acquia DAM (Widen), click Authenticate. The system requires this authentication step only the first time you access the media.

8. Verify that Acquia DAM is selected in the Select media source dropdown.
9. Search and select the required document or PDF asset, and then select Insert selected.

10. (Optional) To adjust display settings such as custom link text or button labels, configure them in the component configuration sidebar.

    The selected document is added to the page as an interactive link or button.

11. Select Save to save your changes or Publish to make the page live.

Search and select the required image, and then click Insert selected.

The selected Acquia DAM (Widen) image is added to the page.

Search and select the required video, and then select Insert selected.

The selected Acquia DAM (Widen) video is added to the page.

(Optional) To adjust display settings such as custom link text or button labels, configure them in the component configuration sidebar.

The selected document is added to the page as an interactive link or button.