Drupal Connect

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

Asset-Picker

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

1. Installation

  • Get the extension from the store
  • Upload the file via admin/modules/install or copy the extracted media_celum_connect folder into the module directory of your Drupal installation (sites/all/modules).
  • In the Drupal 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 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 IT Solutions), the api key (from the CMA in celum), the language locale and the desired download formats.
  • Set one or multiple (comma separated) root nodes
  • Set a "Title information field name" to save the asset to drupal with a title value from a CELUM information field, if not set, the asset name will be used as title.
  • Check "link only" if the user should only have the possibility to link the assets, not to odownload it to drupal. drupal:connect configure 2
  • Set the usage name for downloading and linking assets, these 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 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

3.1. Compatibility Matrix

REST API version CELUM 6 CELUM 5.13.x CELUM 5.12.x Asset Picker version
rest-all-2.1 5.13.0 (+) 5.12.3 (+) 2.0
rest-all-2.1 5.13.2 (-) 2.1
rest-all-2.2 5.13.0 (+) 5.12.3 (+) 2.0
rest-all-2.2 5.13.2 (-) 2.1
rest-all-2.3 5.13.0 (+) 5.12.3 (+) 2.0
rest-all-2.3 5.13.2 (-) 2.1
rest-all-3.0 5.13.1 (+) 2.2
rest-all-3.0 5.13.2 (-) 2.3
rest-all-3.1 5.13.2 (+) 2.3
rest-all-3.2 5.13.3 (+) 2.4
rest-all-3.2 5.13.3 (+) 2.5
rest-all-3.3 5.13.3 (+) 2.5.1
rest-all-3.3 5.13.3 (+) 2.5.2
rest-all-4.0 18.12 (+) 3.0
rest-all-4.1 19.3 (+) 3.0
rest-all-4.2 19.6 (+) 3.0
rest-all-5.0 19.12 (+) 3.0
rest-all-6.8.11 20.9 (+) 6.8.11
rest-all-6.9.3 21.2 (+) 6.9.3

  • (+) The version is the first maintenance version in which a previously unsupported feature is added.

  • (-) The version is the first maintenance version in which a previously supported feature is removed.

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

1.0

Released 2017-02-01

  • Initial version
1.1

Released 2018-04-05

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

Released 2018-08-02

  • Asset Picker version selectable
1.3

Released 2018-08-03

  • License with expiration date
1.4

Released 2018-08-23

  • AdditionalDownloadFormats property for AssetPicker
1.5

Released 2018-08-28

  • DirectDownload url fix, widget text adapted
1.6

Released 2019-01-29

  • AssetPicker 2.5 and AssetPicker 2.5.2 added
1.7

Released 2019-02-12

  • AssetPicker 2.51 added
1.8

Released 2019-02-15

  • DirectDownload token compatibility added (option for DirectDownload secret)
1.11

Released 2019-07-29

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

Released 2019-12-03

  • AssetPicker 3.0 added (CELUM 6.2 Support)
1.13

Released 2020-01-29

  • CELUM 6.4 compatibility (Search feature)
1.18

Released 2021-04-16

  • Asset picker version 6.8.11 and 6.9.3 added, fix in preSave function
1.20

Released 2021-06-02

  • Store config.js in public folder (sites/default/celumconnect)
1.22

Released 2021-07-07

  • Bugfix path if not default drupal installation path
1.23

Released 2021-08-06

  • Link only flag in the configuration to prevent downloading images to drupal
1.30

Released 2021-08-11

  • Set title of an asset by a configured infofield from CELUM