Five Number Lightbox
| 开发者 | gvijaikumar99 |
|---|---|
| 更新时间 | 2026年7月30日 00:21 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Images inserted with no link at all, which is what the block editor produces by default. The full-size file is found automatically.
- Images linked to their media file.
- Images already carrying the classic
rel="lightbox[group]"markup that several older lightbox plugins wrote into post content. These are left exactly as they are, so a site with years of old posts keeps the grouping it was published with.
<picture> elements keep working, links you added yourself are never hijacked, and an image inside a link keeps going where you pointed it.
Parsing is done with WordPress's own HTML API rather than regular expressions, so quoting and unusual attribute values are handled correctly.
It tries not to get in the way
- Images already displayed at full size are skipped. There is nothing to enlarge, so an overlay would just be an extra click.
- Images smaller than 400px wide are skipped, since those are usually icons or logos.
- If the full-size file is missing, the overlay closes and the browser follows the link normally rather than trapping the reader behind a dark screen.
- Ctrl-click, Cmd-click and middle-click still open the image in a new tab.
Esccloses, left and right arrows move between images.- Focus moves into the overlay when it opens, stays inside it while open, and returns to the image you clicked when it closes.
- The dialog is exposed with
role="dialog"andaria-modal, and the image counter is announced. prefers-reduced-motionis respected.
安装:
- In your admin, go to Plugins > Add New > Upload Plugin and upload the zip, or search for "Five Number Lightbox" under Plugins > Add New.
- Activate it.
常见问题:
Do I have to change how I insert images?
No. Insert images the way you already do. If an image has no link, the plugin finds the full-size file for you.
I am moving from an older lightbox plugin. Will my old posts break?
No. Content already containing rel="lightbox[group]" is left untouched and works as it always did, including the grouping.
Why do some images not open in a lightbox?
Four cases are skipped on purpose: images already shown at their full size, images narrower than 400px, images that are not in your media library, and images inside a link you added yourself. In the last case your link is more important than an overlay, so it is left alone.
Can I change the 400px cut-off?
Yes, with the fnlb_min_width filter:
add_filter( 'fnlb_min_width', function () { return 250; } );
Can I turn it off on certain pages?
Yes. fnlb_enabled controls whether the CSS and JavaScript load, and fnlb_rewrite_content controls whether image markup is touched:
add_filter( 'fnlb_enabled', function ( $on ) { return ! is_front_page(); } );
Does it work with galleries?
Images in a gallery block are handled the same way as any other image in the post, and all images in a post form one set.
Does it send any data anywhere?
No. There are no external requests, no analytics and no phoning home.
更新日志:
- First public release.
- Image markup is parsed with WordPress's HTML API rather than regular expressions, and attributes are added to existing tags instead of wrapping them, so post markup is never restructured.
- The CSS and JavaScript are only loaded on pages that actually have images to show.
- Attachment lookups are batched into a single query per post.