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 |
---|---|
4447 | * |
4448 | * @param array $args Arguments passed to get_avatar_data(), after processing. |
4449 | * @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar MD5 hash, |
4450 | * user email, WP_User object, WP_Post object, or WP_Comment object. |
4451 | */ |
4452 | $args = apply_filters( 'pre_get_avatar_data', $args, $id_or_email ); |
4453 |
|
4454 | if ( isset( $args['url'] ) ) { |
4455 | /** This filter is documented in wp-includes/link-template.php */ |
4456 | return apply_filters( 'get_avatar_data', $args, $id_or_email ); |
4457 | } |
4458 |
|
4459 | $email_hash = ''; |
4460 | $user = false; |
4461 | $email = false; |
4462 |
|
4463 | if ( is_object( $id_or_email ) && isset( $id_or_email->comment_ID ) ) { |
4464 | $id_or_email = get_comment( $id_or_email ); |
4465 | } |
Line | Code |
4479 | // User object. |
4480 | $user = $id_or_email; |
4481 | } elseif ( $id_or_email instanceof WP_Post ) { |
4482 | // Post object. |
4483 | $user = get_user_by( 'id', (int) $id_or_email->post_author ); |
4484 | } elseif ( $id_or_email instanceof WP_Comment ) { |
4485 | if ( ! is_avatar_comment_type( get_comment_type( $id_or_email ) ) ) { |
4486 | $args['url'] = false; |
4487 | /** This filter is documented in wp-includes/link-template.php */ |
4488 | return apply_filters( 'get_avatar_data', $args, $id_or_email ); |
4489 | } |
4490 |
|
4491 | if ( ! empty( $id_or_email->user_id ) ) { |
4492 | $user = get_user_by( 'id', (int) $id_or_email->user_id ); |
4493 | } |
4494 | if ( ( ! $user || is_wp_error( $user ) ) && ! empty( $id_or_email->comment_author_email ) ) { |
4495 | $email = $id_or_email->comment_author_email; |
4496 | } |
4497 | } |
Line | Code |
4546 | /** |
4547 | * Filters the avatar data. |
4548 | * |
4549 | * @since 4.2.0 |
4550 | * |
4551 | * @param array $args Arguments passed to get_avatar_data(), after processing. |
4552 | * @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar MD5 hash, |
4553 | * user email, WP_User object, WP_Post object, or WP_Comment object. |
4554 | */ |
4555 | return apply_filters( 'get_avatar_data', $args, $id_or_email ); |
4556 | } |
4557 |
|
4558 | /** |
4559 | * Retrieves the URL of a file in the theme. |
4560 | * |
4561 | * Searches in the stylesheet directory before the template directory so themes |
4562 | * which inherit from a parent theme can just override one file. |
4563 | * |
4564 | * @since 4.7.0 |