Advanced Responsive Images
WordPress plugin to implement responsive images with picturefill
by Alexandre Sadowski · github.com/asadowski10/advanced-responsive-images · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/asadowski10/advanced-responsive-images/archive/refs/heads/master.zipDescription
WordPress plugin that outputs custom HTML for responsive images (for example <picture> with lazy loading), driven by your theme configuration and pluggable rendering modes.
Features
- Choose how images are rendered on the front end (modes such as picture + lazy load).
- Register custom providers and templates for your own markup.
- Integrates with
wp_get_attachment_image()using adata-locationattribute and JSON location definitions under your theme’sassets/conf-img/path (orARI_JSON_DIR).
I cannot guarantee free ad hoc support. Please be patient; I maintain this project alone.
Installation
Requirements
- WordPress 5.6 or higher (uses APIs aligned with modern responsive image handling).
- PHP 8.0 or higher (see
ARI_MIN_PHP_VERSIONin the main plugin file).
From the WordPress admin
Install and activate the plugin from Plugins → Add New if you use a distribution package, or upload the ZIP under Plugins → Add New → Upload Plugin.
Manual upload
- Unpack the download package.
- Upload the folder to
/wp-content/plugins/. - Activate Advanced Responsive Images under Plugins.
With Composer
From your project root (for example a Composer-managed WordPress setup):
composer require asadowski10/advanced-responsive-images
Optional packages (see composer.json):
- WP Thumb — image resizing, cropping, and caching.
- BEA WP Thumb — reduce default WordPress image generation on upload.
Configuration
- Default mode is
picture_lazyload(override with theARI_MODEconstant). - Default JSON config directory is
get_template_directory() . '/assets/conf-img/'(override withARI_JSON_DIR).
See the changelog for release notes and breaking changes.
Repository
- Source: github.com/asadowski10/advanced-responsive-images
- Issues: github.com/asadowski10/advanced-responsive-images/issues
Translate Advanced Responsive Images
If you want to contribute a translation, you can open a pull request with the translation files. Please read the contributing guidelines first.
License
Copyright (c) 2017–2026 Alexandre Sadowski
This code is licensed under the MIT License.