PHPackages                             purplespider/basic-galleries - 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/basic-galleries

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

purplespider/basic-galleries
============================

Basic Photo Gallery functionality

4.0.0(2mo ago)51.5k3BSD-3-ClausePHP

Since Jan 31Pushed 2mo ago3 watchersCompare

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

READMEChangelog (8)Dependencies (6)Versions (29)Used By (0)

Basic Image Gallery Page (& Multiple Gallery Holder Page) for Silverstripe
==============================================================================

[](#basic-image-gallery-page--multiple-gallery-holder-page-for-silverstripe)

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

[](#introduction)

Provides basic image gallery functionality to a Silverstripe site.

Designed to provide a simple, fool-proof way for users to add image galleries to their website.

Applies [Basic Image Gallery Extension ](https://github.com/purplespider/silverstripe-basic-gallery-extension) to a `PhotoGalleryPage` page type, and includes a `PhotoGalleryHolder` type.

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

[](#maintainer-contact)

- James Cocker ()

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

[](#requirements)

- Silverstripe 6

Installation Instructions
-------------------------

[](#installation-instructions)

1. Install:

    ```
    composer require purplespider/basic-galleries ^4

    ```
2. Visit yoursite.com/dev/build to rebuild the database.
3. Log in the CMS, and create a new Photo Gallery Holder page.
4. You can then create Photo Gallery Pages underneath this holder.
5. On a Photo Gallery Page, click on the Image Gallery tab, then click Bulk Upload to add images.

Screenshot
----------

[](#screenshot)

[![Screenshot 2021-07-16 at 13 15 28@2x](https://user-images.githubusercontent.com/329880/125945926-12f45da8-ec7a-4851-927c-c8dddee461af.png)](https://user-images.githubusercontent.com/329880/125945926-12f45da8-ec7a-4851-927c-c8dddee461af.png)

Config
------

[](#config)

You can customise the CMS tab that the gallery appears on, as well as the title of the gallery displayed in the CMS:

```

HomePage:
extensions: - PurpleSpider\BasicGalleries\PhotoGalleryExtension
gallery-title: Image Gallery
gallery-cms-tab: Main

```

### 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.

Version Details
---------------

[](#version-details)

- 0.\* = SilverStripe 3
- 1.\* = Silverstripe 4
- 2.\* = Silverstripe 4 (Uses newer version of `PhotoGalleryExtension` with a polymorphic relation, so upgrading from 1 to 2 will break existing galleries.)
- 3.\* = Silverstripe 5
- 4.\* = Silverstripe 6

Upgrade Notes
-------------

[](#upgrade-notes)

### To v1 or higher (extension moved to seperate module)

[](#to-v1-or-higher-extension-moved-to-seperate-module)

- Change any references to the extension, e.g. if applied to the Homepage type, from `PurpleSpider\BasicGalleries\PhotoGalleryExtension` to `PurpleSpider\BasicGalleryExtension\PhotoGalleryExtension`
- `PurpleSpider\BasicGalleries\PhotoGalleryImage` is now `PurpleSpider\BasicGalleryExtension\PhotoGalleryImage` (in case you applied your own extension to it)
- Run dev/build to update table names automatically (via legacy.yml)

to v2 or higher (individual page and elemental relations changed to a single polymorphic relation)
--------------------------------------------------------------------------------------------------

[](#to-v2-or-higher-individual-page-and-elemental-relations-changed-to-a-single-polymorphic-relation)

- Complete "To v1" upgrade instructions, inc `dev/build`
- Run `/dev/tasks/upgrade-basic-galleries` script to update database for existing galleries.

to v3 (Silverstripe 5)
----------------------

[](#to-v3-silverstripe-5)

- Nothing extra required, just change version to `^3`.

to v4 (Silverstripe 6)
----------------------

[](#to-v4-silverstripe-6)

- Nothing extra required, just change version to `^4`.

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance85

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 98.7% 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 ~182 days

Recently: every ~259 days

Total

25

Last Release

75d ago

Major Versions

0.2.6 → 1.0.02020-03-13

1.0.0 → 2.0.02021-07-16

1.x-dev → 2.0.32021-07-21

2.x-dev → 3.0.02023-06-01

3.1.0 → 4.0.02026-03-04

### 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 (77 commits)")[![mseymour](https://avatars.githubusercontent.com/u/188480?v=4)](https://github.com/mseymour "mseymour (1 commits)")

---

Tags

imagesilverstripephotogallerybulk

### Embed Badge

![Health badge](/badges/purplespider-basic-galleries/health.svg)

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

###  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)

PHPackages © 2026

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