=== NGG Smart Image Search ===
Contributors: wpo-HR
Tags: NextGEN Gallery, image search, smart search, gallery displays, frontend search
Tested up to: 7.0
Stable tag: 4.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

NGG Smart Image Search provides smart search and display functionalities for images in NextGEN galleries. It requires NextGEN Gallery to be installed and activated.

Version 4 is a highly recommended functional and security update. It is a complete revision introducing Gutenberg blocks, new display modes, improved documentation and many optimizations. Previous documentation pages remain valid unless updated.

More information and examples:
https://r-fotos.de/wordpress-plugins/nextgen-galleries-smart-image-search/

== Description ==

NGG Smart Image Search provides a highly customizable search and display functionality for images in NextGEN Galleries. Searches can be performed across title, description, filename and tags. Two search modes are available: basic (OR) and extended (AND).

Search results can be displayed in various layouts:

* linked image lists with meta data
* advanced thumbnail lists
* advanced mosaic layouts
* single image inspection
* fancybox v6 lightbox with EXIF display
* paging, sorting, limiting
* native NextGEN / Pro / Plus galleries

Search input can be provided via:

* Gutenberg block
* URL parameter
* legacy shortcode
* legacy widget

Extended documentation:
https://r-fotos.de/wordpress-plugins/nextgen-galleries-smart-image-search/new-functionalities-v4/

== Installation ==

1. Upload `ngg-smart-image-search` to `/wp-content/plugins/`.
2. Activate the plugin.
3. Replace legacy shortcodes and widgets with Gutenberg blocks.
4. Update or replace the standard search page.

== Frequently Asked Questions ==

= How does the search work? =

There are four ways to perform a search:

1. Dynamic Gutenberg search block.
2. URL parameter `sngg`.
3. Static searchstring in the display block.
4. Legacy widget or shortcode.

Extended documentation:
https://r-fotos.de/wordpress-plugins/nextgen-galleries-smart-image-search/new-functionalities-v4/the-search-process/

= How can a search be customized? =

You can customize:

* searchable fields
* included/excluded galleries and albums
* sort order
* result limits
* separate settings for public vs. logged-in users

All parameters can be configured via Gutenberg block or widget.

= How can the result list be customized? =

Display options:

* display="li" – linked images
* display="at" – advanced thumbnails
* display="am" – advanced mosaic
* display="si" – NextGEN single images
* display="bt" – Basic Thumbnail Gallery
* display="pt" – Pro Thumbnail Gallery
* display="ma" – Pro Masonry Gallery
* display="mo" – Pro Mosaic Gallery

Additional parameters: sort order, paging, limits.

Extended documentation:https://r-fotos.de/wordpress-plugins/nextgen-galleries-smart-image-search/new-functionalities-v4/image-display/

= What search strings can be entered? =

Basic mode: whitespace-separated terms (OR).  
Extended mode: `&`, `&-`, `&t`, `&t-` separated terms (AND).

Special extended search options:

* g:{gallery_id} – select images from gallery
* a:{album_id} – select images from album
* r:{number} – select recent images
* l:{number} – select last uploaded images (with largest picture ID)
* i:{picture_id} – inspect single image
* u:{user_id} – select images uploaded by user

A search string can have escape characters at the beginning to switch between basic and extended mode, and escape options at the end to switch display modes.

Extended documentation:
https://r-fotos.de/wordpress-plugins/nextgen-galleries-smart-image-search/qualified-search-examples/

== Screenshots ==

1. editor liveview of Advanced Mosaic Display (javascript based)
2. editor liveview of Advanced Thumbnails Display (grid layout)
3. editor liveview of fancybox image viewer with exif data display
4. editor liveview of Linked Images Display
5. editor liveview of single Image Inspection Display
6. NGG Smart Image Search Setting Page
7. Searchbox Configuration Panels
8. legacy searchbox widget
9. legacy shortcode default parameter settings for logged-in users
10. legacy shortcode default parameter settings for public users

== Changelog ==

= 4.0.0 =
Major functional and security update (2026-08-08)

* NEW: Gutenberg blocks to define searches and display result lists
* NEW: Liveview support for WordPress 6.3+ and 7
* NEW: Advanced Mosaic display with fancybox viewer
* NEW: Image inspection display
* NEW: security checks supported by anthrophic opus 5
* Updated: Fancybox updated to 6.1.14
* Updated: Fancybox code loaded dynamically only when needed
* Updated: Exiftool updated to 13.57
* Updated: More customization for Advanced Thumbnails
* Updated: Many minor optimizations

= 3.4.3 =
Security update (2025-06-17)

* Fixed: SQL injection vulnerability in hidden browser parameter
* Fixed: HTML formatting issues for paged search results

= 3.4.1 =
Enhancement + security (2025-05-04)

* NEW: Exiftool integration for EXIF display
* NEW: Extended display types lix and atx
* Updated: Default display changed to linked-images
* Fixed: Security issue with unsanitized shortcode parameter

= 3.3.3 =
Error fix (2025-02-03)

* Fixed: Thumbnail and filename addresses incorrect with redirection

= 3.3.2 =
Enhancement + security (2025-02-02)

* NEW: URL parameter `?sngg=`
* NEW: Search variable `a:{album-id}`
* NEW: Search variable `u:{user-id}`
* Updated: Fancybox 5.0 included locally
* Fixed: Security issue with unsanitized shortcode parameter

= 3.2.1 =
Error fix (2024-02-27)

* Fixed: Widget parameters not passed correctly

= 3.2.0 =
Maintenance update (2024-02-24)

* Enhanced: Advanced thumbnail and linked image display
* Enhanced: Wrapper for shortcode searchbox
* Fixed: Modernizr.Canvas removed
* Fixed: Searchbox crash with wptexturize
* Fixed: NextGEN thumbnail name changes
* Fixed: Minor PHP warnings
* Remarks: Searchbox styling depends heavily on theme CSS

= 3.1 =
Maintenance update (2019-04-17)

* Fixed: Javascript compatibility issues
* Fixed: Minor issues
* Remarks: Searchbox styling depends heavily on theme CSS

= 3.0 =
Major release (2018-12-11)

* NEW: Paging for search results
* NEW: Basic search mode
* NEW: Support for all NextGEN native galleries
* NEW: Support for NextGEN e-commerce
* NEW: New sort options
* NEW: Target parameter for shortcode
* Enhanced: Thumbnail and searchbox customization
* Enhanced: Settings page
* Fixed: Landing page duplication issues