collective.embedly

Usage

To embed media from the embedly-supported external resource to Plone:

• Go to the object's edit form, select some text and choose 'Embedly link' style for it.
• 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.
• Select this text again and go to Insert link to insert the URL to the desired object on the external service.
• Save this page. Now when rendered, there will be "preview" from embed.ly service inserted instead of the linked text.
• You can pass resize the embeded object passing 'maxwidth', 'maxheight' params. Example: http://www.youtube.com/watch?v=L1NPLlhFTVk&maxwidth=400&maxheight=300
• Also 'wmode' and 'callback' are available. Consult embed.ly documentation for usage.

More about usage at http://projects.quintagroup.com/products/wiki/collective.embedly

Note

• collective.embedly does not fix errors in provided URLs

• you can check if your URL will be transformed calling embed.ly manualy, for example:

  o video URL http://www.youtube.com/watch?v=L1NPLlhFTVk o you should call http://api.embed.ly/v1/api/oembed setting 'url' parameter with your value o http://api.embed.ly/v1/api/oembed?url=http://www.youtube.com/watch?v=L1NPLlhFTVk o http://api.embed.ly/v1/api/oembed?url=http://www.youtube.com/watch?v=L1NPLlhFTVk&fromat=xml format result as xml

• You can set the API key by going to Site Setup -> Configuration Registry and setting the api_key value. The default is to not pass along a key, your requests to embedly will be anonymous and based solely on IP address.

Supported Plone Version

• Plone 4.x

Contributors

• Volodymyr Cherepanyak
• Roman Kozlovskyi
• Serhiy Valchuk
• Clayton Parker

1.7 - Nov 23, 2011

• added view for updating embedly services manually
• handling of empty api_key added
• local cache of available services updated

1.6 - Sep 14, 2011

• Only 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, 2011

• href distinguishing regular expression improved
• logging added

1.4.1 - Aug 8, 2011

• typpos in CSS fixed

1.4 - Apr 26, 2011

• URL parameters parsing algorithm updated

1.3 - Apr 05, 2011

• maxwidth, maxheight, callback, wmode params support added
• updated list of embedly services

1.2 - Mar 29, 2011

• the embedly link now marked with icon and background in TinyMCE

1.1 - Mar 4, 2011

• proper registration of embedly transformation done; does not clash with safe HTML transform from now on

1.0 - Mar 3, 2011

• Initial release