zeticon/drupal-media-mediahaven

A Drupal module to integrate MediaHaven with the Media module

DISCLAIMER

This module is no longer actively supported by Zeticon. The latest version of the module is compatible with MediaHaven version 15.1, Zeticon no longer guarantees compatibility with later versions of the MediaHaven platform. You are free to use the code as a guideline for your integration implementations. The latest documentation of the API can be found at MediaHaven API documentation., _(*1)

drupal-media-mediahaven

This configuration guide is based on the standard drupal installation, the current version of drupal is 7.25. Any issues can be reported to [github] (https://github.com/Zeticon/drupal-media-mediahaven/issues)., _(*2)

For more information please visit www.zeticon.com or contact us at info@zeticon.com, _(*3)

Server Requirements

Curl must be installed and enabled to run the Mediahaven plugin, _(*4)

Install the media_mediahaven module

Download the latest release and copy the mediahaven module to "sites/all/modules" and rename the folder to "media_mediahaven" if necessary or rename the zip file to "media_mediahaven" before uploading., _(*5)

Required Modules

Upload the following required modules into the folder "sites/all/modules", some modules require additional modules to operate! * [Media 2.x] (https://drupal.org/project/media) * File_entity * Views * Ctools * Styles * Plupload, _(*6)

Go to the "Modules" panel in your admin view and enable the listed modules., _(*7)

Required Library

Additionally to the module "plupload", the plupload library is required. Download the plupload package from: www.plupload.com/download. It is important to note that the current php plupload module does not work with the 2+ version of the library. You will need to download version 1.5.x., _(*8)

Create a new folder "libraries" under "sites/all/" and upload the plupload package to this folder and extract it there. Rename the extracted folder to 'plupload', so you have a folder structure: "sites/all/libraries/plupload"., _(*9)

Mediahaven Configuration Settings

MediaHaven API

MediaHaven login: The login to be used by the module to communicate with MediaHaven.
MediaHaven password: The password to be used by the module to communicate with MediaHaven.
MediaHaven url: The MediaHaven url., _(*10)

MediaHaven Upload settings

Ingestspace id: The MediaHaven ingestspace that will be used to upload files to.
Auto publish: When enabled files will be automatically published after processing. If disabled a user will have to manually publish them using the mediahaven media management software.
Department id: The default department where uploaded files will belong to. This will be used when autopublishing is enabled., _(*11)

MediaHaven Thumbnail settings

Thumbnail width: Width of the thumbnails (in pixels), standard is 150px
Thumbnail height: Height of the thumbnails (in pixels), standard is 150px, _(*12)

These settings require a Mediahaven account, for more information please visit www.zeticon.com, _(*13)

Configure a Media File Selector

Linking media items to a node requires the configuration of a Media Selector Field for mediahaven., _(*14)

Select "Structure" > "Content Types" from the main menu, followed by the operation "manage fields" for the preferred content type., _(*15)

Create a new field by entering a field name of your choice (eg 'Mediahaven Image'), select the field type "Multimedia Asset" (preferred) or "File". Set the widget to "Media File Selector" and confirm by subsequently clicking the "Save"-button and "Save Field"-button., _(*16)

To complete the setup configure the following settings: *enable "Mediahaven" in the enabled browser plugins, *enable alle desired file types in Allowed remote media types *select "mediahaven:// (MediaHaven media)" in Allowed URI schemes, _(*17)

When editing a node of the content type, a Media Selector Field should be available., _(*18)

WYSIWYG

ckeditor

https://drupal.org/comment/6814058#comment-6814058, _(*19)

Media Browser

To enable MediaHaven file selection form within the media browser * go to "configuration/media browser settings" and check MediaHaven., _(*20)

Ajax callbacks in the media overlay cause the active tab to switch tab unexpectedly

This is a known issue and can be fixed with this patch: https://drupal.org/node/1802026, _(*21)

Usage of the module

In order to include media from Mediahaven into Drupal, go to Content and click the link "Add Media from Mediahaven". Enter a search term and/or click any of the provided facets. Select an by clicking on the image. A confirmation "Successfully added media" will be shown and the media file will be available for usage under the "Files" tab., _(*22)

Test environment

The module and the rest-api webservices can be tested against an integration platform: https://integration.mediahaven.com . This setup will be reset every day at 6am CET, so keep in mind that your data will be lost and that the environment will be unavailable during 10 to 15 minutes., _(*23)

Following configuration settings can be used: * url: https://integration.mediahaven.com/ * login: apikey
* password: apikey * ingestspace_id : 5ebefe86-279c-4e19-857c-23ec0e975278 * department_id : cc6ea4c0-c7e9-44e3-906e-8b689d95c8f2, _(*24)

The rest webservices url: https://integration.mediahaven.com/mediahaven-rest-api/, _(*25)