Skip to main content
  • Agency for web development
  • Content Management with Primer
  • Open Source Leadership with Drupal
  • Contact
  • Agency for web development
  • Content Management with Primer
  • Open Source Leadership with Drupal
close
  1. Home
  2. Bynder documentation

Initial Configuration

When installing Bynder, you can choose to enable its demo module as well (drush en bynder_demo), which will add a new Content type "bynder_example", a configured entity browser and document and video media types. You can use this example configuration to quickly try out the Bynder integration, but for actual websites, we recommend to create the necessary configuration yourself since you will certainly have your existing content types and more specific requirements.

To perform the first configuration of Bynder on your website, you will need to make sure that:

  • At least one Media Type is present
  • your Content Types contain Media Entity Reference
  • You use an Entity Browser Widget to select and optionally upload Bynder assets

Media Type

The bynder module uses Media entities to store information about bynder assets that can then be used in Drupal. Unlike media types that store their asset locally, the Bynder media types just store the bynder asset ID and some metadata like the URL for the different variations of an image. Only a small preview of the asset is stored locally, for the media library.

As the image is not stored locally, it is not possible to use the Drupal Image Style system, instead, formatters are provided that allow to display the image in one of the variations (derivatives) provided by Bynder or as a link, for documents.

Check at Admin > Structure > Media that the Bynder Media Type is present.

Bynder MediaType

If you want to also use document assets from Bynder, create a "Bynder Document" media type and configure it with the Bynder document formatter. You can similarly create a "Bynder Video" media type and configure it with the Bynder video formatter. In some specific cases, you may want to create more Media Types depending on your needs.

Note that currently, only one image, document and video media type can be used per entity browser configuration.

Follow these steps if you need to create a new Media Entity Type. Choose "Bynder" as Media source.

Reference Entities in Content

Second, your Content types (or Paragraph types or other content structures) should contain a field of type: Entity reference with a target type of Media.

If you are already using media entities, then this will already be present and you need to instead make sure that the Bynder media types are allowed to be selected either exclusively or additionally, depending on your use cases.

In your Content structure, go to the "Manage fields" page. The url should look like: admin/structure/types/manage/your_content/fields.

Bynder Fields

Create a new media reference field by clicking on "Add field".

 

Bynder AddEntityReference

Then create a new Media reference or select an existing field.

Bynder NewEntityReference

Alternatively, for an existing field, edit the field to verify the bundle settings.

Bynder EntityReferenceEdit

After creating a field or editing an existing one, ensure that your Bynder media types are allowed on the field settings page.

Bynder EntityReferenceType

Entity Browser / Widget

The last step of the initial configuration is to make sure that you can access the proper media when creating content.

The Bynder module integrates with Entity Browser and provides two Widgets, one to select existing assets using the Bynder CompactView integration and an optional widget to upload new assets directly into Bynder from your Drupal installation.

In Admin > Configuration > Content authoring > Entity Browsers, look for the Entity Browser that you use for the Content Entity Type you are editing.

Tip: if you are not sure which Entity Browser is used for the Content Entity Type, go to Admin > Structure > Content Types > your_content > Manage Form Display. Then, find the Entity Browser field; the dropdown menu called "Entity browser" will tell you which one it is.

Bynder EntityBrowsers

Edit the proper Entity Browser, go to the "Widget Settings" tab, and add a new widget plugin: "Bynder search". The settings of this widget plugin are explained there.

You can optionally add the widget plugin "Bynder upload", which will allow users to upload media to Bynder directly from the website. See this page for more details.

Bynder BrowserEdit

If you had to create a new Entity Browser, do not forget to link it to the Content Entity Type. Go to Admin > Structure > Content Types > your_content > Manage Form Display.

Bynder ManageFormDisplay

Make sure the Entity Browser widget is selected: click on the gears to modify the Entity Browser field and select the new Entity Browser. Adjust the other settings per your preference, to for example display a preview of the media entity while editing.

Bynder ManageFormDisplayEntityBrowser

Navigation

  • Setup
  • Initial Configuration
  • Display Configuration
  • Edit Bynder asset browser
  • Add a media in content
  • Upload a file
  • Update Metadata
  • SNS Notifications
  • Common issues
  • Transformations with Single File Selection

About Open Source

At MD Systems, we believe in collaborative and open work. That's why we invest a lot in Open Source. We believe that you as a business can also profit from it, but information is hard to obtain. That's why we created this platform, so that you can more easily understand what Open Source can do for you.

MD Systems GmbH

Hermetschloostrasse 77, CH-8048 Zürich

Switzerland

+41 44 500 45 95

primer@md-systems.ch

  • Contact
  • Impress

© Copyright 2021 MD Systems GmbH. All rights reserved. Built with PRIMER - powered by Drupal.