ucf / ucf-video-vtt
Plugin that provides a series of tools for developers to properly enqueue descriptive text tracks for videos (vtt files) for their videos.
Requires
- composer/installers: ~1.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Plugin that provides a series of tools for developers to properly enqueue descriptive text tracks for videos (vtt files) for their videos.
Description
The primary goal of this project is to provide a series of tools for including
Documentation
Head over to the UCF Video VTT Tools wiki for detailed information about this plugin, installation instructions, and more.
Changelog
0.1.1
Enhancements:
- Added composer file.
0.1.0
- Initial release of the plugin.
- Includes a field for setting a custom vtt file for a video.
- Generates a vtt using the video description field if no custom file is provided.
- Provides an API endpoint that delivers the vtt file.
- Provides helper classes that will insert the appropriate markup to point to the vtt file.
Upgrade Notice
n/a
Development
Enabling debug mode in your wp-config.php file is recommended during development to help catch warnings and bugs.
Requirements
- node v16+
- gulp-cli
Instructions
-
Clone the UCF-Video-VTT repo into your local development environment, within your WordPress installation's
plugins/directory:git clone https://github.com/UCF/UCF-Video-VTT.git -
cdinto the new UCF-Video-VTT directory, and runnpm installto install required packages for development intonode_modules/within the repo -
Optional: If you'd like to enable BrowserSync for local development, or make other changes to this project's default gulp configuration, copy
gulp-config.template.json, make any desired changes, and save asgulp-config.json.To enable BrowserSync, set
synctotrueand assignsyncTargetthe base URL of a site on your local WordPress instance that will use this plugin, such ashttp://localhost/wordpress/my-site/. YoursyncTargetvalue will vary depending on your local host setup.The full list of modifiable config values can be viewed in
gulpfile.js(seeconfigvariable). -
Run
gulp defaultto process front-end assets. -
If you haven't already done so, create a new WordPress site on your development environment to test this plugin against, and install and activate all plugin dependencies.
-
Activate this plugin on your development WordPress site.
Other Notes
- This plugin's README.md file is automatically generated. Please only make modifications to the README.txt file, and make sure the
gulp readmecommand has been run before committing README changes. See the contributing guidelines for more information.
Contributing
Want to submit a bug report or feature request? Check out our contributing guidelines for more information. We'd love to hear from you!