Skip to content

Local AVIF plugin for WordPress. It converts JPEGs to AVIFs with a focus on quality and replaces JPEGs on the front-end of WordPress for browsers that support them. It also includes an LQIP (Low Quality Image Placeholder) feature that when on immediately shows a blurry version on the image.

License

Notifications You must be signed in to change notification settings

af1/avif-local-support

 
 

Repository files navigation

AVIF Local Support Extended

Contributors: ddegner, af1
Tags: avif, images, performance, media, optimization
Requires at least: 6.8
Tested up to: 6.9
Stable tag: 0.6.1
Requires PHP: 8.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A practical fork of AVIF Local Support focused on real-world UX, logging clarity, and compatibility improvements.

Description

AVIF Local Support Extended is a fork of the original AVIF Local Support plugin by David Degner (ddegner).

Original project

Fork project

This fork resolves two gaps in the original plugin:

  • It serves AVIF files in the Kadence Theme Gallery Block, including both thumbnails and the lightbox.
  • It scans the WordPress uploads/ directory directly, not just the Media Library, to find images to convert. This is more reliable because it converts files that are not registered in the Media Library, including the additional image sizes generated by Kadence galleries.

As a quality-of-life improvement, I also reformatted the logs area to make them easier to read and skim.

Credit

This plugin is based on the original AVIF Local Support by:

All core AVIF conversion architecture and original plugin foundation are credited to the original author.

Why This Fork Exists

The fork was created to solve practical issues discovered during real usage:

  1. Better operational visibility
    Conversion logs were hard to scan quickly when processing many files.

  2. Clearer conversion context
    Thumbnail conversions can be confusing if source/target naming and size comparisons are not explicit.

  3. Safer compatibility behavior
    Real sites often combine multiple image/gallery/lazy-load systems.

  4. Workflow-friendly administration
    UX changes were made to reduce friction when reviewing results and identifying files that still need conversion.

Main Changes In This Fork

  • Plugin identity updated to AVIF Local Support Extended.
  • Logging UX enhancements for easier scanning and troubleshooting.
  • Clearer per-entry conversion metadata in logs.
  • Better visibility into files without AVIF.
  • Compatibility-oriented adjustments for gallery/lazy-load edge cases.
  • Multiple admin/tooling refinements for production use.

License

This fork remains licensed under the GNU General Public License v2 or later (GPLv2+), same as the original project.

Installation

  1. Upload this plugin to /wp-content/plugins/avif-local-support.
  2. Activate it from WordPress admin.
  3. Open plugin settings/tools to configure conversion behavior.

Changelog

0.6.1

  • Rebranded fork as AVIF Local Support Extended.
  • Added fork-oriented documentation and attribution.
  • Maintained GPLv2+ license and original credit.

About

Local AVIF plugin for WordPress. It converts JPEGs to AVIFs with a focus on quality and replaces JPEGs on the front-end of WordPress for browsers that support them. It also includes an LQIP (Low Quality Image Placeholder) feature that when on immediately shows a blurry version on the image.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages

  • PHP 79.1%
  • JavaScript 18.9%
  • CSS 2.0%