GhostLabs Serendipity – Masonry & Mosaic Photo Gallery Block

开发者	ghostlabs
更新时间	2026年10月29日 05:58
PHP版本:	8.1 及以上
WordPress版本:	7.1
版权:	GPL-2.0-or-later
版权网址:	版权信息

下载

1.0.0

详情介绍:

Serendipity composes a mosaic from your photographs — not a grid with the gaps filled in, but a partition of the space where every tile earns its size. Compose one, keep it, and it stays exactly as you left it: layouts are saved per breakpoint, so a gallery looks deliberate on a phone as well as a desktop. A masonry-style gallery that fills its space If you want a gallery that isn't a rigid grid, this is one. Like a masonry gallery, Serendipity mixes tiles of different sizes, and the more photographs you give it, the more they vary. Unlike one, it doesn't run on down the page in uneven columns: it fills the space you give it, cropping each photograph to its tile. Choose Refresh Layout & Save in the block toolbar until you like what it composes. It saves for the breakpoint you are editing. It is a block, not a custom post type. There is no separate gallery screen to visit, nothing to sync, and nothing left behind if you deactivate the plugin — the gallery lives in the post where you put it. Bring your own lightbox Serendipity links each image to its full-size file and groups the gallery, which is what lightbox plugins look for. If you already run one, it will pick these galleries up with no configuration. If you would rather it did not, there is a setting for that too: link to the file without grouping, link to the attachment page, or emit no link at all. What it does

A generative mosaic engine — compose, refresh, keep the one you like
Saved layouts at all three breakpoints, so nothing reshuffles on a phone
Gap, minimum height, thumbnail and full-size resolution
Stack on mobile, for galleries that read better as a column
Lightbox-agnostic output, or no links at all
One hover style, Fade-Up, with captions
Four starter block patterns
Loads nothing on pages that have no gallery

安装:

Install through Plugins → Add Plugin, or upload the plugin folder to /wp-content/plugins/.
Activate it through the Plugins screen.
In a post or page, add the Serendipity Gallery block and choose Add Images.
Choose Refresh Layout & Save in the block toolbar until you like what it composes. It saves for the breakpoint you are editing; switch to Tablet or Mobile in the same toolbar to compose those too. A breakpoint you leave unsaved borrows the nearest saved layout.
Optional: start from a pattern instead. The inserter's Patterns tab has a Serendipity category with four starter galleries.

屏幕截图:

升级注意事项:

1.0.0 First release. A photo gallery block that fills the space you give it with a mosaic, and keeps the layout you choose at each breakpoint. Requires WordPress 7.1 and PHP 8.1.

常见问题:

Is it a masonry gallery?

It's the masonry look without the uneven columns. Serendipity breaks the space you give it into a mosaic of tiles of different sizes, so it isn't a rigid grid. A classic masonry gallery keeps every photograph whole and lets its columns run on to different lengths; Serendipity crops each photograph to its tile, so the gallery fills its space. If every photograph has to stay uncropped, Serendipity is not the gallery you want.

Does it work with my lightbox plugin?

Very probably. Each image is linked to its full-size file — not the attachment page, which is what some lightboxes need — and the gallery is grouped with data-rel so a lightbox can page through it rather than treating every tile as a lone image. These four were installed and tested against a Serendipity gallery, and all four picked it up with no configuration: Firelight (Easy FancyBox), Responsive Lightbox & Gallery, FooBox, and Lightbox with PhotoSwipe. If yours needs something else, the ghostlabs_serendipity_link_attributes filter lets you add any attribute to the link without touching the plugin.

My gallery looks different every time I reload the editor

Compose a layout and save it. Until a layout is saved for a breakpoint, the mosaic is generated fresh each time — that is the point of the generator. Once saved, it is fixed, and other breakpoints borrow it rather than composing their own.

Will it slow my site down?

The gallery's stylesheet and script load only on pages that actually contain a gallery, and the composition is rendered as CSS by the server, so the layout is correct on the first paint rather than after JavaScript runs.

What is in Serendipity Deluxe?

Layout Studio — drag the seams between tiles, reframe a photograph inside its tile, swap two photographs — plus a built-in carousel lightbox with autoplay, three more hover styles, and a library of twelve block patterns. The free plugin is not a trial: nothing here expires, and no feature is withheld that would make a gallery look broken without it.

I bought Serendipity Deluxe. How do I switch over?

Serendipity Deluxe is a separate plugin. Once you have bought it:

Download it from your GhostLabs account. Settings → Serendipity links there under Have a license?
From the Plugins menu, open the screen for adding a plugin and choose Upload Plugin.
Activate it, then enter the license key from your receipt email in its settings.

When Serendipity Deluxe starts, it deactivates this plugin. Every gallery and saved layout stays exactly as it is, because every gallery's settings and layout live in the gallery block, which both plugins read. This plugin is left installed but inactive, and you can delete it whenever you like.

更新日志: