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>\n\n
There are currently three ways to add an Able Player instance to a WordPress site:<\/p>\n\n
[ableplayer]<\/code> shortcode.<\/li>\n- Enter or paste any valid HTML5 Able Player code into your web page. Full documentation is available on the Able Player<\/a> project page on GitHub.<\/li>\n<\/ol>\n\n
Using the media rewriting in option #1, Able Player will replace any audio<\/code> or 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>\n\nUsing 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>\n\n
Option #3 supports the full scope of Able Player features.<\/p>\n\n
The [ableplayer] shortcode<\/h3>\n\n
The [ableplayer]<\/code> shortcode supports the following attributes.<\/p>\n\nRequired attributes (one of these)<\/h4>\n\n\nyoutube-id<\/code> - 11-character YouTube ID or YouTube URL.<\/li>\nvimeo-id<\/code> - Vimeo ID or URL.<\/li>\n- `media-id' - An attachment ID for a media file in your WordPress media library or the URL to a hosted video.<\/li>\n<\/ul>\n\n
Additional Player Content<\/h4>\n\n\ncaptions<\/code> - Attachment ID or URL to .vtt<\/code> captions file. Optional pipe separator for language code and label.<\/li>\nsubtitles<\/code> - Attachment ID or URL to .vtt<\/code> subtitles file. Optional pipe separator for language code and label.<\/li>\nchapters<\/code> - Attachment ID or URL to .vtt<\/code> chapters file. Optional pipe separator for language code and label.<\/li>\ndescriptions<\/code> - Attachment ID or URL to .vtt<\/code> audio descriptions file. Optional pipe separator for language code and label.<\/li>\nyoutube-desc-id<\/code> - YouTube URL or ID of a described version of the video<\/li>\nyoutube-sign-src<\/code> - YouTube URL or ID of a sign language interpreted accompanying video<\/li>\nvimeo-desc-id<\/code> - Vimeo URL or ID of a described version of the video<\/li>\n<\/ul>\n\nAll captions, subtitles, chapters, and descriptions tracks must be in .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>\n\nEither an attachment ID or a URL for your track .vtt<\/code> is required; you can optionally add a language code and a custom label:<\/p>\n\ncaptions=\"\/path\/to\/file.vtt|es|Espa\u00f1ol\"\n<\/code><\/pre>\n\nBy default, the language will be your WordPress installation language, with the labels \"Captions\", \"Subtitles\", \"Chapters\" or \"Audio Description\".<\/p>\n\n
Player Options<\/h4>\n\n\nyoutube-nocookie<\/code> - \"true\" or \"false\" (use \"true\" to embed YouTube untracked, for added privacy)<\/li>\nautoplay<\/code> - \"true\" or \"false\" (default is \"false\")<\/li>\nloop<\/code> - \"true\" or \"false\" (default is \"false\")<\/li>\nplaysinline<\/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>\nhidecontrols<\/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>\nposter<\/code> - the URL of a poster image, displayed before the user presses Play<\/li>\nwidth<\/code> - a value in pixels (by default, the player will be sized to fit its container)<\/li>\nheight<\/code> - a value in pixels (by default, the height of the player will be in proportion to the width)<\/li>\nheading<\/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>\nspeed<\/code> - \"animals\" or \"arrows\" (default is \"animals\")<\/li>\nstart<\/code> - start time at which to start playing the media, in seconds. Some browsers do not support this.<\/li>\nvolume<\/code> - \"0\" to \"10\" (default is \"7\" to avoid overpowering screen reader audio). Some browsers do not support this.<\/li>\nseekinterval<\/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>\nnowplaying<\/code> - \"true\" or \"false\" to include a \"Selected Track\" section within the media player (default is \"false\").<\/li>\ntranscript-div<\/code> - ID attribute of a target element that will contain the video transcript<\/li>\nid<\/code> - a unique id for the player (if omitted, one will be automatically assigned)<\/li>\n<\/ul>\n\nExamples<\/h3>\n\nExample 1<\/h4>\n\n
This example uses HTML to add an audio player to the page, with one source (an MP3 file).\n html\n <audio id=\"audio1\" preload=\"auto\" data-able-player src=\"path_to_audio.mp3\"><\/audio><\/code><\/p>\n\nExample 2<\/h4>\n\n
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).\n html\n <video id=\"able-player-1\" data-able-player preload=\"auto\" poster=\"path_to_image.jpg\">\n <source type=\"video\/mp4\" src=\"path_to_video.mp4\">\n <track kind=\"captions\" src=\"path_to_captions.vtt\" srclang=\"en\" label=\"English\">\n <track kind=\"subtitles\" src=\"path_to_subtitles.vtt\" srclang=\"es\" label=\"Espa\u00f1ol\">\n <track kind=\"descriptions\" src=\"path_to_descriptions.vtt\" srclang=\"en\">\n <track kind=\"chapters\" src=\"path_to_chapters.vtt\" srclang=\"en\">\n <\/video><\/code><\/p>\n\nExample 3<\/h4>\n\n
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.\n html\n [ableplayer poster=\"21\" media-id=\"24\" captions=\"25|en|English\" subtitles=\"26|es|Espa\u00f1ol\" descriptions=\"27\" chapters=\"28\"]<\/code><\/p>\n\nExample 4<\/h4>\n\n
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).\n [ableplayer youtube-id=\"XXXXXXXXXXX\" youtube-desc-id=\"YYYYYYYYYYY\"]<\/code><\/p>\n\nExample 5<\/h4>\n\n
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).\n [ableplayer vimeo-id=\"XXXXXXXXX\" vimeo-desc-id=\"YYYYYYYYY\"]<\/code><\/p>\n\nThe Able Player plugin was originally created by Terrill Thompson<\/a>.<\/p>\n\n\n\n- Upload the unzipped folder
ableplayer<\/code> to the \/wp-content\/plugins\/<\/code> directory.<\/li>\n- Activate the Able Player plugin through the 'Plugins' menu in WordPress<\/li>\n
- Follow the Instructions for Use<\/li>\n<\/ol>\n\n\n
2.3.0<\/h4>\n\n\n- Add Playground previews on .org<\/li>\n
- Update to Able Player v4.8.0<\/a>.<\/li>\n
- New feature to enable\/disable cookies.<\/li>\n
- Bug fix: Use history.pushState on tabs change.<\/li>\n<\/ul>\n\n
2.2.1<\/h4>\n\n