Changes between Version 13 and Version 14 of collective.embedly

Timestamp:

Mar 2, 2011 10:06:43 AM (14 years ago)

Author:

olha

Comment:

--

collective.embedly

@@ -10 +10 @@
 == Overview ==
 
-This package provides TinyMCE visual editor support for [http://api.embed.ly/docs embed.ly] service, so that media (audio, video, photo, ...) can be inserted to Plone from different services: video streaming services, audio resources, photo stocks, etc.
+This package provides TinyMCE visual editor support for [http://api.embed.ly/docs 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.
 
-The approach here is to use the Transform machinery to replace the URL with embed code by calling the embed.ly API.
+There are [http://api.embed.ly 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
 
 == Usage ==
 
- 1. Go to your site '''HTML Filtering''' panel (/@@filter-controlpanel) and remove ''embed'' and ''object'' from the list of '''Nasty tags''' and add them to the list of '''Custom tags'''.
+To embed media from the embedly-supported external resource to Plone:
+
+ 1. Go to your site '''HTML Filtering''' panel (/@@filter-controlpanel) and add tags that are used for embedding content from that external service into the list of '''Custom Tags''' and remove them from the lissts of '''Nasty Tags''' and '''Stripped Tags'''. These are usually such tags as ''embed'', ''object'', ''iframe'' and others. 
 
  2. Go to the object's edit form, select some text and choose "Embedly link" style  for it
@@ -22 +28 @@
  [[Image(style.png, nolink)]]   
 
- 3. The text should now look like linked (TinyMCE makes the whole passage linked)
- 4. Select this text again and go to ''Insert link'' to insert the URL to the desired object (e.g. ''!http://youtube.com/..'').
+ 3. 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.
+ 4. Select this text again and go to ''Insert link'' to insert the URL to the desired object on the external service.
  5. Save this page
 
 Now when rendered, there will be "preview" from embed.ly service inserted instead of the linked text.
 
- [[Image(page.png, nolink)]]
+== Examples ==
 
+Let's consider adding links to objects on such sites as:
+
+=== 1. !YouTube on Plone ===
+
+http://www.youtube.com/watch?v=LBDtqdOG4Uc
+
+[[Image(page.png, nolink)]]
+
+
+=== 2. blip.tv on Plone ===
+
+http://quintagroup.blip.tv/file/2074802
+
+=== 3. Flickr on Plone ===
+
+http://www.flickr.com/photos/quintagroup/3468489696
+
+=== 4. Google Maps on Plone ===
+
+http://maps.google.com/maps?f=q&source=s_q&hl=en&geocode=&q=lviv&aq=&sll=49.85,24.016667&sspn=0.300621,0.617294&ie=UTF8&hq=&hnear=L%27viv,+L%27vivs%27ka+oblast,+Ukraine&z=12&iwloc=A
+
+
+