Use Acquia DAM assets directly in rich text fields through CKEditor. After you configure this integration, content authors can select images and other media stored in Acquia DAM. They must use the Insert Media option in CKEditor to insert assets into text areas, body fields, long text fields, and WYSIWYG components.

This guide describes the method to configure text formats so that CKEditor can use Acquia DAM media types through the Drupal Media Library.

Prerequisites

Before you begin, make sure:

• The Acquia DAM module is enabled and configured.
• The Media Library is enabled and active.
• Your user account has permission to:
  • Administer text formats and editors.
  • Use the Media Library.
  • Access Acquia DAM media types.

Configure CKEditor text formats to use Acquia DAM

You must configure each text format that enables authors to select Acquia DAM media from CKEditor. Typical formats include basic HTML, full HTML, or any custom text format.

Step 1: Open text formats and editors

1. In the administrator account toolbar, go to Administration > Configuration > Content authoring > Text formats and editors.
2. Review the list of text formats, such as plain text, basic HTML, and full HTML.

Step 2: Configure a text format for Acquia DAM media

Repeat these steps for each text format that should support Acquia DAM assets.

1. On the Text formats and editors page, locate the desired text format.
2. In the Operations column, select Configure.
3. On the configuration page, ensure that Editor is set to CKEditor.

4. From the Toolbar configuration section, drag Drupal Media from Available options to the Active toolbar.

   
5. Go to the Enabled filters section and check the Embed media checkbox.
6. Go to the Filter settings section.
7. Find the Embed media settings subsection.
8. Under Media types selectable in the Media Library, select all Acquia DAM media types you want authors to be able to insert from CKEditor.
   Such as:
   • Acquia DAM: Image
   • Acquia DAM: Video

9. Select Save configuration.

   Repeat these steps for any additional text formats that must allow Acquia DAM assets.

Important notes and behavior

• Both configurations are required
  To ensure that Acquia DAM assets are fully available in your site:

  • Media fields must be configured to use Acquia DAM media types, such as image or media fields on content types.

  • Text formats and CKEditor must be configured as previously described so that the Insert Media button can select Acquia DAM media in rich text fields.

• Per-format control

  • Configuration Requirement: A text format must be configured with Acquia Digital Asset Management (DAM) media types under the Embed media options.

  • Impact of Absent Configuration: If this configuration is absent, content authors who use that specific text format cannot see Acquia DAM assets within the Media Library.

  • End Result for Authors: Consequently, those authors are unable to select and insert Acquia DAM media into their content through CKEditor.

• Permissions
  Users must have permission to:
  • Use the chosen text format.
  • Access the Media Library.
  • Access and use the relevant Acquia DAM media types.

Integrate Acquia DAM with CKEditor and Media Library