/oembed_field

Easily embed videos/images from ANY website that implements the oEmbed format

Primary LanguagePHPOtherNOASSERTION

Field: oEmbed

Version: 1.11.x

Easily embed videos/images from ANY* website that implements the oEmbed format

@see http://oembed.com

SPECS

  • Adds a field that takes as input the link to the page that has the embeded media
  • Caches the oEmbed XML info into the database
    • Easily incorporate this XML via your Data Sources
    • Refreshes the info each time the entry is saved
  • *Currently supported services:
    • Vimeo (http/https)
    • Youtube (https/https)
    • Dailymotion (http/https)
    • Twitter (http/https)
    • Instagram (http/https)
    • Facebook (http/https)
    • Embed.ly (http/https) * Non-native (requires an account to get the key)
    • Iframely (http/https) * Non-native
    • Flickr (http/https)
    • Qik (http)
    • Viddler (http)
    • SlideShare (http)
    • Soundcloud (http/https)
    • Mixcloud (http/https)
    • Noembed (http) * Non-native
    • Yours... Anybody can add a service!
      Just fork, code the missing Service Driver and request a pull!

REQUIREMENTS

  • Symphony CMS version 2.5.0 and up (as of the day of the last release of this extension)

INSTALLATION

  • git clone / download and unpack the tarball file
  • (re)Name the folder oembed_field
  • Put into the extension directory
  • Enable/install just like any other extension

See http://www.getsymphony.com/learn/tasks/view/install-an-extension/

Voila !

HOW TO USE

  • After installation, add a oEmbed field to a section
  • Configure the field
    • Select at least one supported driver
    • You can add extra parameters to the oEmbed request's query string: this is usefull for settings embed sizes
  • All the data will be available as xml in a datasource
  • Use the oembed tag for embeding the resource into your frontend

Non-native

"Non-native" solutions like embed.ly are tested after all other "native" solutions. This will allow you to enable both natives solution while being able to revert to a global fallback. If other non-native solutions are added, please do not enable more than one because this may cause un-wanted behavior.

TODO

  • Adds a auto-refresh data mechanism
  • Automatically add sites in the JIT authorized sites (for thumbnail and image services)
  • Add MySpace driver: Waiting for MySpace to complete their oEmbed service
  • Add Cinemagram driver: Waiting for Cinemagram to complete their oEmbed service
  • Add Issuu driver: Waiting for Issuu to complete their oEmbed service
  • Add UStream driver: Waiting for UStream to complete their oEmbed service

CREDITS

Come say hi! -> https://deuxhuithuit.com/

And thanks to everybody that added ServiceDrivers, reported bugs or submitted any improvements !

LICENSE

MIT. See the LICENSE file or http://deuxhuithuit.mit-license.org