Changeset 31561 for trunk/src/wp-includes/link-template.php

Timestamp:

02/26/2015 09:16:02 PM (10 years ago)

Author:

wonderboymusic

Message:

In get_avatar_data() and get_avatar(), allow height and width to be specified separately (both default to size). Also allow arbitrary attributes on the <img> via the extra_attr arg.

Props miqrogroove.
See #31469.

File:

• trunk/src/wp-includes/link-template.php (modified) (5 diffs)

trunk/src/wp-includes/link-template.php

@@ -3423 +3423 @@
  *     Optional. Arguments to return instead of the default arguments.
  *
- *     @type int    $size           Height and width of the avatar in pixels. Default 96.
+ *     @type int    $size           Height and width of the avatar image file in pixels. Default 96.
+ *     @type int    $height         Display height of the avatar in pixels. Defaults to $size.
+ *     @type int    $width          Display width of the avatar in pixels. Defaults to $size.
  *     @type string $default        URL for the default image or a default type. Accepts '404' (return
  *                                  a 404 instead of a default image), 'retro' (8bit), 'monsterid' (monster),
@@ -3437 +3439 @@
  *     @type array  $processed_args When the function returns, the value will be the processed/sanitized $args
  *                                  plus a "found_avatar" guess. Pass as a reference. Default null.
+ *     @type string $extra_attr     HTML attribute to insert in the IMG element.  Has no default and is not sanitized.
  * }
  *
@@ -3450 +3453 @@
     $args = wp_parse_args( $args, array(
         'size'           => 96,
+        'height'         => null,
+        'width'          => null,
         'default'        => get_option( 'avatar_default', 'mystery' ),
         'force_default'  => false,
@@ -3455 +3460 @@
         'scheme'         => null,
         'processed_args' => null, // if used, should be a reference
+        'extra_attr'     => '',
     ) );
 
@@ -3464 +3470 @@
     } else {
         $args['size'] = 96;
+    }
+
+    if ( is_numeric( $args['height'] ) ) {
+        $args['height'] = absint( $args['height'] );
+        if ( ! $args['height'] ) {
+            $args['height'] = $args['size'];
+        }
+    } else {
+        $args['height'] = $args['size'];
+    }
+
+    if ( is_numeric( $args['width'] ) ) {
+        $args['width'] = absint( $args['width'] );
+        if ( ! $args['width'] ) {
+            $args['width'] = $args['size'];
+        }
+    } else {
+        $args['width'] = $args['size'];
     }