=== Ultimate Portfolio - Filterable Gallery and Slider for Image, Video and Blog Post ===
Contributors: webenvo, awordpresslife, FARAZFRANK, hanif0991, razipathhan, fkfaisalkhan007, zishlife, muhammadshahid, sharikkhan007
Tags: portfolio, image gallery, post slider, blog, slider
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.0
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build responsive portfolio galleries, filterable image galleries, blog post grids, and interactive post sliders inside Gutenberg.

== Description ==

Ultimate Portfolio is a complete WordPress portfolio and gallery solution built specifically for the Gutenberg block editor. Whether you need to showcase creative client work, publish a photography portfolio, display blog posts in a dynamic post grid, or build a touch-responsive post slider, this plugin provides all the tools directly within the native editor without requiring custom code.

Designed for freelancers, agencies, photographers, designers, and bloggers, Ultimate Portfolio gives you complete control over how your media and website content are presented to visitors.


Pro Live Demo - [Ultimate Portfolio Pro Live Demo](https://wpfrank.com/demo/ultimate-portfolio-pro/)

Buy Pro - [Ultimate Portfolio Pro →](https://wpfrank.com/wordpress-plugins/ultimate-portfolio-pro/)


= How It works - Tutorial Video =
https://www.youtube.com/watch?v=2tjaXgjJsA4

### Primary Portfolio and Gallery Features

* Native Gutenberg Block: Add portfolio galleries, post grids, and sliders directly into any page or post.
* Multiple Layout Types: Choose between clean Grid, Pinterest-style Masonry, Edge-to-edge Justified, or touch-friendly Slider layouts.
* Category Filtering: Allow visitors to instantly filter portfolio items and blog posts by category using interactive Isotope filter buttons.
* Real-Time Search and Sorting: Include a live search bar and sorting controls so users can sort items by title, date, or order.
* Lightbox Popup Integration: Enable full-screen lightbox view with zoom capabilities, slideshow mode, and image sharing.
* Dynamic Content Querying: Display custom image galleries, WordPress blog posts, custom post types, or WooCommerce products.
* Responsive Column Controls: Define custom column counts, image heights, border radiuses, and item gaps independently for desktop, tablet, and mobile screens.
* Flexible Pagination Options: Choose between standard numbered pagination, AJAX Load More buttons, or infinite scroll on page scroll.
* Performance Optimized Lazy Loading: Load images dynamically as visitors scroll down the page to ensure fast load times and optimal page speed scores.
* Shortcode Integration: Display saved portfolio layouts anywhere on your site using the [ultimate_portfolio id="123"] shortcode.

### Versatile Display Options for Every Project

* Photography Portfolio: Showcase high-resolution photos in masonry or justified image gallery layouts with full-screen lightbox previews.
* Creative Project Showcase: Highlight agency case studies and design projects with category filters and interactive hover overlays.
* Blog Post Grid and Post Slider: Turn standard WordPress blog posts into attractive post grids or responsive post sliders with post dates, author metadata, and excerpts.
* Product Showcase: Display WooCommerce products in filterable grid layouts with custom hover titles and direct page links.

### Free vs Pro Version Comparison

Free Version Highlights:
* Responsive Grid, Masonry, and Justified portfolio layouts.
* Single-level category filtering with customizable color schemes.
* Responsive column adjustments for mobile, tablet, and desktop views.
* Lightbox popup with full-size image viewing.
* Image drag-and-drop ordering in the editor.
* Lazy loading support for improved site speed.
* Custom CSS field for tailored styling.

Pro Version Extras:
* Advanced Carousel and Slider effect options.
* Multi-level taxonomy filtering for complex portfolios.
* Deep linking for filterable portfolio URLs.
* Social Media feed integrations including Instagram, YouTube, Vimeo, Flickr, and Unsplash.
* Custom load and hover animation effects.
* Priority email support.

For live demonstrations and plugin details:
* Pro Version Demo: https://wpfrank.com/demo/ultimate-portfolio-pro/
* Upgrade to Pro: https://wpfrank.com/wordpress-plugins/ultimate-portfolio-pro/

== Installation ==

1. Log into your WordPress admin dashboard and navigate to Plugins > Add New.
2. Search for "Ultimate Portfolio" in the search field.
3. Click Install Now and then Activate the plugin.
4. Open any page or post in the Gutenberg editor and insert the "Ultimate Portfolio" block.
5. Configure your layout, choose your content source (images or blog posts), and publish.

Alternatively, for manual installation:
1. Download the plugin zip file and upload it via Plugins > Add New > Upload Plugin.
2. Activate the plugin through the Plugins menu in WordPress.

== Frequently Asked Questions ==

= How do I create a portfolio gallery with category filters? =
Insert the Ultimate Portfolio block into your page editor. In the block inspector on the right, enable the Filter option under the Filter Controls section. Assign category tags to your images or select categories from your portfolio post items.

= Can I use this plugin to display WordPress blog posts in a slider or grid? =
Yes. In the block settings, change the Content Source option from media images to WordPress posts. You can display blog posts in a standard grid, masonry layout, or dynamic post slider complete with featured images, titles, excerpts, and category badges.

= Is the portfolio block fully responsive on mobile devices? =
Yes. The plugin allows you to set specific column counts for desktop, tablet, and mobile screens independently. Image heights and layout gaps automatically adjust for optimal mobile viewing.

= Does Ultimate Portfolio support shortcodes for page builders like Elementor? =
Yes. Every portfolio item created under the Ultimate Portfolio menu generates a unique shortcode formatted as [ultimate_portfolio id="123"]. You can paste this shortcode into Elementor, Beaver Builder, Divi, or standard widget areas.

= Will adding a large image gallery slow down my website? =
No. The plugin includes built-in lazy loading that only loads gallery images as visitors scroll down to view them. This ensures fast initial page loading times regardless of how many images your portfolio contains.

= Can I customize hover effects and background colors? =
Yes. The block settings include controls for hover styles, overlay colors, background colors, text colors, font alignments, and border radiuses.

== Screenshots ==

1. Filterable portfolio gallery layout with category buttons.
2. Responsive blog post grid showcasing featured images and excerpts.
3. Interactive post slider layout with navigation arrows.
4. Lightbox preview window with image zoom and slideshow controls.
5. Gutenberg block editor controls and drag-and-drop gallery manager.
6. Custom portfolio admin settings page.

== Changelog ==

= 1.2.1 =
* Date: 30 July 2026
* Fixed leftover debug print output polluting frontend AJAX filtering and pagination layouts.
* Fixed performance bottleneck by removing global rewrite rule flushing on every request.
* Sanitized custom CSS block attribute input to prevent potential stored XSS vulnerabilities.
* Fixed admin bar menu output buffering to prevent header HTML rendering out of order.
* Added missing file dependency checks for media upload functions on plugin activation.
* Synchronized version constants and updated documentation for WordPress search optimization.

= 1.2.0 =
* Rewrote documentation and description for enhanced SEO and keyword relevance.
* Refined feature breakdown and layout options.
* Updated compatibility verification with WordPress 6.9.

= 1.1.7 =
* Verified compatibility with WordPress 6.9.

= 1.1.6 =
* General bug fixes and stability improvements.

= 1.1.5 =
* Fixed an issue where category filters were disappearing under certain theme configurations.

= 1.1.4 =
* General maintenance and code optimization.

= 1.1.3 =
* Resolved special character encoding issues within portfolio category filter titles.
* Verified compatibility with WordPress 6.8.2.

= 1.1.2 =
* Resolved Gutenberg block rendering inconsistencies.

= 1.1.1 =
* Adjusted filter spacing and alignment rules.

= 1.1.0 =
* Improved Isotope filtering performance.

== Upgrade Notice ==

= 1.2.1 =
Performance improvements, frontend layout bug fixes, and security enhancements. Recommended update for all users.

= 1.2.0 =
Updated plugin documentation and optimized keyword structure for better search visibility. No breaking changes.