Juiceboc gallery screenshot

This module provides an integration between the popular Juicebox HTML5 responsive gallery (Javascript) library and Drupal.

The Juicebox library, which is distributed, maintained and supported separately from this Drupal project, is:

  • Based on HTML5 and supports "universal playback". This means it can run on nearly any device and supports multiple input methods (touch gestures, etc.).
  • Fully responsive so galleries can dynamically re-size and adapt to different browser sizes.
  • Powered by a lightweight javascript library.
  • Very friendly to "Create once publish anywhere" (COPE) concepts such that galleries managed in one system can also be embedded in other front-ends (e.g., headless Drupal).
  • Free (though not open source). A "Pro" version is also available that adds some special features.
  • See more features...

This Juicebox module integrates with the library and allows you to turn arbitrary Drupal image data into Juicebox galleries. It includes:

  • A field formatter that allows image and file fields to be formatted as Juicebox Galleries (individual nodes/entities can contain Juicebox galleries).
  • A views style plugin that allows content and file views to be formatted as Juicebox galleries (groups of nodes/entities or files can become Juicebox galleries).
  • Robust integration with the Media and File Entity modules (7.x-2.x).
  • Multilingual support for both gallery content and the Juicebox interface (7.x-2.x).
  • Adaptive delivery of raw source images with support for the library's native "multi-size" image features and/or integration with the Adaptive image styles (AIS) module.
  • Search engine friendly content. Client-side javascript is involved in creation of the Juicebox HTML5 output but this module still ensures that everything is accessible to search engines and non-javascript devices.
  • Easy administrative control over nearly all Juicebox-specific configuration options.

Installing Library

1. Download the Library from https://juicebox.net/download/ and paste it inside your drupal
sites /libraries folder
2. Go inside /libraries/juicebox/web/jbcore and copy the juicebox.js file and classic
folder and paste it under /libraries/juicebox/

Demos and Examples

Views demos with contextual filters showing multiple Juicebox galleries organized with taxonomy and a single view.

Dependencies

Prior to 8.x-3.0-alpha2 released 17 December 2020, the Drupal
API Library module version 2.0 or above was required. This is found at http://drupal.org/project/libraries. Of course, you will also need to download a recent copy of the Juicebox javascript library from http://www.juicebox.net/download.

Both the Lite (free) and Pro versions of the Juicebox library should work fine with this module. The one you choose will depend largely on how much formatting flexibly you require. The Juicebox download and examples pages provide some insight into how the Lite and Pro versions differ. Please remember that this module is not affiliated with the Juicebox library itself, and its maintainers do not benefit in any way if you purchase a "Pro" license.

Full step-by-step installation instructions can be found in the module documentation.

Usage and Configuration

This module integrates with Drupal on many levels but conceptually it operates just like any other display formatter. It's designed to let you easily turn groups of Drupal-managed image data into Juicebox galleries without making too many assumptions about how your site is structured or what media management strategy you use.

If you want to add galleries to individual nodes/entities you can use the Juicebox field formatter (this is probably the easiest option to set up and manage). Or, if you need to group image data from multiple nodes/entities/files into galleries, and leverage the flexibility of views to organize everything, you can use the Juicebox views style plugin.

Step-by-step directions and additional information can be found in the module documentation, which includes dedicated pages for the field formatter and the views style plugin.

This module and its maintainer are in no way affiliated with Simpleviewer Inc., the company behind Juicebox. No endorsement is expressed or implied.



Supporting organizations: 
Drupal 8/9 maintenance and development

Project information

Releases