PHPackages                             purplespider/silverstripe-basic-gallery-extension - 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. purplespider/silverstripe-basic-gallery-extension

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

purplespider/silverstripe-basic-gallery-extension
=================================================

Silverstripe CMS Image Gallery Extension

5.0.0(1y ago)24.4k↓28.6%22BSD-3-ClausePHP

Since Mar 13Pushed 3mo ago2 watchersCompare

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

READMEChangelog (5)Dependencies (6)Versions (19)Used By (2)

Basic Image Gallery Extension for Silverstripe
==============================================

[](#basic-image-gallery-extension-for-silverstripe)

Introduction
------------

[](#introduction)

Add this extension to any page type, to get the following batch image upload interface in the CMS:

[![Screenshot](screenshot.png)](screenshot.png)

It allows images to be bulk uploaded, drag and drop reordering and inline caption adding.

Or use the following modules:

- [Basic Image Gallery Page](https://github.com/purplespider/silverstripe-basic-galleries) - Uses this extension to provide Image Gallery Page and Image Gallery Holder page types.
- [Basic Image Gallery Elemental Block](https://github.com/purplespider/silverstripe-elemental-basic-gallery) - Uses this extension to provide an Image Gallery Elemental block.

Maintainer Contact
------------------

[](#maintainer-contact)

- James Cocker ()

Requirements
------------

[](#requirements)

- Silverstripe 6

v3 Upgrade Notes
----------------

[](#v3-upgrade-notes)

Upgrading to v3 will break existing galleries due to a change to a polymorphic relation, to fix:

1. Run `dev/build`
2. Run `/dev/tasks/upgrade-basic-galleries` script.

Config
------

[](#config)

The Extension can be applied to any page type to enable the gallery functionality.

You can also customise the CMS tab that the gallery appears on, as well as the title of the gallery displayed in the CMS, and rename the main Content tab:

```
---
Name: custom-basic-gallery-extension
After: basic-gallery-extension
---
HomePage:
    extensions:
        - PurpleSpider\BasicGalleryExtension\PhotoGalleryExtension
    gallery-title: Image Gallery
    gallery-cms-tab: Main
    content-cms-tab: Top Content
```

### Automatically Delete Image Files

[](#automatically-delete-image-files)

To automatically delete image files when an image is deleted from a gallery:

```
---
Name: custom-basic-gallery-extension
After: basic-gallery-extension
---
PurpleSpider\BasicGalleryExtension\PhotoGalleryImage:
    ondelete_delete_image_files: true
```

This uses [Delete Asset If Unused Extension](https://github.com/purplespider/asset-delete-if-unused-extension) to detect if the image is being used elsewhere on the site, and will only delete it if it isn't. There are caveats though, so check this module's readme, i.e. you might not want to use this on sites that have been upgraded from Silverstripe 3.

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance66

Regular maintenance activity

Popularity27

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 81.8% 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 ~116 days

Recently: every ~172 days

Total

17

Last Release

391d ago

Major Versions

1.0.3 → 2.0.02020-03-19

2.0.0 → 3.0.02021-07-16

3.x-dev → 4.0.02023-06-01

4.0.3 → 5.0.02025-04-22

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/329880?v=4)[James Cocker](/maintainers/purplespider)[@purplespider](https://github.com/purplespider)

---

Top Contributors

[![purplespider](https://avatars.githubusercontent.com/u/329880?v=4)](https://github.com/purplespider "purplespider (27 commits)")[![wernerkrauss](https://avatars.githubusercontent.com/u/1043925?v=4)](https://github.com/wernerkrauss "wernerkrauss (6 commits)")

---

Tags

imagesilverstripeextensionphotogallerybulk

### Embed Badge

![Health badge](/badges/purplespider-silverstripe-basic-gallery-extension/health.svg)

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

###  Alternatives

[frankmullenger/gallery

SilverStripe Gallery Module

243.7k1](/packages/frankmullenger-gallery)

PHPackages © 2026

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