collective.embedly

Links

• collective.embedly on Quintagroup.com
• ​collective.embedly on plone.org
• ​collective.embedly om PyPi
• ​Repository
• ​Build status

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: Grooveshark, SoundCloud, last.fm
• image/photo sticks: Flickr
• other: GoogleMaps, Facebook, Twitter

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 collective embedly interfaces IEmbedlySettings api_key in your portal_registry section.

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, click "Insert/Edit? Embedly link" on the toolbar

2. 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"

3. Save this page.

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

Notes

• collective.embedly does not fix errors in provided URLs
• you can check if your URL will be transformed calling embed.ly manualy, for example:
  • video URL ​http://www.youtube.com/watch?v=L1NPLlhFTVk
  • you should call ​http://api.embed.ly/v1/api/oembed setting 'url' parameter with your value
  • ​http://api.embed.ly/v1/api/oembed?url=http://www.youtube.com/watch?v=L1NPLlhFTVk
  • ​http://api.embed.ly/v1/api/oembed?url=http://www.youtube.com/watch?v=L1NPLlhFTVk&fromat=xml format result as xml

Examples of usage

Please see the following pages to learn how to:

• How to embed videos from YouTube to Plone
• How to embed videos from blip.tv to Plone
• How to embed videos from vimeo to Plone
• How to embed videos from TED.com to Plone
• How to embed images from Flickr to Plone
• How to embed map from GoogleMaps to Plone
• How to embed audio from SoundCloud to Plone
• How to embed content from Facebook to Plone
• How to embed pdf files from Scribd to Plone