AVIF Local Support
| 开发者 | ddegner |
|---|---|
| 更新时间 | 2026年10月22日 10:59 |
| PHP版本: | 8.3 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
标签
下载
0.2.5
0.2.6
0.2.8
0.2.9
0.8.0
0.2.7
0.5.4
0.5.9
0.1.6
0.5.10
0.5.13
0.5.14
0.5.15
0.5.5
0.5.16
0.5.17
0.5.18
0.5.11
0.5.19
0.6.1
0.6.2
0.5.20
0.3.0
0.2.1
0.2.2
0.2.3
0.1.3
0.2.4
0.4.2
0.4.5
0.4.6
0.4.7
0.4.8
0.4.9
0.1.7
0.5.0
0.5.21
0.5.22
0.5.6
0.5.23
0.5.3
0.5.8
0.5.7
0.6.0
0.1.5
0.5.1
0.6.3
0.6.4
0.7.0
详情介绍:
Built by a Boston photographer for site owners who care about visual quality and full control. This plugin prioritizes image quality over everything else — no subscriptions, no external services.
安装:
- Upload to
/wp-content/plugins/avif-local-supportor install via Plugins → Add New - Activate the plugin
- Navigate to Settings → AVIF Local Support
- PHP: 8.3 or later
- WordPress: 6.8 or later
- Recommended: Imagick extension with AVIF-enabled ImageMagick
屏幕截图:
常见问题:
Does this modify my original JPEGs?
No. AVIF files are created alongside your existing images. Your originals remain untouched.
Will this slow down uploads?
If "Convert on upload" is enabled, uploads may take slightly longer. You can disable this and use scheduled background conversion instead.
Do I need Imagick?
Recommended but not required. Imagick provides the best quality and preserves metadata/color profiles. The plugin falls back to GD if unavailable.
Does it track users or send data externally?
No. Zero tracking, zero external calls. Everything runs locally.
Why do I see "High risk of memory exhaustion"?
The plugin estimates memory before processing to prevent crashes. Try switching to "ImageMagick CLI" engine, increasing PHP memory_limit, or checking "Disable memory check" in settings.
AVIF conversions produce empty files on LiteSpeed?
This is caused by libheif 1.12.0 crashing in LiteSpeed's restricted environment. Upgrade libheif to 1.15+ to fix. See the WordPress.org FAQ for build instructions.
ImageMagick CLI not detected on LiteSpeed/CyberPanel?
LiteSpeed's open_basedir restriction prevents PHP from detecting executables outside allowed paths. The binary may still work — try setting the path manually in settings.
更新日志:
0.8.2
- Enhancement: The existing full-image fade setting now uses a 180ms opacity crossfade only for eligible images initially below the viewport; first-screen, high-priority, and already loaded images appear normally.
- Fix: Keep the ThumbHash visible through image decoding and the actual transition, with safe cleanup for cached images, errors, responsive source changes, and reduced-motion preferences.
- Fix: Preserve saved fade settings and authored picture styles, keep pixelated placeholders from affecting photograph rendering, and retain compatibility with independent image-loading buffers.
- Tests: Added Chromium and WebKit coverage at desktop and mobile sizes for loading races, visual transitions, and unchanged image delivery and layout.
- Fix: Preserve WebP and other non-JPEG files when deleting companion AVIFs, and isolate playground previews so existing media cannot be overwritten.
- Fix: Support WordPress's three-argument image-quality filter, final responsive image attributes, cropped galleries, and native lightbox controls.
- Fix: Keep CSS background media queries, gradients, multiple layers, and stylesheet ordering intact, including pages whose backgrounds appear only in linked CSS.
- Fix: Preserve custom thumbnail crops, accept valid compact AVIF files, and apply PHP memory limits only to encoders running inside PHP.
- Fix: Preserve resumable job progress across delayed cron runs, cancel queued LQIP generation on deletion, and prevent active workers from restoring deleted placeholders.
- Fix: Preserve the file-cache lifetime when saving settings, avoid unused playground conversions, respect disabled AVIF delivery, generate accurate palette-image placeholders, and honor LQIP CLI
--force. - Fix: Avoid deprecated GD cleanup calls on PHP 8.5.
- Tests: Added portable regression suites and disposable WordPress integration coverage; see the GitHub test documentation.
- Enhancement: Setting explanations are now always visible below each field instead of hidden in hover-only "?" tooltips, making them accessible to keyboard and touch users.
- Enhancement: Redesigned the Logs panel — each entry is a compact one-line summary (engine, duration, size change) that expands for full details, with accessible status colors and no more scroll trapping.
- Enhancement: Destructive buttons (Delete All AVIF Files, Delete All LQIPs, Clear Logs, Reset All Plugin Settings) now use red styling, and confirmation dialogs show how many items will be affected.
- Change: The negated "Disable memory safety check" setting is now a positive "Check available memory before each conversion" (new
aviflosu_memory_checkoption); existing settings migrate automatically. - Enhancement: Clearer Tools tab — sections scoped as "AVIF Tools: Media Library" and "AVIF Tools: Uploads Folder", the diagnostics panel renamed to "Server Diagnostics", and engine statuses now read "Will be tried" / "Not used" instead of "Attempting" / "Skipped".
- Enhancement: Unified interface copy — consistent generate/convert verbs, "JPEG" naming, sentence-case labels, typographic dashes and arrows, and count-aware confirmation strings.
- Enhancement: The Settings Playground loads the preview automatically when a JPEG is selected, and tabs announce the active state to assistive technology.
- Fix: Corrected the documented encoding speed range from 0–10 to the actual 0–8.
- Fix: A warning notice pointed to the removed "Upload Test" tool; it now points to the AVIF Settings Playground.
- Fix: LQIP (ThumbHash) placeholders were decoded at the wrong aspect ratio and rendered as distorted slivers; placeholders now match each image's shape.
- Fix: LQIP placeholders no longer stay hidden for images that are not wrapped in a
<picture>element. - Fix: Failed conversions no longer leave tiny invalid
.aviffiles that could be served to visitors and were never regenerated; such files are now cleaned up and reconverted. - Fix: "Delete All AVIF" no longer erases LQIP placeholder data, which is managed independently.
- Fix: LQIP generation now succeeds for attachments with missing or broken metadata by falling back to the original file.
- Enhancement: Bulk AVIF conversion and LQIP generation now run as resumable, time-sliced background jobs, preventing request timeouts and cron stalls on large media libraries.
- Enhancement: Removed a database write that occurred on every front-end request from the AVIF file-existence cache.
- Enhancement: Unified the Tools interface — consistent progress indicators that end on a completion checkmark, clearer status messages, and accurate stopped/queued states for scans.
- Enhancement: Renamed settings tabs to "AVIF Settings" and "LQIP Settings" and removed redundant in-tab headings.
- Chore: Made filesystem-scan status messages translatable and removed an unused bundled admin script.
- Feature: Added a filesystem scanner for JPEGs under uploads that are not represented in the Media Library, including WP-CLI and admin Tools support.
- Enhancement: Added WordPress AVIF compatibility diagnostics to
wp avif status --format=jsonand Site Health debug data. - Chore: Confirmed WordPress 7.0 compatibility and hardened production package exclusions for development metadata.
- Fix: Lightbox/slideshow links now correctly rewrite from JPEG to AVIF when the image was already wrapped in a
<picture>element by another plugin (e.g. photo-collage). Previously the<a>href rewriting was skipped for images inside<picture>, causing lightboxes to load full-size JPEGs instead of AVIFs.
- Chore: Added a commit-based beta build workflow that publishes prerelease ZIPs to GitHub Releases.
- Chore: Kept stable release builds tag-based and guarded WordPress.org deploy so
beta-*tags are ignored.
- Fix: Clear Logs now reliably clears stored logs and prevents stale long-running processes from repopulating old entries.
- Enhancement: Logs panel now refreshes from server state after clearing, so UI always matches stored data.
- Enhancement: Clear Logs button is temporarily disabled while the clear request is in progress to prevent duplicate requests.
- Chore: Uninstall now removes the logs-generation option used by the clear-logs protection.
- Fix: Removed redundant on-upload AVIF conversion hook path to avoid duplicate work and keep upload conversion predictable.
- Fix: Improved daily scheduling behavior so overdue events run instead of being pushed to tomorrow, and on-demand AVIF scans always run regardless of schedule toggle state.
- Feature: Added stop control for bulk LQIP generation (REST endpoint + transient stop signal + admin status updates).
- Enhancement: Standardized admin LQIP wording and labels, including a short LQIP explanation at the top of the LQIP tab.
- Fix: Uninstall now clears LQIP stop transient and uses
delete_post_meta_by_key()for ThumbHash metadata cleanup. - Chore: Plugin Check hardening for release by excluding non-distribution files from check scope and clearing stray
.DS_Storefiles.
- Feature: Added an AVIF Settings Playground for real JPEG/AVIF preview comparisons and one-click apply of tested settings.
- Feature: Expanded Tools with dedicated LQIP bulk generation/deletion controls and progress/status feedback.
- Enhancement: Refreshed admin UX across tabs (clearer labels, advanced sections, improved diagnostics and logs layout).
- Enhancement: Updated WordPress.org screenshots to match the current AVIF, Placeholders, Tools, and About screens.
- Fix: Plugin Check hardening for release by escaping help-tip output safely and using
wp_delete_file()in preview cleanup paths.
- Fix: AVIF Delete All now removes only plugin companion AVIF files for JPEG attachments, preventing deletion of user-uploaded AVIF originals.
- Fix: CSS background AVIF overrides now keep a JPEG fallback and use
image-set(...)so non-AVIF browsers still render backgrounds. - Fix: ThumbHash decoder aspect-ratio extraction corrected (
h16 & 7) to match the upstream reference implementation. - Fix: Restore defaults now resets background-image and all LQIP settings in addition to core AVIF settings.
- Fix: Corrected malformed HTML in the Tools diagnostics table around the schedule-time display.
- Fix: Clarified Tools count labels to match scope: AVIF now shows file-level totals as "JPEG Files" (originals + generated sizes), and LQIP shows attachment-level totals as "Media Items" (plus clearer "Without AVIF/LQIP" and "AVIF files" progress wording).
- Enhancement: ThumbHash input increased to 100px for richer LQIP placeholders.
- Fix: AVIF srcset now correctly lists all responsive sizes by running after WordPress adds srcset attributes.
- Fix: Single AVIF images now include width descriptors for proper responsive selection.
- Refactor: Removed redundant
render_blockfilter; unified image processing inthe_contentfilter.
- Fix: Instant reveal now waits for
img.decode()to prevent white flash on fast-loading images.
- Refactor: Simplified LQIP fade transition — removed blur filter and scale animation.
- Fix: Eliminated white flash during LQIP-to-image transition by ensuring image is fully visible before removing placeholder.
- Fix: Fast-loading images now appear instantly without the 400ms fade delay.
- Cleanup: Removed unused per-image load duration tracking.
- Feature: LQIP Generate All now shows real-time progress counter, status text, and stop button.
- Feature: Unified spinner/status UI for both AVIF and LQIP tools panels.
- Fix: "AVIF conversion available" badge now correctly shows "Yes" when engines report support.
- Fix: AVIF Delete All button now correctly re-enables Generate All button after completion.
- Fix: LQIP background now correctly clears for already-loaded/cached images.
- Feature: Restored LQIP background cleanup after image load.
- Feature: Added "Pixelated placeholders" option to display ThumbHash as sharp pixels.
- Enhancement: Improved LQIP transition — blur-up effect with scale animation.
- Change: Transition updated to 400ms ease-out for smoother reveal.
- Enhancement: Tuned LQIP fade thresholds based on human perception research.
- Change: Page load window increased to 2 seconds (covers initial render).
- Change: Individual load duration increased to 200ms (perception threshold).
- Fix: WordPress Plugin Check compliance — proper escaping for inline scripts/styles.
- Fix: Replace
strip_tags()withwp_strip_all_tags()in BackgroundImages. - Fix: Prefix global variables with plugin prefix.
- Chore: Remove
.DS_Storefiles from repository.
- Refactor: Simplified LQIP fade logic by removing background cleanup step.
- Feature: LQIP operations now log successes, failures, and summaries to the Logs panel.
- Fix: LQIP stats now correctly validate metadata structure, matching generation skip logic.
- Fix: Add object cache clearing before LQIP generation to prevent stale data on servers with persistent caching.
- Fix: Prevent false positive \"success\" reports in
wp lqip generatewhen generation fails silently but stale data exists. - Fix: Remove deprecated
imagedestroy()calls for PHP 8.0+ compatibility. - Refactor: Consolidate LQIP generation logic into shared helper for consistency between Admin UI and CLI.
- Fix: Critical fix for
wp lqip generate --forceoption. - Fix:
wp lqip delete --allnow correctly clears object cache to prevent stale stats.
- Feature: Added
--forceoption towp lqip generatecommand to force regeneration of LQIPs.
- Fix: Resolved "Insufficient memory" error when generating LQIP for high-resolution images by optimizing ImageMagick loading.
- Feature: CSS background image AVIF support — replaces JPEG background images with AVIF versions. Thanks to David C.
- Feature: Works with page builders (Elementor, Divi, Beaver Builder, WPBakery, Bricks, etc.)
- Feature: New setting "Serve AVIF for CSS backgrounds" under AVIF serving options
- Fix: Versioned image URLs (e.g.,
image.jpg?ver=123) now correctly detected and replaced - Fix: Query string stripping for CSS file path resolution
- Security: Sanitize CSS selectors to prevent XSS injection
- Enhancement: Smart fade logic — only apply fade transition for slow-loading images
- Enhancement: Images loading within 1 second of page load display instantly (no fade)
- Enhancement: Cached/fast-loading images skip fade for snappier feel
- Feature: Added "Fade in images" option to smoothly transition from LQIP to full image
- Fix: Used img.decode() to prevent white flash during LQIP fade transition
- Fix: CSS selector now correctly handles both picture wrapper and standalone img cases
- Feature: Added optional smooth fade-in for LQIP images
- Translations: Added German, Italian, Japanese, Portuguese (Brazil), and Russian translations
- Enhancement: Updated translations for Spanish, French, Hindi, and Chinese
- Fix:
wp lqip generate --allnow correctly processes all eligible images - Fix:
wp lqip statsaccurately counts all supported image types - Fix: LQIP JavaScript is now correctly excluded when feature is disabled
- Fix: Improved error logging for LQIP generation failures
- Fix: Added missing LQIP options to plugin activation (thumbhash_size, generate_on_upload, generate_via_schedule)
- Fix: Added missing LQIP options to uninstall cleanup for complete data removal
- Fix: Properly minified thumbhash-decoder.min.js (62% size reduction)
- Fix: Excluded developer documentation from WordPress plugin distribution
- Feature: Bundled ThumbHash library — no Composer dependency required on deployment
- Enhancement: Improved LQIP generation with better error handling, progress reporting, and memory management
- Enhancement: Added
--limitand--verboseoptions towp lqip generatecommand - Fix: Resolved hanging issue in
wp lqip generate --allcommand with better error handling and progress output - Fix: Clear error messages when ThumbHash library is unavailable
- Fix: Improved error handling and logging for ThumbHash generation
- Enhancement: WP-CLI now warns if LQIP feature is disabled in settings
- Enhancement: Better diagnostics for missing source files during LQIP generation
- Feature: LQIP (Low Quality Image Placeholder) using ThumbHash for smooth image loading
- Feature: WP-CLI commands for LQIP management (
wp lqip stats,wp lqip generate,wp lqip delete) - Feature: Dedicated LQIP settings tab with enable/disable toggle
- Enhancement: Reorganized admin UI with combined AVIF Tools section
- Enhancement: Consistent stat labels across AVIF and LQIP tools (Images/With/Without)
- Enhancement: Renamed "Test conversion" to "Test AVIF Conversion" for clarity
- Enhancement: Removed beta labels from LQIP feature
- Fix: LQIP stats now correctly count all supported image types (JPEG, PNG, GIF, WebP)
- Dev: Auto-fixed 6,152+ PHPCS issues for WordPress coding standards compliance
- Fix: WordPress Plugin Check compliance — proper escaping, Yoda conditions, and PHPCS ignores
- Fix: Improved uninstall cleanup with object cache awareness
- Dev: Code formatting aligned with WordPress coding standards
- Fix: Resolved logging pipeline issues where REST API couldn't retrieve logs due to
is_admin()check - Fix: Fixed upload test timeout by temporarily disabling synchronous AVIF conversion during test uploads
- Fix: Improved AJAX feedback for log operations (clear/refresh)
- Docs: Updated minimum requirements to WordPress 6.8 and PHP 8.3
- Docs: Cleaned up README header format for WordPress.org compatibility
- Docs: Removed donate link from readme
- Dev: Added WordPress stubs for improved IDE support
- Enhancement: Improved time formatting in conversion progress display (hh:mm:ss format)
- Enhancement: CLI code formatting improvements
- Fix: Corrected contributor username in readme
- Docs: Added WordPress.org metadata headers
- Docs: Updated tested up to WordPress 6.9
- Fix: Corrected "Upload & Test" status display issues (spinner visibility, status text alignment)
- Fix:
wp avif deletecommand now correctly reports success/failure counts and handles permission errors - Fix:
wp avif convertcommand output now includes count of missing AVIFs - Enhancement: Added GitHub Action for automated release creation
- Feature: Fully asynchronous "Upload & Test" conversion to prevent timeouts on large images
- Enhancement: Re-architected test conversion to use sequential polling
- Enhancement: Admin UI modularized with template-based architecture
- Optimization: Removed unused
vendorstorage and legacy dependencies, reducing plugin size - Fix: Restored robust queue rendering for test results
- Added WP-CLI commands: status, convert, stats, logs, delete
- Refactored admin interface with modular architecture
- Improved logging and environment diagnostics
- Auto-detection for ImageMagick CLI in "Auto" mode
- REST API replaces admin-ajax for better performance
- Smart -define namespace probing (heic/avif)
- Tested with WordPress 6.9
- Compatibility: Tested up to WordPress 6.9
- Major refactor: strict types, DTOs, dedicated Encoder classes
- Optimized frontend HTML parsing
- Enhanced CLI execution and error handling
- Composer support (PSR-4 ready)
- Environment variable injection for restricted PHP environments
- Original image source handling fixes
- Engine priority: CLI, Imagick, GD
- ImageMagick CLI support with auto-detection
- Memory pre-check to prevent fatal errors
- Logs panel with detailed entries
- Lightbox anchor rewriting
- Chroma subsampling and bit depth options
- Initial release with Imagick/GD support
- ICC profile preservation
- EXIF orientation handling
- Basic admin interface