Package: collective.embedly
IntroductionThis package provides TinyMCE visual editor support for embed.ly service:
videos, images and other rich media 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 more than 200 services that support embed.ly service. These are such
video sharing sites as Youtube, Blip.tv, Vimeo; such audio streaming services
as Grooveshark, SoundCloud, last.fm; such image/photo stocks as Flickr, and
many other: GoogleMaps, Facebook, Twitter, etc.This product was developed byhttp://quintagroup.comfor Plone collective,
sponsored by Headnet ApShttp://headnet.dk.UsageTo embed media from the embedly-supported external resource to Plone:Go to the object’s edit form, select some text and click
‘Insert/Edit Embedly link’ button.In the panel add link and configure extra parameters in ‘Advanced’ tab.
Checkhttp://embed.ly/docs/argumentsfor params description.The text should now look like linked. TinyMCE makes the whole passage linked,
so keep in mind that the whole passage will later be substituted with
embedded media.Save this page. Now when rendered, there will be “preview” from embed.ly
service inserted instead of the linked text.More about usage athttp://projects.quintagroup.com/products/wiki/collective.embedlyNotecollective.embedly does not fix errors in provided URLsyou can check if your URL will be transformed calling embed.ly manualy, for example:o video URLhttp://www.youtube.com/watch?v=L1NPLlhFTVko you should callhttp://api.embed.ly/1/oembedsetting ‘url’ parameter with your value
ohttp://api.embed.ly/1/oembed?url=http://www.youtube.com/watch?v=L1NPLlhFTVk
ohttp://api.embed.ly/1/oembed?url=http://www.youtube.com/watch?v=L1NPLlhFTVk&fromat=xml format result as xmlYou can set parameters by going to the Plone control panel / Embedly settings:o cache usage and timeout
o service URL verification
o API keyYou can update the regular expression for supported services by callinghttp://yourhost/plonesite/@@update_embedly_servicesThe default is to not pass along an API key, your requests to embedly will be
anonymous and based solely on IP address.Supported Plone VersionPlone 4.xContributorsVolodymyr CherepanyakRoman KozlovskyiSerhiy ValchukClayton ParkerLaurent LasudryHarald FriessneggerChangelog2.4 - May 6, 2015Internationalization added
[lepri]add url of document that caused embedly error in the error log
(this fixes #12) [fRiSi]Add rel=0 setting to not show related videos in
youtube embeds.
[fRiSi]Add German translations. [fRiSi]2.3 - Jan 29, 2014Add control panel to manage settings
[laulaz]2.2 - Aug 29, 2013Don’t cache errors in persistent cache
[kroman0]Added persistent cache and cache timeout
[kroman0]2.1 - May 13, 2013Updated embed.ly api url
[kroman0]support urls containing non-asci characters such ashttp://maps.google.com/maps?q=%C3%96sterreich(fixes #5)
[fRiSi]added ‘Use services regexp’ bool field to registry.
(fixes #4)
[kroman0]2.0 - Feb 25, 2013change tests structure
[kroman0]added acceptance tests
[kroman0]added TinyMCE plugin
[kroman0]cleanup genericsetup profiles
[kroman0]1.7 - Nov 23, 2011added view for updating embedly services manuallyhandling of empty api_key addedlocal cache of available services updated1.6 - Sep 14, 2011Only run the uninstall profile when the product is being uninstalled.
This allows for the api key to survive through a reinstall.
[claytron]Add support for passing the embedly API key
[claytron]1.5 - Sep 2, 2011href distinguishing regular expression improvedlogging added1.4.1 - Aug 8, 2011typpos in CSS fixed1.4 - Apr 26, 2011URL parameters parsing algorithm updated1.3 - Apr 05, 2011maxwidth, maxheight, callback, wmode params support addedupdated list of embedly services1.2 - Mar 29, 2011the embedly link now marked with icon and background in TinyMCE1.1 - Mar 4, 2011proper registration of embedly transformation done; does not clash with
safe HTML transform from now on1.0 - Mar 3, 2011Initial release