Contents

Convert a Url to image or video embed.

Supports:

 - Youtube
 - Vimeo
 - ... soon more ...

Install
=======
    sudo gem install url_to_media_tag
Or

    rails plugin install git://github.com/grosser/url_to_media_tag.git

Usage
=====
### Convert

    UrlToMediaTag.convert('http://www.youtube.com/watch?v=kW-dS4otEZU') # -> <iframe ...>
    UrlToMediaTag.convert(url, :width => 480, :height => 320)           # -> <iframe ...>
    UrlToMediaTag.convert('http://foo.com/xxx.jpg')                     # -> <img
    UrlToMediaTag.convert('no-url')                                     # -> nil

### settings

More specific settings overwrite others

    UrlToMediaTag.convert(url, :width => '400px', :settings => {:image => {:width => '100%'}, :vimeo => {:show_title => true})
    any   -> :width => '400px'
    image -> :width => '100%'
    vimeo -> :width => '400px', :show_title => true

Videos get default settings

    :width => 640,
    :height => 480,
    :class => "url-to-media-tag-video",
    :frameborder => 0

### Find

    urls = text.scan(%r{https?://[^\s]*})

### Replace

    text_with_embed = text.gsub(%r{https?://[^\s]*}){|url| UrlToMediaTag.convert(url) }

Alternative
===========
 - [auto_html](https://github.com/dejan/auto_html) If you want more fancy stuff like auto-linking + strip-tags + active-record-integration (and more dependencies / C-extensions)

TODO
====
 - let users choose which providers to convert

Author
======
Filter logic borrowed from Dejan Simic`s [auto_html](https://github.com/dejan/auto_html) MIT-LICENSE

[Michael Grosser](http://grosser.it)<br/>
[e-mail]<br/>
Hereby placed under public domain, do what you want, just do not hold me accountable...

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
url_to_media_tag-0.1.3	Readme.md