PHPackages                             entidi/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. entidi/silverstripe-gallery

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

entidi/silverstripe-gallery
===========================

A new page type that embeds a responsive and touch-enabled image gallery with strip thumbnail navigator and zoomable slides

3.1.1(4y ago)22851BSD-3-ClauseScheme

Since May 20Pushed 4y ago1 watchersCompare

[ Source](https://github.com/ntd/silverstripe-gallery)[ Packagist](https://packagist.org/packages/entidi/silverstripe-gallery)[ Docs](http://silverstripe.entidi.com/)[ RSS](/packages/entidi-silverstripe-gallery/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (11)Used By (0)

Silverstripe Gallery
====================

[](#silverstripe-gallery)

A new page type (*GalleryPage*) that provides everything needed to manage a photo gallery.

You can do bulk uploads and reorder the images by dragging and dropping their thumbnails in a dedicated tab (*Gallery*) inside the CMS. The same image can be shared among multiple galleries.

Usage
-----

[](#usage)

You can write your own templates and support the JavaScript library of your choice. Out of the box the [Fotorama](http://fotorama.io/) library is used. You can embed the default gallery block in your pages by including `ContentGallery.ss`, e.g.:

```

$Title

    $Content

```

Keep in mind the default templates only use the `Height` and `ThumbnailHeight` settings: they *must* be set to a value greater than 0 or an error will be generated. By default they should be set by the CMS to 400 and 64 respectively.

Alternatively, the `GalleryPage.ss` layout template is provided. It renders a full (standard) page, though it works out of the box only with [silverstrap](http://dev.entidi.com/p/silverstrap/) because it relies on some convention adopted by that theme.

Configuration
-------------

[](#configuration)

This module adds some field to the *Settings* tab. This will allow to customize some aspect of the gallery at run time on a per page basis, e.g. the height of the thumbnail strip, the height of the image slide and a flag to show or hide the captions.

The fallback values can be customized too by leveraging the SilverStripe [configuration API](http://docs.silverstripe.org/en/developer_guides/configuration/). Just create your own YAML file in `mysite/_config`, e.g.:

```
---
Name: DefaultSettings
After:
  - 'gallery/*'
---
GalleryPage:
  defaults:
    Captions: false
    Height: 480
    ThumbnailWidth: 0
    ThumbnailHeight: 80

```

The above settings will be applied to *every* instance of the `GalleryPage` class.

Author
------

[](#author)

Although the project originally started as a fork of [silverstripe-gallery](https://github.com/i-lateral/silverstripe-gallery)by [i-lateral](http://www.i-lateral.com/), the actual code has been rewrote almost from scratch by [ntd](mailto:ntd@entidi.it) and, apart the name, practically everything else has changed.

The project [home page](http://silverstripe.entidi.com/) is shared by other [SilverStripe](http://www.silverstripe.org/) modules and themes.

To check out the code, report issues or propose enhancements, go to the [dedicated tracker](http://dev.entidi.com/p/silverstripe-gallery). Alternatively, you can do the same things by leveraging the official [github repository](https://github.com/ntd/silverstripe-gallery).

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

[](#installation)

The gallery module is implemented as an extension of [silverstripe-carousel](https://github.com/ntd/silverstripe-carousel), so you *must* install it first. This in turn will install the [sortablefile](https://github.com/bummzack/sortablefile) module that provides the drag and drop reordering feature.

To install silverstripe-gallery itself you should proceed as usual: drop the directory tree in your SilverStripe root and do a `/dev/build/`. You will gain the new `GalleryPage` type in the CMS.

If you use [composer](https://getcomposer.org/), the dependencies will be pulled-in automatically, so you could just run the following command:

```
composer require entidi/silverstripe-gallery dev-master

```

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 87.1% 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 ~402 days

Recently: every ~696 days

Total

8

Last Release

1460d ago

Major Versions

1.99.0 → 2.0.02014-09-27

2.0.1 → 3.0.12014-09-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/664f545546593aba0414ee3f558665eacbf4f57681276d194e79e084dbcf5fbb?d=identicon)[ntd](/maintainers/ntd)

---

Top Contributors

[![ntd](https://avatars.githubusercontent.com/u/160618?v=4)](https://github.com/ntd "ntd (61 commits)")[![mlewis-everley](https://avatars.githubusercontent.com/u/687143?v=4)](https://github.com/mlewis-everley "mlewis-everley (9 commits)")

---

Tags

gallerymodulesilverstripesilverstripe-modulesilverstripebootstrapgallerycolorboxfotoramasilverstrap

### Embed Badge

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

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

###  Alternatives

[frankmullenger/gallery

SilverStripe Gallery Module

243.7k1](/packages/frankmullenger-gallery)[chrometoaster/silverstripe-image-quality

Adds Quality function to images

1013.0k1](/packages/chrometoaster-silverstripe-image-quality)[thisisbd/silverstripe-fixjpeg-orientation

SilverStripe Fix JPEG Orientation Module. Ensures that JPEG images uploaded from a mobile are rotated and saved upright according their orientation value for consistent viewing when displayed on a web page.

153.3k](/packages/thisisbd-silverstripe-fixjpeg-orientation)

PHPackages © 2026

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