=== ReelsHive ===
Contributors: aarati24
Tags: reels, gallery, video, tiktok, slider
Requires at least: 5.0
Tested up to: 7.0.2
Requires PHP: 7.2
Stable tag: 1.0.13
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display engaging vertical videos in WordPress with the ultimate WordPress reels plugin.

== Description ==

**Are you looking to show immersive vertical videos in WordPress, but struggling with slow page loads or distracting embeds?**

Over 80% of web traffic is mobile, and users don’t rotate their phones anymore. If your website is still relying on flat, landscape-oriented videos or cluttered YouTube/Vimeo embeds, **you are leaking traffic and conversions every single second.** 

If you aren't capturing the micro-attention of today's mobile audience with immersive, portrait-style video loops, **your website is already falling behind.**

### The Ultimate WordPress Reel Plugin: Stand Out with ReelsHive

**ReelsHive** is the ultimate **WordPress reels** plugin designed to let you easily create and display high-converting, TikTok-style **vertical videos in WordPress** using your own self-hosted videos. 

Get the exact same addictive, swipeable, fullscreen video experience of Instagram Reels and YouTube Shorts on your site. By using this lightweight **WordPress reel** plugin, you keep users on your pages and **retain 100% control of your traffic**—with no competitor ads, external logo overlays, or leaky links.

### Why You Need a Dedicated WordPress Reel Plugin:
* **Seamless Vertical Videos in WordPress:** Modern mobile users expect vertical content. ReelsHive delivers beautiful portrait-style videos that feel native on smartphones, capturing mobile engagement that traditional videos lose.
* **Stop Leaking Traffic:** Standard embeds invite users to click away. ReelsHive uses your own self-hosted MP4/WebM video files, keeping users glued to *your* brand and *your* site.
* **Add Call-to-Actions Directly to Reels:** Turn passive viewers into active buyers. Place fully customizable CTA buttons on top of your **WordPress reels** to instantly direct traffic to your landing pages, signup forms, or checkout.
* **Blazing Fast Performance:** Don't let heavy video scripts kill your Google Core Web Vitals. ReelsHive features predictive lazy loading and mobile buffering to ensure your pages stay fast.

### Zero Complexity. Complete Control.
You don’t need a developer or complex video tools. Getting your portrait reel gallery live takes less than 2 minutes:
1. **Upload:** Go to `ReelsHive -> Add New Single Reel` and upload your MP4 video file.
2. **Convert:** Add an engaging Call-to-Action link, custom button text, and colors directly onto the video.
3. **Embed:** Copy the simple shortcode and drop it anywhere—posts, pages, sidebar widgets, or page builders like Elementor and Gutenberg.

### Core Features built for Conversions:
* **100% Self-Hosted & Ad-Free:** Run portrait video reels without dependency on external video networks or risk of algorithm distractions.
* **Interactive CTA Buttons:** Overlay direct links, custom colors, and text to guide user action on each reel.
* **Multiple Display Layouts:** Build TikTok-like Vertical Scroll feeds, responsive Grid galleries, or horizontal Swipeable Sliders.
* **Deep Linking Support:** Link directly to a specific video within a gallery from external emails or social campaigns.
* **High-Performance Lazy Loading:** Smart buffering that preloads videos selectively, optimizing your page speed and mobile bandwidth.
* **Universal Responsiveness:** Designed to look and work flawlessly across desktop, tablet, and mobile browsers.

== External services ==

This plugin provides social sharing functionality that links to third-party services. These services are only accessed when a user explicitly clicks on a share button.

* **Facebook**: Used for sharing video reels on Facebook. When a user clicks the Facebook share button, they are redirected to Facebook's sharing interface. The shared URL and page title are sent to Facebook.
  - Service provider: Meta Platforms, Inc.
  - [Terms of Service](https://www.facebook.com/legal/terms), [Privacy Policy](https://www.facebook.com/about/privacy)

* **WhatsApp**: Used for sharing video reels via WhatsApp. Clicking the WhatsApp share button redirects the user to the WhatsApp API to compose a message. The shared URL and page title are sent.
  - Service provider: WhatsApp LLC
  - [Terms of Service](https://www.whatsapp.com/legal/), [Privacy Policy](https://www.whatsapp.com/legal/privacy-policy)

* **Twitter (X)**: Used for sharing video reels on Twitter (X). Clicking the Twitter share button redirects the user to the Twitter intent interface. The shared URL and page title are sent.
  - Service provider: X Corp.
  - [Terms of Service](https://x.com/en/tos), [Privacy Policy](https://x.com/en/privacy)



== Installation ==

1. Upload the `reelshive` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to the 'ReelsHive' menu to start creating your first reels.

== Frequently Asked Questions ==

= How do I display vertical videos in WordPress? =
To show vertical videos in WordPress, install ReelsHive, navigate to 'ReelsHive' -> 'Add New Single Reel', upload your MP4 video, and save. Copy the generated shortcode and paste it anywhere on your site to display your vertical video.

= What makes ReelsHive the best reels WordPress plugin? =
Unlike standard embed solutions that drive traffic away with competitor ads, ReelsHive is a dedicated WordPress reel plugin that uses self-hosted videos. It features overlay call-to-actions, deep-linking, and lazy loading specifically optimized for vertical videos on WordPress websites.

= How do I create a vertical scroll (TikTok-style) WordPress reel gallery? =
Create individual vertical video reels first. Then go to 'ReelsHive' -> 'Add New Gallery', choose the reels you want to show, select 'Vertical Scroll' as the layout mode, and publish. Paste the gallery shortcode on any page.

= Will hosting my own WordPress reels slow down my website load time? =
No. ReelsHive uses an advanced predictive lazy loading mechanism. Videos only start buffering when visitors scroll near them, ensuring your pages stay fast and secure.

= How does the Call-to-Action (CTA) overlay work? =
For each vertical video, you can assign custom links and styling. The CTA button is automatically laid over your WordPress reel so viewers can take action right from the video.

= Can I link directly to a specific video in a gallery? =
Yes. ReelsHive supports deep linking. Every video in a gallery has its own URL parameter, meaning you can share a link that automatically scrolls to and loads a specific video for your audience.

= Is ReelsHive compatible with page builders? =
Yes! The shortcodes generated by ReelsHive work flawlessly with any block editor, classic editor, or popular page builders such as Elementor, Divi.

== Changelog ==

= 1.0.13 =
- Enhanced: Updated the plugin description in readme.txt.

= 1.0.12 =
- Tested: Successfully with WordPress 7.0.2

= 1.0.11 =
- Enhanced: Redesigned the selection checkboxes on the single reels grid to be fully responsive and properly centered across all screen widths/resolutions.
- Fixed: Resolved vertical alignment of dashicon inside the select button in the gallery meta box.
- Changed: Lowered default Call-To-Action (CTA) font size fallback from 14px to 12px for cleaner UI and consistent display.

= 1.0.9 =
- Enhanced: Loading spinner displays cleanly with a transparent background directly over the video poster image.
- Enhanced: Handled various UI/UX edge cases for robust playback state management, ensuring smooth and stable interactions across all gallery modes.
- Fixed: Resolved video initialization issues in grid gallery layouts by strictly using the `loadeddata` event, ensuring videos are properly prepared before displaying.
- Enhanced: Engineered a predictive lazy loading mechanism for the UI, drastically optimizing performance and memory consumption.
- Fixed: Append reel type to Add New URL
- Fixed: Preview video not visible in select reels tab

= 1.0.7 =
- Enhanced: Unified admin preview width to 260px for perfect visibility on Desktop, iPad, and Mobile.
- Fixed: Resolved JavaScript ReferenceError in the admin dashboard.
- Fixed: Synchronized loading state and real-time percentage display in the admin preview player.

= 1.0.5 =
- Enhanced: Optimized mobile video loading with predictive buffering (600px margin).
- Enhanced: Redesigned video loader with smooth cross-fade transitions and real-time buffering percentage.
- Enhanced: Improved admin responsiveness for settings, meta boxes, and documentation tables.
- Fixed: Resolved play/pause synchronization issues in fullscreen mode.
- Fixed: Synchronized mute icons between inline and fullscreen players.
- Fixed: Resolved video visibility issues in fullscreen mode for already-buffered elements.
- Improved: Added `playsinline` and `metadata` preloading for faster mobile playback.

= 1.0.4 =
- Fixed minor layout issues in Grid gallery.

= 1.0.3 =
- Fixed: Prefixed taxonomy identifier from `reel_type` to `reelshive_reel_type` to comply with WordPress.org naming requirements.
- Fixed: Prefixed taxonomy term slugs — `single_reel` → `reelshive_single_reel`, `reels_gallery` → `reelshive_reels_gallery`.
- Fixed: Updated all admin URL query parameters, column keys, and taxonomy lookups across the admin class and partial templates to use the new prefixed identifiers.
- Fixed: Updated activation hook to register terms under the new prefixed taxonomy and slugs.

= 1.0.2 =
- Enhanced: Enforced Prefix Consistency
- Solved: Nonces and User Permissions Before Processing Requests
- Solved: Use wp_enqueue commands
- Add correct contributor username to readme
- Solved: Undocumented use of external service

= 1.0.1 =
- Initial public release for WordPress.org.
- Added professional safety guards for duplicate installations.

= 1.0.0 =
- Beta release.
