Easily embed media (with options) into haml/erb templates, bypassing the need to use JavaScript APIs if desired.

This gem comes bundled with a railtie for automatic Rails integration.

Currently supports:

• Youtube
• Vimeo

• Soundcloud

Add this line to your application's Gemfile:

gem 'media_embed'

And then execute:

$ bundle

Or install it yourself as:

$ gem install media_embed

Include MediaEmbed::Handler into your class and use the embed method with an optional options hash.

class Post
  include MediaEmbed::Handler

  def media(options = {})
    embed(@url, options)
  end
end

If you're using Rails, you can directly embed your URLs into your template:

<div id='my-fancy-media'>
  <%= embed(url, @options).html_safe %>
</div>

The embed method takes an optional options hash.

embed(url, { width: '500px', height: '500px', autoplay: true })

Any of the following whitelisted options can be specified:

See w3schools.com IFrame tag page for more information about the accepted attributes.

See the IFrame Player API reference for more information about the accepted parameters.

See the player embedding reference for more information about the accepted parameters.

See the Soundcloud Widget API docs or the Widget docs for more information about the accepted parameters.

A single-level hash assumes that you want all iframes to behave the same way. Including a parameter that is only whitelisted for one service will not effect any of the others.

{ show_user: 0, width: '500px' } will set all iframes to 500px wide, but only the Soundcloud iframes will append '&show_user=0' to its source.

If you want iframes to behave differently, or just want to clarify which options belong to which services, you can break the hash down with keywords for each service (soundcloud, youtube, and vimeo):

{
  soundcloud: {
    width: '200px'
  },
  youtube: {
    autoplay: 1,
    color: 'white'
  },
  loop: 0,
  autoplay: 0,
  width: '500px',
  show_artwork: 0
}

The aforementioned hash:

• will render Soundcloud iframes at 200px wide, and all others at 500px wide
• YouTube iframes will autoplay, all other iframes will not
• YouTube iframes will be white, all others will have their default color
• no iframes will loop
• Soundcloud will not show artwork, and no other iframe will be rendered with the show_artwork parameter

In short, top-level parameters will be used in all iframes where the given parameter is whitelisted. Parameters under a service key will override all top-level parameters for that service.

If you would rather use a provided JS API to control your videos, simply supply the necessary parameters ({ enablejsapi: 1, origin: "#{yourdomainhere}"} for YouTube, for example) and go about your normal day with the JavaScript.

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

• Continue to build regex/template matchers for any other embeddable media.

Bug reports and pull requests are welcome on GitHub at https://github.com/littlelines/embed_media.

If submitting a PR, please include tests and relevant information to the README.

The gem is available as open source under the terms of the MIT License.