=== FolioBlocks ===
Contributors: portfolioblocks , campanellafoto, freemius
Plugin link: https://folioblocks.com/
Tags: gallery, image gallery, photo gallery, video gallery, lightbox, 
Tested up to:      7.1
Requires at least: 6.3
Requires PHP: 7.4
Stable tag:        1.4.5
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Create fast, responsive photo and video galleries with grid, masonry, justified, modular, and carousel layouts—ideal for photographers and creatives.

== Description ==

= Native Gallery Blocks for WordPress =

FolioBlocks is a **native WordPress gallery plugin** for building responsive image galleries, video galleries, portfolio layouts, and comparison blocks directly in the **Block Editor**. It is designed for photographers, designers, artists, agencies, creative businesses, and WooCommerce stores that need flexible visual layouts without shortcodes or external gallery managers.

Create **Grid, Masonry, Justified, Carousel, Filmstrip, Modular, and Video galleries** using familiar Gutenberg controls. FolioBlocks keeps your workflow inside WordPress while giving you tools for **lightboxes, hover overlays, gallery filtering, image downloads, WooCommerce product links, EXIF display, and content protection**.

The free version includes the core gallery and media blocks. **FolioBlocks Pro** unlocks advanced creative and commerce features, including **Modular Gallery, gallery filtering, WooCommerce integration, image downloads, lazy loading, advanced styling controls, Pro List View thumbnails**, and more.

= Included Blocks =

* **Background Video Block** - Add an autoplaying, responsive background video with overlay content on top
* **Before & After Block** – Compare two images with an interactive slider
* **Loupe Block** - Highlight fine details with an elegant magnifying zoom effect
* **Carousel Gallery Block** – Smooth, swipe-friendly horizontal image slider
* **Filmstrip Gallery Block** – Scroll through large images with thumbnail navigation below
* **Grid Gallery Block** – Classic evenly-spaced grid layout
* **Image Block** - Display a single image with lightbox, hover overlay, optional downloads, and WooCommerce linking
* **Justified Gallery Block** – Professional row-based gallery with balanced heights
* **Masonry Gallery Block** – Pinterest-style vertical gallery layout
* **Modular Gallery Block (Pro Only)** – Build custom, magazine-style image layouts
* **Video Block** - Display a single video with custom thumbnail, lightbox playback, captions, and optional WooCommerce linking
* **Video Gallery Block** – Showcase YouTube, Vimeo, or self-hosted videos

= Core Gallery Features =

* **Fully responsive layouts** for desktop, tablet, and mobile
* **Built-in lightbox support**
* **Caption support** and accessibility-friendly interactions
* **Drag-and-drop image ordering**
* **100% native Gutenberg block editing** with no shortcodes and no separate gallery manager
* **WordPress 7.0 List View inspector support** for gallery children

= Pro Features =

* **Block transforms** to convert galleries and supported media blocks in one click
* **Custom image click actions** for media files, custom URLs, Page/Post links, downloads, lightbox, and WooCommerce products
* **Per-image click and hover overrides** inside galleries
* **Gallery image filtering** with per-image category assignment
* **WooCommerce product integration** for images and videos
* **Download full-resolution images**
* **Randomize image order**
* **Seamless looping** for Carousel Gallery
* **Disable right-click / content protection**
* **Lazy load images** for faster performance
* **Hover effects, image overlays, and overlay content controls**
* **EXIF metadata display** in lightboxes and hover overlays
* **Light and Dark lightbox appearances**, fullscreen viewing, swipe navigation, and combined title, caption, and EXIF layouts
* **Password protection controls** for Posts and Pages
* **Responsive desktop, tablet, and mobile gallery gaps**
* **Pro List View thumbnails** for easier gallery reordering
* **Advanced gallery styling controls** for borders, shadows, radius, filter bars, icons, and overlays

= Why FolioBlocks? =

FolioBlocks is built for users who want **fast, native, block-based galleries** without the complexity of third-party gallery builders or shortcode-based plugins. If you want a clean way to display **photography, client work, products, portfolios, or case studies**, FolioBlocks gives you those tools directly inside the editor.

== Installation ==

= Install from WordPress =

The easiest way to install FolioBlocks is by visiting your **Plugins > Add New** menu. Search for **"FolioBlocks"** and install the first result you see there.

= Install from a ZIP File =

To install with the zip file downloaded from this page:

1. Log in to your WordPress dashboard
2. Visit the **Plugins > Add New** menu
3. Click the **Upload Plugin** button at the top
4. In the upload form that appears, click the **Choose file** button and select the **portfolio-blocks.zip** file you downloaded here
5. Click the **Install Now** button
6. Once the page reloads, click the blue **Activate** link

== Frequently Asked Questions ==

= What is FolioBlocks? =
FolioBlocks is a collection of **modern, responsive gallery and media blocks** built specifically for the WordPress Block Editor (Gutenberg). You can create image and video galleries with advanced layouts like **Grid, Masonry, Justified, Carousel**, and more — all directly in the editor.

= Does FolioBlocks work with any WordPress theme? =
Yes. FolioBlocks is designed to work with **all modern WordPress themes**. For best results, we recommend using a block theme that supports **Full Site Editing**.

= What’s the difference between the free and Pro versions? =
The free version includes all the core blocks with the exception of the **Modular Gallery**. The Pro version includes the Modular Gallery block and unlocks additional premium features across all blocks such as **Gallery Filtering, WooCommerce integration, Image Downloads, Randomize Image Order, Lightbox Captions, Right-Click Disable, Lazy Load**, and more.

= Can I use FolioBlocks with page builders like Elementor or Divi? =
FolioBlocks is built specifically for the **WordPress Block Editor (Gutenberg)**. It will not work inside Elementor, Divi, or other third-party page builders.

= Will FolioBlocks slow down my website? =
No. FolioBlocks is **optimized for performance** and loads only the scripts and styles needed for each block. The Pro version also includes **Lazy Load** support to further improve loading speed.

= Can I upgrade from the free version to Pro? =
Yes. You can install the free version from the WordPress plugin directory, and upgrade to Pro at any time. Your galleries will continue to work — you’ll simply unlock **unlimited images and additional features**.

= Do you offer support? =
Yes. Free users can post support requests on the **WordPress.org plugin forum**. Pro users receive **priority email support** directly from the developer.

= Can I use FolioBlocks on client websites? =
Absolutely. FolioBlocks is built with **agencies and freelancers** in mind. The Pro version offers licensing for single sites, 5 sites, or unlimited client projects depending on your plan.

= Will my galleries stop working if I deactivate the plugin? =
No, the galleries will remain in place on your site. However, the **advanced layouts and features** are powered by FolioBlocks, so deactivating the plugin will remove those.

== Screenshots ==

1. Before & After Comparison block populated with images
2. Carousel Gallery block populated with images
3. Grid Gallery block populated with images
4. Justified Gallery block populated with images
5. Masonry Gallery block populated with images
6. Video Gallery block populated with images

== Changelog ==

= 1.4.5 =
* Fixed a PHP fatal error in Image Block rendering caused by missing shared CSS value sanitizers in the 1.4.4 package.
* Improved review notice actions so stale Maybe Later and I Already Did links can still dismiss the notice.

= 1.4.4 =
* Fixed the admin review link so an expired review notice no longer shows a WordPress "link expired" error.

= 1.4.3 =
* Fixed Grid and Masonry Gallery editor syncing so repeated autosaves cannot duplicate existing gallery images.

= 1.4.2 =
* Fixed Modular Gallery row alignment when Image Stacks appear beside Image Blocks.

= 1.4.1 =
* Fixed a bug in the Image Block Lightbox that prevented some images from being properlly sized. 
* Fixed a bug in Modular Gallery where gallery images could flash on screen before gallery styles had properlly loaded. 


= 1.4.0 =
* Added responsive desktop, tablet, and mobile gap controls to Carousel, Masonry, Justified, Modular, and Video Galleries.
* Added fullscreen controls to Video Block and Video Gallery lightboxes.
* Added Subtle, Soft, Elevated, and Dramatic drop-shadow presets to Image Block, Video Block, and photo and video galleries.
* Added tap-to-hide controls and captions plus touch swipe navigation to image lightboxes.
* Added Light and Dark image and video lightbox appearances, including inheritable per-image appearance overrides.
* Added combined image title, caption, and EXIF content layouts for image lightboxes.
* Added optional WooCommerce and Page/URL link icons for linked thumbnails.
* Added a Pro fullscreen button and F keyboard shortcut to Image Block lightboxes.
* Added a Pro action for syncing Image Block titles, captions, and alternative text to the WordPress Media Library.
* Added Pro per-image click and hover overrides to Grid, Justified, Masonry, Carousel, Modular, and Filmstrip Galleries.
* Added Gallery Click Settings, Gallery Click Styles, Gallery Hover Settings, and per-image overrides to Filmstrip Gallery.
* Added Filmstrip Gallery image lightboxes with scoped navigation, inherited or per-image appearance and content, EXIF display, and fullscreen handoff.
* Added optional Pro seamless looping to Carousel Gallery for continuous arrow, keyboard, swipe, and autoplay navigation.
* Added Pro password protection controls for Posts and Pages to the FolioBlocks Page Settings panel.
* Added Video Title, Play Button, and Filtering Category combinations to Video Block and Video Gallery overlays.
* Added Pro per-video hover overrides for Video Galleries, including styles, overlay content, visibility, and Color Overlay colors.

= 1.3.1 =
* Refactored repeated Pro controls for Image Click Styles, gallery toggles, List View thumbnails, and editor filtering into shared helpers.
* Improved editor-side filtering consistency for Grid, Justified, Masonry, and Video Gallery blocks.
* Fixed randomized gallery order on the front end so randomized galleries reshuffle on page refresh.
* Fixed gallery block transform errors caused by randomize-order effects firing during transformed block setup.
* Replaced deprecated WordPress media selector usage and cleaned up redundant legacy premium control registrations.

= 1.3.0 =
* Added WordPress 7.0 editor improvements, including gallery List View inspector support and Image Block content controls in the Content inspector.
* Improved Pro List View thumbnails for FolioBlocks Image Blocks, Video Blocks, and gallery children.
* Added a unified Image Click Behavior control for Image Block and photo galleries, with support for Lightbox, Downloads, WooCommerce products, Media File links, Custom URLs, and Page/Post links.
* Added faster per-image linking workflows, including toolbar shortcuts for Custom URL, Page/Post, and WooCommerce product links.
* Added EXIF metadata support for Image Blocks, with premium Lightbox and hover overlay display options.
* Improved Image Hover Settings with a single Hover Style control, new overlay content options, and refined color controls.
* Updated Filmstrip, Carousel, Grid, Masonry, and Justified galleries to use the improved click and hover settings patterns.
* Improved gallery filtering controls, including clearer per-image filtering settings.
* Refreshed the FolioBlocks admin dashboard and fixed the admin menu icon display.
* Fixed Masonry Gallery column settings on the front end, including desktop, tablet, and mobile column values.
* Fixed front-end rendering when multiple Masonry or Justified galleries appear on the same page.
* Fixed Justified Gallery filtering so filter bars only affect their own gallery.
* Fixed hover overlay display issues, including Gradient Overlay behavior when Reduce Motion is enabled.
* Fixed several Image Block inspector, Lightbox, EXIF, WooCommerce, and overlay style issues.

= 1.2.9 =
* Added Block Transforms support to convert WordPress Video, YouTube Embed, and Vimeo Embed blocks into a FolioBlocks Video Block.  
* Added attribute parity in Block Transforms feature. 
* Fixed Vimeo private link support in Video Block and Video Gallery lightboxes by preserving Vimeo privacy hashes in embed URLs.
* Fixed Video Block and Video Gallery lightbox sizing so 16:9 videos are not clipped in Chromium-based browsers.
* Improved Video Block and Video Gallery split lightbox sizing so videos with descriptions use more of the available viewport.

= 1.2.8 =
* Support to transform a WordPress gallery into a FolioBlocks gallery. 
* Updated existing block transforms so all galleries, except Modular, can transform into one another. 
* General secuirty improvements based on code audit. 
* Fixed a bug that prevented custom image sizes from registered by galleries. 

= 1.2.7 =
* Fixed a bug in Video Gallery that cause the block to crash in WordPress 7.0 
* Fixed deprecation warnings raised by WordPress 7.0 in our CompactTwoColorControl component. 
* Updated Swedish translations. 
* Changed Dashboard icon to better follow WordPress standards. 

= 1.2.6 =
* Fixed a bug in Modular Gallery that prevented the correct image resolution from being used in the front-end. 

= 1.2.5 =
* Removes support for coverting legacy (Portfolio Blocks) blocks into FolioBlocks blocks. 
* Improves Swedish translations 

= 1.2.4 =
* Excludes System Info from translation strings

= 1.2.3 =
* Fixed a bug that caused undefined variable warning in Grid Gallery

= 1.2.2 =
* Added responsive settings to Row Height slider in Justified Gallery Block.
* Updated Lightbox on Image Block to fill more of the viewport when exapnded. 
* Increased maximum row height value on Justifed gallery block. 

= 1.2.1 =
* Added support for videos from Bunny Stream to the Video Block and Video Gallery.  
* Moved video parsing logic from block into seperate helper file. 

= 1.2.0 =
* Public release of Filmstrip Gallery & Background Video Block. 
* Public release of Block Transforms. 
* Public release of new Custom Color Overlay in all galeries. 
* Public release of Overlay Styles on Video Block and Video Gallery. 
* Public release of multi-category filtering in all galleries.
* Updated Free Vs Pro Page with new blocks and block features. 
* Fixed layout bugs in the Background Video Block. 

= 1.1.8 =
* Fixed a bug that prevented Play/Pause and Full Screen from being accessed when overlay was enabled on Filmstrip Gallery.

= 1.1.7 =
* Prevent Filmstirp Gallery coming into focus when autoplay is enabled in the editor.
* Added support for setting Add To Cart icon behavior when using WooCommerce integration on Video Block & Video Gallery.
* Added Randomize Image Order feature to Filmstrip Gallery.
* Fixed a bug in Add To Cart icon on Video Block and Video Gallery. 
* Fixed a bug in Image Block that prevent drop shadow from being applied when used individually.

= 1.1.6 =
* Layout related bugs on Background Video Block. 
* Fixed a bug on Video Block and Video Gallery Block that threw up warning on the free verion of FolioBlocks. 
* Fixed a bug on Video Block that displayed an empty PanelBody. 
* Fixed bugs on Carousel, Grid, Justified, Masonry, and Video Gallery blocks that displayed a Notice out of alignment.   

= 1.1.5 =
* Added support for setting multiple categories per image when filtering in Grid, Justified, and Masonry Galleries. 
* Added support for setting multiple categories per video when filtering in Video Gallery. 
* Updated to a MediaPlaceholder for initial state on Background Video Block. 
* Moved Enable Full-Screen Mode feature on Filmstrip Gallery into premium.js 
* Fixed visual layout bugs in Filmstrip Gallery. 
* Updated Filmstrip Gallery to set image ID and srcset size. 
* Updated Carousel Gallery to use custom CompactTwoColorControl. 

= 1.1.4 =
* Build initial render.php file for Filmstrip Gallery.
* Added support for Block Transforms for Carousel Gallery and Filmstrip Gallery. 
* Filmstrip Gallery block now supports setting image resolution. 
* Filmstrip Gallery now supports showing title on hover. 

= 1.1.3 = 
* Added Overlay styles (Default, Blur, & Color) to Video Block & Video Gallery.
* Fixed bug in Color and Fade Overlay that affected image title rendering. 
* Merged Title and Play button visibility into one control on Video Block & Video Gallery. 
* Replaced Play button icon on Video Block with SVG variant. 
* Combined all icon helper files into one file. 

= 1.1.2 = 
* Added keyboard full-screen support (F) for the Video Lightbox. 
* Added support for Disable Right Click to Background Video Block. 
* Added block transforms on Grid Gallery, Justified Gallery, and Masonry Gallery. 
* Updated the Free Vs Pro page to include new blocks and new features.
* Prevent all blocks from transforming into Groups, Columns, or Details blocks. 


= 1.1.1 = 
* Added new Background Video Block.
* Added new Color Overlay option for all photo galeries (Carousel, Grid, Justified, Masonry, & Modular) and Image Block. 

= 1.1.0 = 
* Added style controls to set icon color and background color on Add To Cart and Download icons. 
* Added Drop Shadow control to Image Block. 
* Added new compact Border color component.
* WooCommerce Add To Cart Links now uses Ajax. 
* Images linked with WooCommerce can now select if the Add To Cart button Adds Product to Shopping Cart or leads to Product Page. 
* Fixed visual bug in Modular gallery where margin bottom in stacked images created gap between image and the selection outline. 
* Changed Gallery Image Styles now all inside of a single filter. 

= 1.0.10 = 
* Bug in Modular Gallery border controls.
* Bug in playback controls on Carousel Gallery Block.

= 1.0.9 = 
* Fixed bug in Masonry Gallery Image Filtering.

= 1.0.8 = 
* Fixed bug in Grid Gallery layout logic.
* Fixed bug in Image block when using border-radius. 
* Reduced availble border-width in all galleries to a maximum of 15px. 
* Reduced available border-radius on all galleries to a maximum of 50px. 
* Changed label names on all Gallery blocks to ensure matching language.
* Changed default setting for Image Downloads to "On Hover" to match default in WooCommerce Integration.

= 1.0.7 = 
* Fixed bug in Grid Gallery that clipped images when set to content width.

= 1.0.6 = 
* Adds Image Block and Video Block as standalone blocks. 
* Updates the organization of controls on all blocks. 
* Additional Hover Styles built into Image Block. 
* Add controls to access new Hover styles to Carousel, Grid, Justified, Masonery, and Modular galleries.
* Adds Lightbox, WooCommerce, Lazy Load, and Disable Right-click options to Video Block when used individually. 
* Adds Resolution, Lightbox, Hover, WooCommerce, Image Download, Lazy Load, Disable Right-Click options to Image Block when used individually.
* Added API Version to migration script in deprecated.js to prevent false warnings in WordPress 6.9. 
* Fixed layout issue with Justified Gallery when using Gallery Filtering
* Fixed block previews on Image Block and Video Block
* Fixed escaping issue on Loupe block
* Fixed a layout issue with the final row on Justified Gallery

= 1.0.5 = 
* New Loupe Block introduced.
* Fixed bug that prevented Disable Right-Click on Carousel Gallery.
* Changed variable prefixes to comply with WordPress standards.

= 1.0.4 =
* Changed variable prefixes to comply with WordPress standards 
* Fixed escaping issues on dashboard pages

= 1.0.3 =
* Improves loading method on premium scripts 
* Upgrade page now redirects to pricing page on FolioBlocks website

= 1.0.2 =
* Fixed minor bugs in Grid, Justified, and Masonry galleries 

= 1.0.1 =
* Added is-loading spinner to Carousel, Grid, Justified, and Masonry galleries
* Fixed bug in Carousel gallery that prevented correct height from being set
* Fixed bugs related to FolioBlocks domain name switch
* Tested for WordPress 6.9 compatibility

= 1.0.0 =
* Public Release
* Rebuilt the Admin Dashboard

== Source Code ==

Public repository:
https://github.com/folioblocks/folioblocks
