=== Iframely Responsive Embeds === Contributors: psergeev, ivanp Tags: iframely, oembed, embed, responsive, video, youtube, vimeo, instagram, gist, fitvids, mu Requires at least: 2.9 Tested up to: 3.9.1 Stable tag: trunk License: MIT Iframely converts URLs in your posts into responsive embed widgets for 1500+ domains. == Description == [Iframely](http://iframe.ly?from=wp) brings you the responsive embeds and support of over 1500 domains. It means the embeds will resize, if possible, if you are on responsive theme. Iframely will detect URLs in your posts and replace it with embed codes for *over 1500 domains*. Supports all usual suspects such as YouTube, Vimeo, Instagram, GitHub Gists, Google +, Facebook Posts, Storify, SlideShare, well, you know, over 1.5 thousand of them and keeps growing. _How to use_: The plugin works the same way the standard oEmbed is supported by WordPress: URL on a separate line. For example, ` Check out this cool video: http://iframe.ly/fquGGl That was a cool video. ` Iframely also has its own shortcode `[iframely]http://your.url/here[/iframely]`. _Note of caution_: Some people expect Iframely to wrap URLs with <iframe src=...> code. That's not what Iframely is for. The plugin converts original URLs into native embed codes itself. _Options of use_: Depending on your settings, Iframely can be configured in one of the following three ways: - Detect only links that you manually shorten through [http://iframe.ly](http://iframe.ly) web shortener first (The short URL will come with the embed codes attached to it); - Process all links that you publish, on a separate line or in `[iframely]` shortcode (this will disable default WordPress oEmbeds on a separate line such as YouTube, Twitter) - Use Iframely in `[iframely]` shortcode only, leaving the default WordPress "URL on a separate line" processors in place. _API Key_: To enable non- `iframe.ly/*` web links parsers, you need to get & configure your API Key. Get a free key at [http://iframe.ly](http://iframe.ly?from=wp). If API Key isn't configured, the plugin will only process links of iframe.ly domain (so you'll need to manually shorten your media URLs first). The source code of the plugin is published [on GitHub](https://github.com/itteco/iframely-wordpress), if you'd like to tweak it yourself. == Installation == The installation is pretty standard: 1. Upload the package contents to to the `/wp-content/plugins/` directory 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Go to plugin settings to configure Iframely the way you want to use it. 4. If you'd like Iframely to process _all_ URLs, [get your FREE API Key here](http://iframe.ly). == Screenshots == Here's some samples of what Iframely supports. 1. Instagram sample 2. Vimeo sample 3. GitHub Gists 4. Google+ Posts 5. Imgur & Galleries 6. Facebook Statues 7. And many-many others == Frequently Asked Questions == = How do I resize my widgets? = Well, that's the point of responsive embeds. You don't have to. Iframely widgets will take 100% available width. If you need to limit it, just define your CSS styles for `iframely-widget-container`. Please, note that not all the embeds codes will be responsive. Some of hosting domains can not be converted responsively. In those cases, Iframely will left-align the embeds. You might want to consider padding and alignment styles, if you don't have generic ones for `iframes` and `images` yet. = Is it compatible with other embeds plugins I have? = * Iframely works in the same WordPress embeds framework as other plugins would. * Since default WordPress embeds are not responsive, Iframely can disable the standard code and replaces it with the responsive embeds. Otherwise, you might be wondering why is some widgets are not responsive * You can conifugure Iframely to only work in its own shortcode, thus leaving other plugins intact. = What about embeds in my previous posts? = Iframely works in native WordPress embeds framework. All your new posts should start seeing responsive widgets. The older posts will be re-cached via WordPress logic itself (usually when you edit and save the post), and should granually get the new embeds code too. However, we do not interfere into this default process and do not re-cache older posts upon install. If there's a specific post you'd like to update, just go to Edit and Save it again. It should re-cache it and trigger Iframely. = Will my shortcodes work? = Iframely does not change behavior of the shortcode plugins. Everything should work the old way, except for `[embed]` shortcode, which will now start producing responsive widgets unless limited in size. == Changelog == = 0.2.0 = There are 3 main changes: API Key, Shortcode, and Options page. - In order to keep our servers up and running, we need to secure the API with the API Key. Get your [FREE API Key here](http://iframe.ly?from=wp). - If you don't want the hastle of configuring API Key, just shorten your links manually at [http://iframe.ly](http://iframe.ly?from=wp) first, before pasting it into your post. The short URL will come with the embed codes attached to it. - Also, Iframely now has the options page where you can configure the way you'd like to use it. - For example, you can opt to use Iframely in `[iframely]` shortcode only, leaving all the other default oEmbed providers intact. - `[iframely]http://your.url/here[/iframely]` shortcode itself was introduced in this version. = 0.1.0 = This is our initial release. Please, rate if you like the plugin. And please, help do submit issues if you see any. == Upgrade Notice == = 0.2.0 = In order to keep our API servers up and running, we need to secure the API with the API Key. Get your FREE API Key at iframe.ly. The previous (open) API will be available until August 1st, 2014 only.