Documentation

Adding / editing gallery

Enter edit mode, find "Grand Gallery" block in list on the left and add it to area of your choice.

Gallery types

Gallery based on Files

  • Adding image to gallery will not directly interfere with File Sets or Folders
  • You can add single image from File Manager or whole File Sets/Folders
  • When deleting image, you have option to:
    • Remove it from current gallery only
    • Remove it from current gallery + completely remove from CMS

Gallery based on File Set

  • You can create/edit/delete File Sets within block (any changes will be present in your CMS)
  • Changing order of images will change order in File Set (after saving block)
  • Adding image to gallery will immediately assign it to currently selected File Set (before saving block)
  • When deleting image, you have option to:
    • Remove it from selected File Set only
    • Remove it from selected File Set + completely remove from CMS

Gallery based on Folder

  • You can create/edit/delete Folders within block (any changes will be present in your CMS)
  • Adding image to gallery will immediately move it to currently selected Folder (before saving block)
  • When deleting image, you have option to:
    • Completely remove it from CMS

Gallery based on Page List

  • You need to type the name of Parent Page. Displayed images are being taken from page attribute "Thumbnail". 
  • To change thumbnail: go to Sitemap, left-click Page under your Parent Page, select "Attributes" from menu and choose Thumbnail. 
  • Pages should have unique images selected in "Thumbnail" attribute (you can not use the same image for two different pages).
  • Links to pages/external links will be forced in all cases

Add / order images

You can change order of images by grabbing and moving thumbnails within area.

Edit images

Do you want to display Titles and Descriptions? – available options:

  • No
  • Yes, get values directly from File Attributes
  • Yes, get values from current Page
  • Yes, set the same values for all Images
  • Yes, set different values for every Image

Selecting last option will give you greatest possibilities to modify images, titles, descriptions and order of images.

Texts

You can change title and description of gallery here.

Settings

Recommended way is to change global settings in dashboard page, because you will not have to edit multiple galleries, if you want to change one element. Albeit, if you are in need of changing some options for particular gallery, feel free to do it here.

See Dashboard Block Settings for more information.


Templates

While in edit mode, click Grand Gallery block, select "Design & Custom Template", click cog icon, select custom template and click "Save" button.

Default template (grid)

  • Tags don't work in this template, choose masonry instead (choose masonry template, set "Thumbnail width", "Thumbnail height", "Thumbnail crop" and "Masonry random heights" to 100% to mimic default template)

Circles

In order to have perfect circle-shaped images, you need to:

  • Set identical thumbnail width and height (for example: width 500px and height 500px)
  • Check crop

Masonry

  • Recommended template to use 

Masonry cards

  • Appearance of cards can be changed in Settings tab

Dashboard settings (Grand Gallery)

Click "Dashboard" button and find "Grand Gallery" link in panel on the right.

Settings

Available options:

  • Change default Gallery Type when adding new block
  • Restrict File Set selection to those starting with typed word (for example: you can restrict File Sets to those starting with "Gallery - ")
  • Restrict Folder selection to those located under selected folder (for example: you can restrict Folders to those located under "Galleries" folder)
  • Change lightbox options (currently PhotoSwipe and Magnific Popup available), you can have only one of them enabled for all galleries on your site
  • You can also change color, size, padding etc. of most elements here

Block settings

These are global settings for all galleries, which you can override in every single block if necessary.

Dimensions

  • Image generation method
    • Use image helper
      • Leave empty fields to use original images as thumbnails (no cropping and resizing).
      • You can also provide: only width, only height or both width and height.
      • Cropping images will, in practice, make all images the same size.
    • Use concrete5 thumbnail system
      • Thumbnail types can be created/modified in "/dashboard/system/files/thumbnails".
        It is best to create/modify thumbnail types before uploading images (because you will need to rescan files otherwise).
        To rescan image go to "File Manager", right click on selected image, select "Properties" and click "Rescan" button.
    • Masonry random heights requires masonry template, thumbnail width, height and crop selected in your global/block settings to work. 
  • You also need to specify number of columns depending on screen size.
  • You can turn on/off Lazy loading here
  • Available reveal methods:
    • Show all images as one, non-divided gallery (works in all templates)
    • Divide gallery into parts and reveal them using JavaScript (works in all templates except default)
    • Divide gallery into pages (works in all templates, but tags will be disabled)

Thumbnails

Go to demo page to check all available effects.

Thumbnails - Hover

Go to demo page to check all available effects.

Masonry cards

You can change appearance of masonry_cards template here (colors, size, paddings etc,).

Reset Global Settings

Here you can reset global settings to default values.