=== Awesome Responsive Photo Gallery – Image & Video Lightbox Gallery ===
Contributors: realwebcare
Tags: image gallery, responsive gallery, gallery, photo gallery, lightbox gallery
Requires at least: 5.4
Tested up to: 6.7
Stable tag: 1.2.1
Requires PHP: 7.4
Donate link: https://www.realwebcare.com/billing/store/support/donation
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html


Upgrade WordPress gallery shortcode to a modern, responsive, touch-friendly lightbox gallery with 3 stunning lightbox styles.

=== Description ===

**Awesome Responsive Photo Gallery** is a powerful lightbox plugin integrated with WordPress default image gallery. It now comes with a modern admin interface, enhanced security features, and dynamic Gallery ID functionality for both the Classic Editor and Block Editor.

The plugin supports three responsive lightbox scripts, allowing you to create stunning galleries with ease. With newly added features and improvements, managing your galleries has never been simpler.

[DEMO](https://www.realwebcare.com/demo/awesome-responsive-photo-gallery-free/) | [SETUP GUIDE](https://www.realwebcare.com/plugin/awesome-gallery/) | [CONTACT US](https://www.realwebcare.com/billing/submitticket.php?step=2&deptid=6)

= Watch Video Walkthrough =
https://youtu.be/BjVt24T7nEs

### Why Use This Plugin?
WordPress has a built-in gallery feature, but it is quite basic. It doesn't include a lightbox option, which means when users click on an image, it opens in a new page instead of a popup. This can make browsing your images less user-friendly and slower.

Our plugin improves the default WordPress gallery by turning it into a modern, interactive lightbox gallery. Once installed, every gallery you create will have a smooth, professional look. Visitors can click on any image to view it in a popup with navigation options, making your gallery more attractive and easier to use.

### How Does It Help You?
1. **Automatic Upgrade:** After installing the plugin, it replaces the default gallery with the upgraded lightbox version. No extra setup needed.
2. **Better User Experience:** Visitors can quickly browse through images in a popup without leaving the page.
3. **Professional Look:** Makes your gallery feel premium and enhances your site's design.

This plugin works automatically, saving you time and effort while giving your gallery a polished, modern appearance.

### New Features in v1.2:
* Fully Object-Oriented Programming (OOP) implementation.
* Enhanced security with proper sanitization, validation, escaping, and nonce verification.
* Modernized admin interface with modal-based functionality and clear progress messages.
* Organized internal CSS into a separate custom CSS file.
* Unique plugin option name to avoid conflicts with other plugins.
* Dynamic Gallery ID insertion for Classic Editor and Block Editor.
* New help page providing a feature overview and usage guide.
* Fixed minor JavaScript and CSS issues for better performance.


=== Key Features ===

* Fully responsive, touch-friendly design.
* 3 responsive lightbox scripts: lightGallery, Lightcase, jGallery.
* Flourished admin UI with a modern look.
* Dynamic Gallery ID support for Classic and Block Editor.
* Organized CSS for improved maintainability.
* Support for YouTube, Vimeo, and HTML5 videos.
* Infinite looping, swipe navigation, and customizable transitions.
* Social sharing options: Twitter, Facebook, Pinterest, and more.
* Support for multiple galleries on the same page with unique IDs.

== Usage ==

1. After activating the plugin, navigate to **Awesome Gallery** in your WordPress admin panel.
2. Navigate to **Pages >> Add New** and click on **Add Media** to open the media uploader.
3. Click on **Create Gallery** and select **Upload Files** if you don’t have any images
4. Upload your photos and after completing upload click on **Create a New Gallery** button
5. In the right side enter image Title, Alt Text, Description and Video URL (if you want)
6. Click on **Insert Gallery** button
7. In the gallery shortcode insert your desired **Gallery ID** (depends on how you want to show your gallery), like [gallery **id="1"** ids="114,115,112,113,110"]
8. Publish your page and click **View Page** to see your awesome gallery 🙂.
9. To create another gallery, use an another unique ID. Example: [gallery id="1" ids="506,505,502,503"] or [gallery id="2" ids="506,505,502,503"]
10. Access the **Help Page** under the plugin menu for detailed instructions.


== Support ==

For any queries, feedback, or assistance, please visit our [Plugin Support Page](https://wordpress.org/support/plugin/awesome-responsive-photo-gallery/). We're here to help you make the most of the plugin.


== Installation ==

**Awesome Responsive Photo Gallery** plugin can be installed in two convenient ways: manually or directly from the WordPress plugin directory.

= Manual Installation: =
1. Log in to your WordPress admin dashboard.
2. Navigate to **Plugins** in the left menu and click **Add New**.
3. Click **Upload Plugin** and choose the **awesome-responsive-photo-gallery.1.2.zip** file. Click **Install Now**.
4. Once installed, activate the plugin to enable its features.

= Installation from WordPress Plugin Directory: =
1. Log in to your WordPress admin dashboard.
2. In the left menu, click **Plugins**, then select **Add New**.
3. In the search field, type **Awesome Responsive Photo Gallery Realwebcare** and press Enter.
4. Locate the plugin in the search results and click the **Install Now** button.
5. After installation, activate the plugin.


== Frequently Asked Questions ==

= How do I create a gallery with this plugin? =
Creating a gallery is simple:
1. Go to **Pages > Add New** or edit an existing page.
2. Click **Add Media** and select **Create Gallery**.
3. Upload images or select existing ones, then insert the gallery shortcode.
4. Use the plugin settings or assign a unique Gallery ID to customize your gallery.

= Does the plugin support videos? =
Yes, the plugin supports YouTube, Vimeo, and HTML5 videos. Simply add the video URL in the **Video URL** field under **Attachment details** while creating the gallery.

= Can I use multiple galleries on the same page? =
Absolutely! You can create unlimited galleries by assigning unique Gallery IDs for each gallery.

= What are the supported lightbox scripts? =
The plugin supports three responsive lightbox scripts:
1. **lightGallery**
2. **Lightcase**
3. **jGallery**

You can choose your preferred lightbox script from the plugin settings.

= Is the plugin compatible with the Block Editor (Gutenberg)? =
Yes, the plugin integrates seamlessly with both the Block Editor and Classic Editor. It allows you to dynamically insert Gallery IDs directly into your post or page.

= How do I customize the appearance of my gallery? =
You can customize the gallery by:
1. Choosing from five image sizes: Thumbnail, Medium, Large, Full Size, or Custom.
2. Adjusting thumbnail borders, shadows, and hover effects in the plugin settings.

= Is the plugin fully responsive? =
Yes, the plugin is designed to adapt to all screen sizes, making your galleries look great on any device.

= Does the plugin support social sharing? =
Yes, the lightbox includes social sharing options for platforms like Facebook, Twitter, and Pinterest.

= What security measures are implemented? =
The plugin is built with modern WordPress standards, including sanitization, validation, escaping, and nonce verification, ensuring secure operation.

= How can I get support? =
For support:
1. Check the dedicated Help page in the plugin menu for usage guides.
2. Visit our [website](https://www.realwebcare.com/) or [Facebook Page](https://www.facebook.com/realwebcare) for assistance.


=== Changelog ===

= 1.2.1 (7 March, 2025) =
* Fixed an issue where non-admin users were unable to load the WordPress admin panel due to plugin interference.

= 1.2 (12th January, 2025) =
* Major update with full OOP implementation.
* Enhanced security with sanitization, validation, escaping, and nonce verification.
* Modernized admin interface with modal-based messages.
* Introduced a dedicated help page for plugin features and usage.
* Improved Classic and Block Editor integration for dynamic Gallery ID.
* Fixed minor JavaScript and CSS issues.
* Updated option name for better uniqueness.
* Organized internal CSS into a custom CSS file.
* Replaced Google Plus share with LinkedIn share.

= 1.0.5 (19th May, 2018) =
* Fixed some bugs.
* Included Gallery ID button in post editor text mode.

= 1.0.4 (20th April, 2018) = 
* 5th release
* Included thumbnail title and caption with hover effect
* Added more gallery options

= 1.0.3 (14th April, 2018) = 
* 4th release
* Included 3 different gallery scripts
* Added more gallery options
* Unlimited gallery support by gallery ID

= 1.0.2 (6th April, 2018) = 
* 3rd release
* Thumbnail Border and Shadow Support

= 1.0.1 (1st April, 2018) = 
* 2nd release
* Youtube and Vimeo Support

= 1.0 (8th March, 2018) = 
* 1st release


== Upgrade Notice ==

= 1.2.1 =
Resolved an issue where non-admin users experienced interruptions while loading the WordPress admin panel. This update ensures that the admin panel loads correctly for all user roles without interference.

= 1.2 =  
This is a major update with a complete OOP overhaul. Enjoy a modernized admin interface, enhanced security, and dynamic Gallery ID support.

= 1.0.5 =  
Bug fixes and a new Gallery ID button in the post editor for easier shortcode insertion.

= 1.0.4 =  
Added thumbnail title/caption hover effects and more gallery customization options.

= 1.0.3 =  
Introduced three new responsive lightbox scripts and unlimited gallery support by ID.

= 1.0.2 =  
Thumbnail border and shadow customization now available.

= 1.0.1 =  
Added support for YouTube and Vimeo videos in galleries.

= 1.0 =  
Initial release with basic gallery functionality.


=== Credits ===

– [Lightcase](https://github.com/cbopp-art/lightcase/)
– [jGallery](https://github.com/jakubkowalczyk-pl/jgallery/)
– [lightGallery](https://github.com/sachinchoolur/lightGallery)
– Developed By: [Realwebcare](https://www.realwebcare.com/)
– [Facebook Page](https://www.facebook.com/realwebcare)


== Screenshots ==

1. Thumbnail View
2. Lightbox View for lightGallery
3. Lightbox View for Lightcase
4. Lightbox View for jGallery
5. Gallery Settings in Edit Gallery
6. Created Gallery Lists
7. Add Gallery ID Button
8. Gallery Settings

== License ==

This plugin is released under the GPLv2 license. You can find a copy of the license [here](https://www.gnu.org/licenses/gpl-2.0.html).