manifest / ecommerce / wc-product-gallery

WC Product Gallery

Advanced product gallery for WordPress with mobile swipe support, responsive thumbnail navigation, and lazy loading. Built to work seamlessly with Advanced Custom Fields (ACF).

by Harun Studio · github.com/randyhs123/wc-product-gallery · website

★ 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/randyhs123/wc-product-gallery/archive/refs/heads/main.zip

Updates itself. It ships its own updater (Plugin Update Checker), so new versions appear under Dashboard → Updates.

Readme github.com/randyhs123/wc-product-gallery ↗

Advanced product gallery for WordPress with mobile swipe support, responsive thumbnail navigation, and lazy loading. Built to work seamlessly with Advanced Custom Fields (ACF).

Features

📱 Mobile First: Native-like swipe gestures for mobile users.
🖱️ Desktop Navigation: Clickable thumbnail grid.
⚡ Performance: Built-in lazy loading and optimized asset loading (only loads when shortcode is used).
🎨 Customizable: Clean CSS variables for easy theming.
🔄 Auto-Updates: Automatic updates directly from GitHub.

Requirements

WordPress 5.0+
Advanced Custom Fields (ACF) plugin (Free or Pro)

Installation

Download the latest release .zip file.
Go to Plugins > Add New > Upload Plugin.
Upload and activate the plugin.
Ensure you have ACF installed and a Gallery field created.

Usage

Basic Usage

Add the shortcode to any post, page, or template:

[product_gallery]

By default, this looks for an ACF field named gallery_produk.

Custom Field Name

If your ACF gallery field has a different name:

[product_gallery field="my_custom_gallery"]

Disable Lazy Loading

Lazy loading is enabled by default. To disable it:

[product_gallery lazy="false"]

Configuration

Go to Settings > Product Gallery to configure global defaults:

Default ACF Field: Set the default field name so you don't have to add field="" every time.

Developer Hooks

Filters

wc_gallery_max_images Limit the number of images displayed (default: 20).

add_filter('wc_gallery_max_images', function($max) {
    return 30;
});