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

PascalBajorat

<p>This plugins adds possibility to place audio files into posts and pages using the oEmbed technology used by WordPress for other purposes (YouTube videos etc). Audio files are embeded using HTML5 audio tag, with Flash-based backup player for MP3 format for browsers that don’t support either HTML5 or MP3 format (Internet Explorer up to version 8.0, Firefox and Opera).</p>
<p>To put audio file into a post, simply enter the URL link to the audio file as separate paragraph. The plugin will convert it into the player on the page. See screenshots.</p>
<p>This is a special version of oEmbed HTML5 Audio: It is completely rewritten to support Cache Systems like WP Super Cache or W3 Total Cache and I’ve added some new Features.</p>
<h4>Key Features</h4>
<ul>
<li>oEmbed support for mp3, ogg and wav audio files</li>
<li>HTML5 Audio Shortcode (supports this functions: autoplay, loop, preload, controls and flash fallback)</li>
<li>Easy to use Shortcode-Generator</li>
<li>Compatible with Cache-Systems like WP Super Cache or W3 Total Cache</li>
<li>Flash Fallback</li>
</ul>
<h4>Auf der Suche nach einer deutschsprachigen Anleitung?</h4>
<p>Eine deutschsprachige Anleitung zu diesem Plugin ist auf meinem Blog zu finden:<br />
<a href="http://www.webdesign-podcast.de/2013/02/14/wordpress-und-html5-audio-support-plugin/" title="WordPress und HTML5 Audio Support – Plugin" rel="nofollow ugc">WordPress und HTML5 Audio Support – Plugin</a></p>
<h4>The new Shortcode:</h4>
<p>I’ve added a simple Shortcode to give you the full control of your HTML5 Audio:</p>
<pre><code>[audio id="your-css-id" class="pb-html5-audio-element" mp3="audio.mp3" ogg="audio.ogg" wav="audio.wav" autoplay="on" loop="on" preload="on" controls="on" flash_fallback="on" hidden="off"]
</code></pre>
<p>All Parameters are optional, but you need to specify at least one Audio Source: mp3, ogg or wav.</p>
<p>Defaults:</p>
<ul>
<li>id (optional, will be auto generated by the plugin if you not provide an ID)</li>
<li>class = pb-html5-audio-element</li>
<li>autoplay = off</li>
<li>loop = off</li>
<li>preload = on</li>
<li>controls = on</li>
<li>flash_fallback = on</li>
<li>hidden = off</li>
</ul>
<p>Please note: The Flash Fallback works only with mp3 files!</p>
<p>Since version 2.3 you can use the Generator below your Editor in Posts and Pages.</p>
<h4>Use the Shortcode in your Theme</h4>
<p>If you want to place an Audio-Tag Player in your Theme, you can use the Shortcode via PHP:</p>
<pre><code><?php
echo do_shortcode('[audio mp3="audio.mp3" ogg="audio.ogg" wav="audio.wav" autoplay="on" loop="on" preload="on" controls="on" flash_fallback="on" hidden="off"]');
?>
</code></pre>
<h4>Tested support in browsers:</h4>
<ul>
<li>Google Chrome 14: MP3, OGG, WAV – native HTML5</li>
<li>Firefox 6: OGG, WAV – native HTML5; MP3 – Flash-based backup player</li>
<li>Opera 11: OGG, WAV – native HTML5; MP3 – Flash-based backup player</li>
<li>Internet Explorer 8: MP3 – Flash-based backup player; OGG, WAV – not supported</li>
<li>Internet Explorer 9: MP3 – native HTML5; OGG, WAV – not supported</li>
<li>Safari: MP3 – Flash-based backup player; OGG, WAV – not supported</li>
</ul>
<p>A complete list which Browser supports which format you can find here: <a href="http://html5css3box.com/audio-tag-generator/" title="HTML5 CSS3 Box - HTML5 Audio-Tag" rel="nofollow ugc">HTML5 CSS3 Box – HTML5 Audio-Tag</a></p>
<p>If you have any questions or problems, you can ask me: <a href="https://www.pascal-bajorat.com/" title="Pascal Bajorat - Webdesigner / WordPress / WebDeveloper Berlin" rel="nofollow ugc">Pascal Bajorat – Webdesigner / WordPress / WebDeveloper</a></p>
<h4>Credits</h4>
<ul>
<li>Developer: Pascal Bajorat</li>
</ul>
<p>Translators:</p>
<ul>
<li>Spanish Translation by Andrew Kurtis – <a href="http://www.webhostinghub.com/" title="webhostinghub.com" rel="nofollow ugc">webhostinghub.com</a></li>
</ul>
<h3>Licence</h3>
<p>GNU General Public License v.3 – http://www.gnu.org/licenses/gpl-3.0.html</p>
<h4>HTML5 Audio Tag Shortcode:</h4>
<p>I’ve added a simple Shortcode to give you the full control of your HTML5 Audio:</p>
<pre><code>[audio id="your-css-id" class="pb-html5-audio-element" mp3="audio.mp3" ogg="audio.ogg" wav="audio.wav" autoplay="on" loop="on" preload="on" controls="on" flash_fallback="on" hidden="off"]
</code></pre>
<p>All Parameters are optional, but you need to specify at least one Audio Source: mp3, ogg or wav.</p>
<p>Defaults:</p>
<ul>
<li>id (optional, will be auto generated by the plugin if you not provide an ID)</li>
<li>class = pb-html5-audio-element</li>
<li>autoplay = off</li>
<li>loop = off</li>
<li>preload = on</li>
<li>controls = on</li>
<li>flash_fallback = on</li>
<li>hidden = off</li>
</ul>
<p>Since version 2.3 you can use the Generator below your Editor in Posts and Pages.</p>
<h4>Use the Shortcode in your Theme</h4>
<p>If you want to place an Audio-Tag Player in your Theme, you can use the Shortcode via PHP:</p>
<pre><code><?php
echo do_shortcode('[audio mp3="audio.mp3" ogg="audio.ogg" wav="audio.wav" autoplay="on" loop="on" preload="on" controls="on" flash_fallback="on" hidden="off"]');
?>
</code></pre>
<h4>oEmbed HTML5 Audio</h4>
<p>This plugins adds possibility to place audio files into posts and pages using the oEmbed technology used by WordPress for other purposes (YouTube videos etc). Audio files are embeded using HTML5 audio tag, with Flash-based backup player for MP3 format for browsers that don’t support either HTML5 or MP3 format (Internet Explorer up to version 8.0, Firefox and Opera).</p>
<p>To put audio file into a post, simply enter the URL link to the audio file as separate paragraph. The plugin will convert it into the player on the page. See screenshots.</p>


PB oEmbed HTML5 Audio – with Cache Support

This plugin converts URLs to audio files (MP3, OGG, WAV) into HTML5 audio with Flash-based player backup + Cache-System support and Shortcode.

Able Player, accessible HTML5 media player vs PB oEmbed HTML5 Audio – with Cache Support