Knowledge Base

Drupal 8 integration

When you integrate Drupal 8 with Bynder you can add image and document assets from Bynder to your Drupal 8 content using our Compact View. The integration ensures that the latest version of your Bynder assets is automatically reflected in your Drupal 8 content. Find out below how you can start making use of this integration.

Skip directly to

Before you begin

  • Make sure you have a Bynder account. Visit https://www.bynder.com/ for more information.

  • Bynder uses OAuth to allow external applications to connect to it. Drupal will use this to integrate with Bynder. You need to generate API credentials before proceeding. If you want to generate your credentials see Create API tokens for your app.

Supported versions

This plugin supports Drupal 8. If you are upgrading from Drupal 7, uninstall the Drupal 7 plugin, and install the one for Drupal 8.

Derivatives used

There are three basic derivative sizes created initially (webimage, mini and thul (thumbnail)). If you need more derivatives created, contact your Customer Success Manager. Since derivatives are generated on upload and are configured prior to the bulk media import, Bynder recommends creating Drupal-specific derivatives at the start of your implementation. If not, then you might encounter additional Professional Services fees for generating additional derivatives.

Installation and configuration

Follow the installation and configuration steps described on the Drupal website.

Note

  • You only need API credentials to configure the plugin for users. The users will later log in with their Bynder login and password.

  • Currently we do not match Drupal and Bynder permission profiles. However, Bynder permission profiles are enforced, so users only see the assets they have access to.

Use the plugin

Attach Bynder media to content
  1. To attach a Bynder asset to your content, open the content page and click Select assets in the Media Assets section.

  2. The Compact View will open. If your company's Bynder portal URL is already filled in in the pop-up, click Connect. If not, enter the URL in the below format. A popup will open, which allows you to login to your Bynder environment.

    https://YourPortalURL.com
  3. Login to the portal the usual way.

  4. In the Asset tab use the filter bar or search bar filter and search for the assets you need. Select the files(s) you need and click Add asset(s) to add the asset(s) to your Drupal content. In the Collection tab select the collection that you want to add or click the collection and select the file(s) you want to add. Click Add asset(s) to add the asset(s) to your Drupal 8 content.

  5. Click Save to save the changes.

Note

The default time to live (TTL) is one day if you use Bynder CDN. However, if you use CDN of another provider, the TTL may be different since it depends on the CDN configuration.

Edit Bynder assets in Drupal
  1. Go to Content > Media.

    edit-media.png
  2. Select the asset you want to edit.

  3. Click Edit.

  4. Introduce your changes and save.

    edit-drupal.png

    Note

    All edits of the metadata on the Drupal side are considered overrides and won’t be synced back to Bynder. In order to make changes permanent they need to be edited in Bynder. Click the edit asset's metadata on Bynder link to open the asset directly in Bynder.

Remove Bynder assets from Drupal
  1. Go to Content > Media.

  2. Select the asset(s) you want to remove.

  3. Click the drupal8_edit_arrow.png button next to the Edit button and click Delete.

  4. Read the warning message and click Delete to permanently remove the asset in Drupal.

Limitations

  • If the asset that is used in Drupal is updated in Bynder, it will also be updated in Drupal 8. The metadata will not be updated, though. However, you can configure the CDN to always point to the latest version of a file or to a specific version. The URL in Drupal does not get updated so depending on the CDN configuration it either serves the latest version or the version that was used when it was added.

Learn more