wiki:collective.embedly

collective.embedly

This package provides TinyMCE visual editor support for embed.ly service: videos, images and other rich media files can be inserted to Plone from different services through one API. The approach here is to use the Transform machinery to replace the URL with embed code by calling the embed.ly API.

There are 204 services so far that support embedly service, such as:

  • video sharing sites: Youtube, Blip.tv, Vimeo, TED.com
  • audio streaming services: SoundCloud?, last.fm
  • image/photo sticks: Flickr, Picasa
  • other: GoogleMaps, Facebook

This product was developed by http://quintagroup.com for Plone collective, sponsored by Headnet company http://headnet.dk/.

Usage

To embed media from the embedly-supported external resource to Plone, first you will need to register in the embedly service. Upon completing sign up, you'll be provided with the API key. Copy and insert it into API Key field of Embedly settings (add /@@embedly-controlpanel to the site address).

Now you can embed content from more than 200 sharing sources. Follow these steps to insert videos, photos, music into Plone:

  1. Go to the object's edit form, select text (it will be replaced with the embedded media) and click "Insert/Edit? Embedly link" on the TinyMCE toolbar

  1. In the popup window type in the URL of the object. You may click "Preview" to make sure the link is correct. Then click "Insert"

  1. Save this page.

  1. You may customize video parameters (e.g. maxheight, maxwidth, autoplay) using Advanced settings tab.


You can set parameters by going to the Plone control panel / Embedly settings:

  • cache usage and timeout
  • service URL verification
  • API key

You can update the regular expression for supported services by calling

  http://yourhost/plonesite/@@update_embedly_services

The default is to not pass along an API key, your requests to embedly will be anonymous and based solely on IP address.

Notes

Examples of usage

Please see the following pages to learn how to:

Last modified 9 years ago Last modified on May 19, 2015 1:50:58 PM

Attachments (9)

Download all attachments as: .zip