WP Manifestindependent plugin directory
manifest / media / video-gallery-carousel

Video Gallery Carousel

A lightweight, admin-driven vertical video carousel for WordPress featuring smooth navigation, modal video playback, and easy shortcode integration.

by Abdul Samad · github.com/abdulsamadshaikh/video-gallery-carousel

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/abdulsamadshaikh/video-gallery-carousel/archive/refs/heads/main.zip
Readme github.com/abdulsamadshaikh/video-gallery-carousel ↗

🎥 Video Gallery Carousel Plugin

A custom WordPress plugin to create and manage vertical (9:16) video carousels from the admin panel and embed them anywhere using a shortcode.

Supports YouTube, Vimeo, and self-hosted MP4 videos with automatic thumbnail generation and modal video playback.

📥 Installation

  1. Download or clone the plugin repository.
  2. Upload the plugin folder to:
    wp-content/plugins/video-gallery-carousel/
  3. Go to WordPress Dashboard → Plugins.
  4. Activate Video Gallery Carousel.

🚀 Usage

➕ Create a Video Carousel

  1. Go to WP Admin → Video Carousels → Add New
  2. Enter a carousel title (e.g. Landing Page Videos)
  3. Add video items:
    • Video Title
    • Video URL (YouTube / Vimeo / MP4)
    • Optional Thumbnail (recommended: vertical 9:16)
  4. Publish the carousel

🔗 Embed Carousel on a Page

Use the generated shortcode:

[vgc_carousel id="123"]

⚙️ Shortcode Parameters

[vgc_carousel id="123" visible="4" gap="18" title_color="#d4a64a" bg="#000000"]
Parameter Description
id Carousel post ID (required)
visible Number of videos visible on desktop
gap Space between videos (pixels)
title_color Video title color
bg Carousel background color

🖼️ Thumbnail Handling

  • If a thumbnail is selected in admin → it is used
  • If no thumbnail is selected:
    • YouTube: thumbnail auto-generated (hqdefault.jpg)
    • Vimeo: thumbnail fetched via oEmbed (cached)
    • MP4: requires manual thumbnail upload

💡 Features

  • 🎬 Admin-managed video carousels (Custom Post Type)
  • 📱 Vertical (9:16) layout for Shorts/Reels style videos
  • ➡️ Smooth horizontal carousel with arrows
  • ▶️ Modal video playback
  • 🔄 Supports YouTube, Vimeo, and MP4 videos
  • 🖼️ Automatic thumbnail generation (YouTube & Vimeo)
  • 🧩 Manual thumbnail override via Media Library
  • ⚡ Lightweight (no external slider libraries)
  • 📱 Fully responsive across all devices

🧪 Compatibility

  • WordPress 6.x+
  • PHP 7.4+
  • Works with:
    • Gutenberg
    • Divi (Text Module recommended)
    • Elementor
    • Classic Editor

📂 Plugin Structure

video-gallery-carousel/
├── video-gallery-carousel.php
├── admin/
│   ├── vgc-admin.php
│   ├── vgc-admin.js
│   └── vgc-admin.css
└── assets/
    ├── vgc.css
    └── vgc.js

🚀 Performance Notes

  • No third-party slider or carousel libraries
  • Minimal JavaScript usage
  • Native scrolling behavior
  • Vimeo thumbnails cached using WordPress transients
  • Frontend assets load only when the shortcode is used

👤 Author

Abdul Samad
Senior Web Developer
https://www.getabdulsamad.com

📄 License

MIT License
Free to use, modify, and distribute.