Descripción
Snopix adds reverse-image search to the WordPress media library. Upload
an image (or drop one onto the dashboard widget) and the plugin returns the
visually most similar attachments you already have indexed, ranked by a
composite score over three fingerprints:
- A 64-bit perceptual hash (pHash) over a DCT of the greyscale thumbnail
- A 48-element RGB colour histogram
- A 32-element Sobel edge-orientation histogram
The same fingerprints power the Duplicates tab, which clusters
near-identical attachments so you can keep one and bulk-delete the rest.
Features
- Reverse-image search via the admin dashboard or a
[snopix_search]shortcode for
the front end. - Block-editor panel on the core Shortcode block for inserting and editing the
[snopix_search] widget (variant, title, result cap). - Duplicate detection with per-group “keep” selection and bulk delete.
- Background bulk indexing via WP-Cron — no PHP timeouts on large libraries.
- REST API at
/wp-json/snopix/v1/with rate limiting on the public search
endpoint. - Settings panel: search visibility, rate limit, match and duplicate
thresholds, indexer batch size, and probe downscale ceiling. - Setting to keep or drop the index when the plugin is uninstalled.
- Tools panel: reindex everything, clear the index, delete orphan rows,
flush caches. - Pre-downscale of large probe images before fingerprinting to keep search
latency bounded.
Supported MIME types
image/jpeg, `image/png`, `image/gif`, `image/webp`, `image/bmp`.
Where data lives
Snopix creates a single custom table, {prefix}snopix_index, that stores one
row per indexed attachment with its three fingerprints. Uninstalling the
plugin drops the table unless you disable Drop data on uninstall in
settings.
Accuracy notice
Snopix is functional, but search ranking, duplicate detection and the
threshold tuning may be less accurate than expected – you may see occasional
false positives or miss visually-similar images depending on your media
library. Please report anything that looks off.
Instalación
- Upload the
snopixfolder to/wp-content/plugins/(or install the
zip via Plugins Add New Upload Plugin). - Activate the plugin in Plugins.
- Go to Media Snopix and click Index Remaining to fingerprint
any attachments already in your library. This runs in the background via
WP-Cron. - Once at least a handful of images are indexed, drop an image onto the
Search by Image panel to test reverse-image search.
Front-end shortcode
Add the search widget to any post or page with:
[snopix_search]
Optional attributes: variant (card, inline, or narrow; default
card), title (header label; default “Search by image”), and max_results
(1-48; default 12). For example:
[snopix_search variant="inline" max_results="24"]
The block editor also exposes these options via a Snopix Search panel on
the core Shortcode block.
By default the endpoint is open to anyone. Restrict it to logged-in users
from the Settings tab in Media Snopix.
FAQ
-
What image formats are supported?
-
JPEG, PNG, GIF, WebP, and BMP. Other types (SVG, HEIC, AVIF) are rejected at
upload time by the indexer and again at the search endpoint. -
How big can my media library be?
-
The fingerprint table stores one compact row per attachment, so the storage
cost is small. Indexing scales linearly with the number of attachments. The
bulk indexer runs in chained WP-Cron batches so it does not time out, but
indexing a very large library (10k+) will take many minutes. -
Does it work with images stored on S3 / a CDN?
-
The indexer needs to read raw bytes via PHP-GD. If your offload plugin keeps
a local copy until indexing is complete, you are fine. If files are removed
from the local filesystem before the indexer runs, those attachments will be
skipped. -
How accurate is the search?
-
The composite score combines pHash + colour + edge histograms with weights
0.40 / 0.35 / 0.25. In our internal test matrix, format conversions,
resizing, and JPEG re-compression are recovered with > 0.95 similarity.
Heavy Gaussian blur, extreme downscale (sub-128 px), and noise-corrupted
images sit closer to the 0.85 threshold and may not always rank first.
Tuning is ongoing. -
How is duplicate detection different from search?
-
Both rely on the same fingerprints. Search returns ranked matches for an
arbitrary probe image; duplicate detection clusters indexed images among
themselves and surfaces every group with two or more visually-identical
members. -
How do I uninstall cleanly?
-
Deactivate, then delete the plugin from the Plugins screen. When the
Drop data on uninstall setting is enabled (the default), the uninstall
hook drops{prefix}snopix_indexand removes all plugin options and
transients; disable it first if you want the index to survive a reinstall.
Reseñas
No hay reseñas para este plugin.
Colaboradores y desarrolladores
«Snopix» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
0.1.1
- Fixed: certain extreme aspect-ratio images could trigger a fatal error during indexing; working dimensions are now clamped.
- Changed: index vector columns now use LONGTEXT instead of JSON for compatibility with older MySQL / MariaDB.
- Fixed: capitalised indexed-image status labels and corrected spacing on the duplicate “Keep” badge.
- Removed: the non-functional Plugins-screen delete-confirmation modal and its “require confirmation” setting. The keep / drop-on-uninstall setting is unchanged.
0.1.0
- Initial release.
- Perceptual hash + colour histogram + edge histogram fingerprinting.
- Reverse-image search via admin dropzone and
[snopix_search]shortcode. - Block-editor panel for inserting and configuring the search shortcode.
- Duplicate detection with per-group keep selection.
- WP-Cron bulk indexing, rate-limited public search endpoint.
- Configurable thresholds, rate limit, and batch size, plus a keep or
drop-on-uninstall choice. - WordPress.org compatibility: JPEG, PNG, GIF, WebP, BMP.