=== WPJ Sticky Video ===
Contributors: treeflips
Tags: sticky video, floating video, youtube, video embed, video player
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.0.9
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display video embeds in a small sticky player, fixed to the page corner during scroll.

== Description ==

Display video embeds (e.g. YouTube/Vimeo) in a small "sticky" video player, fixed to page corner during scroll. Allowing visitors to watch/listen to videos while scrolling down the page. Increasing site engagement time and overall user experience.

FREE version is powerful enough for anyone, while Sticky Video PRO has extra features and customizations for more demanding sites. Built by WPJohnny, you know this plugin is clean-coded, ultra-lightweight, and fast performance.

###HOW IT WORKS

Add any YouTube or Vimeo embed to your page/post. As the visitor scrolls past the video, it automatically "sticks" to a corner of the screen — so they can keep watching while browsing the rest of your content.

###FREE FEATURES

- **YT/Vimeo compatible** - automatically detects YouTube & Vimeo embedded videos.
- **Customizable** - adjust default sticky player size & position for all screen sizes (desktop, tablet, mobile).
- **Auto Play** - choose whether sticky videos play immediately on page load. (Sound starts muted for browser compatibility).
- **Closeable** - users can X-close the sticky video player.
- **Fast Performance** - ultra-lightweight (~11.9kb total CSS/JS) only loads on pages with video embeds. Option to unload plugin CSS and manually enqueue in theme CSS.

###PRO FEATURES

- **Multiple Videos** - allow multiple videos per page in sticky position (via slideshow layout & dot/arrow navigation), FREE version only allows 1st video embed on each page.
- **Visitor Resize** - visitors can resize sticky video player.
- **Visitor Reposition** - visitors can reposition sticky video.
- **Theme options** - choose custom colors for sticky video player border & icons.
- **Additional networks** - support more video networks (Daily Motion, Wistia, Facebook, X/Twitter, TikTok, HTML 5).

Upgrade to <a href="https://wpjohnny.com/downloads/wpj-sticky-video-pro/">Sticky Video Pro</a>

== Installation ==

1. Install easily from your dashboard Add Plugins page or manually download the plugin and upload the extracted archive to the `/wp-content/plugins/` directory.
2. Activate the plugin through the "Plugins" page in Dashboard.
3. From your Dashboard, go to the sidebar Settings menu and click on “Sticky Video” to configure.

== Frequently Asked Questions ==

= Does this plugin work with newest WP version and also older versions? =
* Yes, this plugin works perfect with the latest version of WordPress! Also works with older versions but you should always run latest WordPress & PHP version for best security/performance. This plugin is used in my critical sites so you can be assured it works perfectly.

= Will this plugin slow down my site? =
* No. The plugin is very lightweight (only 11.9kb total CSS/JS), only loads scripts on pages with video embeds, and has option to dequeue the CSS call. I’m an absolute speed fanatic.

= Which videos are supported? =
* FREE version supports YouTube/Vimeo embeds, use a standard embed block or iframe and the plugin handles the rest. PRO version supports Daily Motion, Wistia, Facebook, X/Twitter, TikTok, HTML 5.

= Can I choose the sticky video size & position? =
* Yes. You can set the size and position (corner + offset) separately for Desktop, Tablet, and Mobile.

= What is the Auto Stick feature? =
* Auto Stick makes the video sticky immediately when the page loads — visitors don't need to scroll past the video first, good option for videos embedded far down the page.

= What is the Auto Play feature? =
* Auto Play triggers the video to start playing automatically when the page loads. Sound starts muted as per modern browser rules, but user can easily unmute the sound. Works with YouTube & Vimeo.

= Can visitors close the sticky video? =
* Yes. A close button (X) appears on the sticky player, allowing visitors to easily close it.

= Can I exclude the sticky video effect from certain pages? =
* Absolutely, this is a good idea for pages where embedded videos are intended to stay in the original size. For example: hero videos above the fold, background videos, or any video you don't want to appear earlier than the content.

= Does it work with pagebuilders (Elementor, Divi, etc.)? =
Generally yes, as long as the pagebuilder outputs a standard video iframe embed.

= How often do you plan to update this plugin? =
* We’ll keep maintaining both FREE and PRO versions to work with the latest WordPress version and other plugins.
* New features and styling adjustments will be made over time, at our discretion. Priority given to the most user-requested ones.
* PRO version pricing will increase over time to reflect added features. Existing PRO customers will be grandfathered in (no price changes for them).

== Screenshots ==

1. Sticky Video player with controls, on site frontend.
2. Sticky Video feature settings from WP backend.
3. Can exclude sticky video feature from any posts/pages.

== Changelog ==

= 1.0.9 (April 29, 2026) =
- WordPress.org review: unique wpjsv_ option and handle prefixes; safer nonces and POST sanitization
- Admin CSS preview: escape generated length values; migrate legacy options to wpjsv_* keys on upgrade
- Frontend localized script object renamed to wpjsv_css_prop

= 1.0.8 (April 16, 2026) =
- Initial release
- Tested with WordPress 6.9.4
- Added responsive settings — separate position/size configuration for Desktop, Tablet, and Mobile
- Added [Settings] and [PRO Features] tabs to admin UI
- Added Auto Stick — video becomes sticky on page load without scroll
- Added Auto Play — video auto-plays (muted) on page load
- Added footer review + PRO upsell in admin
- Improved admin UI layout with live preview
