Title: EC Lightbox
Author: daniloercoli
Published: <strong>20 ژانویه 2026</strong>
Last modified: 20 ژانویه 2026

---

جستجوی افزونه‌ها

![](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://fa.wordpress.org/plugins/ec-lightbox/#description)
 * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/ec-lightbox/#reviews)
 *  [نصب](https://fa.wordpress.org/plugins/ec-lightbox/#installation)
 * [توسعه](https://fa.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**
 *  آخرین به‌روزرسانی **6 ماه پیش**
 *  نصب‌های فعال **20+**
 *  نگارش وردپرس ** 6.7 یا بالاتر **
 *  آزمایش‌شده تا **6.9.5**
 *  نگارش PHP ** 7.4 یا بالاتر **
 *  زبان
 * [English (US)](https://wordpress.org/plugins/ec-lightbox/)
 * برچسب
 * [galleries](https://fa.wordpress.org/plugins/tags/galleries/)[lightbox](https://fa.wordpress.org/plugins/tags/lightbox/)
 *  [نمایش پیشرفته](https://fa.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/)