Skip to content

Latest commit

 

History

History
85 lines (62 loc) · 6.04 KB

README.md

File metadata and controls

85 lines (62 loc) · 6.04 KB
Raw

Folder based image gallery for CMS SilverStripe 4.x

NOTE: Work-in-progress fork of cwsoft/silverstripe-foldergallery, which is no longer maintained.

The foldergallery module is a light weight, simple to use folder based image gallery for the CMS SilverStripe 4 which enables you to setup small to medium image galleries with ease.

Features

  • images displayed from SilverStripe assets folder (upload via FTP or SilverStripe files & media section)
  • automatic thumbnail creation of album cover images, album pictures and the ColorBox preview images
  • automatic album and image pagination (number of albums/images per pages configurable via "_config/settings.yml")
  • option to start slide show for displayed images by mouse click
  • image description built from image filenames (e.g. "001-your-description.jpg" --> "Your description")
  • image display order configurable via "_config/settings.yml" (sort by: Filename, Creation, LastEdited in ASC/DESC order)
  • multiple albums support included (organized via subfolders)
  • image gallery appearance customizable via template and CSS files
  • multilingual support included (actual: English, Dutch, French and German)

Download

You can download an archive of the foldergallery module for the SilverStripe 4.x branch using GitHub ZIP button. The archives of previous module releases can be found in cwsoft's GitHub Tags section. The development history is tracked via GitHub.

Note: You can download the last stable (but no longer maintained) version of the foldergallery module for SilverStripe 2.4.x and 3.0.x series from GitHub.

License

The foldergallery module is licensed under the GNU General Public License (GPL) v3.0.

Requirements

The minimum requirements to get the foldergallery module running on your SilverStripe installation are as follows:

  • SilverStripe 4.x or higher (recommended last stable 4.x version)
  • PHP 5.6 or higher (recommended last stable PHP 5.6.x version)

Installation

To be done

Adapt foldergallery layout to match your theme layout

To be done

Usage

To setup a foldergallery page with two albums "Animals" and "Buildings", just follow the steps shown in the sketch below. The steps below assume you have already installed the module before.

  1. Create a page of type Foldergallery (will serve as album overview) and save it (saving will create the folder 'assets/foldergallery for you)
  2. Create album folders animals and buildings inside assets/foldergallery via SilverStripe Files section and upload images to it. Images named "001-this-will-be-the-first-image.jpg" get a description as follows: "This will be the first image". The first image in an album folder will be used as album cover image.
  3. For the album overview page (container), we do not need to select an album image folder. This step is only required for the album children pages created in step 5
  4. Provide a description for the album overview page or the album pages via the WYSIWYG editor and save the page if done
  5. Now create child pages of type Foldergallery for the albums Animals and Buildings. Choose the album image folder from the dropdown box (3) and provide a album description via the WYSIWYG editor (4) and save the pages

Tip: If you do just want to show a single page with images on it, just follow steps 1 through 4, but choose an image folder in step 3.

A collage of the frontend view for this set-up is shown below:

Collage (album overview / album page / Colorbox effect):

Known Issues

Known issues can be tracked and reported via GitHubs issue tracking service. If you run into any issues with the foldergallery module, visit the issue tracker and check if a similar issue was already reported. If not, just add a new topic descriping your issue.

Questions

Always provide the following information with your support request:

  • detailed error description (what happens, what have you already tried...)
  • the foldergallery version used
  • your PHP and SilverStripe version used
  • information about your operating system (e.g. Windows, Mac, Linux) incl. version
  • information of your browser and browser version used

Credits

Credits go to the following SilverStripe community members who helped in one way or another to continually improve the foldergallery module - thanks guys highly appreciated.

  • cwsoft: Creator of the original cwsoft-foldergallery module
  • Kereru: Bug report on thumbnail creation
  • haantje72: Dutch translation, ideas and suggestions for further improvements