FR

EN

Drupal dashboard

Streamlike oEmbed integration in Drupal

Drupal can now embed Streamlike media simply by pasting their URL. This feature, made possible by the oEmbed protocol, is quick and easy to set up.

oEmbed ?

oEmbed is a protocol that allows you to easily integrate dynamic content (videos, images, tweets…) from different websites into any other website or application, by simply providing a URL.

Streamlike supports oEmbed since version 5.53

To learn more about the oEmbed protocol: https://oembed.com

oEmbed in Drupal

Since version 8.8, Drupal Core offers a media module that allows users with the appropriate permissions to upload, manage and reuse media of all types.

Among the media types offered is the “Remote Video” type, which allows you to declare the URL of a video from a streaming service, and to generate the display automatically.

This functionality is based on oEmbed. By default, the “URL” field of this media type accepts YouTube and Vimeo URLs, but Streamlike can be added as an “oEmbed provider” using a simple community module.

Declaration of Streamlike as oEmbed provider in Drupal

Step 1/3: Installing the “oEmbed Providers” module

Go to the “oEmbed Providers” module page on drupal.org: https://www.drupal.org/project/oembed_providers

This page also provides a complete description of the features and settings of the module.

Install the module in the usual way (preferably using composer):

Step 2/3: Setting up the “oEmbed Providers” module

Go to the module settings form at : /admin/config/media/oembed-providers

> « General » tab

Leave the default settings.

> « Custom Providers » tab

Add an oEmbed provider(« + Add oEmbed provider » at the top right)

Fill in the fields with the following values:

  • Provider name: Streamlike
  • Provider URL: https://cdn.streamlike.com
  • Endpoints / Endpoint #1
    • Endpoint schemes = https://cdn.streamlike.com/play?med_id=*
    • Endpoint URL = https://cdn.streamlike.com/oembed
    • Discovery = enable
    • Available formats = check JSON and XML

Save the settings.

> « Provider Buckets » Tab

Les « providers buckets » sont des groupes de providers utilisés pour l’intégration.

Ajoutez un « provider bucket » (« + Add provider bucket » en haut à droite)

Renseignez les champs avec les valeurs suivantes :

  • Bucket name = video (system name : video)
    NB : this naming must be strictly respected because the media type ” Remote Video ” only uses this one.
  • Description (optional) = for example, Streamlike
  • Allowed Providers = in the list of all the proposed providers, check “Streamlike” as well as all the other providers you wish to integrate.
    NB: this list will replace the default services (Youtube and Vimeo). If you want to offer support for these services, you have to re-select them here.

Save the settings.

Step 3/3: Select available providers for “Remote Video”

Edit the “Remote Video” media type: /admin/structure/media/manage/remote_video

In the “Media source configuration” section, check the authorized providers in “Allowed Providers”.

The media type “Remote Video” is now ready to use Streamlike.

Entering a Streamlike “Remote Video” media type

Add a new media of type ” Remote Video ” : /media/add/remote_video

Below the field is a list of currently supported services, of which “Streamlike” must be included:

Paste the url of a Streamlike media and save the media.

Your Streamlike media is now available in Drupal media, and available to all related features.

How do I get the Streamlike media URL?

The Streamlike media url is of the form

https://cdn.streamlike.com/play?med_id=<id_du_media>

The media ID can be copied directly from the Streamlike console’s “Media” view by hovering over the media thumbnail and clicking on the icon at the bottom right:

Share this post

Subscribe to this blog

Enter your email address to subscribe to this blog and receive notification of each new post by email.