===  Portfolio Block – The Ultimate Project & Portfolio Builder  ===
Contributors: bplugins, abuhayat, prosanta10, freemius
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: portfolio, portfolio gallery, filterable portfolio, gutenberg, project showcase
Requires at least: 6.5
Tested up to: 7.0
Stable tag: 2.2.0
Requires PHP: 7.1
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Create responsive portfolios in Gutenberg with grid, masonry, filters, lightbox, slider, and customizable project layouts.
 
== Description ==

**Showcase your projects like a pro – build clean, modern, filterable portfolios right inside the WordPress block editor, no page builder required.**

[**Portfolio Block**](https://bplugins.com/products/portfolio-block/) | [**Documentation**](https://bplugins.com/docs/portfolio-block/) | [**Pricing**](https://bplugins.com/products/portfolio-block/pricing) | [**Support**](https://bplugins.com/support/) | [**Demo**](https://bblockswp.com/demo/portfolio-block-all-demos/)

Portfolio Block is a Gutenberg portfolio builder that helps freelancers, developers, designers, photographers, agencies, and creative professionals showcase projects on their WordPress websites.

Build a portfolio using grid, masonry, or card hover layouts. Add project images, titles, descriptions, categories, and links. Customize the layout for different screen sizes and choose what happens when visitors click a portfolio item.

### Why Use Portfolio Block?

**Portfolio Block** makes it easy to create a clean, modern portfolio directly inside the WordPress block editor. It includes multiple layouts, category filters, responsive controls, and full design flexibility – ideal for freelancers, designers, photographers, agencies, or anyone who wants to showcase projects in a professional way.

Build a portfolio with the Gutenberg block, or generate a shortcode and display it anywhere on your site – pages, posts, widgets, footers, or page builders. Native Gutenberg, fast loading, lightweight, SEO friendly, and fully responsive, with unlimited projects and categories.

=== Key Features – Free Version ===

- **Multiple Layouts** – Grid, Masonry, and Card Hover layouts for flexible portfolio design.
- **Unlimited Categories** – Organize projects with as many categories as you need and allow users to filter by category.
-  **Portfolio Items** – Add images, titles, descriptions, and external or internal links. Assign multiple categories per item.
- **Item Management** – Duplicate, delete, or reorder items with simple controls.
- **Responsive Controls** – Adjust columns, spacing, and layout settings for desktop, tablet, and mobile.
- **Styling Options** – Customize colors, borders, shadows, spacing, and overlay settings to match your theme.
- **View All Button** – Add a customizable button linking to your full portfolio archive or a separate page.
- **Shortcode Support** – Use your portfolio anywhere with the shortcode format: [pfb id="123"].
  
=== Portfolio Block Pro – Unlock Advanced Features ===

== Pro Features Include ==

- **Advanced Layouts** – Split Screen, Slider, Minimal List, and Stacked Cards for more dynamic presentation styles.
- **Typography Controls** – Adjust fonts, sizes, colors, weight, and alignment for titles, categories, and descriptions.
- **Hover and Animation Effects** – Premium hover transitions and animations for a more interactive experience.
- **Slider Options** – Autoplay, loop, pause on hover, navigation controls, and speed settings for slider-based portfolios.
- **Advanced Styling** – More control over buttons, badges, icons, overlays, and spacing.
- **Full Template Library** – 43 ready-made portfolio sections in 12 categories (agency, personal, business, photography & fashion, video, case studies, hire me and more). Preview any template, import it in one click and save favorites.
- **Image Protection & Age Verification** – Keep photos from being saved, and put sensitive galleries or videos behind an age gate (Client Proofing and Video Portfolio).
- **Specialized Portfolio Blocks** – Create niche-specific portfolios using professionally designed blocks:

	- **Dynamic Portfolio** – Pull posts, projects or any custom post type into a filterable, paginated grid. AJAX category filter, sorting, Load More / Infinite Scroll / numbered pages, and fully server rendered so the items are in the page source for search engines.

	- **Case Study** – Tell the full story of a single project: hero, client meta, result metrics, challenge/solution/outcome, process steps, gallery, client quote and a call to action. Every section can be switched off, and columns, spacing and type sizes are set per device.

	- **Developer Portfolio** – Create a developer portfolio page directly inside Gutenberg to showcase projects and technical work.

	- **Fashion Portfolio** – Display fashion collections, lookbooks, and brand campaigns.

	- **Marketing Portfolio** – Present case studies, campaign results, and marketing projects.

	- **Photography Portfolio** – Highlight photography collections with visual-focused layouts.

	- **Resume Builder** – Create a professional resume or CV portfolio page directly inside Gutenberg.

	- **Before & After** – Show the transformation behind your work with a draggable before and after image comparison.

	- **3D Carousel Portfolio** – An immersive drag-to-rotate 3D media wall for hero sections, project showcases and brand walls. Mixes images and video with atmospheric fog depth.

	- **Video Showreel** – Present your reel and video projects in a fast, poster-first grid that only loads a player when someone hits play.

	- **Video Portfolio** – A filterable video grid with load more, hover autoplay and a lightbox player. Ships with four preset layouts.

	- **Client Proofing** – Share a photo gallery with a client so they can pick favorites, leave notes on each photo and send the final selection back to you.

	- **Interactive Portfolio** – A typographic project list that reveals an image or video on hover. Two layouts: a preview that follows the cursor, and a thumbnail that opens inside the row.

	- **Horizontal Portfolio** – Horizontal project cards that open a details popup. The popup is a template you design with blocks.

	- **Slide Portfolio** – A responsive portfolio slider with six designs: minimal arrows, color overlay, glass caption, frosted panel, card and label. Swipe, loop, autoplay, arrows or pagination, and a lightbox for images and video.

	- **Pinterest Portfolio** – A Pinterest style masonry wall where every pin keeps its real shape. Category filters, load more, a pin detail view with "More like this", shareable pin links and a Save to Pinterest button. Add dozens of images in one go.

	- **Portfolio Studio** – One portfolio section, six designs: Aurora glass grid, Low Light, Index list with a live preview, Carousel with autoplay and progress, Brutalist and Collector cards. Category filters and a project detail view with client, role and result.

	- **Case File** – A one-screen case study: hero with project facts, tabbed challenge, approach and outcome, result metrics and process steps, in Split, Spotlight and Editorial layouts.

	- **Lead Form** – A "Hire Me" / "Get a Quote" form for your portfolio. Enquiries are saved under Portfolio → Leads (with status and CSV export) and emailed to you; optional confirmation email to the visitor. Spam is stopped without a captcha.
- **Priority Support** – Faster support and ongoing updates with the Pro upgrade.

### Portfolio Items

Add the following information to portfolio items:
- Images
- Titles
- Descriptions
- Internal links
- External links
- Categories


### Common Use Cases

Portfolio Block can be used for many types of WordPress websites.

- **Personal Portfolio:** Showcase your skills, experience, and creative work.
- **Freelancer Portfolio:** Present client projects and attract new customers.
- **Developer Portfolio:** Display websites, apps, plugins, and software projects.
- **Photography Portfolio:** Create a visual photography gallery with lightbox support.
- **Agency Portfolio:** Showcase services, client work, and successful projects.
- **Design Portfolio:** Present graphic design, UI/UX, branding, and creative projects.
- **Marketing Portfolio:** Display campaigns, case studies, and marketing projects.
- **Product Showcase:** Present products, product designs, and featured work.
- **Creative Portfolio:** Build a visually engaging portfolio for creative professionals.
- **Resume Portfolio:** Combine professional experience, projects, and skills into a portfolio page.

### Specialized Portfolio Blocks

Portfolio Block Pro includes professionally designed portfolio layouts for different professional needs.

**Developer Portfolio**
Showcase websites, applications, plugins, software projects, GitHub projects, and technical work.

**Fashion Portfolio**
Display fashion collections, campaigns, and creative fashion projects.

**Marketing Portfolio**
Present marketing campaigns, case studies, client results, and creative marketing work.

**Photography Portfolio**
Create an image-focused photography portfolio for photographers, studios, and creative professionals.

**Resume Builder**
Create a professional resume or CV portfolio page containing experience, projects, skills, and professional information.


### What Is Portfolio Block?

Portfolio Block is a Gutenberg portfolio builder for WordPress that lets you create responsive portfolio galleries and project showcases directly in the WordPress Block Editor.

Create portfolio grids, masonry layouts, card hover portfolios, sliders, minimal lists, split-screen portfolios, and stacked card layouts without relying on a separate page builder.

Use it to showcase:

- Client projects
- Websites and applications
- Photography
- Design work
- Marketing campaigns
- Products
- Creative work
- Professional experience
- Case studies
- Personal projects


### Advanced Portfolio Layouts

Portfolio Block Pro adds advanced layouts for creating more distinctive portfolio pages:

- Split Screen
- Slider
- Minimal List
- Stacked Cards
- Advanced typography
- Hover animations
- Advanced styling
- Slider autoplay
- Slider loop
- Pause on hover
- Navigation controls
- Slider speed

### Filterable Portfolio Gallery

Create a filterable portfolio in WordPress by organizing projects into categories.

Visitors can select a category to quickly find relevant projects, making the portfolio easier to browse.

Use category filtering for:

- Web design projects
- Photography collections
- Client projects
- Product categories
- Marketing campaigns
- Design work
- Case studies

### Portfolio Lightbox and Project Links

Choose what happens when visitors click a portfolio item:

- Open a single-image lightbox
- Open a gallery lightbox
- Open a custom URL

Use lightbox layouts to let visitors explore visual projects without leaving the portfolio page.


### Hover and Animation Effects

Add additional hover transitions and animation effects to portfolio layouts.

### Slider Controls

The Pro Slider layout includes:
- Autoplay
- Loop
- Pause on hover
- Navigation controls
- Slider speed


=== How to Use Portfolio Block – Step-by-Step Guide ===

Getting started with Portfolio Block is quick and easy!

== Step-by-Step Instructions ==

1. Install and activate **Portfolio Block**.  
2. Open the Block Editor and click the **+** icon.  
3. Search for **Portfolio (by bPlugins)**.  
4. Add your portfolio items and customize your layout.  
5. Publish your page.

== Shortcode Usage ==
1. Go to Portfolio Block → Add New Portfolio in the dashboard.
2. Create your portfolio using the block editor.
3. Publish it.
4. Copy the shortcode that appears after publishing.
5. Paste it anywhere on your site where you want the portfolio to appear.

== Feedback == 
Have a suggestion or question?  
Email us: support@bplugins.com

### Check out our other WordPress Plugins-

[**Html5 Video Player**](https://bplugins.com/products/html5-video-player/) – Display videos as single and playlist in multiple skins.

[**PDF Poster**](https://bplugins.com/products/pdf-poster/) – Display/Embed PDF files with different styles.

[**Html5 Audio Player**](https://bplugins.com/products/html5-audio-player/) – Listen audios with awesome visuals.

[**StreamCast**](https://bplugins.com/products/streamcast-radio-player/) – Customizable radio player with different skins.

[**3D Viewer**](https://bplugins.com/products/3d-viewer/) – Embed 3D models and 3D products with interaction.

[**Advanced Post Block**](https://bplugins.com/products/advanced-post-block/) – Show posts and custom posts in different layouts.

[**bBlocks**](https://bblockswp.com) – A blocks collection and page building tool for Gutenberg.


== Installation ==

= From the Block Editor (Gutenberg) =
1. Open any page or post in the WordPress Block Editor.
2. Click the “+” Add Block icon.
3. Search for **Portfolio Block**.
4. Look for the block labeled “Portfolio (by bPlugins)” and insert it.
5. Customize the block settings from the right sidebar and publish your page.

= From WordPress Plugin Directory =
1. Go to **Plugins <span aria-hidden="true" class="wp-exclude-emoji">→</span> Add New** in your WordPress dashboard.
2. Search for **Portfolio Block**.
3. Find the plugin developed by **bPlugins**.
4. Click **Install Now**, then click **Activate**.
5. Open a page and start adding your portfolio.

= Upload via Plugin Installer =
1. Download the **portfolio-block.zip** file.
2. Go to **Plugins <span aria-hidden="true" class="wp-exclude-emoji">→</span> Add New <span aria-hidden="true" class="wp-exclude-emoji">→</span> Upload Plugin**.
3. Select the `portfolio-block.zip` file and click **Install Now**.
4. After installation, click **Activate**.

= Manual Installation =
1. Download the plugin ZIP file and extract it.
2. Upload the extracted folder to `/wp-content/plugins/` using FTP or File Manager.
3. Go to **Plugins** in your WordPress dashboard.
4. Find **Portfolio Block** and click **Activate**.

== FAQ ==

= Is it free? =  
Yes, the core plugin is free.

= How do I get the shortcode? =  
After publishing a portfolio under **Portfolio Block** and you will see a ShortCode column.

= Can I use it with page builders? =  
Yes, all builders that support shortcodes.

= Does it work with all themes? =  
Yes, fully compatible with modern WordPress themes.

= Can I customize layouts and styles? =  
Yes, all settings are editable in the block editor sidebar.

= Can I reuse the block? =  
Yes, you can use it as many times as you want.

= Where can I get support? =  
https://wordpress.org/support/plugin/portfolio-block/

= Where do I report security bugs found in this plugin? =
Please report security bugs found in the source code of the Portfolio Block plugin through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/9e5fb645-ef15-4628-91b6-de61c8ef0e78). The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.

== Screenshots ==
1. Admin Dashboard 
2. Add New Item (ShortCode)
3. Preview with Litebox
4. Masonry Grid Layout
5. Card Hover Effects
6. Split Screen Navigation
7. Full-Width Slider
8. Minimal List Layout
9. Stacked Cards Layout
10. Fashion Portfolio
11. Marketing Portfolio	
12. Photography Portfolio
13. Gutenberg Block Settings 1
14. Gutenberg Block Settings 2	
15. Gutenberg Block Settings 3

== Changelog ==  

= 2.2.0 – 18 Oct 26 =
* Added: Client Proofing block - clients pick and comment on their photos, selections are saved to a Proofing Submissions screen and emailed, with privacy export and erase.
* Added: Before After, 3D Carousel, Interactive Portfolio, Horizontal Portfolio, Video Portfolio and Video Showreel blocks.
* Added: Password and age protection for portfolio blocks, verified on the server so locked content never reaches the page.
* Added: Duplicate action on the Portfolios list, to copy a portfolio into a new draft.
* Added: Template library with ready-made portfolio templates.
* Added: Dynamic Portfolio block - query any post type, AJAX category filter, sorting, offset, Load More / Infinite Scroll / numbered pagination, grid, masonry and list layouts, per device columns and gap.
* Added: Dynamic Portfolio renders on the server, so its items appear in the page source and its view script ships without React.
* Added: Case Study block - hero, project meta, result metrics, challenge/solution/outcome, process, gallery, services, client quote and CTA, each section toggleable with per device columns, spacing and type sizes.
* Added: Case Study to the portfolio template chooser and the dashboard block list.
* Added: Slide Portfolio block - six slider designs with per device slides per view and gap, swipe, loop, autoplay, arrows or pagination and an image and video lightbox. Available in the shortcode template chooser and the dashboard.
* Added: Pinterest Portfolio block - masonry pins in their real proportions with no layout jump, category filters, load more, a pin detail view with shareable links and "More like this", Save to Pinterest, bulk image adding and four themes. Rendered on the server, with a small script and no React on the page.
* Added: Portfolio Studio block - six layouts (Aurora, Low Light, Index, Carousel, Brutalist, Collector) sharing one set of projects, with category filters, a project detail view, per device columns and gap, and system fonts for fast loading.
* Added: Case File block - hero with project facts, accessible tabbed sections, metric tiles and process steps in three layouts (Split, Spotlight, Editorial), responsive for laptop, tablet and phone.
* Added: Lead Form block - Hire Me / Get a Quote enquiries saved to a Leads screen and emailed, with project context, service / budget / timeline fields, consent checkbox, auto-reply, CSV export, privacy export and erase, and captcha-free spam protection (honeypot, signed timing, rate limit).
* Fixed: Shortcode now renders reliably when the portfolio post content parses into more than one block.
* Improved: Much smaller editor scripts - the icon library now loads only when an icon picker is opened.
* Improved: Proofing Submissions and Leads screens are available with an active Pro license only.

= 2.1.5 – 30 June 26 =   
* Updated Admin Dashboard   
* Fixed: Added root plugin functionality.

= 2.1.3 – 06 June 26 =   
* Fixed: resume builder style issue. 
* Added: portfolio Click Behavior: Open Single image lightbox, gallery lightbox or Custom URL

= 2.1.1 – 09 Mar 26 =  
* Reduced file size.

= 2.1.0 – 08 Mar 26 =  
* Fixed dashboard issue.

= 2.0.9 – 07 Mar 26 =  
*  Fixed toast issue.

= 2.0.8 – 05 Mar 26 =  
* Improved design and customization.

= 2.0.7 – 25 Feb 26 =  
* Updated Admin Dashboard  

= 2.0.6 – 21 Feb 26 =
*Fixed dropdown visibility issue.

= 2.0.5 – 26 Jan 26 =
* Improved category filter controls with new customization options.

= 2.0.4 – 14 Jan 26 =  
* Performance improvements  

= 2.0.3 – 24 Dec 25 =  
* Bug fixes and performance improvements  

= 2.0.2 - 18 Dec 25 =
* Bug fix: corrected broken links.


= 2.0.1 – 13 Dec 25 =
* UI improvements and bug fixes.


= 2.0.0 – 22 Nov 25 =  
* Added six new themes for improved design and customization.

= 1.0.4 – 16 Apr 25 =  
* Bug fixes and performance improvements  

= 1.0.3 =  
* Library updates  

= 1.0.2 =  
* Added external link icon  

= 1.0.1 =  
* Added translation support  

= 1.0.0 =  
* Initial release  
