WebVTT

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:

• The base file name of the video file (without it’s extension).
• A normalized single character separator typically a dash - to match the WordPress name normalization pattern.
• The kind of text track. The kind is defined by the HTML5 specification and may be one of:
  • captions
  • chapters
  • descriptions
  • metadata
  • subtitles
• (defined above)
• 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

1. Upload entire webvtt directory to /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Upload new or see existing VTT files with the correct naming convention become available to HTML5 videos displayed using the [video] shortcode

Installation Instructions

1. Upload entire webvtt directory to /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Upload new or see existing VTT files with the correct naming convention become available to HTML5 videos displayed using the [video] shortcode

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.

1. 

   Upload video and associated VTT files following the naming convention.

2. 

   Video being displayed using the [video] shortcode with the VTT tracks available.

3. 

   Video and VTT attachments display reference links on media library and edit pages.

4. 

   Localization support on all screens.

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.