manifest / ecommerce / wc-product-gallery

WC Product Gallery self-updates

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

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

Ships its own WordPress updater (Plugin Update Checker), so new versions show up 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;
});