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 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.
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 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.
More about the module¶