Changeset 56112

Timestamp:

06/29/2023 05:32:35 PM (15 months ago)

Author:

flixos90

Message:

Media: Fix inconsistent docs for existing wp_img_tag_add_loading_attr filter and remove duplicate.

Follow-up to [56037].

Props thekt12.
See #58235.

Location:

trunk/src/wp-includes

Files:

• deprecated.php (modified) (1 diff)
• media.php (modified) (1 diff)

trunk/src/wp-includes/deprecated.php

@@ -4780 +4780 @@
     }
 
-    /**
-     * Filters the `loading` attribute value to add to an image. Default `lazy`.
-     *
-     * Returning `false` or an empty string will not add the attribute.
-     * Returning `true` will add the default value.
-     *
-     * @since 5.5.0
-     *
-     * @param string|bool $value   The `loading` attribute value. Returning a falsey value will result in
-     *                             the attribute being omitted for the image.
-     * @param string      $image   The HTML `img` tag to be filtered.
-     * @param string      $context Additional context about how the function was called or where the img tag is.
-     */
+    /** This filter is documented in wp-admin/includes/media.php */
     $value = apply_filters( 'wp_img_tag_add_loading_attr', $value, $image, $context );
 

trunk/src/wp-includes/media.php

@@ -1964 +1964 @@
         /**
          * Filters the `loading` attribute value to add to an image. Default `lazy`.
-         * This filter is added in for backward compatibility.
          *
          * Returning `false` or an empty string will not add the attribute.
          * Returning `true` will add the default value.
-         * `true` and `false` usage supported for backward compatibility.
          *
          * @since 5.5.0
          *
-         * @param string|bool $loading Current value for `loading` attribute for the image.
+         * @param string|bool $value   The `loading` attribute value. Returning a falsey value will result in
+         *                             the attribute being omitted for the image.
          * @param string      $image   The HTML `img` tag to be filtered.
          * @param string      $context Additional context about how the function was called or where the img tag is.