Knowledge Base

Integrate Bynder with SDL Tridion

You can use Bynder in your SDL Tridion environment to seamlessly

Prerequisites

Before you install the plugin, you need to have the following things set up:

Supported versions

The following versions are supported: 

  • SDL Tridion 2013 SP1
  • SDL Web 8
  • SDL Web 8.5
  • SDL Tridion Sites 9
  • SDL Tridion Sites 9.1 (to be released by SDL shortly)

Derivatives

Identify the derivatives you would like to make available in SDL Tridion and make sure they are set to public. Contact your Customer Success Manager or Onboarding Consultant for assistance. Public derivatives are accessible in SDL Tridion via a folder per asset with each of the different derivatives available, for example webimage or banner. The derivatives will also be available through the source.

Installation and configuration

Download the plugin from the SDL appstore. Next, do the following in your SDL environment:

  1. Create a Stub folder named Bynder Provider in SDL under <Root Publication> (or the selected Publication in the BluePrint hierarchy)> Building Blocks > Default Templates > SDL External Content.
    For example: 000 Empty > Building Blocks > Default Templates > SDL External Content.
  2. Copy the folder's TCM URI (also known as Content Manager URI, see SDL documentation). You will need it later on.
  3. Create a directory called BynderProvider under C:\ProgramData\SDL\SDL Tridion\External Content Library\AddInPipeline\Addins\
  4. Copy the compiled DLLs to the directory from step 3. You can do it manually or using Visual Studio.
  5. Go to SDL Web home directory\SDL Web\config and open your ExternalContentLibrary.xml.
  6. In the ExternalContentLibrary.xml add the following code replacing all the variables in [] with values:

    <MountPoint type="BynderProvider" id="bynder" rootItemName="Bynder Provider">
    <StubFolders>
    	<StubFolder id="[STUB FOLDER TCM-URI]" />
    </StubFolders>
    <PrivilegedUserName>[SDL ADMIN USER]</PrivilegedUserName>
    <EnvironmentUrl xmlns="ecl:BynderProvider">[YOUR ENVIRONMENT URL, for example: https://myportal.bynder.com]</EnvironmentUrl>
    <ConsumerKey xmlns="ecl:BynderProvider">[BYNDER USER'S CONSUMER KEY]</ConsumerKey>
    <ConsumerSecret xmlns="ecl:BynderProvider">[BYNDER USER'S CONSUMER SECRET]</ConsumerSecret>
    <TokenKey xmlns="ecl:BynderProvider">[BYNDER USER'S TOKEN KEY]</TokenKey>
    <TokenSecret xmlns="ecl:BynderProvider">[BYNDER USER'S TOKEN SECRET]</TokenSecret>
    </MountPoint>

  7. If you are unsure how to generate Bynder consumer secret and token, see Create API tokens for your app.
  8. Apply the filtering hotfix. Do the following:
    1. Go to %SDLWEB%\web\WebUI\Editors\ExternalContentLibrary\Extensions\Views
    2. Create a backup the SiteEditEditor.Library.js file that you find in this location.
    3. Copy the SiteEditEditor.Library.js file that is included in the plugin zip to %SDLWEB%\web\WebUI\Editors\ExternalContentLibrary\Extensions\Views
    4. Open up the %SDLWEB%\web\WebUI\WebRoot\Configuration\System.config file.
    5. In the attribute 'modification' in the <server> element increase the counter by one: <server version="8.5.0.22656" modification="21">
  9. The hotfix should be active immediately. If you have XPM open in a browser you need to refresh the current browser tab.

  10. Restart SDL services and verify that you can see the Bynder Provider folder and you can browse the assets in your environment through WebSDL.

Use the plugin

  • You can access your Bynder asset overview within Tridion assets by opening the Bynder Provider folder.

  • Use the Search box to search assets on keywords.
  • Click Toggle View to change to list view and filter the columns in your view.

    list view sdl

  • When you use Bynder assets in SDL, we do not copy the asset but use its URL. In this way your CMS displays the latest version of the asset available in Bynder. To select an asset, open the Bynder Provider folder and select your asset.

    use assets in Tridion

Watch a video

Learn more