Integration: Drupal 7

Installing the connector module¶

To install the Acquia DAM connector, complete the following steps:

1. Download the 7.x version of the Media: Acquia DAM. module.

2. Install Media: Acquia DAM and Media: Acquia DAM Browser. For more information, see Install the module on your Drupal website.

3. Sign in to Acquia DAM Classic.

4. Create a dedicated background user and group for the routine syncing of metadata and to allow anonymous users to view assets in the asset viewer. Ensure that the dedicated group that you assign to your background user includes permissions for viewing and downloading the assets you plan to use with your Drupal website.

5. Edit your Drupal settings.php file, and replace [username] and [password] with the username and password of the background user you created in the previous step:

   $conf['media_acquiadam_background_user'] = '[username]';
   $conf['media_acquiadam_background_pass'] = '[password]';
   

Configuring the connector module¶

1. Sign in to your Drupal website as a user with Administrator permissions.

2. In the top menu, click Configuration.

3. In the Media section, click Media: Acquia DAM settings.

4. In the Authentication tab, enter values for the following fields:

   • Client ID – Acquia DAM Classic client ID

   • Client Secret – Acquia DAM Classic client secret

   • Client mode – Select Mixed or Background only
     When set to Mixed, a user authenticates with Acquia DAM Classic when selecting and viewing assets in the asset viewer. When set to Background only, only assets accessible to the background user in Acquia DAM Classic will be available for viewing and downloading by Drupal users.

     Note

     If you do not have your Client ID or Client secret, contact your account manager.

5. Click the Caching tab, and then enter values for the following fields:

   • Used lifetime – Duration, in minutes, to cache asset information in Drupal. Some asset information stores locally for performance reasons. Acquia recommends setting the timeout as high as allowable. A value of 0 disables caching.

   • Unused lifetime – Duration, in minutes, to cache asset information loaded while using the asset browser to improve performance. Acquia recommends a short timeout (five to 30 minutes) to avoid displaying outdated information to a user. A value of 0 will disable caching for unused assets.

6. Click the Media tab, and then enter values for the following fields:

   • Mimetype adjustment – Override the handling of a file type with that of a different file type. For example, you may want Drupal to handle an eps file like a png file.

7. Click the Media browser tab, and then enter values for the following fields:

   • Results per page – Number of assets, not including folders, displayed per page of results in the asset browser.

8. Scroll to the bottom of the page, and then click Save configuration.

9. Ensure you create cron jobs to periodically refresh data.

You can also configure the fields described previously using Drush:

Adding a Content type field¶

Complete the following steps to add a content type field for your chosen content type:

1. Sign in to your Drupal website as a user with Administrator permissions.

2. In the top menu, select Structure.

3. Select Content types.

4. From your content type row, select Manage fields from the Operations menu.

5. For Add a new field, enter a label, such as DAM asset.

6. Select Field type as File.

7. Select Widget as Media browser.

8. Select Save and then select Save field settings.

9. Scroll to the Enabled browser plugins section and select Acquia DAM Asset at the bottom of the page.

10. Add Allowed file extensions for uploaded files and enter the desired file extensions separated by spaces. For example, jpg gif png svg pdf.

11. Select Save settings.

Assets¶

The Acquia DAM connector affects assets in the following circumstances and methods.

Permissions¶

The Acquia DAM connector includes several permissions for managing what a user can do, including the following permissions:

Search behavior¶

The Acquia DAM connector uses Acquia DAM Classic for executing search queries. A query is affected by the permissions assigned to the user in Acquia DAM Classic running the search. When searching a folder, results in child folders are also returned.

When making changes to an asset’s metadata in Acquia DAM Classic, there may be a delay before a search query reflects the change.