Title: ReformBox
Author: Tsubu
Published: <strong>2026 年 3 月 25 日</strong>
Last modified: 2026 年 3 月 26 日

---

搜索插件

![](https://s.w.org/plugins/geopattern-icon/reformbox.svg)

# ReformBox

 作者：[Tsubu](https://profiles.wordpress.org/tbshiki/)

[下载](https://downloads.wordpress.org/plugin/reformbox.0.3.3.zip)

 * [详情](https://cn.wordpress.org/plugins/reformbox/#description)
 * [评价](https://cn.wordpress.org/plugins/reformbox/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/reformbox/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/reformbox/#developers)

 [支持](https://wordpress.org/support/plugin/reformbox/)

## 描述

ReformBox extends WordPress Lightbox functionality beyond images. It currently supports
Group, Paragraph, and Video blocks with poster images directly, while delegating
Image lightbox behavior to WordPress core. For `core/image`, ReformBox only syncs
the sidebar toggle with core lightbox settings.

[This plugin is developed on GitHub.](https://github.com/tbshiki/reformbox)

**Supported Blocks:**

 * Image Block – Uses WordPress core lightbox behavior (ReformBox panel toggles 
   core `lightbox.enabled`)
 * Video Block – Opens in a lightbox when a poster image is set (poster acts as 
   the click trigger)
 * Group Block – Supports both `same` mode (same content in page + modal) and `split`
   mode (separate Preview/Modal direct child Group slots)
 * Paragraph Block – Click to open itself in a lightbox

**Features:**

 * No-code lightbox creation via block editor controls
 * Core-first image lightbox integration (`core/image`)
 * Core-aligned overlay markup for custom lightboxes
 * Core-aligned zoom animation
 * ESC key and overlay click to close
 * Accessible (ARIA attributes, focus management, keyboard navigation)
 * Group split mode with Preview/Modal slot mapping
 * Safe split fallback: if no Modal slot is assigned, Preview content is used
 * Lazy-loaded assets (CSS/JS only loaded when needed)
 * Self-lightbox videos defer preload/autoplay until opened
 * Core image workflow integration without overriding core image rendering
 * Global overlay background color and opacity controls in Settings > ReformBox
 * Plugin list row includes a Settings action link for quick access
 * Lightweight and performant

## 安装

 1. In your WordPress admin, go to Plugins > Add New Plugin
 2. Search for `ReformBox`
 3. Click `Install Now`, then click `Activate`
 4. Open the block editor and select any supported block
 5. Enable ReformBox in the block’s settings panel (for Image blocks, use `Enable Core
    Image Lightbox`)

For Video blocks, add a poster image in the block settings before enabling ReformBox.

## 常见问题

### Does ReformBox replace the core image lightbox?

No. `core/image` self-lightbox behavior is delegated to the WordPress core lightbox.
ReformBox extends the surrounding workflow so images, videos, and container content
can share a common modal workflow.

For images, the ReformBox sidebar toggle only updates the core `lightbox.enabled`
setting; the clickable link behavior and overlay rendering are still handled by 
WordPress core.

### Why does Video lightbox require a poster image?

Video self-lightbox uses the poster image as the visible in-page trigger and loads
the full video inside the overlay. Without a poster image, ReformBox keeps the video
lightbox toggle disabled.

### How does Group split mode work?

Enable ReformBox on a Group block, then switch `Display Mode` to `Split`. Inside
that parent Group, set direct child Group blocks to `Preview`, `Modal`, or `Preview
+ Modal (Both)` in the sidebar.

    ```
    Preview content is rendered in-page, `Modal` content is rendered inside the lightbox overlay, and unassigned child Groups (`none`) are rendered in both. If modal content is still empty, ReformBox automatically falls back to `Preview` content.
    Slot Type controls are shown only on direct child Group blocks of the split parent.
    ```

### Where can I change ReformBox overlay appearance?

Open `Settings > ReformBox` in WP Admin. You can set the ReformBox overlay background
color and opacity there.
 The same settings screen is also linked from the plugin
row action (`Plugins > ReformBox > Settings`).

## 评价

![](https://secure.gravatar.com/avatar/cf491a59cec4bd03bf40b7dfb352c00ae8f40681380b53c73d42a53f79f19790?
s=60&d=retro&r=g)

### 󠀁[めっちゃ便利！](https://wordpress.org/support/topic/%e3%82%81%e3%81%a3%e3%81%a1%e3%82%83%e4%be%bf%e5%88%a9%ef%bc%81/)󠁿

 [Kotaro Kitamura](https://profiles.wordpress.org/koots2020/) 2026 年 3 月 26 日

段落、動画、グループブロックにもLightboxを拡張できて凄い！！ かゆいところに手が届く
シンプルで素敵なプラグインです！

 [ 阅读所有1条评价 ](https://wordpress.org/support/plugin/reformbox/reviews/)

## 贡献者及开发者

「ReformBox」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Tsubu ](https://profiles.wordpress.org/tbshiki/)

「ReformBox」插件已被翻译至 1 种本地化语言。 感谢[所有译者](https://translate.wordpress.org/projects/wp-plugins/reformbox/contributors)
为本插件所做的贡献。

[帮助将「ReformBox」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/reformbox)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/reformbox/)，查看[SVN仓库](https://plugins.svn.wordpress.org/reformbox/)，
或通过[RSS](https://plugins.trac.wordpress.org/log/reformbox/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/reformbox/)。

## 更新日志

#### 0.3.3

 * Unified ReformBox overlay controls into a single background color + opacity setting
 * Improved consistency of overlay background rendering across ReformBox lightboxes
 * Kept WordPress core lightbox appearance override separate from ReformBox overlay
   controls

#### 0.3.2

 * Improved overlay styling and close behavior to avoid unintended interactions 
   with page content and WordPress core lightbox instances

#### 0.3.1

 * Clarified Image and Video lightbox behavior in the plugin documentation

#### 0.3.0

 * Improved internal code quality and release preparation for the plugin

#### 0.2.0

 * Added Group split mode and refined lightbox behavior for content and media blocks

#### 0.1.0

 * Initial release
 * Group block as lightbox container
 * Image/Video block self-lightbox
 * Paragraph block as self-lightbox
 * Core-aligned zoom animation
 * Keyboard and accessibility support

## 额外信息

 *  版本 **0.3.3**
 *  最后更新：**2 月前**
 *  活跃安装数量 **10+**
 *  WordPress 版本 ** 6.4 或更高版本 **
 *  已测试的最高版本为 **6.9.4**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/reformbox/) 和 [Japanese](https://ja.wordpress.org/plugins/reformbox/).
 *  [翻译成简体中文](https://translate.wordpress.org/projects/wp-plugins/reformbox)
 * 标签
 * [blocks](https://cn.wordpress.org/plugins/tags/blocks/)[gutenberg](https://cn.wordpress.org/plugins/tags/gutenberg/)
   [lightbox](https://cn.wordpress.org/plugins/tags/lightbox/)[modal](https://cn.wordpress.org/plugins/tags/modal/)
   [popup](https://cn.wordpress.org/plugins/tags/popup/)
 *  [高级视图](https://cn.wordpress.org/plugins/reformbox/advanced/)

## 评级

 5 星（最高 5 星）。

 *  [  1 条 5 星评价     ](https://wordpress.org/support/plugin/reformbox/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/reformbox/reviews/?filter=4)
 *  [  0 条 3 星评价     ](https://wordpress.org/support/plugin/reformbox/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/reformbox/reviews/?filter=2)
 *  [  0 条 1 星评价     ](https://wordpress.org/support/plugin/reformbox/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/reformbox/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/reformbox/reviews/)

## 贡献者

 *   [ Tsubu ](https://profiles.wordpress.org/tbshiki/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/reformbox/)