This will display a responsive YouTube or Vimeo video in pages or posts - anywhere shorttags can be used, including the "text" widget.
For a YouTube video, you can specify either the full URL to the video or just the unique video ID, like this:
[responsive_youtube http://www.youtube.com/watch?v=NbCr0UyoFJA ] [responsive_youtube NbCr0UyoFJA]
And if you want to specify whether or not you'd like the "related videos" to display, you can use the "rel" or "norel" parameters in the shortcode syntax, like this:
[responsive_youtube NbCr0UyoFJA norel] [responsive_youtube NbCr0UyoFJA rel]
The rel and norel tags will override whatever you have set in the plugin settings screen for that specific video only.
YouTube supports the setting of an iframe window mode via parameter. The full explaination of what this does is beyond the scope of this documentation (practically, it usually affects the iframe's z-index (so wierd!)), but you can adjust this parameter using "wmode_none", "wmode_transparent", and "wmode_opaque" shorttag parameters, like this:
[responsive_youtube NbCr0UyoFJA wmode_none] [responsive_youtube NbCr0UyoFJA wmode_transparent] [responsive_youtube NbCr0UyoFJA wmode_opaque]
Of course the "rel" or "norel" and "wmode_*" parameters can be combined as well:
[responsive_youtube NbCr0UyoFJA norel wmode_transparent]
Also, the plugin settings page allows you to set the wmode parameter globally, which you can then override on an as needed basis with the shorttag parameters shown here.
Similarly, for a Vimeo video, you can use the full video player URL or just the video ID, like this:
[responsive_vimeo https://vimeo.com/29506088 ] [responsive_vimeo 29506088]
Unique to Vimeo, there are a few extra parameters you can use to control which elements are visible while displaying the posterframe:
In a future version, these extended options will probably be globally configurable.