collective.embedly 1.6

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