Drupal Connect

For the most up-to-date documentation, please visit docs.brix.ch

Drupal celum:connect is a Drupal 8 extension, which allows you to download assets from CELUM via the CELUM Asset Picker directly into the Drupal 8 filesystem and use it in a post, or just link it from celum in your Drupal 8 post.

1. Installation

  • copy the media_celum_connect folder into the module directory of your Drupal 8 installation (sites/all/modules).
  • In the Drupal 8 backend, go to "Extend" and check the checkbox next to "Media celum:connect" in the module list. drupal:connect install

2. Configuration

  • In the Drupal 8 backend, go to "Configuration" and click on "Celum:connect configuration" in the web services section. drupal:connect configure 1
  • Define the celum license (delivered by brix cross media), the api key (from the CMA in celum), the language locale and the desired download formats, drupal:connect configure 2
  • set the usage name for downloading and linking assets, this names will be used in celum to mark the assets as used in Drupal.
  • Save the configuration

3. Creating a content type

  • In the Drupal 8 backend, go to Structure->Content types
  • Add a new content type or edit an existing one
  • Go to manage fields and add a new field of type "Celum:connect field"
  • Go to field settings and change the desired settings drupal:connect configure content type

4. Using the new content type

  • Add new content with Content->Add content and choose the newly created/edited content type
  • Click on the Select assets button in the previously created celum:connect field drupal:connect widget
  • Choose the desired asset
  • Choose the desired download format
  • Choose between download and link the assets drupal:connect asset picker drupal:connect asset added

Release Notes


Released 2017-02-01

  • Initial version

Released 2018-04-05

  • Link and download mode added (direct Download plugin required)
  • Usage will be written to the asset in celum

Released 2018-08-02

  • Asset Picker version selectable

Released 2018-08-03

  • License with expiration date

Released 2018-08-23

  • additionalDownloadFormats property for AssetPicker

Released 2018-08-28

  • DirectDownload url fix, widget text adapted

Released 2019-01-29

  • AssetPicker 2.5 and AssetPicker 2.5.2 added

Released 2019-02-12

  • AssetPicker 2.51 added

Released 2019-02-15

  • DirectDownload token compatibility added (option for DirectDownload secret)

Released 2019-07-29

  • Plugin Name capitalized and helpp hook implemented (new plugin guidelines)