Title: EC Lightbox
Author: daniloercoli
Published: <strong>2026 年 1 月 20 日</strong>
Last modified: 2026 年 1 月 20 日

---

搜索插件

![](https://ps.w.org/ec-lightbox/assets/icon-256x256.jpg?rev=3443453)

# EC Lightbox

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

[下载](https://downloads.wordpress.org/plugin/ec-lightbox.1.1.0.zip)

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

 [支持](https://wordpress.org/support/plugin/ec-lightbox/)

## 描述

EC Lightbox is a minimal WordPress plugin that adds a modern lightbox to galleries
using [GLightbox](https://github.com/biati-digital/glightbox).

The plugin is opt-in by behavior: once activated, it only applies its lightbox functionality
to blocks where you explicitly add a custom CSS class (for example, a Gallery block).
Everywhere else, WordPress behaves normally.

### Features

 * Uses [GLightbox](https://github.com/biati-digital/glightbox) for a clean, responsive
   lightbox.
 * Works with WordPress core blocks (e.g. Gallery, Image).
 * Opt-in activation via a custom CSS class (`ec-lightbox`).
 * Groups images by gallery container (each block with `ec-lightbox` is its own 
   gallery).
 * Includes a **Settings page** in WordPress Admin.
 * Configurable behavior: loop, touch navigation, zoom.
 * Local vendor assets by default (no hard dependency on external CDNs).

### Requirements

 * WordPress 5.0+
 * PHP 7.0+
 * A block-based setup (Gutenberg) is recommended.

### How to enable EC Lightbox on a Gallery block

 1. Insert a **Gallery** block.
 2. Select the **Gallery block itself** (not a single image inside it).
 3. In the block sidebar, configure:
 4.  * **Link to**  `None`
     * Disable **“Open in lightbox” / “Enlarge on click”** if present.
 5. Open the **Advanced** panel.
 6. Add the following class:
     ec-lightbox
 7. Update or publish the post.

When users click an image inside that gallery, EC Lightbox will open and allow navigation
through the gallery.

Note:
 Make sure individual images inside the gallery do **not** have click settings
assigned. If these WP-native actions remain enabled, WordPress will attach its own
click/lightbox behavior, overriding this plugin.

### ⚙️ Settings Page (WordPress Admin)

A configuration screen is available at:

**Settings  EC Lightbox**

Available options:

 * **Loop images**
 * **Enable touch navigation**
 * **Enable zoom**
 * **Autoplay videos** (for future video support)

All settings are passed directly to the lightbox JavaScript on initialization.

### 🧩 Filters & Developer API

### 1. Modify GLightbox options programmatically

    ```
    `php
    ```

add_filter( ‘ec_lightbox_js_options’, function ( $options ) {
 $options[‘loop’] 
= true; $options[‘zoomable’] = false; $options[‘openEffect’] = ‘zoom’; // Any GLightbox
option is accepted return $options; }); ` Options merged from: 1. Plugin defaults
2. Admin settings 3. This filter (highest priority)

## 安装

 1. Install EC Lightbox via the WordPress.org plugin repository or by uploading the
    files to your server.
 2. Activate **EC Lightbox** from **Plugins  Installed Plugins**.
 3. (Optional) Review default options in **Settings  EC Lightbox**.

The plugin ships with local GLightbox assets already included — no external downloads
are required.

## 评价

此插件暂无评价。

## 贡献者及开发者

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

贡献者

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

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

### 对开发感兴趣吗?

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

## 额外信息

 *  版本 **1.1.0**
 *  最后更新：**4 月前**
 *  活跃安装数量 **10+**
 *  WordPress 版本 ** 6.7 或更高版本 **
 *  已测试的最高版本为 **6.9.4**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/ec-lightbox/)
 * 标签
 * [galleries](https://cn.wordpress.org/plugins/tags/galleries/)[lightbox](https://cn.wordpress.org/plugins/tags/lightbox/)
 *  [高级视图](https://cn.wordpress.org/plugins/ec-lightbox/advanced/)

## 评级

尚未提交反馈。

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

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

## 贡献者

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

## 支持

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

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