=== Responsive Portfolio Image Gallery - Portfolio Gallery ===
Contributors: realwebcare
Requires at least: 5.2
Tested up to: 6.8
Tags: responsive image gallery, grid portfolio, photo album, portfolio, responsive gallery
Stable Tag: 1.3
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

A powerful and lightweight WordPress plugin for creating responsive, filterable image or portfolio galleries using `[shortcode]`.

== Description ==

[FREE VERSION DEMO](https://www.realwebcare.com/demo/responsive-portfolio-image-gallery-free/) | [PRO VERSION DEMO](https://www.realwebcare.com/demo/plugins/?product_id=responsive-portfolio-gallery) | [EXPLORE PRO](https://www.realwebcare.com/item/responsive-portfolio-image-gallery-pro/) | [CONTACT US](https://www.realwebcare.com/billing/submitticket.php?step=2&deptid=6)

**Responsive Portfolio Image Gallery** is a lightweight yet powerful plugin designed to help you display your portfolios in a modern, organized, and responsive layout. Whether you're a photographer, designer, or creative professional, this plugin allows you to build beautiful grid-style portfolio galleries with a filterable interface using WordPress posts and `[shortcode]`.

Each portfolio item uses the featured image for its thumbnail, which opens up a stunning preview area displaying a larger version, along with optional titles, descriptions, buttons, and a related carousel.

Customize the look and feel using the built-in settings panel - choose hover effects, filter animations, the number of posts to show, and much more.

Use simple `[shortcode]` to place your gallery anywhere on your website.

== Important Notes ==
* A featured image must be set for each portfolio item.

<blockquote>
<h4>Unlock more advanced features by upgrading to the Pro version:</h4>
<ul>
<li>Create unlimited galleries with unique styles</li>
<li>Add unlimited buttons in preview area</li>
<li>Duplicate any Portfolio rather than resetting a new one.</li>
<li>Backup and import/export settings</li>
<li>More attractive hover and filter animations</li>
<li>Google Fonts support</li>
<li>YouTube and Vimeo video support</li>
<li>Assign multiple categories per portfolio</li>
<li>Admin preview of each gallery</li>
</ul>
<p><a href="https://www.realwebcare.com/item/responsive-portfolio-image-gallery-pro/">Explore Pro Features</a></p>
</blockquote>

== Pro Version Video DEMO ==
https://youtu.be/4B1bbiBdtJg

== Key Features ==

* Responsive for all devices
* Lightweight and fast-loading
* Built with custom post types and taxonomies
* Two built-in themes: `Light` and `Dark`
* Set the number of items and description length
* Sort portfolios by `date`, `name`, or `ID`
* Customize thumbnail `width` and `height`
* Choose from several hover and filter effects
* Display carousel of related images
* Hide/show description and carousel
* Portfolio description can be hidden
* Height of the expanding preview and carousel wrapper is adjustable
* Enable custom CSS
* Shortcode-based implementation
* Fully compatible with all modern browsers

== Custom Post Type &amp; Taxonomy ==
Portfolios are managed as a dedicated custom post type with their own taxonomy. This structure ensures easy organization and separation from other content types.

== Two color schemes in style ==
There are two color variations for the portfolio gallery plugin, dark and light. You can switch between them and load one up which is suitable for your website.

== Hover &amp; Filter Effects ==
Add visual appeal with a wide variety of CSS-based hover and filter animations. Let users easily navigate your gallery by filtering items based on categories.

== Expanding Preview Panel ==
When a thumbnail is clicked, a clean, expandable preview opens with more details including a large image, title, description, buttons, and related carousel.

== Custom CSS Support ==
Add your own styles directly from the plugin settings panel. Your rules will override the default styles without needing to modify plugin files.

== Frequently Asked Questions ==

= How do I create a portfolio gallery? =
Create portfolio items under the Portfolio post type by assigning them to appropriate categories and setting featured images. After that, go to the `Generate Portfolio` section from the admin menu. There, you can create a new gallery by including the categories you want to display. Once generated, use the `[shortcode]` from the right sidebar on any post or page to showcase your gallery.

= How do I display the gallery on a page? =
Use the `[shortcode]` provided by the plugin. Example: `[rpgal-gallery]`. The free version supports one gallery per page.

= Can I add multiple categories to a portfolio item? =
In the free version, each portfolio can be assigned to only **one category**. For multiple categories per portfolio, please upgrade to the Pro version.

= Do I need to set featured images for portfolio items? =
Yes. The featured image is used to generate the thumbnail for each portfolio item. Without a featured image, it won’t appear in the gallery.

= How do I customize the hover and filter effects? =
Go to the `Generate Portfolio >> Advance Settings` page. You’ll find options for selecting different hover effects, filter styles, direction, and animation types.

= Is it possible to hide the portfolio description or carousel? =
Yes. You can hide both the description and the carousel from the settings panel in the admin area.

= Can I add custom CSS to style my gallery? =
Absolutely. There’s a Custom CSS box in the settings where you can add your own styles. Your CSS will override the default plugin styles.

= Why aren’t my galleries showing after updating? =
Please make sure to include the portfolio categories (instead of excluding them, as in earlier versions). This change was introduced in version 1.1.

= How do I add buttons in the preview section? =
In the free version, each portfolio supports a default button with text and link. In the Pro version, you can add unlimited buttons with custom labels, links, and open in new tab options.

= Is this plugin compatible with the latest WordPress version? =
Yes. The plugin is regularly tested and updated to maintain full compatibility with the latest versions of WordPress.

== Migration Notes for Version 1.3 ==

**Version 1.3** is a major update with internal changes that may affect users upgrading from older versions. We've made structural improvements for better performance and flexibility, which means certain elements have been renamed or migrated.

**Don't worry - most changes are applied automatically through the version checker method.**

However, please visit `Portfolio → Guide` in your WordPress dashboard for detailed upgrade instructions.

=== What You Should Do ===

- ✅ **Shortcodes**: Go to the pages/posts where you added `[rcpig-gallery]` and replace them with `[rpgal-gallery]`.
- ✅ **Post Type Visibility**: If your portfolios are missing, go to your dashboard > Portfolios, and ensure items are listed under the new `rpgal` post type.
- ✅ **Check Gallery Settings**: Visit the `Generate Portfolio` section to confirm your included categories are set correctly.
- ✅ **Custom Button Data**: If you previously used buttons in your preview, confirm that they appear as expected. If not, re-enter them using the new fields.

We’ve tried to make this transition as seamless as possible. However, if you notice anything missing or broken, re-saving your portfolio settings or re-adding buttons under the new structure usually resolves the issue. If you need help, you can contact us at anytime.

== Upgrade Notice ==

= 1.3 =
This is a major update with a fully redesigned admin UI, enhanced security, bug fixes, and improved compatibility. A new "Plain Text" preview mode is added, and older plugin options and post meta are migrated automatically. Please back up your site before upgrading.

== Changelog ==

= 1.3 (10th July 2025) =
* 13th major release.
* `NEW:` Option to display preview content as plain text or styled HTML.
* `ENHANCED:` Entire admin interface redesigned with a cleaner, modern look.
* `ENHANCED:` Improved codebase security and compliance with WP standards.
* `IMPROVED:` Carousel logic now skips empty image sets—no blank sliders.
* `FIXED:` Resolved all known JS and CSS conflicts.
* `COMPATIBILITY:` Verified and compatible with the latest WordPress version.
* `REFACTORED:` Complete migration to OOP for better structure.
* `NEW:` Help page added with plugin usage documentation.

= 1.2 (30th April 2022) =
* 12th release.
* Include Categories bug fixed.
* Category filtering bug fixed.

= 1.1 (26th February 2022) =
* 11th release.
* Fixed few bugs to make the plugin more useful.

= 1.0.9 (12th August 2020) =
* 10th release.
* Fixed a jQuery issue to make compatible with WP 5.5

= 1.0.8 (7 May, 2020) = 
* 9th release.
* Fixed some bugs.

= 1.0.7 (22 June, 2019) = 
* 8th release.
* Upgraded jQuery a little more to overcome few issues.

= 1.0.6 (27 November, 2016) = 
* 7th release.
* Fixed the bug of version 1.0.5

= 1.0.5 (14 November, 2016) = 
* 6th release.
* Fixed some bugs regarding displaying the gallery.

= 1.0.4 (2 September, 2016) = 
* 5th release.
* Added one more effects both for thumbnail filter and hover.

= 1.0.3 (27th August, 2016) = 
* 4th release.
* Included 2 color schemes to choose for portfolio galleries.
* Added option to hide portfolio description.
* Added option to hide carousel images.
* Carousel image wrapper has benn adjusted automatically.

= 1.0.2 (24th August, 2016) = 
* 3rd release.
* Post order and order by option added.

= 1.0.1 (19th August, 2016) = 
* 2nd release.
* Compatible with WordPress 4.6

= 1.0 (9th August, 2016) = 
* 1st release.

== Credits ==

* [Classie – class helper functions](https://github.com/ded/bonzo) by bonzo
* [Direction Aware Hover Effect](http://tympanus.net/codrops/2012/04/09/direction-aware-hover-effect-with-css3-and-jquery/) by Codrops
* [Thumbnail Grid with Expanding Preview](http://tympanus.net/codrops/2013/03/19/thumbnail-grid-with-expanding-preview/) by Codrops
* [Elastislide](http://tympanus.net/codrops/2011/09/12/elastislide-responsive-carousel/) by Codrops
* Presented By: [Realwebcare](https://www.realwebcare.com/)
* [Facebook Page](https://www.facebook.com/realwebcare)


== Installation ==

Responsive Portfolio Image Gallery 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 responsive-portfolio-image-gallery.zip file. Click "Install Now."
4. Once installed, activate the plugin.
5. Create your portfolio items and use the `[shortcode]` on any post/page.

**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 "Responsive Portfolio Image Gallery Realwebcare".
4. Locate the plugin in the search results and click the "Install Now" button.
5. After installation, activate the plugin.
6. Create your portfolio items and use the `[shortcode]` on any post/page.

== Screenshots ==

1. Responsive Portfolio Image Gallery Settings.
2. Responsive Portfolio Image Gallery Thumbnail View.
3. Responsive Portfolio Image Gallery Expanded Preview.
4. Expanded preview with Light Color Scheme.