Drupal 8 and 9 Integration
When you integrate Drupal 8 with Bynder you can add image and document assets from Bynder to your Drupal 8 or 9 content using our Compact View. The integration ensures that the latest version of your Bynder assets is automatically reflected in your Drupal content. Make use of the media asset translations that Drupal offers. Find out below how you can start making use of this integration.
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
The available plugins support Drupal 8 or both 8 and 9. If you are upgrading from Drupal 7, uninstall the Drupal 7 plugin, and install the one for Drupal 8 or 9.
Available Integrations
4.x
This is the preferred Drupal integration, which supports both Drupal 8 and 9. You can find the requirements and main features below:
Requirements
Only supports OAuth 2.0
Requires Entity Usage 2.x
Features
Supports Drupal 8 and 9
Makes use of the Compact View
Add images, videos and documents to your Drupal content
Map an asset type to a specific media type in Drupal
8.x-2.x
This Drupal integration supports Drupal 8 and 9 and is based on the Drupal core media module.
8.x-1.x
This Drupal integration is using the core Media module and supports Drupal 8. There's only minimum support for this integration.
If you have an existing site with Media Entity 1.x and you want to upgrade to Media in core, you need to update the code of this module from 1.x to 2.x or later. Please check the upgrade instructions on the project's documentation page for more information on that process.
Comparison Table
Features | 4.x | 8.x-2.x | 8.x-1.x |
|---|---|---|---|
Drupal 8 Compatible | ✅ | ✅ | ✅ |
Drupal 9 Compatible | ✅ | ✅ | ❌ |
OAuth 2.0 | ✅ | ❌ | ❌ |
✅ | ❌ | ❌ | |
✅ | ❌ | ❌ | |
✅ | ❌ | ❌ | |
Add Images to Drupal Content | ✅ | ✅ | ✅ |
Add Videos to Drupal Content | ✅ | ❌ | ❌ |
Add Documents to Drupal Content | ✅ | ❌ | ❌ |
Support Available for Integration | ✅ | ✅ | ❌ |
Derivatives and Dynamic Asset Transformations
There are three basic derivative sizes created initially (webimage, mini and thul (thumbnail)). The Drupal integration also supports Dynamic Asset Transformations (DAT). 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.
Read more about derivatives here. Read more about using Dynamic Asset Transformations in Drupal here.
How to Download, Install and Configure the Drupal Integration?
Check the download, installation and configuration instructions for our available Drupal integrations below.
4.x
8.x-2.x
Click here for download, installation and configuration instructions for the 8.x-2.x Drupal integration.
8.x-1.x
Click here for download, installation and configuration instructions for the 8.x-2.x Drupal integration.
Use the Plugin
Attach Bynder Media to Content
To attach a Bynder asset to your content, open the content page and click Select assets in the Media Assets section.
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
Log in to the portal the usual way.
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 content.
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.
Upload Assets to Bynder
Bynder uploader widget allows uploading assets from a Drupal site to Bynder. You can upload more than one file at a time. If the description text is provided it will be used for all assets that are uploaded in a given step. You need to log in before you can start uploading.
Note
Depending on the setup of the integration the possibility to upload assets to Bynder may not be available.
To upload an asset to Bynder, go to a content page and click Select assets in the Media Assets section.
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
Log in to the portal the usual way.
Open the Upload tab, which you can find at the top of the Compact View.
In the File upload section click the Select files button.
Select the files you want to upload from your device and click the Upload assets button.
Depending on your Bynder permissions, the assets you upload from Drupal can go to the Waiting Room or directly to the Asset Bank. You also need to be able to upload media to Bynder in your Bynder permission profile to upload files from Drupal.
Note
Even if you do not have the permissions to upload files to Bynder, you will still see the upload tab in Drupal. However, the assets will not be uploaded to Bynder if you try to upload.
After you have uploaded the asset, you can search for it on the description you provided. However, currently the files do not display any indication that they have been uploaded from Drupal.
Note
Currently we do not ingest the metadata embedded in the Drupal asset when you upload this asset to Bynder.
Edit Bynder Assets in Drupal
Go to Content and open the Media tab.
Select the asset you want to edit.
Click Edit.
Introduce your changes and click the Save button.
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
Go to Content and open the Media tab.
Select the asset(s) you want to remove.
Open the Action dropdown and click Delete media.
Click the Apply to selected items button.
Read the warning message carefully and click Delete to permanently remove the asset in Drupal.
Asset Translations
After uploading your Bynder asset to your Drupal website you can directly modify it on the website, and in particular you can translate the related media fields. For example, the Description field, but it works the same for the title, alt title or any other fields. Follow the steps below to access your Bynder media translations.
Make sure you've uploaded your Bynder asset(s) to your Drupal content page.
In Drupal go to Content and open the content type where you can find the Bynder image.
Go to the Bynder media usage tab. You'll get to see a list of media that have been added to the content.
Click the Edit button for the media you want to translate.
Open the Language dropdown and select the language you want to translate.
Enter the translations in the available fields such as the Description field.
Click Save to save the translations.
(Optional) Repeat steps 5-7 to enter translations for other languages.
SNS Notifications
If you use a custom CDN or you want to copy the assets to Drupal's own library you can automatically update your assets by using SNS notifications. The moment a new version of the asset is uploaded to your Bynder portal the changes will be automatically reflected in Drupal. SNS notifications are supported in the Drupal 4.x integration.
Read more about Bynder SNS notifications here and read more about setting up SNS notifications in your Drupal 4.x integration here.
Limitations
When you use the default AWS CDN of Bynder your assets will be automatically updated in Drupal if they're updated in Bynder. However, the metadata will not be updated.