dynamic/silverstripe-elemental-gallery

A block to display a collection of images

6.0.0 2025-10-21 23:05 UTC

Requires

• dnadesign/silverstripe-elemental: ^6
• dynamic/silverstripe-elemental-baseobject: ^6

Requires (Dev)

• silverstripe/recipe-testing: ^4

Suggests

• colymba/gridfield-bulk-editing-tools: Bulk upload images to a gallery.

BSD-3-Clause

• Dynamic

• image
• content
• silverstripe
• photo
• gallery
• blocks
• elemental

README

Requirements

• PHP: ^8.3
• silverstripe/recipe-plugin: ^2
• silverstripe/vendor-plugin: ^2
• dnadesign/silverstripe-elemental: ^6
• dynamic/silverstripe-elemental-baseobject: ^6

Suggested Modules

• colymba/gridfield-bulk-editing-tools (^3): Provides bulk upload support

Installation

composer require dynamic/silverstripe-elemental-gallery

License

See License

Example usage

Photo Gallery Element block allows you to display a collection of images. Click on the image thumbnail to open a larger version in Lightbox.

Features

• Display a collection of images in a responsive gallery layout
• Bulk image upload support via Colymba's GridField Bulk Manager
• Automatic cascade deletion (images are removed when gallery is deleted)
• Automatic cascade duplication (images are copied when gallery is duplicated)
• Optional HTML content field for gallery description
• Lightbox integration for image viewing

Screen Shots

Front End sample of a Gallery Element

Front End sample of a Gallery Element - Lightbox

CMS - Gallery Main Tab

CMS - Gallery - Add/Edit Gallery Image

Configuration

Bulk Image Upload

This module supports bulk image uploads through the CMS. To enable this feature, ensure you have installed the recommended package:

composer require colymba/gridfield-bulk-editing-tools

Once installed, you'll see a bulk upload button in the gallery images grid field.

Content Field

The gallery element includes an optional HTML content field that can be used to add a description or introduction text above the gallery.

Getting more elements

See Elemental modules by Dynamic

Additional Configuration

See SilverStripe Elemental Configuration

Maintainers

• Dynamic ([e-mail])

Bugtracker

Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.

If the issue does look like a new bug:

• Create a new issue
• Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
• Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.

Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.

Development and contribution

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.