PHPackages                             dft/silverstripe-gallery - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. dft/silverstripe-gallery

ActiveSilverstripe-vendormodule[Image & Media](/categories/media)

dft/silverstripe-gallery
========================

A Silverstripe image gallery allowing multi image upload and automatic generation of thumbnail gallery with popups

3.0.5(3mo ago)432451BSD-3-ClausePHP

Since Mar 24Pushed 3mo ago4 watchersCompare

[ Source](https://github.com/Dean-Forest-Tech/silverstripe-gallery)[ Packagist](https://packagist.org/packages/dft/silverstripe-gallery)[ Docs](http://github.com/Dean-Forest-Tech/silverstripe-gallery)[ RSS](/packages/dft-silverstripe-gallery/feed)WikiDiscussions 3 Synced 1mo ago

READMEChangelogDependencies (4)Versions (37)Used By (1)

Silverstripe Image Gallery
==========================

[](#silverstripe-image-gallery)

[![Scrutinizer Code Quality](https://camo.githubusercontent.com/3387a52bb34fd13977d03b7c755667cf4ffafb35f0bc4fbb7bf9286b6d68d996/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f692d6c61746572616c2f73696c7665727374726970652d67616c6c6572792f6261646765732f7175616c6974792d73636f72652e706e673f623d32)](https://scrutinizer-ci.com/g/i-lateral/silverstripe-gallery/?branch=2)

[![Build Status](https://camo.githubusercontent.com/8fd9a72d4273fa8bcfdc8925a92fc638aeaafebdb6f22d3981da8e4564b632c9/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f692d6c61746572616c2f73696c7665727374726970652d67616c6c6572792f6261646765732f6275696c642e706e673f623d32)](https://scrutinizer-ci.com/g/i-lateral/silverstripe-gallery/build-status/2)

Adds image galleries to your SilverStripe website.

Author
------

[](#author)

This module was created by [Dean Forest Tech](https://dean-forest-tech.uk).

Installation
------------

[](#installation)

The prefered method is via composer:

```
composer require dft/silverstripe-gallery

```

Alternativley download and add to:

\[silverstripe-root\]/gallery

Then run a `dev/build` (eithe from the browser of the command line).

Usage
-----

[](#usage)

Once installed, you can add either a `Gallery Hub` or a `Gallery Page` to your site.

### Gallery Hub

[](#gallery-hub)

Hub pages generate a thumbnail for each child `GalleryPage` with a link to view that gallery.

The thumbnail is generated based on the first image in the list

### Gallery Page

[](#gallery-page)

A gallery page allows you to upload images and then generates them as a thumbnail gallery. Clicking on the thumbnail opens a modal/lightbox.

You can add a gallery to your site by creating a `GalleryPage` from within the CMS.

Under the `Gallery` tab, you can then upload as many images as needed.

#### Changing the width and height of images

[](#changing-the-width-and-height-of-images)

If you wish to change the width and height of the gallery images (or thumbnails) loaded, you can do this under the `Settings` tab on your `GalleryPage`.

You can set the following options:

- **Image Width** (default: 950): Width in PX of images loaded in the modal
- **Image Height** (default: 500): Height in PX of images loaded in the modal
- **Image Resize Type** (default: ratio): Type of resize to use on images
- **Background** (default: ffffff): If we use a padded image, set the background colour
- **Thumbnail Width** (default: 150): Width in PX of thumbnail images
- **Thumbnail Height** (default: 150): Height in PX of thumbnail images
- **Thumbnail Resize Type** (default: pad): Type of resize to use on thumbnails

Resize options are as follows:

- crop: Crop image to exact size
- pad: Pad image to size and add whitespace
- ratio: Perform a ratio resize of images

#### Forcing the widths and heights

[](#forcing-the-widths-and-heights)

If you want all galleries to be restriced to set sizes, you can set some config variables. Setting these configs will remove the relevent fields from the CMS.

```
DFT\SilverStripe\Gallery\Model\GalleryHub:
  force_thumbnail_width: 350
  force_thumbnail_height: 350
  force_thumbnail_resize_type: crop
DFT\SilverStripe\Gallery\Model\GalleryPage:
  force_image_width: 1200
  force_image_height: 600
  force_image_resize_type: ratio

```

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance86

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 89.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~85 days

Recently: every ~96 days

Total

35

Last Release

96d ago

Major Versions

1.3.1 → 2.1.02018-03-02

1.3.2 → 2.1.12018-03-02

1.0.0 → 2.1.22018-03-28

1.1.x-dev → 2.2.62023-01-06

2.x-dev → 3.0.02024-11-24

### Community

Maintainers

![](https://www.gravatar.com/avatar/c7d4998767cb41bf0048a65158559384fbab33751b26c996d6367019c68c4f8b?d=identicon)[DFT](/maintainers/DFT)

---

Top Contributors

[![mlewis-everley](https://avatars.githubusercontent.com/u/687143?v=4)](https://github.com/mlewis-everley "mlewis-everley (117 commits)")[![Makreig](https://avatars.githubusercontent.com/u/6011781?v=4)](https://github.com/Makreig "Makreig (9 commits)")[![JorisDebonnet](https://avatars.githubusercontent.com/u/3286264?v=4)](https://github.com/JorisDebonnet "JorisDebonnet (4 commits)")[![spekulatius](https://avatars.githubusercontent.com/u/8433587?v=4)](https://github.com/spekulatius "spekulatius (1 commits)")

---

Tags

gallerygallery-imagesgallery-pagesilverstripesilverstripe-4thumbnail-imagessilverstripeThumbnailsgallerymodallightbox

### Embed Badge

![Health badge](/badges/dft-silverstripe-gallery/health.svg)

```
[![Health](https://phpackages.com/badges/dft-silverstripe-gallery/health.svg)](https://phpackages.com/packages/dft-silverstripe-gallery)
```

###  Alternatives

[nicolafranchini/venobox

Responsive JavaScript modal window plugin, touch swipe gallery

7106.8k](/packages/nicolafranchini-venobox)[andrewhoule/silverstripe-photogallery

Creates a basic photo gallery pagetype with albums and photos. Photos within albums are opened with a lightbox.

117.0k1](/packages/andrewhoule-silverstripe-photogallery)[frankmullenger/gallery

SilverStripe Gallery Module

243.7k1](/packages/frankmullenger-gallery)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)