Title: Missing or misleading docs
Last modified: June 15, 2018

---

# Missing or misleading docs

 *  Resolved [gerd.neumann](https://wordpress.org/support/users/gerdneumann/)
 * (@gerdneumann)
 * [7 years, 12 months ago](https://wordpress.org/support/topic/missing-or-misleading-docs/)
 * Hi,
 * I am very grateful this plugin. It is very **helpful** and I use it together 
   with an Imagify Pro Account (WP Rocket alltogether did not make sense for us,
   since we already have varnish setup on our own).
 * However, I had a hard time getting it working. Here’s why:
 * 1. At the FAQ at [https://wordpress.org/plugins/rocket-lazy-load/#description](https://wordpress.org/plugins/rocket-lazy-load/#description)
   for `Installation instruction` it does not say, that it needs to be activated
   under Settings. Took 2h to debug why it was not working.
 * 2. The Docs at [https://docs.wp-rocket.me/category/32-lazyload](https://docs.wp-rocket.me/category/32-lazyload)
   are not linked from [https://wordpress.org/plugins/rocket-lazy-load/](https://wordpress.org/plugins/rocket-lazy-load/)
   I found them by accident.
 * 3. The [https://wordpress.org/plugins/rocket-lazy-load/](https://wordpress.org/plugins/rocket-lazy-load/)
   page should give credit to the underlying js lib [https://github.com/verlok/lazyload](https://github.com/verlok/lazyload)
   Also because it’s documentation is much better and helps to understand how to
   adjust things. For instance, without it, the `threshold` in [https://wordpress.org/plugins/rocket-lazy-load/](https://wordpress.org/plugins/rocket-lazy-load/)
   FAQ does not really make sense
 * 4. The docs at [https://docs.wp-rocket.me/article/130-manually-apply-lazyload-to-an-image](https://docs.wp-rocket.me/article/130-manually-apply-lazyload-to-an-image)
   are wrong:
    a) The check
 *     ```
       function_exists( 'get_rocket_option' )   && get_rocket_option( 'lazyload' )
       ```
   
 * will only work if Rocket is installed. Something like and using `rocket_lazyload_init`
   for the check like in:
 *     ```
         $rocket_is_installed = function_exists( 'get_rocket_option' ); 
         if( ($rocket_is_installed && get_rocket_option( 'lazyload')) || (!$rocket_is_installed && function_exists( 'rocket_lazyload_init'))) {
           ...
         }
       ```
   
 * would be better.
    b) The `data-lazy-srcset` attribute is not mentioned. In my
   case (using Virtue Premium theme) this meant that all images were still immediately
   loaded (because of the `srcset`). See [https://github.com/verlok/lazyload#responsive-images—srcset-and-sizes](https://github.com/verlok/lazyload#responsive-images—srcset-and-sizes)
   and [https://github.com/verlok/lazyload#responsive-images—picture](https://github.com/verlok/lazyload#responsive-images—picture)
 * 5. The tip at [https://docs.wp-rocket.me/article/113-fade-in-effect-for-your-lazyloaded-images](https://docs.wp-rocket.me/article/113-fade-in-effect-for-your-lazyloaded-images)
   is in contrast to the recommendation at [https://github.com/verlok/lazyload#show-the-images-while-they-load](https://github.com/verlok/lazyload#show-the-images-while-they-load)
   Especially when used together with Imagify which (hopefully) uses Progressive
   JPEG.
 * Let me really say that I found this plugin extremely helpful. But maybe your 
   docs team could update the documentation here and at the Rocket homepage. I guess
   having a few pointers/links to the js lib would be better than having inconsistent
   or even wrong documentation.
 * **So let’s finish by thanking you for providing this plugin! 🙂**
    -  This topic was modified 7 years, 12 months ago by [gerd.neumann](https://wordpress.org/support/users/gerdneumann/).

Viewing 4 replies - 1 through 4 (of 4 total)

 *  [yan.odnoralov](https://wordpress.org/support/users/yanodnoralov/)
 * (@yanodnoralov)
 * [7 years, 11 months ago](https://wordpress.org/support/topic/missing-or-misleading-docs/#post-10407222)
 * [@gerdneumann](https://wordpress.org/support/users/gerdneumann/) thank you for
   your detailed comment. I spent 3 hours trying to troubleshoot the srcset as there
   are NO mentions of it in any docs.
 * Plugins owner, please add this valuable info to the docs.
 *  Thread Starter [gerd.neumann](https://wordpress.org/support/users/gerdneumann/)
 * (@gerdneumann)
 * [7 years, 11 months ago](https://wordpress.org/support/topic/missing-or-misleading-docs/#post-10408219)
 * To add to number 5: The LazyLoad author strongly suggests *not* to use a placeholder,
   see [https://github.com/verlok/lazyload#do-not-use-11-pixel-gif-placeholders](https://github.com/verlok/lazyload#do-not-use-11-pixel-gif-placeholders)
 *  Thread Starter [gerd.neumann](https://wordpress.org/support/users/gerdneumann/)
 * (@gerdneumann)
 * [7 years, 11 months ago](https://wordpress.org/support/topic/missing-or-misleading-docs/#post-10408255)
 * Sorry, correct link is:
    [https://github.com/verlok/lazyload#do-not-use-placeholder-images](https://github.com/verlok/lazyload#do-not-use-placeholder-images)(
   or search for placeholder in above URL)
 *  Plugin Author [WP Media](https://wordpress.org/support/users/wp_media/)
 * (@wp_media)
 * [7 years, 11 months ago](https://wordpress.org/support/topic/missing-or-misleading-docs/#post-10460144)
 * Thank you for taking the time to write this.
 * We’re going to improve some of the content for this plugin specifically.
 * You should know that any documentation on docs.wp-rocket.me is only related to
   WP Rocket, and the lazyload version in it might differ from the lazyload in this
   plugin on the repository, as we use it to test changes and new features before
   integrating them into WP Rocket later on.

Viewing 4 replies - 1 through 4 (of 4 total)

The topic ‘Missing or misleading docs’ is closed to new replies.

 * ![](https://ps.w.org/rocket-lazy-load/assets/icon-256x256.png?rev=2715509)
 * [LazyLoad Plugin – Lazy Load Images, Videos, and Iframes](https://wordpress.org/plugins/rocket-lazy-load/)
 * [Frequently Asked Questions](https://wordpress.org/plugins/rocket-lazy-load/#faq)
 * [Support Threads](https://wordpress.org/support/plugin/rocket-lazy-load/)
 * [Active Topics](https://wordpress.org/support/plugin/rocket-lazy-load/active/)
 * [Unresolved Topics](https://wordpress.org/support/plugin/rocket-lazy-load/unresolved/)
 * [Reviews](https://wordpress.org/support/plugin/rocket-lazy-load/reviews/)

## Tags

 * [Lazyload](https://wordpress.org/support/topic-tag/lazyload/)
 * [srcset](https://wordpress.org/support/topic-tag/srcset/)

 * 4 replies
 * 3 participants
 * Last reply from: [WP Media](https://wordpress.org/support/users/wp_media/)
 * Last activity: [7 years, 11 months ago](https://wordpress.org/support/topic/missing-or-misleading-docs/#post-10460144)
 * Status: resolved