Title: Rado's Native Lightbox
Author: radogado
Published: <strong>4 مارس 2026</strong>
Last modified: 4 مارس 2026

---

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

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

# Rado's Native Lightbox

 توسط [radogado](https://profiles.wordpress.org/radogado/)

[دانلود](https://downloads.wordpress.org/plugin/rados-native-lightbox.1.0.0.zip)

 * [جزئیات](https://fa.wordpress.org/plugins/rados-native-lightbox/#description)
 * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/rados-native-lightbox/#reviews)
 *  [نصب](https://fa.wordpress.org/plugins/rados-native-lightbox/#installation)
 * [توسعه](https://fa.wordpress.org/plugins/rados-native-lightbox/#developers)

 [پشتیبانی](https://wordpress.org/support/plugin/rados-native-lightbox/)

## توضیحات

Rado’s Native Lightbox instantly upgrades every WordPress gallery into a beautiful,
full-screen lightbox carousel. Just activate and go — your existing galleries are
transformed automatically, no shortcodes to learn, no settings pages to configure.

Built on [Native Carousel](https://nativecarousel.com/), it uses the browser’s own
scroll-snapping instead of heavy animation libraries. The result is buttery-smooth
swiping on phones, fluid keyboard navigation on desktops, and a total footprint 
of roughly 13 KB — smaller than a single thumbnail image.

**Why this plugin?**

 * **Zero configuration** — activate it and every gallery on your site becomes a
   lightbox carousel. Deactivate it and galleries revert to normal. Nothing is written
   to your database.
 * **Truly lightweight** — ~13 KB total (JS + CSS). No jQuery, no frameworks, no
   external requests. Your PageSpeed score stays intact.
 * **Works with any theme** — Twenty Twenty-Five, Astra, GeneratePress, or anything
   else. The plugin bundles everything it needs.
 * **Accessible by default** — full keyboard navigation, focus trapping in the lightbox,
   screen-reader labels on every control, and `prefers-reduced-motion` support.
 * **Native scroll-snap** — hardware-accelerated, 60 fps swiping powered by the 
   browser itself, not JavaScript animation loops.
 * **Dark mode aware** — the lightbox overlay adapts to the visitor’s system color
   scheme automatically.

**Features at a glance:**

 * Full-screen lightbox with swipe, keyboard and mouse-wheel navigation
 * Compact thumbnail index strip with scrollable overflow
 * “Thumbnails only” toggle in both the Block Editor sidebar and Classic Editor 
   settings
 * Endless (infinite loop) navigation
 * Lazy-loaded images with low-resolution placeholder blur while loading
 * Captions and alt text fully preserved
 * Featured-image click opens the matching gallery slide on single posts
 * Editor performance guard — caps image sizes in the block editor to prevent crashes
   with large galleries

**How it works:**

The plugin intercepts gallery rendering at display time and outputs [Native Carousel](https://nativecarousel.com/)
HTML markup. Your post content is never modified — the transformation is purely 
visual and fully reversible.

### Third-party source code

This plugin bundles minified assets from **Native Carousel**, an open-source carousel
component (GPL-2.0-or-later).

 * Homepage & documentation: [https://nativecarousel.com/](https://nativecarousel.com/)
 * Source code repository: [https://github.com/radogado/n-carousel](https://github.com/radogado/n-carousel)

The following files in `assets/` are the minified production builds:

 * `n-carousel.min.js` — carousel runtime
 * `n-carousel-preload.min.js` — image preloader
 * `n-carousel.min.css` — carousel styles

The unminified, human-readable source is available in the GitHub repository linked
above. No build tools are needed to work with this plugin’s own code — `gallery-
lightbox.css` and the admin JavaScript files are shipped unminified and readable.

This plugin is also maintained as part of the niui theme project:
 [https://gitlab.com/spacest/niui/-/tree/main/rados-native-lightbox](https://gitlab.com/spacest/niui/-/tree/main/rados-native-lightbox)

## نصب

 1. Upload the `rados-native-lightbox` folder to `/wp-content/plugins/`.
 2. Activate the plugin through the Plugins menu in WordPress.
 3. Your galleries are now lightbox carousels — no configuration needed.

## سوالات متداول

### Does this work with any theme?

Yes. The plugin bundles its own JavaScript and CSS — no special theme support is
needed. It has been tested with Twenty Twenty-Five and other popular themes.

### Will it slow down my site?

No. The entire plugin is about 13 KB (minified JS + CSS combined). There are no 
external HTTP requests, no jQuery dependency, and no render-blocking resources. 
The JavaScript loads in the footer and images are lazy-loaded.

### What happens if I deactivate the plugin?

Galleries revert to WordPress’s default rendering instantly. The plugin never modifies
your post content — the transformation happens at display time only, so there is
nothing to clean up.

### How do I switch between thumbnails-only and full slides?

**Block Editor:** Select the gallery block, open the sidebar, and toggle “Thumbnails
only” under the Native Carousel panel.

**Classic Editor:** Open the gallery settings modal and use the “Thumbnails only”
checkbox.

### Does this work with the Classic Editor plugin?

Yes. The plugin supports both the block editor (Gutenberg) and the Classic Editor.

### Is the lightbox accessible?

Yes. The carousel supports full keyboard navigation (arrow keys, Home, End, Escape
to close), traps focus inside the lightbox when open, provides screen-reader labels
on all controls, and respects the `prefers-reduced-motion` system setting.

### Can I style the controls to match my theme?

Yes. The carousel controls are styled via CSS custom properties. Add these to your
theme’s CSS to customize the look:

    ```
    --nui-control-bg (button background), `--nui-control-color` (button icon/text), `--nui-control-highlight` (selected thumbnail ring), `--nui-border-radius` (button rounding).
    ```

### What is Native Carousel?

[Native Carousel](https://nativecarousel.com/) is a standalone, open-source carousel
component that uses the browser’s native scroll-snapping instead of JavaScript animation.
It is lightweight, accessible, and dependency-free.

## نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

## توسعه دهندگان و همکاران

“Rado's Native Lightbox” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.

مشارکت کنندگان

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

[ترجمه “Rado's Native Lightbox” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/rados-native-lightbox)

### علاقه‌ مند به توسعه هستید؟

[Browse the code](https://plugins.trac.wordpress.org/browser/rados-native-lightbox/),
check out the [SVN repository](https://plugins.svn.wordpress.org/rados-native-lightbox/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/rados-native-lightbox/)
by [RSS](https://plugins.trac.wordpress.org/log/rados-native-lightbox/?limit=100&mode=stop_on_copy&format=rss).

## گزارش تغییرات

#### 1.0.0

 * Initial release.
 * Block gallery (`core/gallery`) transformation via `render_block` filter.
 * Classic `[gallery]` shortcode transformation via `post_gallery` filter.
 * “Thumbnails only” toggle for Block Editor and Classic Editor.
 * Bundled Native Carousel assets — works with any theme.
 * Editor image size capping to improve performance with large galleries.
 * Featured-image-to-lightbox click handler for single posts.

## اطلاعات

 *  نگارش **1.0.0**
 *  Last updated **1 ماه پیش**
 *  نصب‌های فعال **کمتر از 10**
 *  نگارش وردپرس ** 5.9 یا بالاتر **
 *  Tested up to **6.9.4**
 *  نگارش PHP ** 7.4 یا بالاتر **
 *  زبان
 * [English (US)](https://wordpress.org/plugins/rados-native-lightbox/)
 * Tags
 * [carousel](https://fa.wordpress.org/plugins/tags/carousel/)[gallery](https://fa.wordpress.org/plugins/tags/gallery/)
   [lightbox](https://fa.wordpress.org/plugins/tags/lightbox/)[photography](https://fa.wordpress.org/plugins/tags/photography/)
   [thumbnails](https://fa.wordpress.org/plugins/tags/thumbnails/)
 *  [نمایش پیشرفته](https://fa.wordpress.org/plugins/rados-native-lightbox/advanced/)

## امتیازها

هنوز هیچ نقدی ارسال نشده است.

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

[مشاهده همه بررسی‌ها](https://wordpress.org/support/plugin/rados-native-lightbox/reviews/)

## مشارکت کنندگان

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

## پشتیبانی

چیزی برای گفتن دارید؟ نیاز به کمک دارید؟

 [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/rados-native-lightbox/)