{"id":286162,"date":"2026-03-04T11:28:49","date_gmt":"2026-03-04T11:28:49","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/niui-gallery\/"},"modified":"2026-03-04T11:29:23","modified_gmt":"2026-03-04T11:29:23","slug":"rados-native-lightbox","status":"publish","type":"plugin","link":"https:\/\/cs.wordpress.org\/plugins\/rados-native-lightbox\/","author":14641934,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.0","stable_tag":"1.0.0","tested":"6.9.4","requires":"5.9","requires_php":"7.4","requires_plugins":null,"header_name":"Rado's Native Lightbox","header_author":"Radoslav Sharapanov","header_description":"Transforms WordPress galleries into lightweight lightbox carousels powered by Native Carousel. Works with any theme.","assets_banners_color":"","last_updated":"2026-03-04 11:29:23","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/nativecarousel.com\/","header_author_uri":"https:\/\/rado.bg","rating":0,"author_block_rating":0,"active_installs":0,"downloads":215,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"radogado","date":"2026-03-04 11:29:23"}},"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Lightbox carousel with thumbnail index strip.","2":"Block Editor \u2014 \"Thumbnails only\" toggle in the gallery sidebar.","3":"Classic Editor \u2014 \"Thumbnails only\" checkbox in gallery settings."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[786,210,237,2248,2956],"plugin_category":[50],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-286162","plugin","type-plugin","status-publish","hentry","plugin_tags-carousel","plugin_tags-gallery","plugin_tags-lightbox","plugin_tags-photography","plugin_tags-thumbnails","plugin_category-media","plugin_committers-radogado"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/rados-native-lightbox.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Rado's Native Lightbox instantly upgrades every WordPress gallery into a beautiful, full-screen lightbox carousel. Just activate and go \u2014 your existing galleries are transformed automatically, no shortcodes to learn, no settings pages to configure.<\/p>\n\n<p>Built on <a href=\"https:\/\/nativecarousel.com\/\">Native Carousel<\/a>, 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 \u2014 smaller than a single thumbnail image.<\/p>\n\n<p><strong>Why this plugin?<\/strong><\/p>\n\n<ul>\n<li><strong>Zero configuration<\/strong> \u2014 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.<\/li>\n<li><strong>Truly lightweight<\/strong> \u2014 ~13 KB total (JS + CSS). No jQuery, no frameworks, no external requests. Your PageSpeed score stays intact.<\/li>\n<li><strong>Works with any theme<\/strong> \u2014 Twenty Twenty-Five, Astra, GeneratePress, or anything else. The plugin bundles everything it needs.<\/li>\n<li><strong>Accessible by default<\/strong> \u2014 full keyboard navigation, focus trapping in the lightbox, screen-reader labels on every control, and <code>prefers-reduced-motion<\/code> support.<\/li>\n<li><strong>Native scroll-snap<\/strong> \u2014 hardware-accelerated, 60 fps swiping powered by the browser itself, not JavaScript animation loops.<\/li>\n<li><strong>Dark mode aware<\/strong> \u2014 the lightbox overlay adapts to the visitor's system color scheme automatically.<\/li>\n<\/ul>\n\n<p><strong>Features at a glance:<\/strong><\/p>\n\n<ul>\n<li>Full-screen lightbox with swipe, keyboard and mouse-wheel navigation<\/li>\n<li>Compact thumbnail index strip with scrollable overflow<\/li>\n<li>\"Thumbnails only\" toggle in both the Block Editor sidebar and Classic Editor settings<\/li>\n<li>Endless (infinite loop) navigation<\/li>\n<li>Lazy-loaded images with low-resolution placeholder blur while loading<\/li>\n<li>Captions and alt text fully preserved<\/li>\n<li>Featured-image click opens the matching gallery slide on single posts<\/li>\n<li>Editor performance guard \u2014 caps image sizes in the block editor to prevent crashes with large galleries<\/li>\n<\/ul>\n\n<p><strong>How it works:<\/strong><\/p>\n\n<p>The plugin intercepts gallery rendering at display time and outputs <a href=\"https:\/\/nativecarousel.com\/\">Native Carousel<\/a> HTML markup. Your post content is never modified \u2014 the transformation is purely visual and fully reversible.<\/p>\n\n<h3>Third-party source code<\/h3>\n\n<p>This plugin bundles minified assets from <strong>Native Carousel<\/strong>, an open-source carousel component (GPL-2.0-or-later).<\/p>\n\n<ul>\n<li>Homepage &amp; documentation: <a href=\"https:\/\/nativecarousel.com\/\">https:\/\/nativecarousel.com\/<\/a><\/li>\n<li>Source code repository: <a href=\"https:\/\/github.com\/radogado\/n-carousel\">https:\/\/github.com\/radogado\/n-carousel<\/a><\/li>\n<\/ul>\n\n<p>The following files in <code>assets\/<\/code> are the minified production builds:<\/p>\n\n<ul>\n<li><code>n-carousel.min.js<\/code> \u2014 carousel runtime<\/li>\n<li><code>n-carousel-preload.min.js<\/code> \u2014 image preloader<\/li>\n<li><code>n-carousel.min.css<\/code> \u2014 carousel styles<\/li>\n<\/ul>\n\n<p>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 \u2014 <code>gallery-lightbox.css<\/code> and the admin JavaScript files are shipped unminified and readable.<\/p>\n\n<p>This plugin is also maintained as part of the niui theme project:\n<a href=\"https:\/\/gitlab.com\/spacest\/niui\/-\/tree\/main\/rados-native-lightbox\">https:\/\/gitlab.com\/spacest\/niui\/-\/tree\/main\/rados-native-lightbox<\/a><\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>rados-native-lightbox<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate the plugin through the Plugins menu in WordPress.<\/li>\n<li>Your galleries are now lightbox carousels \u2014 no configuration needed.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20work%20with%20any%20theme%3F\"><h3>Does this work with any theme?<\/h3><\/dt>\n<dd><p>Yes. The plugin bundles its own JavaScript and CSS \u2014 no special theme support is needed. It has been tested with Twenty Twenty-Five and other popular themes.<\/p><\/dd>\n<dt id=\"will%20it%20slow%20down%20my%20site%3F\"><h3>Will it slow down my site?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20i%20deactivate%20the%20plugin%3F\"><h3>What happens if I deactivate the plugin?<\/h3><\/dt>\n<dd><p>Galleries revert to WordPress's default rendering instantly. The plugin never modifies your post content \u2014 the transformation happens at display time only, so there is nothing to clean up.<\/p><\/dd>\n<dt id=\"how%20do%20i%20switch%20between%20thumbnails-only%20and%20full%20slides%3F\"><h3>How do I switch between thumbnails-only and full slides?<\/h3><\/dt>\n<dd><p><strong>Block Editor:<\/strong> Select the gallery block, open the sidebar, and toggle \"Thumbnails only\" under the Native Carousel panel.<\/p>\n\n<p><strong>Classic Editor:<\/strong> Open the gallery settings modal and use the \"Thumbnails only\" checkbox.<\/p><\/dd>\n<dt id=\"does%20this%20work%20with%20the%20classic%20editor%20plugin%3F\"><h3>Does this work with the Classic Editor plugin?<\/h3><\/dt>\n<dd><p>Yes. The plugin supports both the block editor (Gutenberg) and the Classic Editor.<\/p><\/dd>\n<dt id=\"is%20the%20lightbox%20accessible%3F\"><h3>Is the lightbox accessible?<\/h3><\/dt>\n<dd><p>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 <code>prefers-reduced-motion<\/code> system setting.<\/p><\/dd>\n<dt id=\"can%20i%20style%20the%20controls%20to%20match%20my%20theme%3F\"><h3>Can I style the controls to match my theme?<\/h3><\/dt>\n<dd><p>Yes. The carousel controls are styled via CSS custom properties. Add these to your theme's CSS to customize the look:<\/p>\n\n<pre><code>--nui-control-bg (button background), `--nui-control-color` (button icon\/text), `--nui-control-highlight` (selected thumbnail ring), `--nui-border-radius` (button rounding).\n<\/code><\/pre><\/dd>\n<dt id=\"what%20is%20native%20carousel%3F\"><h3>What is Native Carousel?<\/h3><\/dt>\n<dd><p><a href=\"https:\/\/nativecarousel.com\/\">Native Carousel<\/a> 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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Block gallery (<code>core\/gallery<\/code>) transformation via <code>render_block<\/code> filter.<\/li>\n<li>Classic <code>[gallery]<\/code> shortcode transformation via <code>post_gallery<\/code> filter.<\/li>\n<li>\"Thumbnails only\" toggle for Block Editor and Classic Editor.<\/li>\n<li>Bundled Native Carousel assets \u2014 works with any theme.<\/li>\n<li>Editor image size capping to improve performance with large galleries.<\/li>\n<li>Featured-image-to-lightbox click handler for single posts.<\/li>\n<\/ul>","raw_excerpt":"Transforms WordPress galleries into lightweight lightbox carousels. Works with any theme \u2014 only ~13 KB.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/286162","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=286162"}],"author":[{"embeddable":true,"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/radogado"}],"wp:attachment":[{"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=286162"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=286162"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=286162"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=286162"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=286162"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cs.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=286162"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}