Integrating Acquia DAM with Drupal Starter Kits

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.

1. To get started with the acquia_cms setup by using the starter kit, follow the instructions in Getting started.

   After the starter kit is installed, you must install the acquia_cms_dam module.

2. To install the acquia_cms_dam module, install any starter kit. For example, let us assume that you want to leverage the acquia_cms_community starter kit to install the acquia_cms_dam module 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.

3. Select acquia_cms_comunity.

   After you select the starter kit, the system prompts you to answer multiple questions to set up the site.

4. 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:

   

5. 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:

1. Log in to the application as an administrator.

2. Click Configuration > Media > Acquia DAM. Alternatively, append /admin/config/acquia-dam to your application name.

   The system displays the Acquia DAM Configuration page.

   

3. In Acquia DAM Domain, specify the domain name for your Acquia DAM account.

   

4. Click Save DAM configuration.

   The system redirects you to the Acquia DAM domain for authentication.

5. (Optional) If the system does not redirect you to Acquia DAM domain, log in to the Acquia DAM domain.

6. 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.

   

7. Click your user account at the top left of your application and click View profile. Alternatively, append /user to your application name.

8. 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.

9. (Optional) If you are not already logged in, log in to the Acquia DAM domain.

10. 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:

1. Click Content > Add content > Article. Alternatively, append /node/add/article to your application name.

   The system displays the Create Article page.

2. Access the body toolbar.

   

3. Click Insert from Media Library.

   The system displays the Add or select media page.

4. In Select media source, select DAM.

   

5. Select the required assets from Acquia DAM.

   

6. Click Next: Select Format.

7. In Embed code, select properties to embed assets.

   

8. 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:

1. Click Content > Add content > Article. Alternatively, append /node/add/article to your application name.

   The system displays the Create Article page.

2. In Media > Image, click Add media.

   

3. In Select media source, select DAM.

   

4. Select assets from Acquia DAM and click Insert selected.

   

   The assets are available in the Drupal site.

   

5. 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:

1. Click Site Studio > Configuration > System settings.

2. Configure the DAM Media types as follows:

   

   Note

   Drupal Starter Kits DAM automatically enables the DAM Image media type.

To create content:

1. Click Content > Add content > Page. Alternatively, append /node/add/page to your application name.

   The system displays the Create Page page.

   

2. In Layout Canvas, click Add content.
3. In the left navigation pane, navigate to Basic components and click the plus icon corresponding to Image.
4. Double-click the image.

5. Click Browse.

   

   The system displays the Image media page.

6. In Select media source, select DAM.

   

7. Select assets from Acquia DAM and click Insert selected.

   The assets are available in the Drupal site.

   

8. Click Apply to verify that your site renders the assets correctly.

   

Important considerations for existing users¶