Using the oEmbed Application
What is oEmbed?
OEmbed is a format for allowing an embedded representation of a URL. OEmbed’s official technical information can be found at http://www.oembed.com/. The oEmbed API allows Ellington to display links posted by users as the video or photo located at said link. OEmbed currently has four types of representations that can be rendered, photo video link and rich. Depending on what the source site has decided, links can be rendered as videos, photos, hyperlinks to said page, or rich html.
Template designers should examine this document </apps/oembed/template_changes for template details.
Ellington supports the following oEmbed providing sites
- 23Hq
- Imgur
- Phodroid
- Photobucket
- Tweetphoto
- Twitgoo
- Twitpic
- Xkcd
- Yfrog
- Amazon
- Gist.Github
- Paper.Li
- Scribd
- Plus.Google
- Clearspring
- Lala
- Storify
- Animoto
- Blip.Tv
- Collegehumor
- Crackle
- Dailymotion
- Dotsub
- Funnyordie
- Justin.Tv
- Liveleak
- Metacafe
- Movieclips
- Movies.Yahoo
- My.Opera
- Myspace
- Nfb.Ca
- Omnisio
- Revver
- Screencast
- Screenr
- Soundcloud
- Vine.Co
- Theonion
- Video.Google
- Video.Yahoo
- Wordpress.Tv
- 5Min
- Break
- Colbertnation
- Comedycentral
- Escapistmagazine
- Fancast
- Howcast
- Hulu
- Tedtalks
- Thedailyshow
- Traileraddict
- Twitvid
- Ustream.Tv
- Veoh
- Pownce
- Smugmug
- Viddler
- Wikipedia.Org
- Qik
- Revision3
- Vimeo
- Flickr
- Slideshare.Net
- Youtu.Be
- Youtube
Ellington is an OEmbed provider
We’ve implemented Oembed providers for many parts of Ellington. This allows Ellington content such as news stories and photos to be Oembeded by other consumers or by our own sites. The content types that are currently provided by Ellington’s Oembed app are:
- Events (These Events must have a URL with a date such as example.com/events/2010/apr/13/1/)
- Photos
- Videos
- Video Sets
- Gallery Sets
- Galleries
- Gallery Photos
- Stories (OEmbedded Media as an Inline)
- Places
- Podcast Shows
- Podcast Episodes
- Weblog Entries
A picture from an Ellington site, posted into a comment on that same Ellington site
Where can users use oEmbed?
An image preview with oEmbed
The results when posted
A preview of a video oEmbed
The Admin Panel
The OEmbed application contains 2 models.
Stored OEmbeds
This is a table of all successful oEmbeds. This is used as a cache so the same oEmbed can be placed multiple times without us having to ping the remote server.
Stored providers
These are custom oEmbed providers that are discovered by Ellington when a link from the provider’s site is posted to your site. Ellington will check for new oEmbed sites once a day, overnight, and populate the sites here. Each new provider is inactive by default, but may be activated if the site appears trustworthy. A site’s content will not be oEmbedded into your site without being accepted in the admin first.
To activate an oEmbed-capable site:
- Go to Stored providers
- Place a checkmark in the Active checkbox
- Save your changes
Example image of a Stored Content Provider
The content in the Stored Provider form is automatically generated by Ellington and should not be edited from the admin panel unless you are 100% positive what you are doing. In most cases regex is used to properly identify oEmbed URLs. You can find more documentation on regex and how to use it here.
0 Comments
Add your comment