Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: get_avatar_data

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 3 times in this file.

Line Code
3577       * @since 4.2.0
3578       *
3579       * @param array             $args          Arguments passed to get_avatar_data(), after processing.
3580       * @param int|object|string $id_or_email   A user ID, email address, or comment object.
3581       */
3582      $args = apply_filters( 'pre_get_avatar_data', $args, $id_or_email );
3583
3584      if ( isset( $args['url'] ) && ! is_null( $args['url'] ) ) {
3585           /** This filter is documented in wp-includes/link-template.php */
3586           return apply_filters( 'get_avatar_data', $args, $id_or_email );
3587      }
3588
3589      $email_hash = '';
3590      $user = $email = false;
3591
3592      // Process the user identifier.
3593      if ( is_numeric( $id_or_email ) ) {
3594           $user = get_user_by( 'id', absint( $id_or_email ) );
3595      } elseif ( is_string( $id_or_email ) ) {
 
Line Code
3614            *
3615            * @since 3.0.0
3616            *
3617            * @param array $types An array of content types. Default only contains 'comment'.
3618            */
3619           $allowed_comment_types = apply_filters( 'get_avatar_comment_types', array( 'comment' ) );
3620           if ( ! empty( $id_or_email->comment_type ) && ! in_array( $id_or_email->comment_type, (array) $allowed_comment_types ) ) {
3621                $args['url'] = false;
3622                /** This filter is documented in wp-includes/link-template.php */
3623                return apply_filters( 'get_avatar_data', $args, $id_or_email );
3624           }
3625
3626           if ( ! empty( $id_or_email->user_id ) ) {
3627                $user = get_user_by( 'id', (int) $id_or_email->user_id );
3628           }
3629           if ( ( ! $user || is_wp_error( $user ) ) && ! empty( $id_or_email->comment_author_email ) ) {
3630                $email = $id_or_email->comment_author_email;
3631           }
3632      }
 
Line Code
3679
3680      /**
3681       * Filter the avatar data.
3682       *
3683       * @since 4.2.0
3684       *
3685       * @param array             $args        Arguments passed to get_avatar_data(), after processing.
3686       * @param int|object|string $id_or_email A user ID, email address, or comment object.
3687       */
3688      return apply_filters( 'get_avatar_data', $args, $id_or_email );
3689 }
3690