Description
Creates any number of HTML5 elements for uploaded WebVTT files for videos displayed using the [playlist]
and [video]
shortcodes.
The uploaded WebVTT file names must follow this convention to be recognized:
+ + + + + β.vttβ
With each value described as:
<video file name>
The base file name of the video file (without it’s extension).<separator>
A normalized single character separator typically a dash-
to match the WordPress name normalization pattern.<WebVTT track kind>
The kind of text track. The kind is defined by the HTML5 specification and may be one of:- captions
- chapters
- descriptions
- metadata
- subtitles
<separator>
(defined above)<language code>
The language of the track text data. This is a lower case 2 character code that represents the language only part of a full BCP 47 language tag. Here’s a listing of available language codes for reference.'.vtt'
The recognized standard file extension for WebVTT files.
As an example, a video file named 'my-video.mp4'
would be able to leverage uploaded track files named:
'my-video-chapters-en.vtt'
to add English chapters'my-video-subtitles-en.vtt'
to add English subtitles'my-video-subtitles-es.vtt'
to add Spanish subtitles
Screenshots
Installation
- Upload entire webvtt directory to
/wp-content/plugins/
directory - Activate the plugin through the βPluginsβ menu in WordPress
- Upload new or see existing VTT files with the correct naming convention become available to HTML5 videos displayed using the
[video]
shortcode
FAQ
- Installation Instructions
-
- Upload entire webvtt directory to
/wp-content/plugins/
directory - Activate the plugin through the βPluginsβ menu in WordPress
- Upload new or see existing VTT files with the correct naming convention become available to HTML5 videos displayed using the
[video]
shortcode
- Upload entire webvtt directory to
- Why aren’t my VTT files available with my video?
-
The uploaded WebVTT file names must follow this convention to be recognized:
+ + + + + β.vttβThis avoids:
- the need for a settings page
- extra meta data fields and trying to keep these in sync
- having to re-upload a video when a VTT file is changed or updated
Please see the Description section for a full explanation of the VTT file name format.
Reviews
Contributors & Developers
“WebVTT” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “WebVTT” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.3.2
2016-08-28
- FIX: Removed unneeded
empty()
calls.
1.3.1
2016-08-28
- FIX: Updated usage of
empty()
to be compatible with PHP versions prior to 5.5.
1.3.0
2016-08-27
- NEW: VTTs will now show up when using the
[playlist]
shortcode. - FIX: Sanitize video name when querying for VTTs.
- FIX: Retrieve vide name from URL with query parameters.
Props @leocaseiro.
1.2.0
2015-08-30
- NEW: Added POT and first translation (Spanish).
- NEW: Added screenshots of media library and localization support.
- FIX: Better attachment metadata localization handling in media library view.
1.1.0
2015-08-29
- NEW: Links between video and VTTs are shown in the media library and on edit pages.
- NEW: Improved VTT query performance and results can now be cached.
- NEW: Filter by
Video tracks
in media library to show only VTT attachments. - NEW: Using classes plugin boilerplate.
- FIX: Cleaned up PHPCS WordPress standard sniffs.
1.0.1
2015-08-19
- NEW: Added Screen shots and filled in more readme sections.
- FIX: Corrected
.vtt
file names in examples.
1.0.0
Initial release.