Home

Simple Gallery for GetSimple CMS CE

Simple Gallery is a lightweight, zero-dependency PHP plugin designed for GetSimple CMS CE. It allows you to quickly create responsive, highly configurable image galleries from subfolders inside your GetSimple uploads/ directory.

Includes a smooth, built-in animated lightbox with swipe support, full-screen mode, and multi-gallery keyboard navigation.

---

Features

• 5 Distinct Grid Layouts: Easily customizable layout options to best fit your media assets.
• Built-in Lightbox: Lightweight modal lightbox with zoom animation, swipe gestures for mobile, keyboard arrow navigation, and fullscreen mode.
• Responsive & Mobile-Friendly: Adapts dynamically across mobile, tablet, and desktop viewports.
• Simple Usage: Embed galleries via shortcodes inside page content or call via PHP functions in theme files.

---

Available Layout Options

You can select your preferred layout directly from the Simple Gallery admin panel under Files > Simple Gallery.

1. Square Grid (square)
   Uniform square thumbnails arranged in a clean, modern grid using CSS Grid and object-fit: cover. Ideal for consistent image displays.

2. Masonry Grid (masonry)
   A fluid, Pinterest-style column layout that preserves every image's natural aspect ratio without cropping.

3. Justified Grid (justified)
   Flexbox-driven row layout where images scale dynamically to keep straight, flush bottoms across rows.

4. Column Grid (columns)
   A smart multi-column partitioning layout that balances images unevenly to achieve perfectly aligned column bottoms without cropping.

5. Metro / Windows Grid (metro)
   A dynamic, tile-based layout inspired by Windows Metro design. Automatically patterns images into mixed tile sizes (2x2, 2x1, 1x2, 1x1).

---

Installation

1. Copy simple_gallery.php into your GetSimple CMS installation directory under plugins/.
2. Ensure your images are uploaded inside subdirectories under data/uploads/ (e.g., data/uploads/gallery1/, data/uploads/portfolio/).
3. Log in to your GetSimple Admin Panel and navigate to Files > Simple Gallery to configure global settings.

---

Usage

Shortcode (Inside Page Content)

To embed a gallery directly into a page inside the GetSimple page editor, use the shortcode format:

(% simple_gallery 'folder_name' %)

Replace 'folder_name' with the name of the folder inside data/uploads/ (e.g., (% simple_gallery 'gallery1' %)).

PHP Template Function

To display a gallery directly within a theme file (e.g., template.php), use the following PHP function:

<?php 
if (function_exists('render_simple_gallery')) {
    render_simple_gallery('folder_name');
}
?>

---

Admin Configuration Settings

From the GetSimple administration dashboard, go to Files > Simple Gallery to manage global default settings:

Setting	Default	Description
Grid size / Min Width	180	Minimum column/item size in pixels. Controls tile sizing across layouts.
Image Gap	10	Spacing/margin between images in pixels.
Border Radius	4	Corner rounding for gallery thumbnails in pixels.
Gallery Layout	square	Choose between Square, Masonry, Justified, Column, or Metro grids.

---

Supported Formats

• Supported Image Formats: .jpg, .jpeg, .png, .gif, .webp