manifest / unclassified / color-swatch-gallery
Color Swatch Gallery
A custom plugin to display color swatches with admin-managed options.
★ 0stars
Install
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/abdulsamadshaikh/color-swatch-gallery/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
✅ Color Swatch Gallery – Documentation
📌 Plugin Overview
A custom WordPress plugin to manage and display color swatches in a visually engaging gallery. Includes a preview image, thumbnail navigation, and shortcode integration. Built for flexibility, accessibility, and clean admin control.
✨ Features
- Admin panel to add Title, Description, and Bottom Note
- Add unlimited swatches with name and image
- Thumbnail carousel with left/right navigation
- Dynamic preview image with fade effect
- Active states for arrows and thumbnails
- Shortcode usage
- Responsive and lightweight
⚙️ Usage Instructions
- Go to WP Admin → Swatch Gallery
- Add a title, description, and bottom note
- Click “Add Swatch”, enter a name and select image from Media Library
- Click Save Changes
💡 Display gallery using the shortcode:
[color_swatches_gallery]
You can use this shortcode on any page, post, or inside a block/widget area.
🧠 How It Works
- The first swatch image appears as the large preview
- Clicking a thumbnail updates the preview with fade transition
- Swatches scroll in a carousel (4 visible at once)
- Image preview and alt text are dynamically handled through settings and JavaScript logic
📁 File Structure
color-swatch-gallery/
├── admin/
│ ├── css/
│ │ └── admin-style.css
│ ├── js/
│ └── admin-settings.php
├── public/
│ ├── css/
│ │ └── style.css
│ ├── icon/
│ │ ├── arrow-left-icon.svg
│ │ └── arrow-right-icon.svg
│ ├── js/
│ │ └── swatch-gallery.js
│ └── swatch-display.php
└── color-swatch-gallery.php
💡 Compatibility & Notes
- Compatible with WordPress 5.6+ (tested on 6.7.2)
- Works with all major themes
- No page builder dependency
- Shortcode will not render live in block editor (only visible on front-end)
- Admin panel includes shortcode instruction reminder
Developer: Abdul Samad
🌐 Website: www.getabdulsamad.com