Knowledge Base

Integrate Bynder with SDL Tridion

You can use Bynder in your SDL Tridion environment to seamlessly

Skip directly to

Watch a video

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 used

Currently, derivatives are not supported. SDL Tridion downloads the original files from Bynder.

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">
    		<StubFolders>
    			<StubFolder id="tcm:2-37-2" />
    		</StubFolders>
    		<PrivilegedUserName>TRIVIDENT01\Administrator</PrivilegedUserName>
    		<EnvironmentUrl xmlns="ecl:BynderProvider">https://trivident.getbynder.com</EnvironmentUrl>
    		<ConsumerKey xmlns="ecl:BynderProvider">...</ConsumerKey>
    		<ConsumerSecret xmlns="ecl:BynderProvider">...</ConsumerSecret>
    		<TokenKey xmlns="ecl:BynderProvider">...</TokenKey>
    		<TokenSecret xmlns="ecl:BynderProvider">..</TokenSecret>
    		
    		<AssetNotFoundPlaceholderId xmlns="ecl:BynderProvider">...</AssetNotFoundPlaceholderId>
    		<DisplayMetaPropertyFolders xmlns="ecl:BynderProvider">enabled</DisplayMetaPropertyFolders>
    		<HideEmptyMetaPropertyFolders xmlns="ecl:BynderProvider">disabled</HideEmptyMetaPropertyFolders>
    		<AdditionalMediaPropertiesToShow xmlns="ecl:BynderProvider">views,dateCreated</AdditionalMediaPropertiesToShow>
    	</MountPoint><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>

    Note

    If you are unsure how to generate Bynder consumer secret and token, see Create API tokens for your app.

  7. 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">

    The hotfix should be active immediately. If you have XPM open in a browser you need to refresh the current browser tab.

  8. 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.

    asset-overview-tridion.png
  • 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.png
  • 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-asset-sdl.png

Learn more