Description
This short, handy plugin will add playback buttons to your audio, video & playlist elements added via the built-in WordPress shortcodes for media using mediaelement.js.
Each set of buttons is configured for it’s corresponding element on the page, so you can adjust the speed of multiple files independently.
There is currently no persistence implemented in this plugin. It just scratches an itch to be able to broadly adjust media playback speeds using the HTML api.
NOTE: This uses the HTML5 media Element API. Any browser not supporting these or using the Flash Player fallback will miss out on this functionality.
Developers
Two hooks are provided within this plugin.
-
media-playback-speed-generate-controls
provides a single argument which is a boolean. If you return this as false, this will stop buttons being added to a media player. This is intended for advanced setups where markup for controls might be placed manually elsewhere on the page such as a sticky footer. So long as controls follow the built-in markup (being within the body tag and have a playback-rate-button class (no default styling, used for enabling DOM access only). -
βmedia-playback-speed-dataβ provides the default array containing arrays as items with
rate
,title
andlabel
entries, which set the playback rate, the title and aria-title for the buttons as well as adjust the button text.
Theme & Front-end
The .playback-rate-button.mejs-active
and/or .playback-rate-button.active-playback-rate
CSS-selectors allow you to style the active speed (per-player).
Initially mejs-active class was added in order to create media-playback-js compatible / familiar class names.
Now that Gutenberg does not add these, it makes sense to for-now add two sets of classes.
The .playback-rate-button.mejs-active
selector will be deprecated in version 2.
Troubleshooting
This works with the traditional audio
, video
and playlist
shortcodes so long as WordPress uses the JavaScript player.
With the latest 1.1.1 release this also works for HTML5 audio and video too, however you will need to implement your own controls which have the playback-rate-button
class and follow the patterns of this.
HTML5 raw controls do not have a playlist the author is aware of, and they use global state, so playback rate is per-page.
There is currently no history as part of this plugin, however a sister plugin could be authored and hooks added to it to store playback rate.
Please ensure that you have no broken javascript, or wrap all functions in (function() { // do things })()
blocks to ensure nothing interferes with this plugin. This plugin does this so that it should not interfere with your site, even in browsers and pages which do not support this plugin.
Feedback
Please feel free to suggest improvements, report conflicts, and/or make suggestions for integration hooks etc.
Screenshots
Installation
Download and extract the zip file or clone this repo to your WordPress plugins directory. Alternatively use the plugin directory to find and install this plugin.
Reviews
Contributors & Developers
“Media Playback Speed” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Media Playback Speed” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2.2
- compatibility with WordPress 6.0
1.2.1
- compatibility with WordPress 5.9
1.2.0
Trying out different selector, which seems to resolve double-click for audio issues
1.1.9
More graphics iteration… This time to honestly reflect that 2x is the maximum currently provided
1.1.8
Spell Daron name correctly in the graphics :facepalm:
1.1.7
- Plugin Directory Graphics – About time it got some. Better contributions welcome.
1.1.6
- WordPress 5.5.1 compatibility verified
1.1.5
- More Non-mediaelement JS fixes for global / local
1.1.4
- Non-mediaelement JS fixes
1.1.3
- IE 11 fixes.
1.1.2
- Re-factor inline JS that does not require PHP to it’s own JS file
1.1.1
- minor rewrite adding comments and building on the Vanilla JS 1.0.7 works
1.0.7
- guard to prevent errors
1.0.6
- change of DOM event
1.0.5
- using DOM events in the absence of jQuery
1.0.4
- No more jQuery
1.0.3
- Addition of playlist support (still requires old WP shortcode embedding)
1.0.2
- Verified working with 5.2.2 (requires old-style shortcode media embedding)
1.0.1
- Modified to enable showing active speed (requires JS to function)
1.0.0
- Initial submission to plugin-directory after button integration works, and re-factoring by Lewis Cowles