=== Grid Gallery - for Photo Gallery, Image Gallery & Portfolio ===
Contributors: aWordPresslife, razipathhan, hanif0991, muhammadshahid, fkfaisalkhan007, sharikkhan007, zishlife, FARAZFRANK
Donate link: https://paypal.me/awplife
Tags: gallery, image gallery, photo gallery, responsive gallery, portfolio
Requires at least: 5.0
Tested up to: 7.0
Stable tag: 2.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Create a beautiful Photo Gallery, Image Gallery, or Portfolio on your website. Use simple shortcodes to show your images.

== Description ==

Do you want to show your images in a clean grid? This plugin helps you create a stunning Photo Gallery, Image Gallery, or design Portfolio. It is fully integrated with a native **Gutenberg Block** and a dedicated **Elementor Widget**, allowing you to insert and customize your grids directly within your preferred editor without copying and pasting shortcodes.

Showcase your photographs, design projects, and business assets with high-performance grids. Traditional galleries use pop-ups that hurt user experience. Grid Gallery expands clicked images inside the page layout itself. This keeps your visitors focused, engaged, and reading your content longer.

It works great for:
* Photographers who want to show their best shots in a beautiful Photo Gallery.
* Artists displaying their creative designs in a professional Portfolio.
* Business owners showing their latest products in a clean Image Gallery.
* Bloggers sharing their favorite travel stories.

**View Pro Demo:** **[Grid Gallery Premium](https://awplife.com/demo/grid-gallery-premium/)**
**More About Pro:** **[Grid Gallery Premium Features](https://awplife.com/wordpress-plugins/grid-gallery-wordpress-plugin/)**
**Where To Buy:** **[Buy Grid Gallery Premium](https://awplife.com/account/signup/grid-gallery-premium)**

https://www.youtube.com/watch?v=GusIaoInRJQ

= Why Choose Grid Gallery? =

* **Seamless Inline Previews:** Users browse full-sized images directly within the grid structure without launching separate windows.
* **Gutenberg & Elementor Ready:** Select and insert your galleries using our native Gutenberg Block or dedicated Elementor Widget inside your preferred editor layouts.
* **SEO-Optimized Image Loading:** Built to load assets quickly, which boosts search engine rankings and keeps users happy.
* **Touch-Enabled Mobile Sliders:** Mobile visitors swipe through your gallery easily with fluid, finger-friendly touch navigation gestures.
* **Clean HTML5 Architecture:** Coded strictly with semantic standards to match any premium or custom WordPress theme effortlessly.

= Build Your Photo Gallery, Image Gallery, or Portfolio =

* Organize your photos into unlimited customized collections for different pages.
* Upload multiple images simultaneously using the built-in WordPress media library interface.
* Copy and paste simple shortcodes, or use the native Gutenberg Block and Elementor Widget to display grids on pages, posts, or widgets.
* Customize grid columns, animation speeds, hover styles, and thumbnail borders.

= Free Features =

* **Grid Columns & Layout:** Customize columns (up to 6 columns) to fit any screen resolution.
* **Image Source Quality:** Select WordPress media resolutions (Thumbnail, Medium, Large, or Full Size) to optimize loading speed.
* **Grid Crop Shape (Aspect Ratio):** Choose 1:1 Square or 4:3 Classic grid cropping.
* **Spacing & Frames:** Toggle item spacing (gaps) and padded frame containers for thumbnails.
* **Hover Animation Styles:** Select between 5 unique hover transitions (Grow, Shrink, Float Shadow, Shadow Radial, Box Shadow Outset).
* **Gallery Loading Spinner:** Customize spinner styles (Spinner, Pulse, Dots, or disabled) and apply custom loading brand colors.
* **Thumbnail Sort Order:** Display images chronologically (Oldest First, Newest First) or in Randomized order.
* **Text Overlay & Detail Panel:** Show titles on thumbnails, display titles in the active preview drawer with customizable font size (range slider) and custom title color.
* **EXIF Camera Data:** Automatically extract and show camera metadata (ISO, Shutter speed, Aperture, and Lens) inside the expanded detail drawer.
* **Expanded Navigation Drawer:** Custom open/close transition speed (0ms to 20000ms) and select from 26 transition easing curve equations.
* **Clickable Link Actions:** Configure "Read More" hyperlinks and link opening behavior (New Tab vs Same Tab).
* **Gutenberg Block Integration:** Seamlessly select and insert grid galleries using the native editor block.
* **Elementor Widget Support:** Easily drag and drop grid galleries inside the Elementor page builder.


= Pro Features =

Unlock the full potential of your galleries with our premium version:

* **Global Settings Dashboard:** Configure lazy loading, shimmering skeleton screens, global custom CSS sandbox editing, and bulk import/export panel options globally across all galleries.
* **Inline Video Embedding:** Embed YouTube, Vimeo, and local MP4 videos inside the preview panel with platform-branded hover play buttons.
* **Device Responsive Columns:** Define separate grid column distributions for Desktop, Tablet, and Mobile viewports for perfect responsiveness.
* **Custom CSS Sandbox:** Inject custom CSS codes directly in settings to overwrite layouts without losing edits on plugin updates.
* **Skeleton Shimmer Loads:** Display high-fidelity shimmering skeleton loader frames on thumbnail grid layout blocks during initialization.
* **Load More AJAX Pagination:** Split image load lists into pages with a customizable, animated AJAX Load More button.
* **Bulk JSON Import & Export:** Migrate layouts effortlessly. Export configurations as JSON files and import them to restore settings on any other site.
* **One-Click Gallery Duplicator:** Instantly duplicate any gallery layout, configuration settings, and enqueued image lists from the dashboard.
* **6 Premium Aspect Crop Ratios:** Unlock 6 crop shapes (1:1 Square, 4:3 Classic, 16:9 Widescreen, 3:2 Photo, 2:3 Portrait, and 3:4 Portrait).
* **20+ Creative Hover Animations:** Advanced 2D, shadow, grow, shrink, and glow transitions.
* **Frosted Glassmorphism Overlay:** Enable modern frosted glass design on detail panels/overlays with custom color filters.
* **Transient Performance Caching:** Auto-caches HTML layouts inside database transients to guarantee lightning-fast rendering.

**More Pro Demo Examples**

* [Customize Border Settings](https://awplife.com/demo/grid-gallery-premium/customize-border-settings/)
* [Image Hover Effects](https://awplife.com/demo/grid-gallery-premium/image-hover-effects/)
* [Gallery Spacing Settings](http://awplife.com/demo/grid-gallery-premium/spacing-settings/)
* [Title And Description On Thumbnails](https://awplife.com/demo/grid-gallery-premium/title-and-description-on-thumbnails/)
* [Multiple Column Layout](https://awplife.com/demo/grid-gallery-premium/column-layout/)

== Installation ==

1. Go to your WordPress admin panel.
2. Search for "New Grid Gallery" in the plugins screen.
3. Install and activate the plugin.
4. Go to the new "Grid Gallery" menu.
5. Click "Add New" and upload your photos.
6. Copy the shortcode and paste it on any page.

== Frequently Asked Questions ==

= How do I create a new Photo Gallery, Image Gallery, or Portfolio? =

Navigate to the "Grid Gallery" menu in your WordPress dashboard and click "Add New." Upload your images using the uploader, choose your desired columns and animation speeds in the settings panel below, and click Publish. You can display the gallery by copying and pasting the generated shortcode, or by selecting the gallery directly using the Gutenberg block or Elementor widget.

= Can I use this for a design Portfolio? =

Yes. The grid structure and clean hover animations make it an excellent choice for a professional portfolio. You can showcase illustrations, web design screenshots, or photography portfolios in elegant grids that highlight your work beautifully.

= Does this Image Gallery work on mobile phones? =

Absolutely. The plugin is designed with a fully responsive fluid grid. It uses CSS3 hardware acceleration to ensure smooth transitions and supports natural swipe gestures for a perfect mobile viewing experience.

= Can I add titles to my photos? =

Yes. You can add unique titles and descriptions to each uploaded image. You have full control to display or hide titles on the thumbnail grid or show them during the active preview expansion.

= Does it work with page builders? =

Yes, it is fully compatible with major page builders and editors. It includes a native **Gutenberg Block** for the default block editor and a dedicated **Elementor Widget** for the Elementor page builder. For other builders like Divi or Beaver Builder, you can simply paste the gallery shortcode into any text, code, or HTML block.

= Can I link photos to other pages? =

This feature is available in the Pro version. You can add custom links to any photo in your image gallery to direct users to specific landing pages.

= Where do I get support? =

You can ask questions on our support forum. We are happy to help you.

== Screenshots ==

1. Add Image Panel
2. Thumbnail Layout Options
3. Text And Overlay Options
4. Full Image Drawer Options
5. Gallery Frontend Without Spacing and Frame
6. Gallery Frontend Without Spacing and Frame, Image Drawer
7. Gallery Frontend With Spacing and Frame
8. Gallery Frontend With Spacing and Frame, Image Drawer

== Changelog ==

= 2.0.1 =
* Date: 17 June 2026
* Updated gallery navigation SVG icons for better visibility.
* Fixed incorrect 'Premium' branding in Elementor and Gutenberg widgets.

= 2.0.0 =
* Date: 17 June 2026
* Reorganized and restructured into a **New Settings Panel Layout**, relocating key configurations (Loading Icon and Thumbnail Spacing) for a cleaner workflow.
* Added native **Gutenberg Block** support to easily select and insert grid galleries directly in the default block editor.
* Added a dedicated **Elementor Widget** integration to drag and drop grid galleries inside the Elementor page builder.
* Added a one-click **Shortcode Copying Helper** in the admin gallery post listing table columns for easier copy-pasting.
* Completely removed the old **Bootstrap framework architecture** (`bootstrap.css`, `gg-bootstrap.css`, and `bootstrap.min.js`) to prevent layout conflicts and eliminate script bloat.
* Re-coded and **optimized CSS and JS files for fast loading**, significantly reducing asset size and improving page rendering speeds.

= 1.5.5 =
* 2026-6-05
* Added "Our Plugins" and "Our Themes" pages to admin dashboard submenus.
* Enqueued shared CSS asset dynamically specifically on these submenu pages.
* Hardened administrative transient refresh action with secure WordPress nonces.
* Upgraded documentation page and settings panel with beautiful, modern responsive styles.

= 1.5.4 =
* Tested with WordPress 6.9

= 1.5.3 =
* Tested with WordPress 6.8.3

= 1.5.2 =
* Fixed text domain errors.
* Tested with WordPress 6.8.2

= 1.5.1 =
* Bug fixes
* Tested with WordPress 6.8.1

= 1.5.0 =
* Bug fixes
* Tested with WordPress 6.7.2

== Upgrade Notice ==

= 2.0.1 =
Minor UI tweaks and branding fixes. Recommended update.

= 2.0.0 =
Upgrading from v1.5.5 introduces a brand new settings panel layout, major builder integrations (Gutenberg Block, Elementor Widget, and Shortcode Copying Helper), and a completely optimized assets architecture. The old bulky Bootstrap framework files have been removed in favor of clean custom styling, improving loading speed and performance. Update recommended.

= 1.5.5 =
Added support for "Our Plugins" and "Our Themes" submenu pages with secure cache refresh and modern responsive designs. Update recommended for all users.

= 1.5.4 =
Tested and compatible with WordPress 6.9. Update recommended for all users.