nanoGALLERY plugin for GetSimple CMS
JavaScript CSS PHP
Latest commit ed46336 Aug 26, 2014 @Kris-B v4.4.2a
Permalink
Failed to load latest commit information.
nanogallery3 v4.4.2a Aug 26, 2014
.gitattributes v4.4.2 Jul 4, 2014
README.md v4.4.2 Jul 4, 2014
nanogallery3.php v4.4.2 Jul 4, 2014
nanogallery3_debug.off new Aug 6, 2013

README.md

nanoGALLERY4GS for GetSimple

Image gallery for GetSimple CMS. A powerful and easy to setup GetSimple plugin for displaying image galleries, with support for pulling in Flickr and Picasa/Google+ photo albums. Mobile-friendly. Images are shown as clickable thumbnails, which will expand to full view via a modal popup window. Support custom themes.

Key features

  • Display image galleries from multiple data sources
  • Slideshow
  • Quick and easy setup
  • Automatic thumbnails
  • Display image captions and descriptions
  • Breadcrumb for easy navigation in photo albums
  • Multiple galleries on one page
  • Include pre-built themes, support for custom themes
  • Highly customizable
  • Responsive layout - mobile friendly
  • Ignore desired albums or photosets (by keyword blacklisting)
  • Possible image sources :
    • Flickr account
    • Picasa/Google+ account

Screenshot Screenshot Screenshot Screenshot

Demonstration

Go to the demonstration site

Usage

To display an image gallery insert a code like this one in a GetSimple page :

(%nanogallery userID=PicasaUserID%)

Replace PicasaUserID with your Picasa/Google+ user ID.

Note: syntax is case sensitive.

Example:

(%nanogallery userID1=cbrisbois@gmail.com%)

History:

  • v4.4.2 - new : swipe support, thumbnail display mode justified (thumbnailWidth=auto) and cascading grid layout (thumbnailHeight=auto), new thumbnails hover effects, new theme
  • v4.0.2 - new : 30 thumbnails animated hover effects (combinations possible) / display images faster (thanks to pre-loading) / Boostrap compatible
  • v3.1.3 - new : built-in themes
  • v3.1.2 - bug fix multiple galleries on one page, new : javascript is now a jQuery plugin
  • v3.1.1 - bug fix for IE on Windows Phone (thanks Gregor!), new option to force load jQuery
  • v3.1.0 - added support of Flickr
  • v3.0.1 - first public release

Installation

  • The latest release is available for download on the GetSimple Homepage: Go to
  • Download the zip file.
  • Extract the content of the zip file into the GetSimple 'plugins' directory.

Syntax and options

Arguments are separated by &. Following arguments are supported

General arguments

  • displayCaption : true / false - display or not the image title (optional)
  • displayDescription : true / false - display or not the image description (optional)
  • thumbnailHeight : integer or auto - Height in pixels of the thumbnails (optional)
  • thumbnailWidth : integer or auto - Width in pixels of the thumbnails (optional)
  • theme : name of the theme clean default (optional)
  • thumbnailHoverEffect : Possible values: slideUp, slideDown, slideLeft, slideRight, imageSlideUp, imageSlideDown, imageSlideLeft, imageSlideRight, labelAppear, labelAppear75, labelSlideDown, labelSlideUp, labelOpacity50, imageOpacity50, borderLighter, borderDarker, imageInvisible, descriptionSlideUp, imageScale150, imageScale150Outside, scale120, overScale, overScaleOutside, scaleLabelOverImage, rotateCornerBR, rotateCornerBL, imageRotateCornerBR, imageRotateCornerBL, imageFlipHorizontal, imageFlipVertical, labelSplitVert, labelSplit4, labelAppearSplitVert, labelAppearSplit4, imageSplitVert, imageSplit4

Picasa/Google+ specific arguments

  • userID : user ID of the Picasa/Google+ account (mandatory)
  • kind : picasa - set the storage type (mandatory)
  • album : album ID - to display only the specified album
  • displayBreadcrumb : true / false - display or not the navigation breadcrumb
  • blackList : list of keywords to ignore - album containing one the keyword in the title will be ignored. Keywords separator is |. (optional)
  • whiteList : List of keywords to authorize - albums must contain one of the keywords to be displayed. Keywords separator is |. (optional)

Flickr specific arguments

  • userID : user ID of the Flickr account (mandatory)
  • kind : flickr - set the storage type (mandatory)
  • photoset : photoset ID - to display only the specified photoset
  • displayBreadcrumb : true / false - display or not the navigation breadcrumb
  • blackList : list of keywords to ignore - photoset containing one the keyword in the title will be ignored. Keywords separator is |. (optional)
  • whiteList : List of keywords to authorize - photoset must contain one of the keywords to be displayed. Keywords separator is |. (optional)

To retrieve your Flickr user ID, use this page:

http://www.flickr.com/services/api/explore/flickr.people.findByUsername

Picasa/Google+ example:

Display albums from the user cbrisbois@gmail.com. Thumbnail size : 300x200 pixels.

(%nanogallery userID=cbrisbois@gmail.com&thumbnailWidth=300&thumbnailHeight=200%)

Display albums from the user cbrisbois@gmail.com. Thumbnail size : 300x200 pixels. Ignore album containing 'scrapbook' or 'profil' in the title.

(%nanogallery userID=cbrisbois@gmail.com&thumbnailWidth=300&thumbnailHeight=200&blackList=scrapbook|profil%)

Flickr example:

Display albums from the user Kris_B (34858669@N00). Thumbnail size : 300x200 pixels.

(%nanogallery kind=flickr&userID=34858669@N00&thumbnailWidth=300&thumbnailHeight=200%)

Display albums from the user 34858669@N00. Thumbnail size : 300x200 pixels. Ignore album containing 'scrapbook' or 'profil' in the title.

(%nanogallery kind=flickr&userID=34858669@N00&thumbnailWidth=300&thumbnailHeight=200&blackList=scrapbook|profil%)

Debug mode

To enable the debug mode:

  • go to the GetSimple plugin directory
  • rename the file nanogallery3_debug.off to nanogallery3_debug.on

To disable the debug mode:

  • go to the GetSimple plugin directory
  • rename the file nanogallery3_debug.on to nanogallery3_debug.off

Requirements

  • GetSimple CMS version 3.1 or superior
  • Javascript must be enabled

Third party tools

  • jQuery
  • fancybox2, credits: Janis Skarnelis