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
- 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 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.
2. Configuration
- In the Drupal 8 backend, go to "Configuration" and click on "Celum:connect configuration" in the web services section.
- 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 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 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
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 |
-
(+) 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
- Choose the desired asset
- Choose the desired download format
- Choose between download and link the assets
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)
© brix IT Solutions