The Acquia Digital Asset Management (DAM) module synchronizes DAM with Drupal’s Media Library. This integration enables Drupal site creators to search, browse, and select assets stored in DAM without leaving the Drupal site builder interface. The module uses embed codes instead of downloading and serving assets through Drupal.

Installation¶

To install the module, add it to the Drupal codebase and enable it for use on the sites.

1. Add the module using Composer:
composer require drupal/acquia_dam

2. Enable the modules by running the following Drush command:
drush en acquia_dam acquia_dam_integration_link

Configuration¶

Configuration of DAM and image styles¶

After you install the module, configure the connection and asset display:

1. Log in to your Drupal site and go to the Acquia DAM configuration details page at /admin/config/acquia-dam.

2. Enter your domain in the Acquia DAM Domain field.
3. Select the connection type:
   • Authorization Code (standard): Use a standard connection with a long-lived access token. The connection remains active until the associated user account expires or revokes access.
   • Refresh Token (more Secure): Use short-lived access tokens that expire, which increases security. Contact Support to enable integration with refresh token support.
4. Select Save DAM configuration.
5. Log in to Acquia DAM when prompted to authorize the site-level integration.For additional details, refer to the Authentication section.

Metadata configuration¶

Field Selection¶

1. In the Configuration page, select the Metadata tab.
2. Choose the metadata fields to map from Acquia DAM to the Drupal module.

3. Select Save.

   

Field Mapping¶

1. Go to Structure and select Media Types in Drupal.
2. For images sourced from Acquia DAM, select Edit.
3. Under Map Fields, view the DAM metadata fields selected during configuration. By default, only the name and alt text fields are available for mapping.

4. To map new fields, create the required fields in Drupal, then select them for mapping.

   

Configuration of DAM media as field in content type¶

To configure DAM media as a field with a content type:

1. Create a media field and select DAM as the media source. For example, for the page content type, add a new field named Acquia DAM.
 

2. Click Continue and choose the media type you wish to support.


   

3. Click Save Settings.

   

Authentication¶

To use Acquia DAM, do one of the following to provide authentication based on the chosen communication method with Acquia DAM:

• Log in to the Acquia Widen site
• Use a secure token