wp_get_attachment_image_attributes filter-hookWP 2.8.0

Filters the list of attachment image attributes.

Usage

add_filter( 'wp_get_attachment_image_attributes', 'wp_kama_get_attachment_image_attributes_filter', 10, 3 );

/**
 * Function for `wp_get_attachment_image_attributes` filter-hook.
 * 
 * @param string[]     $attr       Array of attribute values for the image markup, keyed by attribute name. See wp_get_attachment_image().
 * @param WP_Post      $attachment Image attachment post.
 * @param string|int[] $size       Requested image size. Can be any registered image size name, or an array of width and height values in pixels (in that order).
 *
 * @return string[]
 */
function wp_kama_get_attachment_image_attributes_filter( $attr, $attachment, $size ){

	// filter...
	return $attr;
}
$attr(string[])
Array of attribute values for the image markup, keyed by attribute name. See wp_get_attachment_image().
$attachment(WP_Post)
Image attachment post.
$size(string|int[])
Requested image size. Can be any registered image size name, or an array of width and height values in pixels (in that order).

Changelog

Since 2.8.0 Introduced.

Where the hook is called

wp_get_attachment_image()
wp_get_attachment_image_attributes
wp-includes/media.php 1165
$attr = apply_filters( 'wp_get_attachment_image_attributes', $attr, $attachment, $size );

Where the hook is used in WordPress

wp-includes/media.php 2401
add_filter( 'wp_get_attachment_image_attributes', '_wp_post_thumbnail_class_filter' );
wp-includes/media.php 2414
remove_filter( 'wp_get_attachment_image_attributes', '_wp_post_thumbnail_class_filter' );