How do I configure the Acquia DAM module with Media Library support? | Acquia DAM

The Acquia DAM module syncs DAM with Drupal’s Media Library, so Drupal site creators who have a DAM account can search, browse, and select assets stored in DAM without leaving the Drupal site builder interface. The module leverages embed codes rather than downloading and serving assets through Drupal.

Acquia has two modules that enable integration with Drupal: Acquia DAM and Media: Acquia DAM. Acquia DAM is the newer one.

Support for the module¶

If you have access to both the DAM and Drupal sites, you can install the Acquia DAM module at no additional cost.

However, note that Acquia support teams can only investigate issues if your Drupal site is hosted by Acquia. If it's not, you will need to get support from your Drupal developers, because our teams do not have the access or capability to provide support for your Drupal instance.

Also, Acquia DAM Customer Support will only be able to investigate issues when your DAM instance is impacting the module. Issues related to the module’s compatibility with your Acquia-hosted Drupal instance will be investigated by Acquia’s Drupal team.

Installing in Drupal¶

To install the latest version of Acquia DAM module, you must be using Drupal Core 9.4 or higher. Run a composer command to check why a specific version of the Acquia DAM module cannot be installed. The command will tell you which Drupal version is currently installed.

composer why-not drupal/acquia_dam 1.0.1

You can install the Acquia DAM module using Composer or Drush, or manually in Drupal. For technical details, see the Drupal README documentation.

Install with Composer¶

Use the following command to install with Composer:

composer require drupal/acquia_dam

Install with Drush¶

Use the following command to install with Drush:

php vendor/bin/drush pm:install acquia_dam acquia_dam_integration_links

Install manually in Drupal¶

Install in Drupal by visiting /admin/modules and selecting Acquia DAM and Acquia DAM - Enhanced integration links under Media. Then select Install.

Configuring the module¶

Once you’ve installed the module, follow these steps:

Go to /admin/config/acquia-dam in Drupal.
Enter your DAM domain as the Acquia DAM Domain.
Select whether you want a standard or more secure connection:
- Authorization code (standard): Standard connection using a long-lived access token. It will be active until the user account associated with it expires or the connection is revoked.
- Refresh token (more secure): Refresh tokens use short-lived access tokens that expire, which improves security. This requires support assistance to enable the integration with refresh token support.
Select the image style options you want available in the Drupal Media Library.
Select Save DAM configuration.
You will be redirected to the DAM. Log in to authorize the site-level integration.

Mapping metadata¶

Next, on the Configuration page, select the Metadata tab to choose the metadata fields you want to map from the DAM to the Acquia DAM module. Select Save.

Note that dependent metadata fields cannot be mapped to Drupal.

To map the metadata:

1. Select Structure and Media Types in Drupal.

2. For images sourced from Acquia DAM, select Edit.

3. Under Map Fields, the DAM metadata fields you chose during configuration will display, but the Drupal fields will be empty. To map them, first you need to create new metadata fields in Drupal.

¶

4. Select the Manage Fields tab and Add field. Add a new or existing field and label. Then, save.

5. Fill in settings for the new field and save.

6. Repeat those steps for each of the fields you need to create in Drupal.

7. Select the Edit tab and return to the Map Fields section. Under Drupal mapped field, select a newly created Drupal field to map to each DAM field.

After you've used the Media Library to find and embed DAM assets, you can check to see that your metadata mapping is working for those assets by selecting Content, Media, and DAM Media. For an individual asset, select the dropdown and Edit to view and verify the metadata is correct.

More about the module¶

Did not find what you were looking for?

If this content did not answer your questions, try searching or contacting our support team for further assistance.

Acquia DAM Support