Snopix
| 开发者 |
SH4LIN
akrocks vishalkakadiya |
|---|---|
| 更新时间 | 2026年6月2日 15:32 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- 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
- 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.
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.
安装:
- 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.
[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.屏幕截图:
常见问题:
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.
Does it work on WordPress multisite?
Snopix is built for single-site installs. It creates one
{prefix}snopix_index table per site and is not network-activation aware, so
activate it on each site individually rather than network-wide.
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_index and removes all plugin options and
transients; disable it first if you want the index to survive a reinstall.
更新日志:
- Fixed: removed
readonlyproperties that broke activation on PHP 8.0 (the declared minimum version). - Changed: per-IP search rate limiting now uses an atomic counter when a persistent object cache is present, and fails closed when the client IP cannot be resolved.
- Fixed: bulk indexing no longer stalls when a run of unsupported image types (SVG/AVIF/TIFF/HEIC) is queued — they are skipped at enqueue time.
- Fixed: the daily duplicate scan no longer restarts an in-progress scan, and a failed scan tick recovers instead of appearing to run forever.
- Fixed: deleting a non-existent index row now returns 404; plus minor admin-UI memory and dead-code cleanups.
- Changed: the dashboard "Indexed" count is now shown in green, with status colours centralised as reusable design tokens.
- 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.
- 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.