silverstripe-gallery 

silverstripe-gallery

This module is also available on github.

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. This module adds also some field to the Settings tab. This will allow to customize some aspect of the gallery 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.

Usage

You can write your own templates and support the JavaScript library of your choice. Out of the box the Fotorama library is used. You can embed the default gallery block in your pages by including ContentGallery.ss, e.g.:

<%-- This is a typical Page.ss --%>
<h1>$Title</h1>
<div class="gallery">
    <% include ContentGallery.ss %>
</div>
<div class="content">
    $Content
</div>

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 because it relies on some convention adopted by that theme.

Author

Although the project originally started as a fork of silverstripe-gallery by i-lateral, the actual code has been rewrote almost from scratch by ntd and, apart the name, practically everything else has changed.

The project home page is shared by other SilverStripe modules and themes.

To check out the code, report issues or propose enhancements, go to the dedicated tracker. Alternatively, you can do the same things by leveraging the official github repository.

Installation

The gallery module is implemented as an extension of silverstripe-carousel, so you must install it first. This in turn will install the 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, the dependencies will be pulled-in automatically, so you could just run the following command:

composer require entidi/silverstripe-gallery dev-master

Development Team
Admins
Nicola Fontana

Powered by InDefero,
a CĂ©ondo Ltd initiative.