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

ActiveNeos-plugin[Image & Media](/categories/media)

dl/gallery
==========

Neos plugin to easily render image galleries

4.4.0(2y ago)1416.8k↓45.5%15[3 issues](https://github.com/daniellienert/DL.Gallery/issues)[1 PRs](https://github.com/daniellienert/DL.Gallery/pulls)2MITCSSCI failing

Since Oct 26Pushed 3mo ago6 watchersCompare

[ Source](https://github.com/daniellienert/DL.Gallery)[ Packagist](https://packagist.org/packages/dl/gallery)[ RSS](/packages/dl-gallery/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (34)Used By (2)

[![Latest Stable Version](https://camo.githubusercontent.com/8d2e7c21eff94cf24527cbf186fb5d00f22c4f7e88d040ccc6e6b94aa2918e86/68747470733a2f2f706f7365722e707567782e6f72672f646c2f67616c6c6572792f762f737461626c65)](https://packagist.org/packages/dl/gallery) [![Total Downloads](https://camo.githubusercontent.com/f391af0b579fab6953a1a01ef169ea55c777911fabbd3f35bef1845ce91ff8b3/68747470733a2f2f706f7365722e707567782e6f72672f646c2f67616c6c6572792f646f776e6c6f616473)](https://packagist.org/packages/dl/gallery) [![Latest Unstable Version](https://camo.githubusercontent.com/a4d758bcb5bba2eafc3e52a3fb72d73770b359f6a34450b903719923f22866e1/68747470733a2f2f706f7365722e707567782e6f72672f646c2f67616c6c6572792f762f756e737461626c65)](https://packagist.org/packages/dl/gallery) [![License](https://camo.githubusercontent.com/560a28dcc385bcf4cabd7e75e40e4332beaf55275a123f39de9b12ea2ace7ad0/68747470733a2f2f706f7365722e707567782e6f72672f646c2f67616c6c6572792f6c6963656e7365)](https://packagist.org/packages/dl/gallery)

Neos Gallery
============

[](#neos-gallery)

This package provides a node type to easily render image galleries.

Installation and integration
============================

[](#installation-and-integration)

The installation is done with composer:

```
composer require dl/gallery

```

### (De)activate CSS / Javascript autoloading

[](#deactivate-css--javascript-autoloading)

By default, the galleries CSS and JavaScript files are added to the header and footer includes of your page automatically on pages, where an instance of the gallery plugin is added. If you want to compile the JS / CSS into your pages main files you can deactivate this behavior via settings:

```
DL:
  Gallery:
    loadGalleryCSS: false
    loadGalleryJS: false

```

Show a set of images as a gallery
=================================

[](#show-a-set-of-images-as-a-gallery)

Select images to be displayed in the gallery
--------------------------------------------

[](#select-images-to-be-displayed-in-the-gallery)

Add a new gallery node to your page and use the inspector add images from the media module or upload them directly.

Use Tags or collections
-----------------------

[](#use-tags-or-collections)

**1. Use tags or collections to group images**

The images to show in a gallery need to be grouped by a tag or collection. To group images, go to the media module and add a new tag or collection. Drag and drop images onto this or select it in the image detail view.

**2. Chose a tag in the plugins inspector**

Add a new gallery plugin to your page. You can now choose a tag or a collection as the gallery source in the inspector. The images will then be rendered equally within the gallery.

Gallery Presentation
--------------------

[](#gallery-presentation)

### Theme Bootstrap Lightbox

[](#theme-bootstrap-lightbox)

The thumbnails of the gallery are displayed squared using a bootstrap grid. The lightbox [photoswipe](http://photoswipe.com/) is used to open a large representation of the image.

[![Bootstrap Squares](https://user-images.githubusercontent.com/642226/34392687-0d2e7ab8-eb4e-11e7-8b8c-caa6b5f0d5a6.png)](https://user-images.githubusercontent.com/642226/34392687-0d2e7ab8-eb4e-11e7-8b8c-caa6b5f0d5a6.png)

### Theme Justified

[](#theme-justified)

Uses the jquery plugin [justified.js](http://nitinhayaran.github.io/Justified.js/demo/) to display the thumbnails and also [photoswipe](http://photoswipe.com/) as lightbox.

[![Justified Theme](https://user-images.githubusercontent.com/642226/34392597-6a3c25f8-eb4d-11e7-8bfc-a4561be6a838.png)](https://user-images.githubusercontent.com/642226/34392597-6a3c25f8-eb4d-11e7-8bfc-a4561be6a838.png)

Build your own theme
--------------------

[](#build-your-own-theme)

The themes are written mostly using Neos Fusion code. That means you can adjust the existing two themes from within your own package easily or build your own theme.

Building a new theme is as easy as adding a new fusion prototype to render the images and register your prototype in the settings:

```
DL:
  Gallery:
    themes:
      yourThemeName:
        label: 'Displays the images like I want'
        fusionPrototype: 'YourVendor.YourPackage:renderingPrototype'
        themeSettings:
            settingForMyTheme:SomeSetting

```

Your theme is now selectable in the Nodes theme selector.

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance49

Moderate activity, may be stable

Popularity36

Limited adoption so far

Community26

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 87.5% 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 ~97 days

Recently: every ~384 days

Total

31

Last Release

925d ago

Major Versions

0.4.1 → 1.0.02016-12-23

0.4.x-dev → 1.1.02017-01-07

1.1.3 → 2.0.02017-08-18

1.1.4 → 3.0.02017-12-26

3.3.0 → 4.0.02019-08-20

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/642226?v=4)[Daniel Lienert](/maintainers/daniellienert)[@daniellienert](https://github.com/daniellienert)

---

Top Contributors

[![daniellienert](https://avatars.githubusercontent.com/u/642226?v=4)](https://github.com/daniellienert "daniellienert (91 commits)")[![lorenzulrich](https://avatars.githubusercontent.com/u/1816023?v=4)](https://github.com/lorenzulrich "lorenzulrich (3 commits)")[![jonathantechniconcept](https://avatars.githubusercontent.com/u/29302103?v=4)](https://github.com/jonathantechniconcept "jonathantechniconcept (2 commits)")[![lcherpit](https://avatars.githubusercontent.com/u/490499?v=4)](https://github.com/lcherpit "lcherpit (1 commits)")[![marcrobertscamao](https://avatars.githubusercontent.com/u/249061?v=4)](https://github.com/marcrobertscamao "marcrobertscamao (1 commits)")[![mindpilot](https://avatars.githubusercontent.com/u/3437392?v=4)](https://github.com/mindpilot "mindpilot (1 commits)")[![soee](https://avatars.githubusercontent.com/u/1798417?v=4)](https://github.com/soee "soee (1 commits)")[![cvette](https://avatars.githubusercontent.com/u/6884391?v=4)](https://github.com/cvette "cvette (1 commits)")[![underdoeg](https://avatars.githubusercontent.com/u/243820?v=4)](https://github.com/underdoeg "underdoeg (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![johannessteu](https://avatars.githubusercontent.com/u/769789?v=4)](https://github.com/johannessteu "johannessteu (1 commits)")

---

Tags

galleryneoscms

### Embed Badge

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

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

###  Alternatives

[goat1000/svggraph

Generates SVG graphs

132849.6k3](/packages/goat1000-svggraph)[contao/image

Contao image library

131.7M9](/packages/contao-image)[intervention/image-driver-vips

libvips driver for Intervention Image

4495.5k6](/packages/intervention-image-driver-vips)[jonnitto/plyr

Plyr.io for Neos.io

1236.2k2](/packages/jonnitto-plyr)[shel/neos-image-checker

Image editor with customisable checks for Neos CMS

106.0k](/packages/shel-neos-image-checker)

PHPackages © 2026

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