fix(content-distribution): Image block lightbox and Jetpack carousel support

[miguelpeixe]

All Submissions:

• Have you followed the Newspack Contributing guideline?
• Does your code follow the WordPress' coding standards and VIP Go coding standards?
• Have you checked to ensure there aren't other open Pull Requests for the same update/change?

Changes proposed in this Pull Request:

NPPM-2398

This PR adds core lightbox and Jetpack's full-screen carousel support to incoming posts.

There's an existing bug that occurs when a distributed post image ID matches an existing image in the destination media library, causing the lightbox and carousel libraries to fetch the local image as the "larger" version.

The standard behavior when the attachment doesn't match anything locally is to render the URL from the markup, which is usually low resolution.

The proposed strategy is to set the expected attributes via filters. The libraries will read from them to render the original URL in high resolution.

Note: This PR also moves the block-specific functionality to a separate class, so it's no longer part of the main Content Distribution class.

How to test the changes in this Pull Request:

1. While on trunk, make sure you have Jetpack's "Display images in a full-screen carousel gallery" toggled on:

2. Distribute a post with the following blocks:
   1. Image block with the link set to "Enlarge on click"
   2. Gallery block
   3. Tiled Gallery block
3. Publish and visit the incoming post
4. Click on each image and confirm that it either renders a low-resolution image (compare with the original post lightbox/carousel behavior) or another image entirely (if it matched a local attachment ID)
5. Inspect the markup and confirm the images lack srcset and several other attributes in comparison to the original post markup
6. Checkout this branch, make content changes in the original post, and save to trigger an update to the payload
7. Refresh the incoming post page and confirm the markup now includes additional image attributes
8. Click on each image and confirm the lightbox and carousel render the original resolution

Other information:

• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you written new tests for your changes, as applicable?
• Have you successfully ran tests with your changes locally?

[Copilot]

Pull request overview

This PR adds core lightbox and Jetpack carousel support for distributed posts by enriching the media payload with additional metadata and implementing custom rendering filters on incoming posts. The changes also refactor block processor functionality into a dedicated Blocks class structure for better organization.

• Refactors block processing logic from Content_Distribution class into new Blocks and Block_Processor classes
• Adds Image_Block class to handle lightbox rendering and image attribute filtering for incoming posts
• Enriches outgoing post media data with metadata, srcset, dimensions, title, and description fields

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
includes/content-distribution/blocks/class-blocks.php	New class managing block processor registration and processing for outgoing/incoming blocks
includes/content-distribution/blocks/class-block-processor.php	New class encapsulating individual block processor logic with callbacks
includes/content-distribution/blocks/class-image-block.php	New class implementing custom lightbox rendering and image attribute filtering for distributed posts
includes/content-distribution/class-outgoing-post.php	Enhanced media data collection with additional metadata fields (srcset, dimensions, title, description)
includes/content-distribution/class-incoming-post.php	Updated to use refactored Blocks::process_incoming_block() method
includes/class-content-distribution.php	Refactored to remove block processor methods and delegate to new Blocks class
tests/unit-tests/content-distribution/test-block-processor.php	Updated test references from Content_Distribution to Blocks class

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 8 changed files in this pull request and generated 5 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[leogermani]

Works!

[github-actions]

Hey @miguelpeixe, good job getting this PR merged! 🎉

Now, the needs-changelog label has been added to it.

Please check if this PR needs to be included in the "Upcoming Changes" and "Release Notes" doc. If it doesn't, simply remove the label.

If it does, please add an entry to our shared document, with screenshots and testing instructions if applicable, then remove the label.

Thank you! ❤️

[matticbot]

🎉 This PR is included in version 2.18.2-alpha.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

[matticbot]

🎉 This PR is included in version 2.18.2 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀