How do I configure the Acquia DAM module with Media Library support?
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:
Install in Drupal by visiting /admin/modules and selecting Acquia DAM and Acquia DAM - Enhanced integration links under Media. Then select Install.
Note
This integration uses version 3 (v3) embed links. If you are currently using version 2 (v2) embeds in your implementation, be aware of this version difference before proceeding.
Configuring the module
Once you have 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): Use a standard connection with a long-lived access token. The connection remains active until the user account expires or the connection is revoked.
Refresh token (more secure): This authentication method uses refresh tokens to generate short-lived access tokens that expire after eight hours and provides enhanced security. To use refresh token functionality, submit a support case to Acquia requesting OAuth credentials (client ID and client secret) with refresh tokens enabled.
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.
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 have 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.
After you complete the basic module configuration and metadata mapping, configure two additional settings to enable full functionality of DAM assets in your content:
Media field configuration in content types
To make Acquia DAM assets available in your content type media fields, follow these steps:
1. Add a new field
Go to Administration > Structure > Content types.
Select the content type to modify (for example, Article or Page).
On the Manage Fields tab, select +Add field.
2. Choose the reference field type
On the Add field page, select Reference as the field type.
In the Label field, enter a clear and descriptive name.
In the Choose a field type section, confirm that Content is selected.
Select Continue.
3. Specify the media reference type
On the next page, configure field settings.
Under Type of item to reference, use the dropdown to select Media.
4. Select allowed Acquia DAM media types
A new Reference type section appears.
Under Media type, select the boxes for each Acquia DAM media type to make available for this field (for example, Acquia DAM: Audio, Acquia DAM: Image, Acquia DAM: Video).
Select Save to complete the configuration.
Text editor configuration
To enable Acquia DAM assets in rich text fields:
Go to Administration -> Configuration -> Content Authoring -> Text formats and editors
For each text format that needs DAM access (such as Basic HTML or Full HTML):
Select Configure.
Go to the Filter settings section.
Locate Embed media settings.
Under "Media types selectable in the Media Library," select all relevant Acquia DAM media types.
Select Save configuration.
Important
Both configurations are required for full functionality.
Media field configuration enables DAM assets in dedicated media fields.
Text editor configuration enables DAM assets in rich text areas through the Add media text button and icon.
How do I configure the Acquia DAM module with Media Library support?
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:
Install in Drupal by visiting /admin/modules and selecting Acquia DAM and Acquia DAM - Enhanced integration links under Media. Then select Install.
Note
This integration uses version 3 (v3) embed links. If you are currently using version 2 (v2) embeds in your implementation, be aware of this version difference before proceeding.
Configuring the module
Once you have 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): Use a standard connection with a long-lived access token. The connection remains active until the user account expires or the connection is revoked.
Refresh token (more secure): This authentication method uses refresh tokens to generate short-lived access tokens that expire after eight hours and provides enhanced security. To use refresh token functionality, submit a support case to Acquia requesting OAuth credentials (client ID and client secret) with refresh tokens enabled.
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.
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 have 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.
After you complete the basic module configuration and metadata mapping, configure two additional settings to enable full functionality of DAM assets in your content:
Media field configuration in content types
To make Acquia DAM assets available in your content type media fields, follow these steps:
1. Add a new field
Go to Administration > Structure > Content types.
Select the content type to modify (for example, Article or Page).
On the Manage Fields tab, select +Add field.
2. Choose the reference field type
On the Add field page, select Reference as the field type.
In the Label field, enter a clear and descriptive name.
In the Choose a field type section, confirm that Content is selected.
Select Continue.
3. Specify the media reference type
On the next page, configure field settings.
Under Type of item to reference, use the dropdown to select Media.
4. Select allowed Acquia DAM media types
A new Reference type section appears.
Under Media type, select the boxes for each Acquia DAM media type to make available for this field (for example, Acquia DAM: Audio, Acquia DAM: Image, Acquia DAM: Video).
Select Save to complete the configuration.
Text editor configuration
To enable Acquia DAM assets in rich text fields:
Go to Administration -> Configuration -> Content Authoring -> Text formats and editors
For each text format that needs DAM access (such as Basic HTML or Full HTML):
Select Configure.
Go to the Filter settings section.
Locate Embed media settings.
Under "Media types selectable in the Media Library," select all relevant Acquia DAM media types.
Select Save configuration.
Important
Both configurations are required for full functionality.
Media field configuration enables DAM assets in dedicated media fields.
Text editor configuration enables DAM assets in rich text areas through the Add media text button and icon.
Acquia DAM