Joe Dolson

terrillthompson

<p>This plug-in uses Able Player, an open-source fully-accessible cross-browser HTML5 media player, to embed audio or video within your WordPress page.</p>
<h3>Instructions for Use</h3>
<p>There are currently three ways to add an Able Player instance to a WordPress site:</p>
<ol>
<li>Go to Settings > Able Player > Settings and enable the options to use Able Player for all video, audio, and playlists. Able Player will automatically replace MediaElement.jss or the default WordPress video/audio blocks with Able Player.</li>
<li>Go to Settings > Able Player > Shortcodes to generate an <code>[ableplayer]</code> shortcode.</li>
<li>Enter or paste any valid HTML5 Able Player code into your web page. Full documentation is available on the <a href="http://ableplayer.github.io/ableplayer" rel="nofollow ugc">Able Player</a> project page on GitHub.</li>
</ol>
<p>Using the media rewriting in option #1, Able Player will replace any <code>audio</code> or <code>video</code> block. Any tracks added to that block will be automatically handled, giving you support for all the standard Able Player features: captions, navigable transcripts, subtitles, chapters, and audio description.</p>
<p>Using option #2, you can create Able Player shortcodes that support most of the basic Able Player features, with support for Vimeo, YouTube, or local video.</p>
<p>Option #3 supports the full scope of Able Player features.</p>
<h3>The [ableplayer] shortcode</h3>
<p>The <code>[ableplayer]</code> shortcode supports the following attributes.</p>
<h4>Required attributes (one of these)</h4>
<ul>
<li><code>youtube-id</code> – 11-character YouTube ID or YouTube URL.</li>
<li><code>vimeo-id</code> – Vimeo ID or URL.</li>
<li>`media-id’ – An attachment ID for a media file in your WordPress media library or the URL to a hosted video.</li>
</ul>
<h4>Additional Player Content</h4>
<ul>
<li><code>captions</code> – Attachment ID or URL to <code>.vtt</code> captions file. Optional pipe separator for language code and label.</li>
<li><code>subtitles</code> – Attachment ID or URL to <code>.vtt</code> subtitles file. Optional pipe separator for language code and label.</li>
<li><code>chapters</code> – Attachment ID or URL to <code>.vtt</code> chapters file. Optional pipe separator for language code and label.</li>
<li><code>descriptions</code> – Attachment ID or URL to <code>.vtt</code> audio descriptions file. Optional pipe separator for language code and label.</li>
<li><code>youtube-desc-id</code> – YouTube URL or ID of a described version of the video</li>
<li><code>youtube-sign-src</code> – YouTube URL or ID of a sign language interpreted accompanying video</li>
<li><code>vimeo-desc-id</code> – Vimeo URL or ID of a described version of the video</li>
</ul>
<p>All captions, subtitles, chapters, and descriptions tracks must be in <code>.vtt</code> format. The shortcode only supports a single set of values for each type of data; to add multiple tracks of the same type you can use the Video block or add custom HTML.</p>
<p>Either an attachment ID or a URL for your track <code>.vtt</code> is required; you can optionally add a language code and a custom label:</p>
<pre><code>captions="/path/to/file.vtt|es|Español"
</code></pre>
<p>By default, the language will be your WordPress installation language, with the labels “Captions”, “Subtitles”, “Chapters” or “Audio Description”.</p>
<h4>Player Options</h4>
<ul>
<li><code>youtube-nocookie</code> – “true” or “false” (use “true” to embed YouTube untracked, for added privacy)</li>
<li><code>autoplay</code> – “true” or “false” (default is “false”)</li>
<li><code>loop</code> – “true” or “false” (default is “false”)</li>
<li><code>playsinline</code> – “true” or “false” (default is “true”). By setting to “false”, some devices (e.g., iPhones) will play the video in their own media player rather than in Able Player.</li>
<li><code>hidecontrols</code> – “true” or “false” (default is “false”). Set to “true” to enable the player controls to fade away during playback. They will appear again if the user hovers over the player or pressing a key, and they are always accessible to screen reader users.</li>
<li><code>poster</code> – the URL of a poster image, displayed before the user presses Play</li>
<li><code>width</code> – a value in pixels (by default, the player will be sized to fit its container)</li>
<li><code>height</code> – a value in pixels (by default, the height of the player will be in proportion to the width)</li>
<li><code>heading</code> – The HTML heading level (1-6) of the visually hidden “Media Player” heading that precedes the player (for the benefit of screen reader users). If omitted, a heading level will be intelligently assigned based on context.</li>
<li><code>speed</code> – “animals” or “arrows” (default is “animals”)</li>
<li><code>start</code> – start time at which to start playing the media, in seconds. Some browsers do not support this.</li>
<li><code>volume</code> – “0” to “10” (default is “7” to avoid overpowering screen reader audio). Some browsers do not support this.</li>
<li><code>seekinterval</code> – number of seconds to forward/rewind with the Forward and Rewind buttons. If omitted, the interval will be intelligently assigned based on length of the video.</li>
<li><code>nowplaying</code> – “true” or “false” to include a “Selected Track” section within the media player (default is “false”).</li>
<li><code>transcript-div</code> – ID attribute of a target element that will contain the video transcript</li>
<li><code>id</code> – a unique id for the player (if omitted, one will be automatically assigned)</li>
</ul>
<h3>Examples</h3>
<h4>Example 1</h4>
<p>This example uses HTML to add an audio player to the page, with one source (an MP3 file).<br />
    <code>html<br />
  <audio id="audio1" preload="auto" data-able-player src="path_to_audio.mp3"></audio></code></p>
<h4>Example 2</h4>
<p>This example uses HTML to add a video player to the page, with one source (an MP4 file) and four tracks (for captions, descriptions, and chapters in English; and subtitles in Spanish).<br />
    <code>html<br />
  <video id="able-player-1" data-able-player preload="auto" poster="path_to_image.jpg"><br />
    <source type="video/mp4" src="path_to_video.mp4"><br />
    <track kind="captions" src="path_to_captions.vtt" srclang="en" label="English"><br />
    <track kind="subtitles" src="path_to_subtitles.vtt" srclang="es" label="Español"><br />
    <track kind="descriptions" src="path_to_descriptions.vtt" srclang="en"><br />
    <track kind="chapters" src="path_to_chapters.vtt" srclang="en"><br />
  </video></code></p>
<h4>Example 3</h4>
<p>This example uses the shortcode to add a video player to the page, with one source (an MP4 file) and four tracks (for captions, descriptions, and chapters in English; and subtitles in Spanish). All sources are fetched as WordPress media attachments.<br />
    <code>html<br />
  [ableplayer poster="21" media-id="24" captions="25|en|English" subtitles="26|es|Español" descriptions="27" chapters="28"]</code></p>
<h4>Example 4</h4>
<p>This example uses a shortcode to add a YouTube player to the page, with two versions of the video, one with audio description and the other without (the user can toggle between the two versions using the D button).<br />
    <code>[ableplayer youtube-id="XXXXXXXXXXX" youtube-desc-id="YYYYYYYYYYY"]</code></p>
<h4>Example 5</h4>
<p>This example uses a shortcode to add a Vimeo player to the page, with two versions of the video, one with audio description and the other without (the user can toggle between the two versions using the D button).<br />
    <code>[ableplayer vimeo-id="XXXXXXXXX" vimeo-desc-id="YYYYYYYYY"]</code></p>
<p>The Able Player plugin was originally created by <a href="https://terrillthompson.com" rel="nofollow ugc">Terrill Thompson</a>.</p>


Able Player, accessible HTML5 media player

johndyer

<p>Video and audio plugin for WordPress built on the MediaElement.js HTML5 media player library. Provides Flash or Silverlight fallback players for non-HTML5 browsers. Supports iPhone, iPad, and Andriod.<br />
Supports MP4, OGG, WebM, WMV, MP3, WAV, WMA files as well as captions with WebSRT files.</p>
<p>Check out <a href="http://mediaelementjs.com/" rel="nofollow ugc">mediaElementjs.com</a> for more information and examples.</p>
<h3>Typical Usage for video</h3>
<pre><code>[video src="http://mysite.com/mymedia.mp4" width="640" height="360"]
</code></pre>
<h3>Typical Usage for audio</h3>
<pre><code>[audio src="http://mysite.com/mymedia.mp3"]
</code></pre>
<h3>Shortcode Options</h3>
<h4>Alternatives</h4>
<p>If you have a plugin that conflicts with MediaElement.js, you can also use the short codes</p>
<pre><code>[mejsvideo src="http://mysite.com/mymedia.mp4" width="640" height="360"]
[mejsaudio src="http://mysite.com/mymedia.mp3"]
</code></pre>
<h4>src</h4>
<p>This location of any audio or video file</p>
<pre><code>[video src="http://mysite.com/mymedia.mp4"]
</code></pre>
<p>You can also leave off the extention and MediaElement.js will look for all media files matching the filename (mymedia.mp4, mymedia.webm, etc.)</p>
<pre><code>[video src="http://mysite.com/mymedia"]
</code></pre>
<h4>type</h4>
<p>The media type of the resource</p>
<pre><code>[video src="http://mysite.com/mymedia?xyz" type="video/mp4"]
</code></pre>
<h4>mp4</h4>
<p>The location of the h.264/MP4 source for the video.</p>
<pre><code>[video mp4="http://mysite.com/mymedia.mp4"]
</code></pre>
<h4>mp3</h4>
<p>The location of an MP3 file for video</p>
<pre><code>[audio mp3="http://mysite.com/mymedia.mp3"]
</code></pre>
<h4>ogg</h4>
<p>The location of the Theora/Ogg source for the video.</p>
<pre><code>[video ogg="http://mysite.com/mymedia.ogg"]
</code></pre>
<h4>webm</h4>
<p>The location of the VP8/WebM source for the video.</p>
<pre><code>[video webm="http://mysite.com/mymedia.webm"]
</code></pre>
<h4>poster</h4>
<p>The location of the poster frame for the video.</p>
<pre><code>[video poster="http://mysite.com/mymedia.png"]
</code></pre>
<h4>width</h4>
<p>The width of the video</p>
<pre><code>[video width="640"]
</code></pre>
<h4>height</h4>
<p>The height of the video</p>
<pre><code>[video height="264"]
</code></pre>
<h4>loop</h4>
<p>Loops the video or audio when it ends</p>
<pre><code>[video src="http://mysite.com/mymedia.mp4" loop="true"]
</code></pre>
<h4>preload</h4>
<p>Start loading the video as soon as possible, before the user clicks play.</p>
<pre><code>[video preload="true"]
</code></pre>
<h4>autoplay</h4>
<p>Start playing the video as soon as it’s ready.</p>
<pre><code>[video autoplay="true"]
</code></pre>
<h4>fullscreen</h4>
<p>Disables the fullscreen button</p>
<pre><code>[video src="http://mysite.com/mymedia.mp4" fullscreen="false"]
</code></pre>
<h4>duration</h4>
<p>Disables the duration output</p>
<pre><code>[video src="http://mysite.com/mymedia.mp4" duration="false"]
</code></pre>
<h4>volume</h4>
<p>Disables the volume slider</p>
<pre><code>[video src="http://mysite.com/mymedia.mp4" volume="false"]
</code></pre>
<h4>progress</h4>
<p>Disables the progress bar</p>
<pre><code>[video src="http://mysite.com/mymedia.mp4" progress="false"]
</code></pre>
<h4>captions</h4>
<p>URL to a WebSRT captions file</p>
<pre><code>[video src="http://mysite.com/mymedia.mp4" captions="http://mysite.com/mymedia.srt"]
</code></pre>
<h4>Simple Video</h4>
<p>Basic playback options</p>
<pre><code>[video src="http://mysite.com/mymedia.mp4" width="640" height="360"]
</code></pre>
<h4>All Attributes Video</h4>
<p>All options enabled</p>
<pre><code>[video mp4="http://mysite.com/mymedia.mp4" ogg="http://mysite.com/mymedia.ogg" webm="http://mysite.com/mymedia.webm" poster="http://mysite.com/mymedia.png" preload="true" autoplay="true" width="640" height="264"]
</code></pre>
<h4>Simple Audio</h4>
<p>Basic playback options</p>
<pre><code>[audio src="http://mysite.com/mymedia.mp3"]
</code></pre>
<h4>All Attributes Audio</h4>
<p>All options enabled</p>
<pre><code>[audio mp3="http://mysite.com/mymedia.mp3" ogg="http://mysite.com/mymedia.ogg" preload="true" autoplay="true"]
</code></pre>
<h3>Use in a template</h3>
<p>You can use WordPress shortcodes in your templates using the do_shortcode function.</p>
<pre><code><?php echo do_shortcode('[video src="myvfile.mp4"]'); ?>
</code></pre>


MediaElement.js – HTML5 Video & Audio Player

MediaElement.js is an HTML5 video and audio player with Flash fallback and captions. Supports IE,…

Able Player, accessible HTML5 media player vs MediaElement.js – HTML5 Video & Audio Player