=== EC Lightbox ===
Contributors: daniloercoli
Tags: lightbox, galleries
Requires at least: 6.7
Tested up to: 6.9
Stable tag: 1.1.0
Requires PHP: 7.4
License: GNU General Public License v3.0 or later

EC Lightbox is a minimal WordPress plugin that adds a modern lightbox to galleries using GLightbox.

== Description ==

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.

---

## Installation

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.

---

## 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:
   - **Link to** → `None`
   - Disable **“Open in lightbox” / “Enlarge on click”** if present.
4. Open the **Advanced** panel.
5. Add the following class:
   ec-lightbox

6. 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)