WP hooks navigation: Home/browse • Actions index • Filters index
To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).
The best way to understand what a hook does is to look at where it occurs in the source code.
do_action( "hook_name" )apply_filters( "hook_name", "what_to_filter" ).Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.
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 |