PHPackages rsoury/wp-imgix - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Image & Media](/categories/media) 4. / 5. rsoury/wp-imgix ActiveWordpress-plugin[Image & Media](/categories/media) rsoury/wp-imgix =============== Rewrites WordPress image URLs to use ImgIX 0.12.6(5y ago)167.2k5[2 issues](https://github.com/rsoury/wp-imgix/issues)GPL-2.0PHP Since Sep 22Pushed 1y ago2 watchersCompare [ Source](https://github.com/rsoury/wp-imgix)[ Packagist](https://packagist.org/packages/rsoury/wp-imgix)[ RSS](/packages/rsoury-wp-imgix/feed)WikiDiscussions master Synced 3w ago READMEChangelogDependencies (2)Versions (8)Used By (0) [WP ImgIX](https://github.com/rsoury/wp-imgix) is a Wordpress Plugin to automatically load all your existing (and future) WordPress images via the imgix service for smaller, faster, and better looking images. This plugin handles modifying WordPress image URLs to use the ImgIX service. It works very well with [S3-Uploads](https://github.com/humanmade/S3-Uploads) Installation ------------ [](#installation) 1. [Download the zipped main branch of this plugin from github](https://github.com/rsoury/wp-imgix/archive/refs/heads/master.zip). 2. Extract the plugin to your `plugins` folder. 3. Enable the plugin. 4. Add `define( 'WP_IMGIX_URL', 'your.imgix.net' )` to your `wp-config.php` file. 5. If you're signing urls, Add `define( 'WP_IMGIX_SIGNING_TOKEN', 'abcdefg123456' )` to your `wp-config.php` file. Usage ----- [](#usage) Typically the above steps are all you need to do however you can use the following public facing functions and filters. ### Functions [](#functions) #### `imgix_url( string $image_url, array $args = [] )` [](#imgix_url-string-image_url-array-args---) This function returns the ImgIX URL for a given image. ``` $image_url = 'https://my-bucket.s3.us-east-1.amazonaws.com/path/to/image.jpg'; $args = [ 'x' => '300' 'y' => '300', 'fit' => 'crop' ]; $url = imgix_url( $image_url, $args ); ``` ### Filters [](#filters) The following filters allow you to modify the output and behaviour of the plugin. The filters below can be added to your theme's `functions.php` to modify the behavior of your imgix URLs. #### `imgix_disable_in_admin` [](#imgix_disable_in_admin) Defaults to `true`. ``` add_filter( 'imgix_disable_in_admin', '__return_false' ); ``` #### `imgix_override_image_downsize` [](#imgix_override_image_downsize) Defaults to `false`. Provides a way of preventing ImgIX from being applied to images retrieved from WordPress Core at the lowest level, you might use this if you wanted to use `imgix_url()` manually in specific cases. ``` add_filter( 'imgix_override_image_downsize', '__return_true' ); ``` #### `imgix_skip_for_url` [](#imgix_skip_for_url) Allows skipping the ImgIX URL for a given image URL. Defaults to `false`. ``` add_filter( 'imgix_skip_for_url', function ( $skip, $image_url, $args ) { if ( strpos( $image_url, 'original' ) !== false ) { return true; } return $skip; }, 10, 3 ); ``` #### `imgix_pre_image_url` [](#imgix_pre_image_url) Filters the ImgIX image URL excluding the query string arguments. ``` add_filter( 'imgix_pre_image_url', function ( $image_url, $args ) { if ( rand( 1, 2 ) === 2 ) { $image_url = str_replace( WP_IMGIX_URL, WP_IMGIX_URL_2, $image_url ); } return $image_url; }, 10, 2 ); ``` #### `imgix_pre_args` [](#imgix_pre_args) Filters the query string parameters appended to the imgix image URL. ``` add_filter( 'imgix_pre_args', function ( $args ) { if ( isset( $args['fit'] ) ) { $args['fill'] = 'blur'; } return $args; } ); ``` #### `imgix_remove_size_attributes` [](#imgix_remove_size_attributes) Defaults to `true`. `width` & `height` attributes on image tags are removed by default to prevent aspect ratio distortion that can happen in some unusual cases where `srcset` sizes have different aspect ratios. ``` add_filter( 'imgix_remove_size_attributes', '__return_true' ); ``` Credits ------- [](#credits) Created by Web Doodle Forked from [HumanMade's Tachyon Plugin](https://github.com/humanmade/tachyon-plugin) -- Special thanks to the HumanMade team for working on accelerated Wordpress projects. Written and maintained by [Ryan Soury](https://github.com/rsoury). ### Health Score 32 — LowBetter than 69% of packages Maintenance25 Infrequent updates — may be unmaintained Popularity28 Limited adoption so far Community20 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~26 days Recently: every ~40 days Total 7 Last Release 1949d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/16496556?v=4)[Ryan Soury](/maintainers/rsoury)[@rsoury](https://github.com/rsoury) --- Top Contributors [![roborourke](https://avatars.githubusercontent.com/u/23417?v=4)](https://github.com/roborourke "roborourke (50 commits)")[![peterwilsoncc](https://avatars.githubusercontent.com/u/519727?v=4)](https://github.com/peterwilsoncc "peterwilsoncc (40 commits)")[![joehoyle](https://avatars.githubusercontent.com/u/161683?v=4)](https://github.com/joehoyle "joehoyle (29 commits)")[![rsoury](https://avatars.githubusercontent.com/u/16496556?v=4)](https://github.com/rsoury "rsoury (9 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (6 commits)")[![HeathStratosphere](https://avatars.githubusercontent.com/u/88055612?v=4)](https://github.com/HeathStratosphere "HeathStratosphere (6 commits)")[![etechdevai](https://avatars.githubusercontent.com/u/17013371?v=4)](https://github.com/etechdevai "etechdevai (3 commits)")[![rmccue](https://avatars.githubusercontent.com/u/21655?v=4)](https://github.com/rmccue "rmccue (2 commits)")[![heyitsbryanm](https://avatars.githubusercontent.com/u/22304763?v=4)](https://github.com/heyitsbryanm "heyitsbryanm (2 commits)")[![zloymalefic](https://avatars.githubusercontent.com/u/5164061?v=4)](https://github.com/zloymalefic "zloymalefic (1 commits)")[![Japh](https://avatars.githubusercontent.com/u/237905?v=4)](https://github.com/Japh "Japh (1 commits)")[![pdewouters](https://avatars.githubusercontent.com/u/30460?v=4)](https://github.com/pdewouters "pdewouters (1 commits)")[![wvega](https://avatars.githubusercontent.com/u/45068?v=4)](https://github.com/wvega "wvega (1 commits)")[![brendanlawton](https://avatars.githubusercontent.com/u/10241756?v=4)](https://github.com/brendanlawton "brendanlawton (1 commits)") --- Tags imgiximgix-pluginwordpresswordpress-plugin ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/rsoury-wp-imgix/health.svg) ``` [![Health](https://phpackages.com/badges/rsoury-wp-imgix/health.svg)](https://phpackages.com/packages/rsoury-wp-imgix) ``` ### Alternatives [spacecatninja/imager-x Ninja powered image transforms. 29405.1k38](/packages/spacecatninja-imager-x)[goat1000/svggraph Generates SVG graphs 135911.1k3](/packages/goat1000-svggraph)[riclep/laravel-storyblok A Laravel wrapper around the Storyblok API to provide a familiar experience for Laravel devs 6279.6k5](/packages/riclep-laravel-storyblok)[elgentos/magento2-imgix Imgix extension for Magento 2 to process images 1670.0k](/packages/elgentos-magento2-imgix)[otisz/laravel-imgix 1419.4k](/packages/otisz-laravel-imgix)[imgix/magento imgix extension to search and select product images within Magento 2/Adobe Commerce 195.2k](/packages/imgix-magento) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)