Changeset 45632 for trunk/src/wp-includes/rest-api.php

Timestamp:

07/14/2019 02:34:02 PM (7 years ago)

Author:

SergeyBiryukov

Message:

REST API: Allow rest_get_avatar_urls() to accept full user, post, or comment objects, rather than just an email address, to provide better flexibility for alternative avatar data.

Since the function uses get_avatar_url() internally, which already supports it, this should not have any backward compatibility concerns.

Props donmhico, dshanske, pputzer, joehoyle, TimothyBlynJacobs.
Fixes #40030.

File:

• trunk/src/wp-includes/rest-api.php (modified) (2 diffs)

trunk/src/wp-includes/rest-api.php

@@ -1086 +1086 @@
 
 /**
- * Retrieves the avatar urls in various sizes based on a given email address.
+ * Retrieves the avatar urls in various sizes.
  *
  * @since 4.7.0
@@ -1092 +1092 @@
  * @see get_avatar_url()
  *
- * @param string $email Email address.
+ * @param mixed $id_or_email The Gravatar to retrieve a URL for. Accepts a user_id, gravatar md5 hash,
+ *                           user email, WP_User object, WP_Post object, or WP_Comment object.
  * @return array $urls Gravatar url for each size.
  */
-function rest_get_avatar_urls( $email ) {
+function rest_get_avatar_urls( $id_or_email ) {
     $avatar_sizes = rest_get_avatar_sizes();
 
     $urls = array();
     foreach ( $avatar_sizes as $size ) {
-        $urls[ $size ] = get_avatar_url( $email, array( 'size' => $size ) );
+        $urls[ $size ] = get_avatar_url( $id_or_email, array( 'size' => $size ) );
     }