Acquia Digital Asset Manager (DAM) empowers enterprise creatives and marketers to create, organize, manage, and share all branded content for use through online and offline channels, with optimized asset publishing through the Acquia Platform.
A DAM solution provides a centralized repository in the cloud to store, manage, provide access, and distribute a large number of digital assets across a distributed organization.
Installing Acquia DAM with Drupal Starter Kits
To install Acquia DAM with Drupal Starter Kits, you can leverage any Drupal Starter Kits starter kit like Drupal Starter Kits Community starter kit.
To get started with the
acquia_cmssetup by using the starter kit, follow the instructions in Getting started.After the starter kit is installed, you must install the
acquia_cms_dammodule.To install the
acquia_cms_dammodule, install any starter kit. For example, let us assume that you want to leverage theacquia_cms_communitystarter kit to install theacquia_cms_dammodule as follows:./bin/acms acms:install
This command starts the starter kit installation and provides the following options:
- Drupal Starter Kits headless (
acquia_cms_headless) - Drupal Starter Kits Community (
acquia_cms_comunity) - Drupal Starter Kits Enterprise Low Code (
acquia_cms_enterprise_low_code)
Note
Existing users who want to prevent rebuilding Composer dependencies repeatedly can leverage separate build and install commands. For more information, see Using separate build and install commands.
- Drupal Starter Kits headless (
Select
acquia_cms_comunity.After you select the starter kit, the system prompts you to answer multiple questions to set up the site.
For the Would you like to enable the Acquia DAM modules (configuration will need to be done manually later after site installation) ? prompt, set Yes.
The system starts installing the required modules to enable Acquia DAM and the following modules:
- Access the user interface of your site and complete the Acquia DAM integration steps. For more information on connecting your Acquia DAM account with the site, see Configuring Acquia DAM.
Configuring Acquia DAM
To configure your Acquia DAM account with your site:
- Log in to the application as an administrator.
Click Configuration > Media > Acquia DAM. Alternatively, append
/admin/config/acquia-damto your application name.The system displays the Acquia DAM Configuration page.
In Acquia DAM Domain, specify the domain name for your Acquia DAM account.
Click Save DAM configuration.
The system redirects you to the Acquia DAM domain for authentication.
- (Optional) If the system does not redirect you to Acquia DAM domain, log in to the Acquia DAM domain.
Whenever the system displays the Allow Drupal Cloud Integration to access your DAM account option, click Allow.
The system displays a message that your application is validated, and redirects you to the Drupal application on the Acquia DAM configuration page.
- Click your user account at the top left of your application and click View profile. Alternatively, append
/userto your application name. Click Acquia DAM > Authorize.
The system displays the following page after authorization:
Additionally, the system updates the page and redirects you to the Acquia DAM domain for asset authentication.
- (Optional) If you are not already logged in, log in to the Acquia DAM domain.
Whenever the system displays the Allow Drupal Cloud Integration to access your DAM account option, click Allow.
You are successfully connected with Acquia DAM (widencollective). You can start using assets from Acquia DAM.
Using Acquia DAM assets in CKEditor
To use Acquia DAM assets in CKEditor:
Click Content > Add content > Article. Alternatively, append
/node/add/articleto your application name.The system displays the Create Article page.
Access the body toolbar.
Click Insert from Media Library.
The system displays the Add or select media page.
In Select media source, select DAM.
Select the required assets from Acquia DAM.
- Click Next: Select Format.
In Embed code, select properties to embed assets.
Click Insert selected.
The assets are available in the Drupal site.
Using Acquia DAM assets with the Drupal field
To use Acquia DAM assets with the Drupal field:
Click Content > Add content > Article. Alternatively, append
/node/add/articleto your application name.The system displays the Create Article page.
In Media > Image, click Add media.
In Select media source, select DAM.
Select assets from Acquia DAM and click Insert selected.
The assets are available in the Drupal site.
Click Save to verify that your site renders the assets correctly.
Using Acquia DAM assets with Site Studio layout canvas
Before creating content, you must configure Site Studio so that it can support Acquia DAM media types.
To configure Site Studio:
- Click Site Studio > Configuration > System settings.
Configure the DAM Media types as follows:
Note
Drupal Starter Kits DAM automatically enables the DAM Image media type.
To create content:
Click Content > Add content > Page. Alternatively, append
/node/add/pageto your application name.The system displays the Create Page page.
- In Layout Canvas, click Add content.
- In the left navigation pane, navigate to Basic components and click the plus icon corresponding to Image.
- Double-click the image.
Click Browse.
The system displays the Image media page.
In Select media source, select DAM.
Select assets from Acquia DAM and click Insert selected.
The assets are available in the Drupal site.
Click Apply to verify that your site renders the assets correctly.
Important considerations for existing users
Using the CKEditor5 text editor for the “Site Studio” text format
For new users leveraging Site Studio 7.0, the system sets CKEditor5 as the text editor for the “Site Studio” text format by default. However, existing users must manually set CKEditor5 as the text editor.
To set the CKEditor5 text editor for the “Site Studio” text format:
Click Configuration > Content authoring > Text formats and editors. Alternatively, append
/admin/config/content/formatsto your application name.The system displays the Text formats and editors page.
- Click the Configure button for the Site Studio text format.
In Text editor, select CKEditor 5.
- Access the CKEditor5 plugin settings section and click Style.
Select the Add Site Studio styles checkbox.
Click Media and select the Allow the user to override the default view mode checkbox.
Access the Filter settings section, select at least two view modes.
- Click Save configuration.
Enabling Acquia DAM support
After you enable the Drupal Starter Kits DAM module, the system enables Acquia DAM support for all components except the following:
To get Acquia DAM support for these components, you must manually update these components.
Enabling Acquia DAM support for the image component
To enable Acquia DAM support for the image component:
Access Site Studio > Components > Components > Basic components > Image and click Edit. Alternatively, append
/admin/cohesion/components/components/cpt_image_media/editto your application name.The system displays the Edit image page.
Access Component form builder > Tab container > Content > Image and double-click the Image media field.
The system displays the Entity browser page.
- Click Apply.
Click Save and continue.
You can add an image component in the layout canvas field and select images from Acquia DAM.
Enabling Acquia DAM support for the video component
To enable Acquia DAM support for the video component
Access Site Studio > Components > Components > Basic components > Video and click Edit. Alternatively, append
/admin/cohesion/components/components/cpt_video_media/editto your application name.The system displays the Edit video page.
Access Component form builder > Tab container > Content > Video and double-click the Video media field.
The system displays the Entity browser page.
- Click Apply.
Click Save and continue.
You can add a video component in the layout canvas field and select videos from Acquia DAM.