Filter hook 'pre_get_avatar_data'

Hook Information

Hook Parameters

Usage Examples

<?php
// Hook into pre_get_avatar_data
add_filter('pre_get_avatar_data', 'my_custom_filter', 10, 2);

function my_custom_filter($args, $id_or_email) {
    // Your custom filtering logic here
    return $args;
}

Source Code Context

<?php
4472  	 *
4473  	 * @param array $args        Arguments passed to get_avatar_data(), after processing.
4474  	 * @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar SHA-256 or MD5 hash,
4475  	 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
4476  	 */
4477  	$args = apply_filters( 'pre_get_avatar_data', $args, $id_or_email );
4478  
4479  	if ( isset( $args['url'] ) ) {
4480  		/** This filter is documented in wp-includes/link-template.php */
4481  		return apply_filters( 'get_avatar_data', $args, $id_or_email );
4482  	}

PHP Documentation

<?php
/**
	 * Filters whether to retrieve the avatar URL early.
	 *
	 * Passing a non-null value in the 'url' member of the return array will
	 * effectively short circuit get_avatar_data(), passing the value through
	 * the {@see 'get_avatar_data'} filter and returning early.
	 *
	 * @since 4.2.0
	 *
	 * @param array $args        Arguments passed to get_avatar_data(), after processing.
	 * @param mixed $id_or_email The avatar to retrieve. Accepts a user ID, Gravatar SHA-256 or MD5 hash,
	 *                           user email, WP_User object, WP_Post object, or WP_Comment object.
	 */