__( 'Adorable Avatar (Generated)', 'adorable-avatars' ) ] + $defaults; return $defaults; } /** * Replaces the complete avatar image tag. * * @since 2.1.0 * @wp-hook pre_get_avatar * * @param string|null $avatar Avatar image tag. * @param mixed $id_or_email User identifier. * @param array $args Avatar args. * * @return string|null Avatar image tag. */ public function replace_avatar( $avatar, $id_or_email, array $args ) { if ( $args['default'] && self::NAME !== $args['default'] ) { return $avatar; } /** * Filters whether or not Adorable Avatars should be forced to display. * * @since 2.1.0 * * @param bool $force Force Adorable Avatars? * @param mixed $id_or_email User identifier. * @param array $args Avatar args. */ if ( ! apply_filters( 'adorable_avatars.force', false, $id_or_email, $args ) ) { return $avatar; } $size = $args['size']; $urls = $this->get_urls( $id_or_email, $size ); $avatar = sprintf( '', esc_url( $urls[0] ), esc_url( $urls[1] ), esc_attr( $size ), esc_attr( $this->get_class_value( $size, $args ) ), esc_attr( $args['alt'] ), isset( $args['extra_attr'] ) ? $args['extra_attr'] : '' ); return $avatar; } /** * Replaces the avatar default image. * * @since 2.1.0 * @wp-hook get_avatar * * @param string $avatar Avatar image tag. * @param mixed $id_or_email User identifier. * @param int $size Avatar size. * @param string $default Avatar key. * * @return string Avatar image tag. */ public function replace_default( $avatar, $id_or_email, $size, $default ) { if ( self::NAME !== $default ) { return $avatar; } $urls = $this->get_urls( $id_or_email, $size ); $avatar = preg_replace( '~([?&;]d\=)' . self::NAME . '(&.*)?$~', '$1' . urlencode( $urls[0] ) . '$2', $avatar ); return $avatar; } /** * Returns the URLs of the standard and retina quality avatar images for the given user identifier and size. * * @param mixed $identifier User identifier. * @param int $size Avatar size. * * @return string[] The URLs of the standard and retina quality avatar images. */ private function get_urls( $identifier, $size ) { $identifier = $this->get_identifier( $identifier ); $protocol = is_ssl() ? 'https' : 'http'; $urls = array_map( function ( $factor ) use ( $identifier, $protocol, $size ) { return "{$protocol}://{$this->url}" . ( $size * $factor ) . "/$identifier.png"; }, [ 1, 2 ] ); return $urls; } /** * Returns the identifier string for the given user identifier. * * @param mixed $identifier User identifier. * * @return string The identifier string for the given user identifier. */ private function get_identifier( $identifier ) { if ( is_numeric( $identifier ) ) { $identifier = get_user_by( 'id', $identifier ); } elseif ( $identifier instanceof WP_Post ) { $identifier = get_user_by( 'id', $identifier->post_author ); } elseif ( $identifier instanceof WP_Comment ) { $identifier = 0 < $identifier->user_id ? get_user_by( 'id', $identifier->user_id ) : $identifier->comment_author_email; } if ( $identifier instanceof WP_User ) { $identifier = $identifier->user_email; } elseif ( ! is_string( $identifier ) ) { return ''; } $identifier = md5( strtolower( trim( $identifier ) ) ); return $identifier; } /** * Returns the avatar HTML class attribute value for the given avatar size and args. * * @param int $size Avatar size. * @param array $args Avatar args. * * @return string The avatar HTML class attribute value */ private function get_class_value( $size, array $args ) { $class = [ 'avatar', "avatar-$size", 'adorable-avatar', 'photo', ]; if ( empty( $args['found_avatar'] ) || $args['force_default'] ) { $class[] = 'avatar-default'; } if ( ! empty( $args['class'] ) ) { $class = array_unique( array_merge( $class, (array) $args['class'] ) ); } return join( ' ', $class ); } }