Selective Thumbnail Regenerator
| 开发者 | rberet |
|---|---|
| 更新时间 | 2026年8月3日 18:05 |
| PHP版本: | 7.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
The Selective Thumbnail Regenerator plugin provides a powerful and user-friendly way to regenerate image thumbnails for WordPress media libraries. Unlike other thumbnail regeneration plugins that blindly process the entire library, this plugin gives you precise control: choose a specific year, month, and even a title keyword to target exactly the images you need.
Key Features
- Date & Title Filters - Choose a specific year, month, or search by title to target only the images you need.
- Month Status Calendar - Green months are verified full-month, all-size runs with no failures. Legacy records are retained in amber because their scope cannot be verified.
- Regeneration History Tracking - Bounded job summaries store exact filters, selected sizes, counts, and completion status. A "Reset History" button clears all records when needed.
- Thumbnail Size Selection - Choose specific registered thumbnail sizes to regenerate instead of all sizes.
- Configurable Batch Size - Set how many images are processed per AJAX request (1-20).
- Throttle Delay Control - Set a cooldown pause between batches (0-2000 ms) to reduce server load.
- Dry Run Mode - Verify that matching sources exist, are readable, and can be opened without writing changes.
- Stable Server Jobs - User-scoped transient jobs use a fixed upper attachment ID and ID cursor to avoid duplicate or endless offset processing.
- Reload Recovery - Reopen the plugin page within 24 hours to resume an unfinished job from its last per-image checkpoint or cancel it safely.
- Smart Regeneration - Paginated preflight analysis finds missing, dimensionally incorrect, and stale sizes, estimates output size, and regenerates only that subset.
- Automatic Batch Failure Recovery - Progress is checkpointed before every image. Interrupted jobs retry one image at a time and continue safely.
- Failed Images Log - Detailed table of all failed images including ID, title, and exact failure reason.
- Safe Orphaned File Cleanup - Obsolete thumbnails are deleted only after replacement files and metadata are saved successfully.
- Live Terminal Activity Log - Real-time monospace console with timestamped status messages.
- Visual Completion Metrics - Five-card summary board: Processed, Successful, Failed, Skipped, Duration.
- Cancel Support - Stop safely after the current server step and receive an accurate partial summary.
- Performance Optimized - Direct indexed SQL query for year selector loading.
安装:
- Download the plugin ZIP file.
- Log in to your WordPress admin panel.
- Go to Plugins > Add New > Upload Plugin.
- Upload the ZIP file and click "Install Now".
- Activate the plugin through the "Plugins" menu in WordPress.
常见问题:
Why would I need to regenerate thumbnails?
You might need to regenerate thumbnails if:
- You've changed your theme and it uses different thumbnail sizes
- You've modified thumbnail sizes in WordPress settings
- You've installed a plugin that adds new thumbnail sizes
- Your thumbnails are corrupted or missing
Will this plugin delete my original images?
No. The plugin only regenerates thumbnail versions. Your original uploaded images are never touched.
What does "orphaned file cleanup" mean?
When thumbnail dimensions change, old thumbnail files can remain on disk. The plugin compares old and newly saved metadata, then deletes only files that are no longer referenced. Existing files remain intact if generation or metadata saving fails.
What happens if an image file is missing from the server?
The plugin detects the missing file, marks it as failed in the log, and moves on. The entire regeneration process never stops because of a single missing file.
What happens if a server error occurs mid-batch?
The plugin automatically enters single-retry mode: it re-processes each image in the failed batch individually. The image causing the crash is identified, logged in the Failed Images report, and skipped so the rest complete successfully.
How does Dry Run Mode work?
When Dry Run is enabled, the plugin checks that every matching source exists, is readable, and can be opened by a WordPress image editor. It writes no thumbnail changes and never marks a calendar month complete.
What is the Month Status Calendar?
It is a 4×3 grid of month buttons beneath the date filter. A month turns green only after an unfiltered, all-size run finishes without failures or skips. Older records appear in amber because their scope was not recorded.
Can I cancel the process?
Yes. Click the "Cancel Process" button. The active server step completes safely, then the process stops and shows a partial summary.
What happens if I close the browser during regeneration?
The browser processing loop pauses. Reopen the plugin page within 24 hours and use "Resume Job" to continue from the last per-image checkpoint, or cancel the saved job. Completed work remains applied.
What does Smart Regeneration check?
For each matching source image, Smart Regeneration compares active WordPress image sizes with saved metadata and files. It selects sizes whose file is missing, whose saved dimensions differ from the currently registered dimensions, or whose file is older than the source image. The preflight estimate is approximate and represents expected generated output, not guaranteed net disk growth.
更新日志:
1.1.2
- Compatibility: Pass prepared-query replacements as individual arguments so WordPress Plugin Check can validate all placeholders.
- Compatibility: Refactored attachment database reads into fixed prepared queries accepted by WordPress Plugin Check.
- Security: Switched AJAX nonce validation to the standard check_ajax_referer() flow and documented verified request reads.
- Internationalization: Added translator context for every localized string containing replacement placeholders.
- Feature: Detect and resume unfinished user jobs after the plugin page is reopened.
- Feature: Added a safe saved-job cancellation path and refreshed active-job expiry on every checkpoint.
- Feature: Added paginated Smart Regeneration preflight for missing, dimensionally incorrect, and stale thumbnail sizes.
- Feature: Added affected-image, thumbnail-count, and estimated-output-size metrics before regeneration.
- Performance: Smart mode regenerates only the sizes identified by a fresh per-image analysis.
- Cleanup: Uninstall now removes active-job and Smart-scan transient records in addition to job history and locks.
- Reliability: Replaced full-library offset scans with user-scoped transient jobs, stable ID cursors, immutable upper ID bounds, and per-image checkpoints.
- Data Safety: Generate and save replacement metadata before deleting obsolete thumbnails; preserve existing references for failed sizes.
- History Accuracy: Added versioned job history and verified calendar rules. Legacy completion flags remain visible as unverified amber records.
- Security: Removed dynamic HTML insertion for attachment titles and server messages in the admin interface.
- Bug Fixes: Fixed 0 ms throttle, title-only search, misleading success summaries, dry-run source checks, and safe cancellation behavior.
- Accessibility: Added native month and collapse buttons, focus states, ARIA expansion/selection states, a live progress status, and an activity log.
- Internationalization: Moved client-visible status and error text into localized WordPress strings.
- Critical Fix: Fixed fatal AJAX error by conditionally loading wp-admin/includes/image.php before calling wp_generate_attachment_metadata().
- Performance Fix: Replaced PHP loop-based year extraction with a single fast $wpdb SQL query.
- Bug Fix: Allow thumbnail generation for attachments with missing or corrupt database metadata (empty-array fallback instead of error).
- Cleanup: Implemented physical deletion of orphaned thumbnail files from disk before regeneration.
- Feature: Month Status Calendar - visual 4x3 grid showing regenerated months per year, persisted in the database with Reset History support.
- Feature: Regeneration History Tracking stored in wp_options, persists across sessions.
- Feature: Image title search filter for targeting images by name.
- Feature: Dry Run Mode - preview processing without writing to disk.
- Feature: Configurable Batch Size slider (1-20 images per request).
- Feature: Configurable Throttle Delay slider (0-2000 ms cooldown between batches).
- Feature: Automatic batch failure recovery - retries each image individually when a batch crashes, then continues.
- Feature: Failed Images Log - detailed table showing ID, title, and exact error for every failed image.
- Feature: Cache busting on "Scan Matching Images" to always return fresh counts.
- Redesign: Full UI overhaul - Inter font, card-based responsive layout, custom progress bar, live terminal console, metrics board.
- Feature: Thumbnail size selection - choose which specific sizes to regenerate
- Feature: Cancel button - stop the regeneration process at any time
- Feature: Batch processing - process multiple images per AJAX request for faster regeneration
- Feature: Summary report - view success/failure counts and elapsed time after completion
- Improved: Updated FAQ with new feature documentation
- Security: Added capability checks to AJAX handlers for improved security
- Removed unnecessary plugin assets
- Removed empty languages folder and Domain Path header
- Code structure improvements
- Security: Added ABSPATH protection to prevent direct file access
- Compatibility: Updated "Tested up to" value to WordPress 6.8
- Code Standards: Changed all prefixes from 'str' to 'strgrtr' for uniqueness
- Updated main class name to STRGRTR_Thumbnail_Regenerator
- Fixed contributor username in readme
- Updated all JS/CSS/HTML elements to use consistent prefixes
- Initial release