TruePlayer is a native WordPress video and audio player with its own controls, so every video on your site looks and behaves the same \u2014 wherever it is hosted.<\/p>\n\n
[trueplayer id=\"\u2026\"]<\/code>, a popup\/lightbox shortcode and playlist shortcode.<\/li>\n- SEO<\/strong> \u2014 VideoObject structured data and Google Analytics (GA4) playback events.<\/li>\n<\/ul>\n\n
Everything in this plugin works on its own. A separate add-on, TruePlayer Pro, adds features of its own such as watch verification, quizzes, analytics and automation.<\/p>\n\n
External services<\/h3>\n\n
TruePlayer connects to the following third-party services. Each one is only contacted for the feature it supports, and only when that feature is used.<\/p>\n\n
\n- Vimeo oEmbed<\/strong> (
https:\/\/vimeo.com\/api\/oembed.json<\/code>) \u2014 used to resolve a thumbnail for a Vimeo video when none is set, so the poster image is populated. The video's public Vimeo URL is sent. Called in the admin only, when saving a Vimeo-sourced video. Terms: https:\/\/vimeo.com\/terms \u2014 Privacy: https:\/\/vimeo.com\/privacy<\/li>\n- YouTube captions<\/strong> (
https:\/\/www.youtube.com\/api\/timedtext<\/code>) \u2014 used by the subtitles importer to fetch public captions for a YouTube video when an administrator imports them. Only the public video id is sent. Terms: https:\/\/www.youtube.com\/t\/terms \u2014 Privacy: https:\/\/policies.google.com\/privacy<\/li>\n- Google Analytics (GA4) via Google Tag Manager<\/strong> (
https:\/\/www.googletagmanager.com\/gtag\/js<\/code>) \u2014 only loaded when the site administrator turns on Google Analytics in TruePlayer's Settings \u2192 Integrations screen and enters a GA4 Measurement ID. Standard GA4 playback events are then sent from the viewer's browser to Google. Off by default. Terms: https:\/\/marketingplatform.google.com\/about\/analytics\/terms\/us\/ \u2014 Privacy: https:\/\/policies.google.com\/privacy<\/li>\n- Kodezen usage insights<\/strong> (
https:\/\/store.kodezen.com\/<\/code>) \u2014 optional, anonymous usage telemetry sent only if a site administrator opts in from the notice TruePlayer shows in the admin; it sends the site URL, WordPress\/PHP\/plugin versions and the admin email given at opt-in. When the plugin is deactivated, an optional feedback form can send the reason the administrator chooses. Nothing is sent without that action. Terms: https:\/\/kodezen.com\/terms-and-conditions\/ \u2014 Privacy: https:\/\/store.kodezen.com\/privacy-policy\/<\/li>\n<\/ul>\n\nThird-Party Libraries<\/h3>\n\n
TruePlayer bundles the following open-source libraries. Each one keeps its own license and copyright.<\/p>\n\n
\n- StoreEngine WordPress SDK<\/strong> \u2014 the opt-in usage-insights client described above. Source: https:\/\/github.com\/imrantushar\/storeengine-sdk-for-wordpress \u2014 License: GPL-2.0-or-later (\u00a9 Kodezen). Installed via Composer under
vendor\/storeengine\/wordpress-sdk\/<\/code>.<\/li>\n<\/ul>\n\nSource code & build<\/h3>\n\n
All compiled JavaScript and CSS in assets\/build\/<\/code> is generated from the human-readable sources shipped in the dev_trueplayer\/<\/code> folder of this plugin. The same sources are public at https:\/\/github.com\/imrantushar\/trueplayer .<\/p>\n\nEvery file in assets\/build\/<\/code> maps to a source entry:<\/p>\n\n\nbackend.*.js<\/code> \/ style-backend.css<\/code> \u2014 dev_trueplayer\/backend.js<\/code> (admin app, dev_trueplayer\/admin\/<\/code>)<\/li>\nfrontend.*.js<\/code> \/ style-frontend.css<\/code> \u2014 dev_trueplayer\/frontend.js<\/code> (player, dev_trueplayer\/player\/<\/code>)<\/li>\nblock.*.js<\/code> \u2014 dev_trueplayer\/block\/index.js<\/code> (block editor)<\/li>\nyt.*.js<\/code>, vimeo.*.js<\/code> \u2014 lazily loaded provider chunks from dev_trueplayer\/player\/providers\/<\/code><\/li>\nhlsjs.*.js<\/code>, vimeojs.*.js<\/code> \u2014 the third-party hls.js (https:\/\/github.com\/video-dev\/hls.js, Apache-2.0) and @vimeo\/player (https:\/\/github.com\/vimeo\/player.js, MIT) npm packages, split into their own chunks<\/li>\n<\/ul>\n\nTo rebuild: install Node.js 20+, then run npm install<\/code> and npm run build<\/code> in the plugin folder. The build uses @wordpress\/scripts<\/code> (webpack) with the config in webpack.config.js<\/code>.<\/p>\n\n\n1.7.4 - 24-10-2026<\/h4>\n\n\n- Changed - Removed the unused progress, quiz-attempts, engagement and daily tables from the free plugin; they are no longer created on activation, and uninstall cleanup was updated to match.<\/li>\n<\/ul>\n\n
1.7.3 - 17-10-2026<\/h4>\n\n\n- Security: Colour settings (accent and other colour fields) are now strictly validated on save and at render time.<\/li>\n<\/ul>\n\n
1.7.2 - 14-10-2026<\/h4>\n\n\n- Security - Public opt-in REST endpoint (
\/wp-json\/trueplayer\/v1\/optin<\/code>) now requires a wp_rest<\/code> nonce, applies a per-IP+video rate limit, and includes a honeypot field to block form-walking bots.<\/li>\n- Changed - Admin screens no longer remove queued
admin_notices<\/code> callbacks; a CSS-only suppression keeps the layout clean while leaving other plugins' notices in the DOM.<\/li>\n- Changed - Admin asset enqueue now matches TruePlayer's own page hooks exactly instead of a substring on the plugin slug.<\/li>\n
- Changed - YouTube caption importer sends an honest
TruePlayer\/<version>; <site_url><\/code> User-Agent instead of a browser-spoofing one.<\/li>\n- Added -
uninstall.php<\/code> drops this plugin's custom tables, options, transients and generated poster attachments when the site owner deletes the plugin. Honours a trueplayer_keep_data_on_uninstall<\/code> option, and runs per-site on multisite.<\/li>\n- Changed - Readme tags no longer use third-party brand names.<\/li>\n<\/ul>\n\n
1.7.1 - 14-10-2026<\/h4>\n\n\n- Fixed - Activation schema no longer uses
JSON<\/code> columns or DATETIME DEFAULT CURRENT_TIMESTAMP<\/code>, so tables create cleanly on MySQL versions WordPress still supports.<\/li>\n- Fixed - Schema sync now verifies every expected table exists before recording the database version, so a silent
dbDelta<\/code> failure can no longer mark the install as upgraded.<\/li>\n- Fixed - Seed data and preset-preview samples no longer reference remote demo files; sources start empty and the author picks their own media.<\/li>\n
- Security - The video-preview REST route now requires edit rights on the specific video, not just a generic edit-posts capability.<\/li>\n
- Changed - Vimeo poster transient is now namespaced as
trueplayer_vimeo_poster_<\/code> to avoid colliding with other plugins' short prefixes.<\/li>\n<\/ul>\n\n1.7.0 - 11-10-2026<\/h4>\n\n\n- Changed - Everything in the free plugin now works on its own, with no locked options. Features that belong to TruePlayer Pro now ship only in that add-on.<\/li>\n
- Changed - HLS streams, Google Analytics events and YouTube caption import are free.<\/li>\n
- Removed - Interactive (H5P) content moved to TruePlayer Pro.<\/li>\n
- Removed - Custom CSS fields \u2014 use the Customizer or Site Editor's Additional CSS instead.<\/li>\n
- Security - Quick-editing a video from the block editor now also checks you can edit that video.<\/li>\n
- Changed - Player settings are passed to the page as data attributes instead of inline script tags; admin styles load through the WordPress style queue.<\/li>\n
- Changed - Updated the StoreEngine SDK to 1.6.2.<\/li>\n
- Added - Readme documents where the source for the compiled scripts lives and how to rebuild it.<\/li>\n<\/ul>\n\n
1.6.1 - 10-10-2026<\/h4>\n\n\n- Security - Harden inline player config against breakout \u2014 JSON blobs rendered beside the player, popup and playlist now escape
<\/script><\/code> sequences.<\/li>\n- Changed - Plugin URI updated to https:\/\/true-player.net\/.<\/li>\n
- Changed - Rename post types and taxonomy to plugin-prefixed slugs (
truepl_video<\/code>, truepl_preset<\/code>, truepl_video_tag<\/code>, truepl_playlist<\/code>) to avoid collisions. Existing content is migrated automatically on first admin load.<\/li>\n- Changed - Admin-area white-labeling no longer touches player attribution (the player carries none to suppress).<\/li>\n
- Added - Readme now documents every external service the plugin can contact, with Terms and Privacy links.<\/li>\n<\/ul>\n\n
1.6.0 - 24-09-2026<\/h4>\n\n\n- Added - Quality selector: Auto plus every available level, in the gear menu or as a one-tap button. Bunny Stream, Mux, Gumlet ABR, HLS, YouTube and Vimeo.<\/li>\n
- Added - The viewer's quality choice is remembered across videos.<\/li>\n
- Added - Rapid Engage Bar: a simulated seek bar that runs ahead early so a video feels shorter. Needs Pro.<\/li>\n
- Added - Seek bar is now its own section in the player editor.<\/li>\n
- Added - Waveform is selectable as a video seek bar style, not only for audio.<\/li>\n
Added - Separate Rapid Engage speeds for desktop and mobile.<\/p><\/li>\n
Fixed - The volume slider's indicator sat above its track instead of on it.<\/p><\/li>\n
- Fixed - Firefox drew the volume fill thicker than the track it was filling.<\/li>\n
- Fixed - The volume slider could be squashed by a host theme's input styles.<\/li>\n<\/ul>\n\n
1.5.0 - 14-09-2026<\/h4>\n\n\n- Added - Two more audio starting points: Audiobook and Playlist.<\/li>\n
- Added - Podcast and Audiobook are now audio bars of their own, not just switched-on controls. Need Pro.<\/li>\n
- Added - Video and Audio filters in the media library.<\/li>\n
- Added - The create dialog names the look a new item will use.<\/li>\n
- Added - \"Start from a template\" in the preset builder \u2014 a whole look in one click.<\/li>\n
- Added - The site-wide default look is now set separately for video and audio.<\/li>\n
Added - A short description on every template tile, on hover or keyboard focus.<\/p><\/li>\n
Fixed - A site-wide video template pushed its skin and aspect ratio onto audio items.<\/p><\/li>\n
- Fixed - Choosing a template added to the saved look instead of replacing it.<\/li>\n
- Fixed - A site-wide default preset never showed in the editor preview.<\/li>\n
- Fixed - Saving Settings did not refresh the audio defaults until the page was reloaded.<\/li>\n
- Fixed - A default preset overrode the template tiles with nothing on screen to say so.<\/li>\n
- Fixed - Template tiles showed a PRO badge even with TruePlayer Pro active.<\/li>\n
- Fixed - Audio items offered \"Generate from video\" for cover art, which could only fail.<\/li>\n
- Fixed - The unsaved-changes dialog opened at full width for a single sentence.<\/li>\n
Fixed - The Minimal audio bar and the Simple video skin looked alike in the picker.<\/p><\/li>\n
Security - Videos inside a playlist skipped the free-plan clamp, leaking premium source URLs into the page.<\/p><\/li>\n
- Security - A video title containing markup could break out of the SEO data block and run script.<\/li>\n
Security - Hardened the importer, an interactive-engine query, and imported caption parsing.<\/p><\/li>\n
Changed - Template tiles redesigned: light preview, and a brand-blue tick on the chosen one.<\/p><\/li>\n
- Changed - The audio bar's shape is now called \"Skin\", the same as video.<\/li>\n
- Changed - Free starting points sit above the Pro ones, which are grouped and labelled.<\/li>\n
- Changed - The default audio look is Minimal, so a fresh install starts on something it can use.<\/li>\n
- Changed - The default aspect ratio setting now says it never reaches an audio item.<\/li>\n<\/ul>\n\n
1.4.0 - 10-09-2026<\/h4>\n\n\n- Added - Audio as its own media type \u2014 Video \/ Audio tabs when creating media.<\/li>\n
- Added - Three audio layouts: compact bar, card, and minimal.<\/li>\n
- Added - Audio presets, separate from video ones, with Podcast, Album and Bare starting points.<\/li>\n
- Added - Audio control toggles: previous \/ next track, playback speed, chapters & transcript.<\/li>\n
- Added - Previous \/ next track buttons in playlists.<\/li>\n
- Added - Automatic audio detection from the file extension, so imported and pasted audio needs no re-saving.<\/li>\n
- Added - Site-wide default presets for video and audio, under Settings \u2192 General.<\/li>\n
- Added - A \"When attempts run out\" policy \u2014 lock and require a re-watch, or never lock. Overridable per video.<\/li>\n
Added - Audio wording and icons in Bunny.net Storage and Gumlet uploads.<\/p><\/li>\n
Fixed - Re-watching after using every quiz attempt gave only one attempt instead of a fresh set.<\/p><\/li>\n
- Fixed - A checkpoint before the completion threshold could lock a re-watching viewer out for good.<\/li>\n
- Fixed - Audio items previewed as a video player in the editor.<\/li>\n
- Fixed - The minimal audio layout rendered as an empty white box on light backgrounds.<\/li>\n
- Fixed - Audio was published to search engines as video.<\/li>\n
- Fixed - The audio preset's \"Preview with\" row did not line up with the preview below it.<\/li>\n
Fixed - Fields took their border from WordPress instead of the plugin.<\/p><\/li>\n
Changed - Player controls are defined in one place, so the editor and player can't drift apart.<\/p><\/li>\n
- Changed - The editor hides settings that cannot apply to audio.<\/li>\n
- Changed - The Interactive tab is always shown, with a teaser when the addon is off.<\/li>\n
- Changed - All dialogs open at the same width.<\/li>\n<\/ul>\n\n
1.3.0 - 06-09-2026<\/h4>\n\n\n- Added - Gumlet as a video source \u2014 upload a file from the editor, or use one already in your Gumlet workspace. Needs Pro.<\/li>\n
- Added - Uploads go straight from the browser to Gumlet, with drag & drop, progress and cancel. PHP's upload size limit no longer applies, and your API key never leaves the server.<\/li>\n
- Added - Gumlet settings under Settings \u2192 Sources & CDN, with your workspaces offered as a list.<\/li>\n
- Added - Signed, expiring links for Gumlet videos marked private.<\/li>\n
Added - A video saved while Gumlet is still encoding starts playing on its own when encoding finishes.<\/p><\/li>\n
Fixed - Premium sources leaked their real media URL into the page on free installs. The location is now stripped on the server.<\/p><\/li>\n
- Fixed - Bunny.net Storage videos could not be marked private, played on free installs despite being premium, and showed a raw \"bunnyStorage\" badge.<\/li>\n
- Fixed - HLS video failed to play in Chrome \u2014 the player trusted Chrome's claim that it supports HLS and skipped hls.js.<\/li>\n
- Fixed - Playback failures said only \"Playback error\". They now name the cause.<\/li>\n<\/ul>\n\n
1.2.0 - 03-09-2026<\/h4>\n\n\n- Added - Direct Bunny.net Storage uploads from the editor with drag & drop, picker, progress bar, and cancel support.<\/li>\n
- Added - Bunny.net Storage file browser to reuse existing uploads.<\/li>\n
- Added - Bunny.net Storage credentials under Settings \u2192 Sources & CDN.<\/li>\n
- Added - 4 MB chunked uploads for large files.<\/li>\n
- Added - Post-upload URL verification with playback error details.<\/li>\n
- Added - Collapsible Bunny.net settings sections with status badges.<\/li>\n
- Added - Bunny.net Storage as a source in the Create Media dialog.<\/li>\n
- Added - QuizPress quiz as an alternative question source for checkpoints and the final quiz.<\/li>\n
- Added - Inline QuizPress quiz-taking UI, question-by-question, using QuizPress's own answer widgets and grading.<\/li>\n
- Added - Real pass\/fail and score read from QuizPress's own attempt data.<\/li>\n
- Added - A no-penalty \"awaiting manual review\" outcome for QuizPress quizzes with manually-reviewed questions.<\/li>\n
- Added - QuizPress passing grade, attempt limit, and manual-review warnings shown in the Gating tab.<\/li>\n
- Added - Live-preview grading for QuizPress-sourced quizzes.<\/li>\n
- Added - \"Try again\" after a failed QuizPress-sourced checkpoint.<\/li>\n
- Added - Drag-and-drop reordering and a collapsible accordion for checkpoint and question lists.<\/li>\n
- Added - The editor's active tab now stays in the URL, so a reload keeps your place.<\/li>\n
Added - A \"What's New\" panel in the admin top bar.<\/p><\/li>\n
Fixed - Bunny.net Storage Private mode not applying token protection.<\/p><\/li>\n
- Fixed - Bunny.net token signing for single files and HLS directories.<\/li>\n
- Fixed - Single-file tokens potentially unlocking an entire folder.<\/li>\n
- Fixed - The standalone video page to provide a clean, shareable URL.<\/li>\n
- Fixed - The frontend volume slider stretching to fill the control bar on some themes.<\/li>\n
- Fixed - The settings\/speed menu not closing on an outside click.<\/li>\n
- Fixed - Arrow key volume\/seek shortcuts also scrolling the page.<\/li>\n<\/ul>\n\n
1.1.0 - 01-09-2026<\/h4>\n\n\n- Fixed - Saving a video, preset or playlist whose settings contained a double quote or a backslash wiped the whole configuration, source and layers included. Adding a shortcode layer was the easiest way to hit it.<\/li>\n
- Fixed - Aspect ratio \"Auto (native)\" rendered an invisible<\/li>\n
- Fixed - Caption background colour and background opacity had no effect during playback.<\/li>\n
- Fixed - Loop stopped the end of a video ever being reached, <\/li>\n
- Fixed - silently disabling the final quiz, end screen, end email gate, reset-on-end and playlist auto-advance.<\/li>\n
- Fixed - \"Disable the timeline entirely\" left the arrow keys and the rewind and fast-forward buttons still able to seek.<\/li>\n
- Fixed - \"Start muted\" was ignored on YouTube and Vimeo sources.<\/li>\n
- Fixed - The editor preview shared its saved playback position with the front end, so it could open part-way through a video.<\/li>\n
- Fixed - A caption track marked as default reported itself as off while it was being displayed.<\/li>\n
- Fixed - Playback failures gave no reason. A YouTube video that disallows embedding is now named as such.<\/li>\n
- Fixed - Discarding a preset or playlist edit left the discarded changes on screen.<\/li>\n
- Fixed - Video control, audio playback, source type and interactive email form issues reported during testing.<\/li>\n
- Improved - Removing a video now also removes the poster that came from it, instead of leaving it in the media library.<\/li>\n
- Improved - Video titles are reduced to plain single-line text and capped in length<\/li>\n
- Improved - The control bar now appears as soon as the media is ready, not only after playback starts.<\/li>\n
- Improved - Layer timings are entered as hours, minutes and seconds instead of raw seconds, and layer rows read as timestamps.<\/li>\n
- Improved - The editor's eye toggle now genuinely previews a layer, ignoring its time window and taking it down again afterwards.<\/li>\n
- Improved - Settings the preview cannot demonstrate now say so, and \"Reset to start when finished\" is disabled while Loop is on.<\/li>\n
- Improved - Shortcode layers show a placeholder in the editor preview instead of appearing empty, and their inline scripts now run.<\/li>\n
- Improved - Self-hosted video workflow, audio player styling, H5P media options and admin submenu presentation.<\/li>\n
- Added - Email capture now works with no CRM connected: a built-in Email notification provider mails each capture to the site administrator.<\/li>\n
- Added - An Email form layer with two modes, gate (pauses the video) and inline (does not interrupt). The old Email capture section merged into it and is converted on upgrade.<\/li>\n
- Added - Conditional display rules on layers: logged in, CRM contact, tag or list, URL parameter, or having seen or completed another layer.<\/li>\n
- Added - A poster field and media file card in the Source step, so a file and its poster are managed together.<\/li>\n
- Added - Player preset templates in Settings, with presets resolved in the live preview.<\/li>\n
- Added - A trueplayer:layer-rendered DOM event, so code that initialises at page load can pick up layers added mid-playback.<\/li>\n<\/ul>\n\n
1.0.0 - 27\/08\/2026<\/h4>\n\n
First stable release. TruePlayer ships as a native WordPress video & audio player built for enforcement and automation.<\/p>\n\n
Player<\/strong>\n* Native React player with multiple skins (default, modern, simple, minimal, standard).\n* Sources: self-hosted \/ direct URL, HLS, audio, YouTube and Vimeo.\n* Full customization: control toggles, autoplay\/loop\/save-position\/sticky-float, preload & load strategy (facade\/eager\/on-visible), accent color, play-button style, roundness, control-bar style, aspect ratio, caption size\/color\/background, playback speeds, Picture-in-Picture.\n* Optional bundled H5P interactive engine (import + render H5P content, xAPI fed into the event pipeline).<\/p>\n\nWatch verification<\/strong>\n* Server-authoritative coverage tracking proves a viewer genuinely watched (whole-second progress only), with anti-skip \/ seek-jump and playback-rate guards.<\/p>\n\nQuiz gating<\/strong>\n* Checkpoint and end-gate questions attached to a video; server-side grading (answers never sent to the client). Failing locks the video and resets coverage until the viewer re-watches and re-attempts. (Enforcement activates with TruePlayer Pro.)<\/p>\n\nEvents & webhooks<\/strong>\n* Event bus: view.started, progress.milestone, view.completed, checkpoint.passed\/failed, quiz.passed\/failed, video.locked\/unlocked, subscriber.added.\n* HMAC-SHA256 signed JSON webhooks (X-TruePlayer-Signature header) for automation tools.<\/p>\n\nAdmin<\/strong>\n* React single-page admin: Dashboard, Media library, Editor, Playlists, Presets, Settings.\n* WP-CLI trueplayer<\/code> command; REST API across videos, progress, grading, playlists, presets, subtitles, viewers and webhooks.<\/p>","raw_excerpt":"A fast, customizable video & audio player for self-hosted files, YouTube, Vimeo and HLS \u2014 with chapters, playlists, presets and email capture.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/383691","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=383691"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kodezen"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=383691"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=383691"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=383691"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=383691"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=383691"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=383691"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}