manifest / media / custom-video-library

Custom Video Library

WordPress plugin for managing a video & audio content library with WooCommerce monetization (subscriptions, purchases, and memberships).

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/codesfix-official/custom-video-library/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

A content library plugin for WordPress supporting both video and audio, with flexible WooCommerce monetization.

Video & Audio — a single video CPT handles both; media type is set via an ACF field (_cvl_media_type)
Taxonomies — video_genre (Genre) and video_category (Category) with REST API support
Custom image size — cvl-card (720 × 1080, hard-cropped) registered for consistent card thumbnails
Archive slug — /library/; single items at /library/{slug}/

HTML5 <audio> element with an interactive waveform visualizer (Web Audio API canvas)
Upload — attach a file from the WordPress Media Library (_cvl_audio_file)
External URL — any direct HTTPS audio link (_cvl_video_url)
Cloud storage proxy — Google Drive and Dropbox share links are CORS-blocked by browsers; the plugin routes them through a server-side streaming proxy (?cvl_audio=POST_ID&_cvl_nonce=…) that forwards Range headers so seeking works

Rules are evaluated in order; the first match grants access:

Check	Detail
Admin / editor	`edit_videos` capability
Free flag	`_is_free_video = 1` — public, no login required
No paid gate	No product, subscription, or membership assigned — treated as public
Post author	The user who published the item
WooCommerce purchase	`_wc_product_id` — any completed order containing the product
WC Subscription	`_wc_subscription_id` — one or more product IDs (multi-value ACF)
WC Memberships	`_woo_membership_plan` — one or more plan slugs/IDs (multi-value ACF)

Guest users can always watch free or ungated content without logging in.

Shortcode	Description
`[cvl_video_player id="123"]`	Renders the player for a single item (paywall shown to locked users)
`[cvl_free_library]`	Paginated card grid of all free items; filterable by `?cvl_cat=slug`
`[cvl_paid_library]`	Paginated card grid of all paid items; filterable by `?cvl_cat=slug`
`[cvl_private_library]`	Logged-in user's personal library: wishlist, purchased, in-progress

All shortcodes accept posts_per_page and paged attributes.

Progress saved via AJAX (cvl_save_progress) on timeupdate for HTML5 media and via polling for YouTube/Vimeo
Resume position stored per user; player starts from data-resume-seconds on page load
Progress stored in the custom {prefix}cvl_user_progress table

Clone this repository into wp-content/plugins/
Run composer install
Activate the plugin in WordPress admin
Flush permalinks: Settings → Permalinks → Save Changes
Create and configure ACF field groups for the video post type using the meta keys listed below

Field key	Type	Description
`_cvl_media_type`	Select	`video` or `audio`
`_cvl_video_url`	URL	Direct video/audio URL or external link
`_cvl_youtube_id`	Text	YouTube video ID or full URL
`_cvl_vimeo_id`	Text	Vimeo video ID or full URL
`_cvl_audio_source`	Select	`upload` or `url`
`_cvl_audio_file`	File	WordPress media attachment ID
`_cvl_duration`	Number	Duration in seconds
`_cvl_preview_url`	URL	Public preview clip URL
`_cvl_age_rating`	Text	e.g. G, PG, PG-13, R
`_cvl_release_year`	Number	Four-digit year
`_is_free_video`	True/False	`1` = free for everyone
`_wc_product_id`	Number	WooCommerce product ID for individual purchase
`_wc_subscription_id`	Repeater/Number	WC Subscription product ID(s)
`_woo_membership_plan`	Repeater/Text	WC Membership plan slug(s) or ID(s)

GPL-2.0-or-later