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
3868       *
3869       * @param array  $args        Arguments passed to get_avatar_data(), after processing.
3870       * @param mixed  $id_or_email The Gravatar to retrieve. Accepts a user_id, gravatar md5 hash,
3871       *                            user email, WP_User object, WP_Post object, or WP_Comment object.
3872       */
3873      $args = apply_filters( 'pre_get_avatar_data', $args, $id_or_email );
3874
3875      if ( isset( $args['url'] ) && ! is_null( $args['url'] ) ) {
3876           /** This filter is documented in wp-includes/link-template.php */
3877           return apply_filters( 'get_avatar_data', $args, $id_or_email );
3878      }
3879
3880      $email_hash = '';
3881      $user = $email = false;
3882
3883      if ( is_object( $id_or_email ) && isset( $id_or_email->comment_ID ) ) {
3884           $id_or_email = get_comment( $id_or_email );
3885      }
3886
 
Line Code
3907            *
3908            * @since 3.0.0
3909            *
3910            * @param array $types An array of content types. Default only contains 'comment'.
3911            */
3912           $allowed_comment_types = apply_filters( 'get_avatar_comment_types', array( 'comment' ) );
3913           if ( ! empty( $id_or_email->comment_type ) && ! in_array( $id_or_email->comment_type, (array) $allowed_comment_types ) ) {
3914                $args['url'] = false;
3915                /** This filter is documented in wp-includes/link-template.php */
3916                return apply_filters( 'get_avatar_data', $args, $id_or_email );
3917           }
3918
3919           if ( ! empty( $id_or_email->user_id ) ) {
3920                $user = get_user_by( 'id', (int) $id_or_email->user_id );
3921           }
3922           if ( ( ! $user || is_wp_error( $user ) ) && ! empty( $id_or_email->comment_author_email ) ) {
3923                $email = $id_or_email->comment_author_email;
3924           }
3925      }
 
Line Code
3974      /**
3975       * Filters the avatar data.
3976       *
3977       * @since 4.2.0
3978       *
3979       * @param array  $args        Arguments passed to get_avatar_data(), after processing.
3980       * @param mixed  $id_or_email The Gravatar to retrieve. Accepts a user_id, gravatar md5 hash,
3981       *                            user email, WP_User object, WP_Post object, or WP_Comment object.
3982       */
3983      return apply_filters( 'get_avatar_data', $args, $id_or_email );
3984 }
3985
3986 /**
3987  * Retrieves the URL of a file in the theme.
3988  *
3989  * Searches in the stylesheet directory before the template directory so themes
3990  * which inherit from a parent theme can just override one file.
3991  *
3992  * @since 4.7.0