All Projects → Automattic → Lazy Load

Automattic / Lazy Load

Lazy load images on your WordPress site to improve page load times and server bandwidth.

Programming Languages

javascript
184084 projects - #8 most used programming language

=== Lazy Load === Contributors: batmoo, automattic, jakemgold, 10up Tags: lazy load, images, front-end optimization Requires at least: 3.2 Tested up to: 5.0 Stable tag: 0.7

Lazy load images to improve page load times and server bandwidth. Images are loaded only when visible to the user.

== Description ==

Lazy load images to improve page load times. Uses jQuery.sonar to only load an image when it's visible in the viewport.

This plugin is an amalgamation of code written by the WordPress.com VIP team at Automattic, the TechCrunch 2011 Redesign team, and Jake Goldman (10up LLC).

Uses jQuery.sonar by Dave Artz (AOL).

== Installation ==

  1. Upload the plugin to your plugins directory
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Enjoy!

== Screenshots ==

No applicable screenshots

== Frequently Asked Questions ==

= How do I change the placeholder image =

add_filter( 'lazyload_images_placeholder_image', 'my_custom_lazyload_placeholder_image' ); function my_custom_lazyload_placeholder_image( $image ) { return 'http://url/to/image'; }

= How do I lazy load other images in my theme? =

You can use the lazyload_images_add_placeholders helper function:

if ( function_exists( 'lazyload_images_add_placeholders' ) ) $content = lazyload_images_add_placeholders( $content );

Or, you can add an attribute called "data-lazy-src" with the source of the image URL and set the actual image URL to a transparent 1x1 pixel.

You can also use output buffering, though this isn't recommended:

if ( function_exists( 'lazyload_images_add_placeholders' ) ) ob_start( 'lazyload_images_add_placeholders' );

This will lazy load all your images.

== Changelog ==

= 0.7 =

  • srcset and sizes support (props deas and mariusveltan)
  • Disable for AMP content

= 0.6.1 =

= 0.6 =

  • Filter to control when lazy loading is enabled

= 0.5 =

  • Fix lazyload_images_add_placeholders by adding missing return, props Kevin Smith
  • Lazy load avatars, props i8ramin
  • Don't lazy load images in the Dashboard
  • Better compatibility with Jetpack Carousel

= 0.4 =

  • New helper function to lazy load non-post content
  • Prevent circular lazy-loading

= 0.3 =

  • Make LazyLoad a static class so that it's easier to change its hooks
  • Hook in at a higher priority for content filters

= 0.2 =

  • Adds noscript tags to allow the image to show up in no-js contexts (including crawlers), props smub
  • Lazy Load post thumbnails, props ivancamilov

= 0.1 =

  • Initial working version
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].