1 - Start with Grid Gallery:

Whale Grid Gallery comes with a dashboard gallery generator that makes it extremely easy to use for site admins. You can create your gallery at the dashboard, save that and then use it as a ready-to-go gallery on every page you want. These are steps to use this add-on:

1- After installing the add-on you can see a "Grid Gallery" link in the "Files" box of your dashboard.
2- Click on the link, and you will see a list of galleries has already made, so users can check and use them as starting points.
3- Go to the page you intend to add your gallery, select "Grid Gallery" block, select a prebuilt gallery and you are done.


2 - Setup a gallery with filter:

Whale Grid Gallery uses core image tag property for categorizing images. These are steps to add filter buttons to your gallery:

1- At File Manage right click on the image and select properties, you can insert tags. You can insert multiple tags by separating them with a comma.
2- Now at Grid Gallery: Filters tab you can see a list of all tags available. Select those you want to appear as filter button and save gallery.


3 - Create a blog/page-list gallery

Whale Grid Gallery uses stacks to create a blog/page list gallery:

1- At Dashboard>Stacks & Blocks>Stacks create a new stack that contains a Page List Block
2- At Dashboard>Files>Whale Grid Gallery add a new gallery
3- Set "Gallery Source" to "Pages" and from the list, select your recently created stack. Now you should see an overview of all pages at that stack. If you want to set an image for each page, use  "thumbnail" Page Attribute.


4 - Use your own attribute instead of core "tags" attribute for filtering

1- Create a new file attribute e.g. "gallery_tags" (Textarea, Plain Text & separate tags with Enter or Comma)

2- Copy \packages\whale_grid_gallery\config\whale_grid_gallery.php to \application\config\whale_grid_gallery.php

3- Add newly created attribute handle to 'tags_attribute' config