Advanced Lightbox for Gallery Block

By dmrhn

100+ active installationsVersion 0.7

Extremely lightweight yet powerful and touch-friendly, jQuery-free, Lightbox toggle button for core Gallery block and supports custom-coded galleries.

Description

This WordPress Plugin adds an Advanced Lightbox to the core Gallery block. Select the gallery, open the Link menu in the block toolbar and choose “Advanced Lightbox” (next to “Enlarge on click”). Thumbnails and Captions toggles then appear in the block settings sidebar. It also supports custom coded galleries through a filter (check FAQ).

dLightbox.js is fully responsive, supporting touch, mousewheel, keyboard, and mouse drag interactions, double click or tap/touch to zoom original image, build-in thumbnails, as well as slide counters and figcaption. With no dependency on jQuery, dLightbox.js ensures optimal viewing experiences across all devices.

Although extremely lightweight at only 2.78kb gzipped for both dLightbox.js and dLightbox.css, the plugin only loads assets into the page if there is a core Gallery block or custom selectors defined via a filter.

Features

  • Enable directly inside the gallery block’s own Link dropdown for each Gallery block individually.
  • Custom coded galleries support.
  • Supports touch, mousewheel, keyboard, and mouse drag interactions.
  • Double click or tap/touch to zoom original image.
  • Lightbox thumbnails with an easy toggle button.
  • Slide counter and figcaption support.
  • jQuery-Free, lightweight at only 2.78kb gzipped for both dLightbox.js and dLightbox.css
  • Fully responsive.

Installation

  1. Download the plugin ZIP file.
  2. In your WordPress admin panel, navigate to Plugins -> Add New.
  3. Click the “Upload Plugin” button, choose the ZIP file you downloaded, and click “Install Now.”
  4. After installation, activate the plugin.

FAQ

How do I enable the Lightbox for the core Gallery block?

Select the gallery block, open the Link menu in the block toolbar and choose “Advanced Lightbox”. Choosing any other Link option turns it off. Thumbnails and Captions toggles appear in the block settings sidebar while it is selected.

Can I use Lightbox with my custom galleries?

Yes, you can use the lightbox with custom galleries by using the provided filter. Example code is provided for reference.

add_filter( ‘dLightbox:custom:selectors’, function ( $selectors ) {
$selectors = array_merge( $selectors, array(‘.my-gallery’, ‘.your-gallery’) );
return $selectors;
});

Is it mobile touch friendly?

dLightbox.js supports touch, mousewheel, keyboard, and mouse drag interactions.

Is it supports thumbnails?

Yes it supports Lightbox thumbnails with an easy toggle. Also with “dLightbox-thumbnails” class you can easily adapt thumbnails to your custom coded galleries.

Is the lightbox responsive?

Yes, the lightbox feature provided by Gallery Lightbox is fully responsive, ensuring optimal viewing experiences across all devices.

Does it need jQuery?

No, there is no dependency on jQuery. dLightbox is custom coded from scratch, ensuring efficient performance and compatibility with modern web development practices.

Does the plugin impact page loading speed?

Although extremely lightweight at only 2.78kb gzipped for both dLightbox.js and dLightbox.css, the plugin only loads assets into the page if there is a core Gallery block or custom selectors defined via a filter. This ensures minimal impact on page loading speed.

What if I encounter any issues or have feature requests?

If you encounter any issues, have feature requests, or need support, please visit the GitHub repository and create an issue. Our team will be happy to assist you.

Screenshots

Changelog

0.7

  • “Advanced Lightbox” is now an option inside the gallery block’s own Link dropdown, after “Enlarge on click”
  • Thumbnails and Captions toggles show in the sidebar only while Advanced Lightbox is selected

0.6

  • Improved dLightbox.js code
  • Fixed an issue when toogle off thumbnails

0.5

  • Improved dLightbox.js code
  • Added auto carousel to thumbnails container if wider than viewport

0.4

  • Improved double click to zoom
  • Added double tap to zoom on mobile

0.3

  • Added Zoom to original image size on double click

0.2.1

  • Added Caption Toggle

0.2

  • Added Dynamic Thumbnails

0.1

  • Initial release